Kodowanie i dekodowanie plików prostych w usłudze Azure Logic Apps

Dotyczy: Azure Logic Apps (Zużycie + Standardowa)

Przed wysłaniem zawartości XML do partnera biznesowego w scenariuszu B2B (business-to-business) możesz najpierw zakodować zawartość. Jeśli otrzymasz zakodowaną zawartość XML, musisz najpierw zdekodować zawartość. Podczas tworzenia przepływu pracy aplikacji logiki w usłudze Azure Logic Apps można kodować i dekodować pliki proste przy użyciu wbudowanych akcji łącznika Flat File oraz prostego schematu plików do kodowania i dekodowania. Akcje flat file można używać w wielodostępnych przepływach pracy aplikacji logiki zużycie i przepływach pracy aplikacji logiki w warstwie Standardowa z jedną dzierżawą.

Chociaż nie są dostępne żadne wyzwalacze pliku prostego, możesz użyć dowolnego wyzwalacza lub akcji, aby udostępnić źródłową zawartość XML do przepływu pracy. Można na przykład użyć wbudowanego wyzwalacza łącznika, wyzwalacza łącznika zarządzanego lub hostowanego na platformie Azure dostępnego dla usługi Azure Logic Apps, a nawet innej aplikacji.

W tym artykule pokazano, jak dodać akcje kodowania i dekodowania pliku prostego do przepływu pracy.

• Dodaj akcję kodowania lub dekodowania pliku prostego do przepływu pracy.
• Wybierz schemat, którego chcesz użyć.

Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją:

• Użycie a aplikacje logiki w warstwie Standardowa
• Wbudowane łączniki konta integracji
• Omówienie wbudowanych łączników dla usługi Azure Logic Apps
• Łączniki zarządzane lub hostowane na platformie Azure w usłudze Azure Logic Apps

Wymagania wstępne

• Konto i subskrypcja platformy Azure. Jeśli nie masz jeszcze subskrypcji, utwórz bezpłatne konto platformy Azure.

• Przepływ pracy aplikacji logiki, pusty lub istniejący, w którym chcesz użyć akcji Plik prosty.

  Jeśli masz pusty przepływ pracy, użyj dowolnego wyzwalacza, który chcesz uruchomić przepływ pracy. W tym przykładzie użyto wyzwalacza Żądania .

• Zasób aplikacji logiki i przepływ pracy. Operacje na plikach prostych nie mają dostępnych wyzwalaczy, więc przepływ pracy musi zawierać wyzwalacz co najmniej. Więcej informacji można znaleźć w następującej dokumentacji:

  • Tworzenie przykładowego przepływu pracy aplikacji logiki zużycie w wielodostępnych usłudze Azure Logic Apps

  • Tworzenie przykładowego standardowego przepływu pracy aplikacji logiki w usłudze Azure Logic Apps z jedną dzierżawą

• Prosty schemat pliku do kodowania i dekodowania zawartości XML. Aby uzyskać więcej informacji, dodaj schematy do użycia z przepływami pracy w usłudze Azure Logic Apps.

• W zależności od tego, czy pracujesz nad przepływem pracy aplikacji logiki Zużycie, czy Standardowa, potrzebny będzie zasób konta integracji. Zazwyczaj ten zasób jest potrzebny, gdy chcesz zdefiniować i przechowywać artefakty do użycia w przepływach pracy integracji przedsiębiorstwa i B2B.

  Ważne

  Aby współpracować, zarówno konto integracji, jak i zasób aplikacji logiki muszą istnieć w tej samej subskrypcji platformy Azure i regionie świadczenia usługi Azure.

  • Jeśli pracujesz nad przepływem pracy aplikacji logiki Zużycie, zasób aplikacji logiki wymaga linku do konta integracji.

  • Jeśli pracujesz nad przepływem pracy aplikacji logiki w warstwie Standardowa, możesz połączyć zasób aplikacji logiki z kontem integracji, przekazać schematy bezpośrednio do zasobu aplikacji logiki lub oba te scenariusze:

    • Jeśli masz już konto integracji z artefaktami, których potrzebujesz lub chcesz użyć, możesz połączyć konto integracji z wieloma zasobami standardowej aplikacji logiki, w których chcesz używać artefaktów. W ten sposób nie trzeba przekazywać schematów do poszczególnych aplikacji logiki. Aby uzyskać więcej informacji, zobacz Łączenie zasobu aplikacji logiki z kontem integracji.

    • Wbudowany łącznik Flat File umożliwia wybranie schematu, który został wcześniej przekazany do zasobu aplikacji logiki lub połączonego konta integracji, ale nie obu tych elementów. Następnie możesz użyć tego artefaktu we wszystkich podrzędnych przepływach pracy w ramach tego samego zasobu aplikacji logiki.

    Jeśli więc nie masz lub nie potrzebujesz konta integracji, możesz użyć opcji przekazywania. W przeciwnym razie możesz użyć opcji łączenia. Tak czy inaczej, można użyć tych artefaktów we wszystkich podrzędnych przepływach pracy w ramach tego samego zasobu aplikacji logiki.

