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

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

Tento průvodce ukazuje, jak přidat akce kódování a dekódování EDIFACT do existujícího pracovního postupu aplikace logiky. Pokud není k dispozici žádná aktivační událost EDIFACT , můžete spustit pracovní postup libovolným triggerem. Příklady v této příručce používají trigger požadavku.

Technické reference ke konektoru

Konektor EDIFACT má různé verze založené na typu aplikace logiky a hostitelském prostředí.

Integrované operace EDIFACT (jenom pracovní postupy standardu – Preview)

Integrovaný konektor EDIFACT ve verzi Preview má následující akce, které se podobají jejich protějšku akcím spravovaného konektoru EDIFACT, s výjimkou případů uvedených v omezeních a známých problémech.

• Akce kódování EDIFACT
• Akce dekódování EDIFACT

Omezení a známé problémy

• Integrovaný konektor EDIFACT ve verzi Preview

  • Tato funkce je ve verzi Preview a podléhá dodatečným podmínkám použití pro microsoft Azure Preview.

  • Akce tohoto konektoru aktuálně podporují datové části až do 100 MB.

  • Akce dekódování EDIFACT ve verzi Preview v současné době neobsahuje následující možnosti:

    • Zkontrolujte duplicitní čísla pro výměnu, skupinu a sadu transakcí, pokud jsou nakonfigurovaná.

    • Zachovejte celou výměnu.

    Jinak akce integrovaného konektoru ve verzi Preview EDIFACT a EDIFACT dekódují , mají funkce podobné akcím spravovaného konektoru EDIFACT .

  • Akce tohoto konektoru v současné době nepodporují výměny s více transakcemi nebo dávkovými zprávami.

  • Akce tohoto konektoru momentálně nevygenerují sledování specifické pro EDI.

Požadavky

• Účet a předplatné Azure. Pokud ještě nemáte předplatné, 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 EDIFACT použité ve vašem pracovním postupu. Definice obou partnerů musí používat stejný kvalifikátor obchodní identity , což je ZZZ – Vzájemně definované pro tento scénář.

  • Definuje smlouvu EDIFACT 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, naleznete v tématu Nastavení zprávy EDIFACT.

    Důležité

    Konektor EDIFACT podporuje pouze znaky UTF-8. Pokud výstup obsahuje neočekávané znaky, zkontrolujte, jestli zprávy EDIFACT používají znakovou sadu UTF-8.

• 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í	Vyžaduje se připojení a propojení s účtem integrace. Připojení můžete vytvořit při přidání operace EDIFACT do pracovního postupu.
  Standard	Vyžaduje se připojení k účtu integrace, ale nevyžaduje se propojení. Připojení můžete vytvořit při přidání operace EDIFACT do pracovního postupu.

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

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

  • Vytvoření ukázkového pracovního postupu aplikace logiky Consumption ve víceklientských azure Logic Apps

  • Vytvoření ukázkového pracovního postupu standardní aplikace logiky v Azure Logic Apps s jedním tenantem

Kódování zpráv EDIFACT

Akce spravovaného konektoru EDIFACT s názvem Kódovat do EDIFACT akce zprávy a akce integrovaného konektoru EDIFACT s názvem EDIFACT Encode provádí následující úlohy, s výjimkou případů, kdy je uvedeno v omezeních a známých problémech:

• Vyřešte smlouvu shodou s kvalifikátorem a identifikátorem příjemce a kvalifikátorem a identifikátorem odesílatele.

• Serializace elektronické výměny dat (EDI), která převádí xml kódované zprávy na EDI transakce sady v rámci výměny.

• Použít segmenty hlavičky a přívěsu sady transakcí.

• Vygenerujte čí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.

• Nahraďte oddělovače v datech datové části.

• Ověřte vlastnosti specifické pro EDI a partnery, jako je schéma datových prvků sady transakcí pro schéma zpráv, datové prvky sady transakcí a rozšířené ověřování datových prvků sady transakcí.

• Vygenerujte dokument XML pro každou sadu transakcí.

• V případě konfigurace požádejte o technické potvrzení, funkční potvrzení nebo obojí.

  • Jako technické potvrzení označuje zpráva CONTRL potvrzení o výměně.

  • Jako potvrzení funkčnosti označuje zpráva CONTRL přijetí nebo odmítnutí přijaté výměny, skupiny nebo zprávy, včetně seznamu chyb nebo nepodporovaných funkcí.

Dekódování zpráv EDIFACT

Akce spravovaného konektoru EDIFACT s názvem Dekódování zprávy EDIFACT a akce integrovaného konektoru EDIFACT s názvem EDIFACT provádí následující úlohy, s výjimkou případů, kdy jsou zaznamenány v omezeních a známých problémech:

• Ověřte obálku proti smlouvě obchodního partnera.

• Vyřešte smlouvu tak, že se shoduje s kvalifikátorem a identifikátorem odesílatele spolu s kvalifikátorem a identifikátorem příjemce.

• Rozdělení výměny na více sad transakcí, pokud má výměna více než jednu transakci na základě nastavení příjmu smlouvy.

• Rozeberte výměnu.

• Ověřte elektronické výměny dat (EDI) a vlastnosti specifické pro partnery, jako je struktura obálky výměny, schéma obálky proti schématu řízení, schéma datových prvků sady transakcí proti schématu zpráv a rozšířené ověřování datových prvků sady transakcí.

• Ověřte, že řídicí čísla sady výměn, skupin a transakcí nejsou duplicitní (pouze spravovaný konektor), pokud je nakonfigurovaná, například:

  • Zkontrolujte číslo ovládacího prvku výměny oproti dříve přijatým výměnám.

  • Zkontrolujte číslo ovládacího prvku skupiny proti jiným číselám ovládacích prvků skupiny ve výměně.

  • Zkontrolujte řídicí číslo sady transakcí u jiných čísel ovládacích prvků sady transakcí v dané skupině.

• Rozdělte výměnu na sady transakcí nebo zachovejte celou výměnu (pouze spravovaný konektor), například:

  • Split Interchange as transaction sets - suspend transaction sets on error.

    Dekódovací akce rozdělí výměnu na sady transakcí a parsuje každou sadu transakcí. Akce vypíše pouze ty sady transakcí, které se nepodaří ověřit badMessages, a výstup zbývající transakce se nastaví na goodMessages.

  • Split Interchange as transaction sets - suspend interchange on error.

    Dekódovací akce rozdělí výměnu na sady transakcí a parsuje každou sadu transakcí. Pokud jedna nebo více sad transakcí v ověření výměny selže, akce vypíše všechny sady transakcí v této výměně do badMessages.

  • Zachování výměny – pozastavení sad transakcí při chybě.

    Dekódovací akce zachovává výměnu a zpracovává celou dávkovou výměnu. Akce vypíše pouze ty sady transakcí, které se nepodaří ověřit badMessages, a výstup zbývající transakce se nastaví na goodMessages.

  • Zachování výměny – pozastavení výměny při chybě

    Dekódovací akce zachovává výměnu a zpracovává celou dávkovou výměnu. Pokud jedna nebo více sad transakcí v ověření výměny selže, akce vypíše všechny sady transakcí v této výměně do badMessages.

• Pokud je nakonfigurované, vygenerujte technické potvrzení, funkční potvrzení nebo obojí.

  • Technické potvrzení nebo ACK CONTRL, které hlásí výsledky syntaktické kontroly na úplné přijaté výměně.

  • Funkční potvrzení, které potvrzuje přijetí nebo odmítnutí přijaté výměny nebo skupiny.

Zpracování segmentů UNH2.5 v dokumentech EDIFACT

V dokumentu EDIFACT se segment UNH2.5 používá pro vyhledávání schématu. Například v této ukázkové zprávě EDIFACT je EAN008pole UNH:

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

Pokud chcete zpracovat dokument EDIFACT nebo zpracovat zprávu EDIFACT, která má segment UN2.5, postupujte takto:

1. Aktualizujte nebo nasaďte schéma, které má název kořenového uzlu UNH2.5.

   Předpokládejme například, že kořenový název schématu pro ukázkové pole UNH je EFACT_D03B_ORDERS_EAN008. Pro každý D03B_ORDERS , který má jiný segment UNH2.5, musíte nasadit jednotlivá schémata.

2. Na webu Azure Portal přidejte schéma do prostředku účtu integrace nebo prostředku aplikace logiky podle toho, jestli máte pracovní postup aplikace logiky Consumption nebo Standard.

3. Bez ohledu na to, jestli používáte akci dekódování nebo kódování EDIFACT, nahrajte schéma a nastavte nastavení schématu v částech Nastavení příjmu smlouvy EDIFACT nebo Odeslat nastavení.

4. Pokud chcete upravit smlouvu EDIFACT, vyberte v podokně Smlouvy svoji smlouvu. Na panelu nástrojů podokna Smlouvy vyberte Upravit jako JSON.

   • V části smlouvy receiveAgreement najděte schemaReferences oddíl a přidejte hodnotu UNH2.5.

     

   • V části smlouvy sendAgreementnajděte schemaReferences oddíl a přidejte hodnotu UNH2.5.

     

Další kroky

• Nastavení zpráv EDIFACT