Výměna zpráv X12 pomocí pracovních postupů v Azure Logic Apps

  • Článek

Platí pro: Azure Logic Apps (Consumption + Standard)

Pokud chcete odesílat a přijímat zprávy X12 v pracovních postupech, které vytvoříte pomocí Azure Logic Apps, použijte konektor X12 , který poskytuje operace, které podporují a spravují komunikaci X12.

Tento návod ukazuje, jak přidat akce kódování A dekódování X12 do existujícího pracovního postupu aplikace logiky. Konektor X12 neobsahuje žádné triggery, takže ke spuštění pracovního postupu můžete použít libovolný trigger. Příklady v této příručce používají trigger požadavku.

Připojení otechnické referenční informace

Konektor X12 má jednu verzi napříč pracovními postupy v Azure Logic Apps s více tenanty, Azure Logic Apps s jedním tenantem a prostředí integrační služby (ISE). Technické informace o konektoru X12 najdete v následující dokumentaci:

Požadavky

  • Účet a předplatné Azure. Pokud ještě nemáte předplatné Azure, zaregistrujte si bezplatný účet Azure.

  • Prostředek účtu integrace, kde definujete a ukládáte artefakty, jako jsou obchodní partneři, smlouvy, certifikáty atd., pro použití v podnikových integracích a pracovních postupech B2B. Tento prostředek musí splňovat následující požadavky:

    • Váš účet integrace i prostředek aplikace logiky musí existovat ve stejném předplatném Azure i v oblasti Azure.

    • Definuje alespoň dva obchodní partnery , kteří se účastní operace X12 použité ve vašem pracovním postupu. Definice obou partnerů musí používat stejný kvalifikátor obchodní identity X12.

    • Definuje smlouvu X12 mezi obchodními partnery, kteří se účastní vašeho pracovního postupu. Každá smlouva vyžaduje partnera hostitele a partnera typu host. Obsah zpráv mezi vámi a druhým partnerem musí odpovídat typu smlouvy. Informace o nastavení smlouvy, která se mají použít při přijímání a odesílání zpráv, najdete v tématu Nastavení zprávy X12.

      Důležité

      Pokud pracujete se schématy zákonu HIPAA (Health Insurance Portability and Accountability Act), musíte do své smlouvy přidat schemaReferences oddíl. Další informace najdete v tématu Schémata HIPAA a typy zpráv.

    • Definuje schémata, která se mají použít pro ověřování XML.

      Důležité

      Pokud pracujete se schématy HIPAA (Health Insurance Portability and Accountability Act), zkontrolujte schémata a typy zpráv HIPAA.

  • Na základě toho, jestli pracujete na pracovním postupu aplikace logiky Consumption nebo Standard, může prostředek aplikace logiky vyžadovat odkaz na váš účet integrace:

    Pracovní postup aplikace logiky Vyžaduje se propojení?
    Využití Připojení vyžaduje se propojení s účtem integrace. Připojení můžete vytvořit při přidání operace X12 do pracovního postupu.
    Standard Připojení požadování účtu integrace, ale nevyžaduje se propojení. Připojení můžete vytvořit při přidání operace X12 do pracovního postupu.

  • Prostředek aplikace logiky a pracovní postup, ve kterém chcete použít operace X12.

    Další informace najdete v následující dokumentaci:

Kódování zpráv X12

Operace kódování do zprávy X12 provádí následující úlohy:

  • Řeší smlouvu odpovídajícími vlastnostmi kontextu odesílatele a příjemce.
  • Serializuje EDI interchange a převede xml kódované zprávy na EDI transakce sady v rámci výměny.
  • Použije segmenty hlavičky a přívěsu sady transakcí.
  • Vygeneruje číslo ovládacího prvku výměny, číslo ovládacího prvku skupiny a číslo ovládacího prvku sady transakcí pro každou odchozí výměnu.
  • Nahradí oddělovače dat datové části.
  • Ověřuje vlastnosti specifické pro EDI a partnery.
    • Ověřování schématu datových prvků sady transakcí vůči schématu zpráv
    • Ověřování EDI u datových prvků sady transakcí
    • Rozšířené ověřování datových prvků sady transakcí.
  • Požádá o technické a funkční potvrzení, pokud je nakonfigurované.
    • Vygeneruje technické potvrzení v důsledku ověření hlavičky. Technické potvrzení hlásí stav zpracování zaměnitelné hlavičky a přívěsu příjemcem adresy.
    • Vygeneruje funkční potvrzení v důsledku ověření těla. Funkční potvrzení hlásí každou chybu, ke které došlo při zpracování přijatého dokumentu.

  1. Na webu Azure Portal otevřete prostředek aplikace logiky a pracovní postup v návrháři.

  2. V návrháři podle těchto obecných kroků přidejte do pracovního postupu akci X12 s názvem zakódovat do zprávy X12 podle názvu smlouvy.

    Poznámka:

    Pokud místo toho chcete pomocí akce Kódování na X12 použít akci Kódování na X12, budete později muset zadat jiné hodnoty, například identifikátor odesílatele a identifikátor příjemce určený vaší smlouvou X12. Musíte také zadat zprávu XML, která se má kódovat, což může být výstup z triggeru nebo předchozí akce.

  3. Po zobrazení výzvy zadejte pro svůj účet integrace následující informace o připojení:

    Vlastnost Požadováno Popis
    Název připojení Ano Název připojení
    Účet pro integraci Ano V seznamu dostupných účtů integrace vyberte účet, který chcete použít.

    Příklad:

    Screenshot showing Consumption workflow and connection information for action named Encode to X12 message by agreement name.

  4. Až budete hotovi, vyberte Vytvořit.

  5. Do pole s informacemi o akci X12 zadejte následující hodnoty vlastností:

    Vlastnost Požadováno Popis
    Název smlouvy X12 Ano Smlouva X12, která se má použít.
    Zpráva XML pro kódování Ano Zpráva XML pro kódování
    Další parametry No Tato operace zahrnuje následující další parametry:

    - Oddělovač datových prvků
    - Oddělovač součástí
    - Náhradní znak
    - Ukončení segmentu
    - Přípona ukončovací nástavce segmentu
    - Číslo verze ovládacího prvku
    - Identifikátor odesílatele aplikace / kód GS02
    - Identifikátor příjemce aplikace / kód GS03

    Další informace najdete v nastavení zprávy X12.

    Jako datovou část zprávy XML můžete například použít výstup základního obsahu z triggeru požadavku:

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