• Zainstaluj lub użyj narzędzia, które może wysyłać żądania HTTP w celu przetestowania rozwiązania, na przykład:

  • Program Visual Studio Code z rozszerzeniem z witryny Visual Studio Marketplace
  • PowerShell Invoke-RestMethod
  • Microsoft Edge — narzędzie konsoli sieciowej
  • Bruno
  • lok

  Uwaga

  W przypadku scenariuszy, w których masz poufne dane, takie jak poświadczenia, wpisy tajne, tokeny dostępu, klucze interfejsu API i inne podobne informacje, upewnij się, że używasz narzędzia chroniącego dane przy użyciu niezbędnych funkcji zabezpieczeń, działa w trybie offline lub lokalnie, nie synchronizuje danych z chmurą i nie wymaga zalogowania się do konta online. Dzięki temu można zmniejszyć ryzyko ujawnienia poufnych danych publicznie.

Ograniczenia

• Zawartość XML, którą chcesz dekodować, musi być zakodowana w formacie UTF-8.

• W schemacie pliku prostego upewnij się, że zawarte grupy XML nie mają nadmiernej max count liczby właściwości ustawionej na wartość większą niż 1. Unikaj zagnieżdżania grupy XML z wartością max count właściwości większą niż 1 wewnątrz innej grupy XML z właściwością max count większą niż 1.

• Gdy usługa Azure Logic Apps analizuje schemat plików prostych, a gdy schemat zezwala na wybór następnego fragmentu, usługa Azure Logic Apps generuje symbol i przewidywanie dla tego fragmentu. Jeśli schemat zezwala na zbyt wiele takich konstrukcji, na przykład ponad 100 000, rozszerzenie schematu staje się zbyt duże, co zużywa zbyt dużo zasobów i czasu.

Przekazywanie schematu

Po utworzeniu schematu należy teraz przekazać schemat w oparciu o następujący scenariusz:

• Jeśli pracujesz nad przepływem pracy aplikacji logiki Zużycie, dodaj schemat do konta integracji.

• Jeśli pracujesz nad przepływem pracy aplikacji logiki w warstwie Standardowa, możesz dodać schemat do konta integracji lub dodać schemat do zasobu aplikacji logiki.

Dodawanie akcji kodowania pliku prostego

Zużycie

1. W witrynie Azure Portal otwórz przepływ pracy aplikacji logiki w projektancie, jeśli jeszcze nie jest otwarty.

2. Jeśli przepływ pracy nie ma wyzwalacza ani żadnych innych akcji, których potrzebuje przepływ pracy, najpierw dodaj te operacje. Operacje na plikach prostych nie mają dostępnych żadnych wyzwalaczy.

   W tym przykładzie jest kontynuowany wyzwalacz żądania o nazwie Po odebraniu żądania HTTP.

3. W projektancie przepływu pracy w obszarze kroku, w którym chcesz dodać akcję Plik prosty, wybierz pozycję Nowy krok.

4. W polu wyszukiwania Wybierz operację wybierz pozycję Wbudowane. W polu wyszukiwania wprowadź prosty plik.

5. Z listy akcji wybierz akcję o nazwie Kodowanie plików prostych.

   

6. We właściwości Content akcji podaj dane wyjściowe z wyzwalacza lub poprzedniej akcji, którą chcesz zakodować, wykonując następujące kroki:

   1. Kliknij wewnątrz pola Zawartość , aby wyświetlić listę zawartości dynamicznej.

   2. Z listy zawartości dynamicznej wybierz zawartość pliku prostego, którą chcesz zakodować.

      W tym przykładzie z listy zawartości dynamicznej w obszarze Po odebraniu żądania HTTP wybierz token Treść , który reprezentuje dane wyjściowe zawartości treści z wyzwalacza.

   

   Uwaga

   Jeśli właściwość Treść nie jest wyświetlana na liście zawartości dynamicznej, wybierz pozycję Zobacz więcej obok etykiety sekcji Po odebraniu żądania HTTP. Możesz również bezpośrednio wprowadzić zawartość, aby zakodować w polu Zawartość .

