Udostępnij za pośrednictwem

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

Łącznik X12 ma jedną wersję między przepływami pracy w wielodostępnych usługach Azure Logic Apps i Azure Logic Apps z jedną dzierżawą. 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 jest połączenie i połączenie z kontem integracji. Połączenie można utworzyć podczas dodawania operacji X12 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 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:

    Zrzut ekranu przedstawiający przepływ pracy użycia i informacje o połączeniu dla akcji o nazwie Kodowanie do komunikatu X12 według nazwy umowy.

  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:

    Zrzut ekranu przedstawiający przepływ pracy Zużycie, akcję o nazwie Kodowanie do komunikatu X12 według nazwy umowy i właściwości akcji.

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:

    Zrzut ekranu przedstawiający przepływ pracy użycia i informacje o połączeniu dla akcji o nazwie Dekoduj komunikat X12.

  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:

    Zrzut ekranu przedstawiający przepływ pracy Zużycie, akcję o nazwie Dekoduj komunikat X12 i właściwości akcji.

Następne kroki