Dekódování zpráv X12

Operace dekódování zpráv X12 provádí následující úlohy:

  • Ověří obálku vůči smlouvě s obchodním partnerem.

  • Ověřuje vlastnosti specifické pro EDI a partnery.

    • Strukturální ověřování EDI a rozšířené ověřování schématu
    • Strukturální ověřování obálek pro výměnu
    • Ověření schématu obálky proti schématu ovládacího prvku
    • Ověření schématu datových prvků sady transakcí proti schématu zpráv
    • Ověřování EDI u datových prvků sady transakcí

  • Ověřuje, že řídicí čísla sady výměn, skupin a transakcí nejsou duplicitní.

    • Zkontroluje kontrolní číslo výměny oproti dříve přijatým výměnám.
    • Zkontroluje číslo ovládacího prvku skupiny proti jiným číselám ovládacích prvků skupiny ve výměně.
    • Zkontroluje kontrolní číslo sady transakcí proti jiným čísel ovládacím prvkům sady transakcí v dané skupině.

  • Rozdělí výměnu na sady transakcí nebo zachová celou výměnu:

    • Rozdělení výměny na sady transakcí nebo pozastavení sad transakcí při chybě: Parsovat každou sadu transakcí. Dekódování X12 akce výstup pouze transakční sady, které se nezdaří ověření badMessages, a výstup zbývající transakce nastaví na goodMessages.

    • Rozdělení výměny na sady transakcí nebo pozastavení výměny při chybě: Parsujte každou sadu transakcí. Pokud jedna nebo více transakčních sad v ověřování výměny selžou, dekódování X12 akce vypíše všechny sady transakcí v této výměně na badMessages.

    • Zachování výměny nebo pozastavení sad transakcí při chybě: Zachování výměny a zpracování celé dávkové výměny. Dekódování X12 akce výstup pouze transakční sady, které se nezdaří ověření badMessages, a výstup zbývající transakce nastaví na goodMessages.

    • Zachování výměny nebo pozastavení výměny při chybě: Zachování výměny a zpracování celé dávkové výměny. Pokud jedna nebo více transakčních sad v ověřování výměny selžou, dekódování X12 akce vypíše všechny sady transakcí v této výměně na badMessages.

  • Vygeneruje technické a funkční potvrzení, pokud je nakonfigurováno.

    • Vygeneruje technické potvrzení v důsledku ověření hlavičky. Technické potvrzení hlásí stav zpracování zaměnitelné hlavičky a přívěsu příjemcem adresy.
    • Vygeneruje funkční potvrzení v důsledku ověření těla. Funkční potvrzení hlásí každou chybu, ke které došlo při zpracování přijatého dokumentu.

  1. Na webu Azure Portal otevřete prostředek aplikace logiky a pracovní postup v návrháři.

  2. V návrháři přidejte do pracovního postupu akci X12 s názvem Dekódovat zprávu X12.

  3. Po zobrazení výzvy zadejte pro svůj účet integrace následující informace o připojení:

    Vlastnost Požadováno Popis
    Název připojení Ano Název připojení
    Účet pro integraci Ano V seznamu dostupných účtů integrace vyberte účet, který chcete použít.

    Příklad:

    Screenshot showing Consumption workflow and connection information for action named Decode X12 message.

  4. Až budete hotovi, vyberte Vytvořit.

  5. Do pole s informacemi o akci X12 zadejte následující hodnoty vlastností:

    Vlastnost Požadováno Popis
    Zpráva o plochém souboru X12 pro dekódování Ano Zpráva X12 ve formátu plochého souboru pro dekódování

    Poznámka: Datová část nebo obsah zprávy XML pro pole zpráv, dobrá nebo špatná, je kódována base64. Proto musíte použít výraz, který zpracovává tento obsah. Například následující výraz zpracuje obsah zprávy jako XML:

    xml(base64ToBinary(item()?['Body']))
    Další parametry No Tato operace zahrnuje následující další parametry:

    - Zachování výměny
    - Pozastavit výměnu při chybě

    Další informace najdete v nastavení zprávy X12.

    Jako datovou část zprávy XML můžete například použít výstup základního obsahu z triggeru Požadavku, ale musíte tento obsah nejprve předzpracovat pomocí výrazu:

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

Další kroky