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

  • Artykuł

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ą:

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:

  • 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.

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:

Dodawanie akcji kodowania pliku prostego

  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.

    Screenshot showing Azure portal and Consumption workflow designer with

  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.

    Screenshot showing Consumption workflow designer and

    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.

    Screenshot showing Consumption workflow designer and opened

    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:

    Screenshot showing Consumption workflow with finished

  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.

Dodawanie akcji dekodowania pliku prostego

  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.

    Screenshot showing Azure portal and Consumption workflow designer with

  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.

    Screenshot showing the Consumption workflow designer and

    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.

    Screenshot showing Consumption workflow designer and opened

    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:

    Screenshot showing Consumption workflow with finished

  8. 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:

Testowanie przepływu pracy

  1. Za pomocą narzędzia Postman lub podobnego narzędzia i POST metody wyślij wywołanie do adresu URL wyzwalacza żądania, które pojawia się we właściwości HTTP POST wyzwalacza żądania i dołącz zawartość XML, którą chcesz zakodować lub zdekodować w treści żądania.

  2. 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