Wymiana komunikatów EDIFACT przy użyciu przepływów pracy w usłudze Azure Logic Apps

Aby wysyłać i odbierać komunikaty EDIFACT w przepływach pracy tworzonych przy użyciu usługi Azure Logic Apps, użyj łącznika EDIFACT, który zapewnia operacje, które obsługują komunikację EDIFACT i zarządzają nią.

W tym przewodniku pokazano, jak dodać akcje kodowania i dekodowania EDIFACT do istniejącego przepływu pracy aplikacji logiki. Jeśli nie jest dostępny wyzwalacz EDIFACT , możesz uruchomić przepływ pracy za pomocą dowolnego wyzwalacza. Przykłady w tym przewodniku korzystają z wyzwalacza Żądania.

dokumentacja techniczna Połączenie or

Łącznik EDIFACT ma różne wersje na podstawie typu aplikacji logiki i środowiska hosta.

Aplikacja logiki Środowisko wersja Połączenie or
Zużycie wielodostępna usługa Azure Logic Apps Łącznik zarządzany EDIFACT (klasa Standardowa). Łącznik EDIFACT udostępnia tylko akcje, ale można użyć dowolnego wyzwalacza, który działa w danym scenariuszu. Aby uzyskać więcej informacji, zobacz następującą dokumentację:

- Dokumentacja łącznika zarządzanego EDIFACT
- Limity komunikatów EDIFACT
Zużycie Środowisko usługi integracji (ISE) Łącznik zarządzany EDIFACT (klasa Standardowa) i wersja EDIFACT ISE, która ma inne limity komunikatów niż klasa Standardowa. Łącznik EDIFACT udostępnia tylko akcje, ale można użyć dowolnego wyzwalacza, który działa w danym scenariuszu. Aby uzyskać więcej informacji, zobacz następującą dokumentację:

- Dokumentacja łącznika zarządzanego EDIFACT
- Limity komunikatów EDIFACT
Standardowa Usługa Azure Logic Apps i środowisko App Service Environment w wersji 3 z jedną dzierżawą (tylko plany systemu Windows) Wbudowany łącznik EDIFACT (wersja zapoznawcza) i łącznik zarządzany EDIFACT . Wbudowana wersja różni się w następujący sposób:

— Wbudowana wersja udostępnia tylko akcje, ale można użyć dowolnego wyzwalacza, który działa w danym scenariuszu.

— Wbudowana wersja może uzyskiwać bezpośredni dostęp do sieci wirtualnych platformy Azure. Nie potrzebujesz lokalnej bramy danych.

Aby uzyskać więcej informacji, zobacz następującą dokumentację:

- Dokumentacja łącznika zarządzanego EDIFACT
- Wbudowane operacje łącznika EDIFACT
- Limity komunikatów EDIFACT

Wbudowane operacje EDIFACT (tylko standardowe przepływy pracy — wersja zapoznawcza)

Wbudowany łącznik EDIFACT w wersji zapoznawczej ma następujące akcje, które są podobne do akcji łącznika zarządzanego EDIFACT, z wyjątkiem przypadków, w których określono ograniczenia i znane problemy.

Ograniczenia i znane problemy

  • Wbudowany łącznik EDIFACT w wersji zapoznawczej

    • Ta funkcja jest dostępna w wersji zapoznawczej i podlega dodatkowym warunkom użytkowania wersji zapoznawczej platformy Microsoft Azure.

    • Akcje tego łącznika obsługują obecnie ładunki do co najmniej 100 MB.

    • Akcja dekodowania EDIFACT w wersji zapoznawczej obecnie nie obejmuje następujących możliwości:

      • Sprawdź zduplikowaną wymianę, grupę i numery kontrolek zestawu transakcji, jeśli zostały skonfigurowane.

      • Zachowaj całą wymianę.

      W przeciwnym razie wbudowane akcje łącznika EDIFACT i EDIFACT w wersji zapoznawczej mają funkcje podobne do akcji łącznika zarządzanego EDIFACT.

    • Akcje tego łącznika obecnie nie obsługują wymiany z wieloma transakcjami ani komunikatami wsadowymi.

    • Akcje tego łącznika nie emitują obecnie śledzenia specyficznego dla interfejsu EDI.

