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 łącznika

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

Aplikacja logiki	Środowisko	Wersja łącznika
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
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.

• Akcja kodowania EDIFACT
• Akcja dekodowania EDIFACT

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 jest połączenie i połączenie z kontem integracji. Połączenie można utworzyć podczas dodawania operacji EDIFACT do przepływu pracy.
  Standardowa	Połączenie z kontem integracji jest wymagane, ale nie jest wymagane żadne łą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:

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

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.

Zużycie

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:

   

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:

   

6. Zapisz przepływ pracy.

Standardowa

Wbudowany łącznik EDIFACT (wersja zapoznawcza)

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 EDIFACT Encode do przepływu pracy.

3. W okienku akcji EDIFACT podaj wymagane wartości właściwości:

   Właściwości	Wymagania	opis
   Komunikat do kodowania	Tak	Zawartość komunikatu XML, którą chcesz zakodować. W szczególności identyfikator biznesowy nadawcy komunikatu określony w umowie EDIFACT.
   Parametry zaawansowane	Nie.	Z listy dodaj inne właściwości, których chcesz użyć. Ta operacja obejmuje następujące inne parametry: - Kwalifikator odbiorcy tożsamości nadawcy - Identyfikator odbiorcy tożsamości nadawcy - Kwalifikator odbiorcy tożsamości odbiorcy - Identyfikator odbiorcy tożsamości odbiorcy - Nazwa umowy EDIFACT

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

   

4. Zapisz przepływ pracy.

Łącznik zarządzany EDIFACT

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
   Identyfikator konta integracji	Tak	Identyfikator zasobu dla konta integracji, który ma następujący format: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Na przykład: . /subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Aby znaleźć ten identyfikator zasobu, wykonaj następujące kroki: 1. W witrynie Azure Portal otwórz konto integracji. 2. W menu konta integracji wybierz pozycję Przegląd. 3. Na stronie Przegląd wybierz pozycję Widok JSON. 4. Z właściwości Identyfikator zasobu skopiuj wartość.
   Adres URL sygnatury dostępu współdzielonego konta integracji	Tak	Adres URL punktu końcowego żądania używający uwierzytelniania sygnatury dostępu współdzielonego (SAS) w celu zapewnienia dostępu do konta integracji. Ten adres URL wywołania zwrotnego ma następujący format: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Na przykład: . https://prod-04.west-us.logic-azure.com:443/integrationAccounts/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=ZZZZZZZZZZZZZZZZZZZZZZZZZZZ Aby znaleźć ten adres URL, wykonaj następujące kroki: 1. W witrynie Azure Portal otwórz konto integracji. 2. W menu konta integracji w obszarze Ustawienia wybierz pozycję Adres URL wywołania zwrotnego. 3. Z właściwości Generated Callback URL (Wygenerowany adres URL wywołania zwrotnego) skopiuj wartość .
   Rozmiar bloku numeru kontrolnego	Nie.	Rozmiar bloku numerów kontrolnych do zarezerwowania z umowy dla scenariuszy o wysokiej przepływności

   Na przykład:

   

4. Po zakończeniu wybierz Utwórz.

5. W okienku 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:

   

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 ustawień 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.

Zużycie

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:

   

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:

   

Standardowa

Wbudowany łącznik EDIFACT (wersja zapoznawcza)

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 EDIFACT do przepływu pracy.

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

   Właściwości	Wymagania	opis
   Komunikat do 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:

   

4. Zapisz przepływ pracy.

Łącznik zarządzany EDIFACT

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:

   

4. Po zakończeniu wybierz Utwórz.

5. W okienku 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 dekodowania może być danymi wyjściowymi treści z wyzwalacza Żądanie:

   

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 dekodowania EDIFACT, czy kodowania, przekaż schemat i skonfiguruj ustawienia schematu odpowiednio w sekcjach Ustawienia odbierania lub Wysyłania ustawień umowy EDIFACT.

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.

     

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

     

Następne kroki

• Ustawienia komunikatów EDIFACT