7. Z listy Nazwa schematu wybierz schemat.

   

   Uwaga

   Jeśli lista schematów jest pusta, zasób aplikacji logiki nie jest połączony z kontem integracji lub konto integracji nie zawiera żadnych plików schematu.

   Po zakończeniu akcja wygląda podobnie do następującej:

   

8. Aby dodać inne parametry opcjonalne do akcji, wybierz te parametry z listy Dodaj nowy parametr .

   Parametr	Wartość	Opis
   Tryb generowania pustego węzła	ForcedDisabled lub HonorSchemaNodeProperty lub ForcedEnabled	Tryb używany do generowania pustych węzłów z kodowaniem plików prostych. W przypadku usługi BizTalk schemat pliku prostego ma właściwość, która kontroluje generowanie pustych węzłów. Możesz postępować zgodnie z zachowaniem właściwości generowania pustych węzłów dla schematu pliku prostego lub użyć tego ustawienia, aby usługa Azure Logic Apps wygenerowała lub pominąła puste węzły. Aby uzyskać więcej informacji, zobacz Tagi dla pustych elementów.
   Normalizacja XML	Tak lub Nie	Ustawienie włączania lub wyłączania normalizacji XML w kodowaniu plików prostych. Aby uzyskać więcej informacji, zobacz XmlTextReader.Normalization.

9. Zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Standardowa

1. W witrynie Azure Portal otwórz przepływ pracy aplikacji logiki w projektancie, jeśli jeszcze nie jest otwarty.

2. Jeśli przepływ pracy nie ma wyzwalacza ani żadnych innych akcji, których potrzebuje przepływ pracy, najpierw dodaj te operacje. Operacje na plikach prostych nie mają dostępnych żadnych wyzwalaczy.

   W tym przykładzie jest kontynuowany wyzwalacz żądania o nazwie Po odebraniu żądania HTTP.

3. W projektancie w obszarze kroku, w którym chcesz dodać akcję Plik prosty, wybierz znak plus (+), a następnie wybierz pozycję Dodaj akcję.

4. W wyświetlonym okienku Dodaj akcję w polu wyszukiwania wybierz pozycję Wbudowane.

5. W polu wyszukiwania wprowadź prosty plik. Z listy akcji wybierz akcję o nazwie Kodowanie plików prostych.

   

6. We właściwości Content akcji podaj dane wyjściowe z wyzwalacza lub poprzedniej akcji, którą chcesz zakodować, wykonując następujące kroki:

   1. Kliknij wewnątrz pola Zawartość , aby wyświetlić listę zawartości dynamicznej.

   2. Z listy zawartości dynamicznej wybierz zawartość pliku prostego, którą chcesz zakodować.

      W tym przykładzie z listy zawartości dynamicznej w obszarze Po odebraniu żądania HTTP wybierz token Treść , który reprezentuje dane wyjściowe zawartości treści z wyzwalacza.

   

7. Z listy Źródło wybierz pozycję LogicApp lub IntegrationAccount jako źródło schematu.

   W tym przykładzie jest kontynuowane wybranie pozycji IntegracjaKonto.

   

8. Z listy Nazwa wybierz schemat, który został wcześniej przekazany do zasobu aplikacji logiki na potrzeby kodowania, na przykład:

   

   Uwaga

   Jeśli lista schematów jest pusta, zasób aplikacji logiki nie jest połączony z kontem integracji, konto integracji nie zawiera żadnych plików schematu lub zasób aplikacji logiki nie zawiera żadnych plików schematu.

9. Zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Dodawanie akcji dekodowania pliku prostego

Zużycie

1. W witrynie Azure Portal otwórz przepływ pracy aplikacji logiki w projektancie, jeśli jeszcze nie jest otwarty.

2. Jeśli przepływ pracy nie ma wyzwalacza ani żadnych innych akcji, których potrzebuje przepływ pracy, najpierw dodaj te operacje. Operacje na plikach prostych nie mają dostępnych żadnych wyzwalaczy.

   W tym przykładzie jest kontynuowany wyzwalacz żądania o nazwie Po odebraniu żądania HTTP.

3. W projektancie przepływu pracy w obszarze kroku, w którym chcesz dodać akcję Plik prosty, wybierz pozycję Nowy krok.

4. W polu wyszukiwania Wybierz operację wybierz pozycję Wbudowane. W polu wyszukiwania wprowadź prosty plik.

5. Z listy akcji wybierz akcję o nazwie Dekodowanie pliku prostego.

   