Wymagania wstępne

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

  • Zasób konta integracji, w którym definiujesz i przechowujesz artefakty, takie jak partnerzy handlowi, umowy, certyfikaty itd., do użycia w przepływach pracy integracji przedsiębiorstwa i B2B. Ten zasób musi spełniać następujące wymagania:

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

    • Definiuje co najmniej dwóch partnerów handlowych, którzy uczestniczą w operacji EDIFACT używanej w przepływie pracy. Definicje dla obu partnerów muszą używać tego samego kwalifikatora tożsamości biznesowej, czyli ZZZ — wzajemnie zdefiniowanego dla tego scenariusza.

    • Definiuje umowę EDIFACT między partnerami handlowymi, którzy uczestniczą w przepływie pracy. Każda umowa wymaga partnera hosta i partnera-gościa. Zawartość komunikatów między Tobą a innym partnerem musi być zgodna z typem umowy. Aby uzyskać informacje o ustawieniach umowy do użycia podczas odbierania i wysyłania komunikatów, zobacz Ustawienia komunikatów EDIFACT.

      Ważne

      Łącznik EDIFACT obsługuje tylko znaki UTF-8. Jeśli dane wyjściowe zawierają nieoczekiwane znaki, sprawdź, czy komunikaty EDIFACT używają zestawu znaków UTF-8.

  • W zależności od tego, czy pracujesz nad przepływem pracy aplikacji logiki Zużycie, czy Standardowa, zasób aplikacji logiki może wymagać linku do konta integracji:

    Przepływ pracy aplikacji logiki Link jest wymagany?
    Zużycie Wymagane są Połączenie ion i link do konta integracji. Połączenie można utworzyć podczas dodawania operacji EDIFACT do przepływu pracy.
    Standardowa Połączenie do konta integracji wymagane, ale nie jest wymagane łącze. Połączenie można utworzyć podczas dodawania operacji EDIFACT do przepływu pracy.
  • Zasób aplikacji logiki i przepływ pracy, w którym chcesz używać operacji EDIFACT.

    Więcej informacji można znaleźć w następującej dokumentacji:

Kodowanie komunikatów EDIFACT

Akcja łącznika zarządzanego EDIFACT o nazwie Encode to EDIFACT message action (Akcja komunikatu EDIFACT) i wbudowana akcja łącznika EDIFACT o nazwie EDIFACT Encode wykonuje następujące zadania, z wyjątkiem przypadków, w których określono ograniczenia i znane problemy:

  • Rozwiąż umowę, pasując do kwalifikatora nadawcy i identyfikatora oraz kwalifikatora i identyfikatora odbiorcy.

  • Serializuj elektroniczną wymianę danych (EDI), która konwertuje komunikaty zakodowane w formacie XML na zestawy transakcji EDI w wymiany.

  • Zastosuj nagłówki zestawu transakcji i segmenty przyczepy.

  • Wygeneruj numer kontrolny wymiany, numer kontrolny grupy i numer kontrolny zestawu transakcji dla każdej wymiany wychodzącej.

  • Zastąp separatory w danych ładunku.

  • Zweryfikuj właściwości EDI i właściwości specyficzne dla partnera, takie jak schemat elementów danych zestawu transakcji względem schematu komunikatu, elementów danych zestawu transakcji i rozszerzonej weryfikacji elementów danych zestawu transakcji.

  • Wygeneruj dokument XML dla każdego zestawu transakcji.

  • Zażądaj potwierdzenia technicznego, potwierdzenia funkcjonalnego lub obu tych opcji, jeśli zostały skonfigurowane.

    • Jako potwierdzenie techniczne komunikat CONTRL wskazuje potwierdzenie wymiany.

    • Jako potwierdzenie funkcjonalne komunikat CONTRL wskazuje akceptację lub odrzucenie odebranej wymiany, grupy lub komunikatu, w tym listę błędów lub nieobsługiwanych funkcji.

  1. W witrynie Azure Portal otwórz zasób aplikacji logiki i przepływ pracy w projektancie.

  2. W projektancie wykonaj następujące ogólne kroki, aby dodać akcję EDIFACT o nazwie Encode do komunikatu EDIFACT według nazwy umowy do przepływu pracy.

    Uwaga

    Jeśli zamiast tego chcesz użyć kodu encode do AKCJI EDIFACT według tożsamości , musisz później podać różne wartości, takie jak identyfikator nadawcy i identyfikator odbiorcy określony przez umowę EDIFACT. Należy również określić komunikat XML do kodowania, który może być danymi wyjściowymi wyzwalacza lub poprzedniej akcji.

  3. Podaj następujące informacje o połączeniu dla konta integracji:

    Właściwości Wymagania opis
    Nazwa połączenia Tak Nazwa połączenia
    Konto integracji Tak Z listy dostępnych kont integracji wybierz konto do użycia.

    Na przykład:

    Screenshot shows Azure portal, Consumption workflow, and connection box for action named Encode to EDIFACT message by agreement name.

  4. Po zakończeniu wybierz Utwórz.

  5. W akcji EDIFACT podaj następujące wartości właściwości:

    Właściwości Wymagania opis
    Nazwa umowy EDIFACT Tak Umowa EDIFACT do wykorzystania.
    Komunikat XML do kodowania Tak Identyfikator biznesowy nadawcy komunikatu określony w umowie EDIFACT
    Inne parametry Nie. Ta operacja obejmuje następujące inne parametry:

    - Separator elementów danych
    - Wskaźnik wydania
    - Separator składników
    - Separator powtórzeń
    - Terminator segmentu
    - Sufiks terminatora segmentu
    - Wskaźnik dziesiętny

    Aby uzyskać więcej informacji, zobacz Ustawienia komunikatów EDIFACT.

    Na przykład ładunek komunikatu XML do kodowania może być danymi wyjściowymi treści z wyzwalacza Żądanie:

    Screenshot shows Consumption workflow, action named Encode to EDIFACT message by agreement name, and message encoding properties.

  6. Zapisz przepływ pracy.

