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

  • Artykuł

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

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

W tym przewodniku z instrukcjami pokazano, jak dodać akcje kodowania i dekodowania X12 do istniejącego przepływu pracy aplikacji logiki. Łącznik X12 nie zawiera żadnych wyzwalaczy, więc możesz użyć dowolnego wyzwalacza, aby uruchomić przepływ pracy. Przykłady w tym przewodniku korzystają z wyzwalacza Żądania.

dokumentacja techniczna Połączenie or

Łącznik X12 ma jedną wersję między przepływami pracy w wielodostępnych usługach Azure Logic Apps, Azure Logic Apps z jedną dzierżawą i środowiskiem usługi integracji (ISE). Aby uzyskać informacje techniczne dotyczące łącznika X12 , zobacz następującą dokumentację:

Wymagania wstępne

  • Konto i subskrypcja platformy Azure. Jeśli nie masz jeszcze subskrypcji platformy Azure, 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 X12 używanej w przepływie pracy. Definicje dla obu partnerów muszą używać tego samego kwalifikatora tożsamości biznesowej X12.

    • Definiuje umowę X12 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, które mają być używane podczas odbierania i wysyłania komunikatów, zobacz Ustawienia komunikatów X12.

      Ważne

      Jeśli pracujesz ze schematami Health Insurance Portability and Accountability Act (HIPAA), musisz dodać sekcję schemaReferences do umowy. Aby uzyskać więcej informacji, zobacz schematy i typy komunikatów HIPAA.

    • Definiuje schematy do użycia na potrzeby walidacji XML.

      Ważne

      Jeśli pracujesz ze schematami ustawy HIPAA (Health Insurance Portability and Accountability Act), zapoznaj się ze schematami i typami komunikatów HIPAA.

  • 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 X12 do przepływu pracy.
    Standardowa Połączenie do konta integracji wymagane, ale nie jest wymagane łącze. Połączenie można utworzyć podczas dodawania operacji X12 do przepływu pracy.

  • Zasób aplikacji logiki i przepływ pracy, w którym chcesz używać operacji X12.

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

Kodowanie komunikatów X12

Operacja kodowania komunikatu X12 wykonuje następujące zadania:

  • Rozwiązuje umowę, pasując do właściwości kontekstu nadawcy i odbiorcy.
  • Serializuje wymianę EDI i konwertuje komunikaty zakodowane w formacie XML na zestawy transakcji EDI w wymiany.
  • Stosuje nagłówki zestawu transakcji i segmenty przyczepy.
  • Generuje numer kontrolny wymiany, numer kontrolny grupy i numer kontrolny zestawu transakcji dla każdej wymiany wychodzącej.
  • Zamienia separatory w danych ładunku.
  • Sprawdza poprawność właściwości EDI i właściwości specyficznych dla partnera.
    • Sprawdzanie poprawności schematu elementów danych zestawu transakcji względem schematu komunikatu.
    • Walidacja EDI elementów danych zestawu transakcji.
    • Rozszerzona walidacja elementów danych zestawu transakcji.
  • Żąda potwierdzenia technicznego i funkcjonalnego, jeśli jest skonfigurowane.
    • Generuje potwierdzenie techniczne w wyniku weryfikacji nagłówka. Potwierdzenie techniczne zgłasza stan przetwarzania nagłówka wymiany i przyczepy przez odbiornik adresu.
    • Generuje potwierdzenie funkcjonalne w wyniku weryfikacji treści. Potwierdzenie funkcjonalne zgłasza każdy błąd napotkany podczas przetwarzania odebranego dokumentu.

  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ę X12 o nazwie Encode do wiadomości X12 według nazwy umowy do przepływu pracy.

    Uwaga

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

  3. Po wyświetleniu monitu 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 showing Consumption workflow and connection information for action named Encode to X12 message by agreement name.

  4. Po zakończeniu wybierz Utwórz.

  5. W polu informacji o akcji X12 podaj następujące wartości właściwości:

    Właściwości Wymagania opis
    Nazwa umowy X12 Tak Umowa X12 do użycia.
    Komunikat XML do kodowania Tak Komunikat XML do kodowania
    Inne parametry Nie. Ta operacja obejmuje następujące inne parametry:

    - Separator elementów danych
    - Separator składników
    - Znak zastępczy
    - Terminator segmentu
    - Sufiks terminatora segmentu
    - Numer wersji kontroli
    - Identyfikator nadawcy aplikacji/kod GS02
    - Identyfikator odbiornika aplikacji/kod GS03

    Aby uzyskać więcej informacji, zapoznaj się z ustawieniami komunikatów X12.

    Możesz na przykład użyć danych wyjściowych treści z wyzwalacza Żądanie jako ładunku komunikatu XML:

    Screenshot showing Consumption workflow, action named Encode to X12 message by agreement name, and action properties.