6. We właściwości Content akcji podaj dane wyjściowe z wyzwalacza lub poprzedniej akcji, którą chcesz zdekodować, wykonując następujące kroki:

   1. Kliknij wewnątrz pola Zawartość , aby wyświetlić listę zawartości dynamicznej.

   2. Z listy zawartości dynamicznej wybierz zawartość pliku prostego, którą chcesz zakodować.

      W tym przykładzie z listy zawartości dynamicznej w obszarze Po odebraniu żądania HTTP wybierz token Treść , który reprezentuje dane wyjściowe zawartości treści z wyzwalacza.

   

   Uwaga

   Jeśli właściwość Treść nie jest wyświetlana na liście zawartości dynamicznej, wybierz pozycję Zobacz więcej obok etykiety sekcji Po odebraniu żądania HTTP. Możesz również bezpośrednio wprowadzić zawartość, aby zakodować w polu Zawartość .

7. Z listy Nazwa schematu wybierz schemat.

   

   Uwaga

   Jeśli lista schematów jest pusta, zasób aplikacji logiki nie jest połączony z kontem integracji lub konto integracji nie zawiera żadnych plików schematu.

   Po zakończeniu akcja wygląda podobnie do następującej:

   

8. Zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Standardowa

1. W witrynie Azure Portal otwórz przepływ pracy aplikacji logiki w projektancie, jeśli jeszcze nie jest otwarty.

2. Jeśli przepływ pracy nie ma wyzwalacza ani żadnych innych akcji, których potrzebuje przepływ pracy, najpierw dodaj te operacje. Operacje na plikach prostych nie mają dostępnych żadnych wyzwalaczy.

   W tym przykładzie jest kontynuowany wyzwalacz żądania o nazwie Po odebraniu żądania HTTP.

3. W projektancie w obszarze kroku, w którym chcesz dodać akcję Plik prosty, wybierz znak plus (+), a następnie wybierz pozycję Dodaj akcję.

4. W wyświetlonym okienku Dodaj akcję w polu wyszukiwania wybierz pozycję Wbudowane.

5. W polu wyszukiwania wprowadź prosty plik. Z listy akcji wybierz akcję o nazwie Dekodowanie pliku prostego.

   

6. We właściwości Content akcji podaj dane wyjściowe z wyzwalacza lub poprzedniej akcji, którą chcesz zdekodować, wykonując następujące kroki:

   1. Kliknij wewnątrz pola Zawartość , aby wyświetlić listę zawartości dynamicznej.

   2. Z listy zawartości dynamicznej wybierz zawartość pliku prostego, którą chcesz zakodować.

      W tym przykładzie z listy zawartości dynamicznej w obszarze Po odebraniu żądania HTTP wybierz token Treść , który reprezentuje dane wyjściowe zawartości treści z wyzwalacza.

   

7. Z listy Źródło wybierz pozycję LogicApp lub IntegrationAccount jako źródło schematu.

   W tym przykładzie jest kontynuowane wybranie pozycji IntegracjaKonto.

   

8. Z listy Nazwa wybierz schemat, który został wcześniej przekazany do zasobu aplikacji logiki na potrzeby dekodowania, na przykład:

   

   Uwaga

   Jeśli lista schematów jest pusta, zasób aplikacji logiki nie jest połączony z kontem integracji, konto integracji nie zawiera żadnych plików schematu lub zasób aplikacji logiki nie zawiera żadnych plików schematu.

9. Zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Teraz możesz skonfigurować akcję dekodowania pliku prostego. W rzeczywistej aplikacji możesz przechowywać zdekodowane dane w aplikacji biznesowej (LOB), takiej jak Salesforce. Możesz też wysłać zdekodowane dane do partnera handlowego. Aby wysłać dane wyjściowe z akcji dekodowania do usługi Salesforce lub partnera handlowego, użyj innych łączników dostępnych w usłudze Azure Logic Apps:

• Łączniki zarządzane dla usługi Azure Logic Apps
• Wbudowane łączniki dla usługi Azure Logic Apps

Testowanie przepływu pracy

Aby wyzwolić przepływ pracy, wykonaj następujące kroki:

1. W wyzwalaczu Żądanie znajdź właściwość HTTP POST URL i skopiuj adres URL.

2. Otwórz narzędzie żądania HTTP i użyj jego instrukcji, aby wysłać żądanie HTTP do skopiowanego adresu URL, w tym metodę oczekiwaną przez wyzwalacz żądania .

   W tym przykładzie użyto POST metody z adresem URL.

3. Dołącz zawartość XML, którą chcesz zakodować lub zdekodować w treści żądania.

4. Po zakończeniu działania przepływu pracy przejdź do historii uruchamiania przepływu pracy i sprawdź dane wejściowe i wyjściowe akcji Flat File.

Następne kroki

• Dowiedz się więcej o pakiecie integracyjnym dla przedsiębiorstw