Dekodowanie komunikatów EDIFACT

Akcja łącznika zarządzanego EDIFACT o nazwie Dekoduj akcję komunikatu EDIFACT i wbudowaną akcję łącznika EDIFACT o nazwie Dekodowanie EDIFACT wykonuje następujące zadania, z wyjątkiem przypadków, w których określono ograniczenia i znane problemy:

  • Zweryfikuj kopertę z umową partnera handlowego.

  • Rozwiąż umowę, pasując do kwalifikatora nadawcy i identyfikatora wraz z kwalifikatorem i identyfikatorem odbiorcy.

  • Podziel wymianę na wiele zestawów transakcji, gdy wymiana ma więcej niż jedną transakcję, na podstawie Ustawienia odbierania umowy.

  • Zdemontuj wymianę.

  • Zweryfikuj schemat elektronicznej wymiany danych (EDI) i właściwości specyficzne dla partnera, takie jak struktura koperty wymiany, schemat koperty względem schematu kontrolki, schemat elementów danych zestawu transakcji względem schematu komunikatów i rozszerzona walidacja elementów danych zestawu transakcji.

  • Sprawdź, czy numery kontrolne wymiany, grupy i zestawu transakcji nie są duplikatami (tylko łącznik zarządzany), jeśli są skonfigurowane, na przykład:

    • Sprawdź numer kontrolny wymiany względem wcześniej odebranych wymiany.

    • Sprawdź numer kontrolny grupy względem innych numerów kontrolnych grupy w wymienności.

    • Sprawdź numer kontrolny zestawu transakcji względem innych numerów kontrolnych zestawu transakcji w tej grupie.

  • Podziel wymianę na zestawy transakcji lub zachowaj całą wymianę (tylko łącznik zarządzany), na przykład:

    • Podziel wymianę jako zestawy transakcji — wstrzymywanie zestawów transakcji w przypadku błędu.

      Akcja dekodowania dzieli wymianę na zestawy transakcji i analizuje każdy zestaw transakcji. Akcja wyprowadza tylko te zestawy transakcji, które kończą się niepowodzeniem weryfikacji do badMessages, a pozostałe transakcje są ustawiane na goodMessageswartość .

    • Podziel wymianę jako zestawy transakcji — wstrzymuje wymianę po błędzie.

      Akcja dekodowania dzieli wymianę na zestawy transakcji i analizuje każdy zestaw transakcji. Jeśli co najmniej jeden zestaw transakcji w walidacji wymiany zakończy się niepowodzeniem, akcja zwraca wszystkie zestawy transakcji w tej wymiany do badMessages.

    • Zachowaj wymianę — wstrzymywanie zestawów transakcji w przypadku błędu.

      Akcja dekodowania zachowuje wymianę i przetwarza całą wsadowaną wymianę. Akcja wyprowadza tylko te zestawy transakcji, które kończą się niepowodzeniem weryfikacji do badMessages, a pozostałe transakcje są ustawiane na goodMessageswartość .

    • Zachowaj wymianę — wstrzymaj wymianę po błędzie.

      Akcja dekodowania zachowuje wymianę i przetwarza całą wsadowaną wymianę. Jeśli co najmniej jeden zestaw transakcji w walidacji wymiany zakończy się niepowodzeniem, akcja zwraca wszystkie zestawy transakcji w tej wymiany do badMessages.

  • W przypadku skonfigurowania generuj potwierdzenie techniczne, potwierdzenie funkcjonalne lub oba te elementy.

    • Potwierdzenie techniczne lub CONTRL ACK, które zgłasza wyniki z kontroli składniowej na pełnej otrzymanej wymiany.

    • Potwierdzenie funkcjonalne, które potwierdza akceptację lub odrzucenie odebranej wymiany lub grupy.

  1. W witrynie Azure Portal otwórz zasób aplikacji logiki i przepływ pracy w projektancie.

  2. W projektancie wykonaj następujące ogólne kroki, aby dodać akcję EDIFACT o nazwie Dekoduj komunikat EDIFACT do przepływu pracy.

  3. Podaj następujące informacje o połączeniu dla konta integracji:

    Właściwości Wymagania opis
    Nazwa połączenia Tak Nazwa połączenia
    Konto integracji Tak Z listy dostępnych kont integracji wybierz konto do użycia.

    Na przykład:

    Screenshot shows Consumption workflow designer and connection pane for the action named Decode EDIFACT message.

  4. Po zakończeniu wybierz Utwórz.

  5. W akcji EDIFACT podaj następujące wartości właściwości:

    Właściwości Wymagania opis
    Komunikat pliku prostego EDIFACT w celu dekodowania Tak Komunikat pliku prostego XML w celu dekodowania.
    Inne parametry Nie. Ta operacja obejmuje następujące inne parametry:

    - Separator składników
    - Separator elementów danych
    - Wskaźnik wydania
    - Separator powtórzeń
    - Terminator segmentu
    - Sufiks terminatora segmentu
    - Wskaźnik dziesiętny
    - Zestaw znaków ładunku
    - Sufiks terminatora segmentu
    - Zachowaj wymianę
    - Wstrzymywanie wymiany przy błędzie

    Aby uzyskać więcej informacji, zobacz Ustawienia komunikatów EDIFACT.

    Na przykład ładunek komunikatu XML do dekodowania może być danymi wyjściowymi treści z wyzwalacza Żądanie:

    Screenshot shows Consumption workflow, action named Decode EDIFACT message, and message decoding properties.