Dekoduj komunikaty X12

Operacja dekodowania komunikatu X12 wykonuje następujące zadania:

  • Weryfikuje kopertę przed umową z partnerem handlowym.

  • Sprawdza poprawność właściwości EDI i właściwości specyficznych dla partnera.

    • Weryfikacja strukturalna EDI i rozszerzona weryfikacja schematu
    • Walidacja strukturalna koperty wymiany
    • Weryfikacja schematu koperty względem schematu kontrolki
    • Sprawdzanie poprawności schematu elementów danych zestawu transakcji względem schematu komunikatów
    • Walidacja EDI elementów danych zestawu transakcji

  • Sprawdza, czy numery kontrolne wymiany, grupy i zestawu transakcji nie są duplikatami.

    • Sprawdza numer kontrolny wymiany względem wcześniej odebranych wymiany.
    • Sprawdza numer kontrolny grupy względem innych numerów kontrolnych grupy w wymienności.
    • Sprawdza numer kontrolny zestawu transakcji względem innych numerów kontrolnych zestawu transakcji w tej grupie.

  • Dzieli wymianę na zestawy transakcji lub zachowuje całą wymianę:

    • Podziel wymianę na zestawy transakcji lub wstrzymaj zestawy transakcji w przypadku błędu: Przeanalizuj każdy zestaw transakcji. Akcja dekodowania X12 generuje tylko zestawy transakcji, które kończą się niepowodzeniem weryfikacji do badMessages, a pozostałe transakcje są ustawiane na goodMessages.

    • Podziel wymianę na zestawy transakcji lub wstrzymaj wymianę po błędzie: Przeanalizuj każdy zestaw transakcji. Jeśli co najmniej jeden zestaw transakcji w walidacji wymiany zakończy się niepowodzeniem, akcja dekodowania X12 zwraca wszystkie zestawy transakcji w tej wymiany na badMessages.

    • Zachowaj zestawy transakcji wymiany lub wstrzymywanie na błędzie: Zachowaj wymianę i przetwórz całą wsadowaną wymianę. Akcja dekodowania X12 generuje tylko zestawy transakcji, które kończą się niepowodzeniem weryfikacji do badMessages, a pozostałe transakcje są ustawiane na goodMessages.

    • Zachowaj wymianę lub wstrzymaj wymianę po błędzie: Zachowaj wymianę i przetwórz całą wsadowaną wymianę. Jeśli co najmniej jeden zestaw transakcji w walidacji wymiany zakończy się niepowodzeniem, akcja dekodowania X12 zwraca wszystkie zestawy transakcji w tej wymiany na badMessages.

  • Generuje potwierdzenie techniczne i funkcjonalne, jeśli zostało skonfigurowane.

    • Generuje potwierdzenie techniczne w wyniku weryfikacji nagłówka. Potwierdzenie techniczne zgłasza stan przetwarzania nagłówka wymiany i przyczepy przez odbiornik adresu.
    • Generuje potwierdzenie funkcjonalne w wyniku weryfikacji treści. Potwierdzenie funkcjonalne zgłasza każdy błąd napotkany podczas przetwarzania odebranego dokumentu.

  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ę X12 o nazwie Dekoduj komunikat X12 do przepływu pracy.

  3. Po wyświetleniu monitu 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 showing Consumption workflow and connection information for action named Decode X12 message.

  4. Po zakończeniu wybierz Utwórz.

  5. W polu informacji o akcji X12 podaj następujące wartości właściwości:

    Właściwości Wymagania opis
    Komunikat pliku prostego X12 w celu dekodowania Tak Komunikat X12 w formacie pliku prostego do dekodowania

    Uwaga: Ładunek lub zawartość komunikatu XML dla tablicy komunikatów, dobra lub zła, jest zakodowana w formacie base64. Dlatego należy użyć wyrażenia, które przetwarza tę zawartość. Na przykład następujące wyrażenie przetwarza zawartość komunikatu jako XML:

    xml(base64ToBinary(item()?['Body']))
    Inne parametry Nie. Ta operacja obejmuje następujące inne parametry:

    - Zachowaj wymianę
    - Wstrzymywanie wymiany w przypadku błędu

    Aby uzyskać więcej informacji, zapoznaj się z ustawieniami komunikatów X12.

    Na przykład możesz użyć danych wyjściowych treści z wyzwalacza Żądanie jako ładunku komunikatu XML, ale najpierw należy wstępnie przetworzyć tę zawartość przy użyciu wyrażenia:

    Screenshot showing Consumption workflow, action named Decode X12 message, and action properties.

Następne kroki