Obsługa segmentów UNH2.5 w dokumentach EDIFACT

W dokumencie EDIFACT segment UNH2.5 jest używany do wyszukiwania schematu. Na przykład w tym przykładowym komunikacie EDIFACT pole UNH to EAN008:

UNH+SSDD1+ORDERS:D:03B:UN:EAN008

Aby obsłużyć dokument EDIFACT lub przetworzyć komunikat EDIFACT z segmentem UN2.5, wykonaj następujące kroki:

  1. Zaktualizuj lub wdróż schemat o nazwie węzła głównego UNH2.5.

    Załóżmy na przykład, że nazwa główna schematu dla przykładowego pola UNH to EFACT_D03B_ORDERS_EAN008. Dla każdego D03B_ORDERS , który ma inny segment UNH2.5, należy wdrożyć pojedynczy schemat.

  2. W witrynie Azure Portal dodaj schemat do zasobu konta integracji lub zasobu aplikacji logiki na podstawie tego, czy masz odpowiednio przepływ pracy aplikacji logiki Zużycie, czy Standardowa.

  3. Niezależnie od tego, czy używasz akcji dekodowania EDIFACT, czy kodowania, przekaż schemat i skonfiguruj ustawienia schematu odpowiednio w sekcjach Odbierz Ustawienia lub Wyślij Ustawienia.

  4. Aby edytować umowę EDIFACT, w okienku Umowy wybierz umowę. Na pasku narzędzi okienka Umowy wybierz pozycję Edytuj jako plik JSON.

    • W sekcji umowy receiveAgreement znajdź sekcję schemaReferences i dodaj wartość UNH2.5.

      Screenshot showing the Azure portal with an EDIFACT agreement's

    • W sekcji umowy sendAgreementznajdź sekcję schemaReferences i dodaj wartość UNH2.5.

      Screenshot showing the Azure portal with an EDIFACT agreement's

Następne kroki