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 pomocí libovolného spouštěče. Příklady v této příručce používají spouštěč požadavku.

Technické reference ke konektoru

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

Aplikace logiky	Prostředí	Verze konektoru
Využití	Azure Logic Apps pro více tenantů	Spravovaný konektor EDIFACT (třída Standard). Konektor EDIFACT má pouze jeden trigger, ale můžete použít libovolný trigger, který funguje pro váš scénář. Další informace najdete v následující dokumentaci: - Referenční informace ke spravovanému konektoru EDIFACT - Omezení zpráv EDIFACT
Standard	Azure Logic Apps a App Service Environment v3 s jedním tenantem (pouze plány Windows)	Integrovaný konektor EDIFACT a spravovaný konektor EDIFACT Integrovaná verze se liší následujícími způsoby: – Integrovaná verze poskytuje pouze akce, ale můžete použít libovolný trigger, který funguje pro váš scénář. - Přijímá plochý soubor jako vstup a XML pro spravovanou verzi. – Integrovaná verze má přímý přístup k virtuálním sítím Azure. Nepotřebujete místní bránu dat. Další informace najdete v následující dokumentaci: - Referenční informace ke spravovanému konektoru EDIFACT - Integrované operace konektoru EDIFACT - Omezení zpráv EDIFACT

Integrované operace EDIFACT (pouze pracovní postupy standardu)

Integrovaný konektor EDIFACT 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

  • Akce tohoto konektoru momentálně podporují payloady až do 100 MB.

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

    • Zkontrolujte duplicitní kontrolní čísla výměn, skupin a transakčních sad, pokud jsou nastavená.

    • Zachovejte celou výměnu.

    V opačném případě mají akce kódování EDIFACT a dekódování EDIFACT integrovaného konektoru podobné funkce jako akce 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 hostitelského partnera a hostujícího partnera. 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, zda pracujete na pracovním postupu typu Consumption nebo Standard v rámci logické aplikace, může váš zdroj logické aplikace vyžadovat odkaz na váš účet integrace.

  Pracovní postup aplikace logiky	Vyžaduje se propojení?
  Spotřeba	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řte ukázkový pracovní postup aplikace logiky Consumption ve víceklientském prostředí Azure Logic Apps

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

• Obsah pro kódování nebo dekódování. Akce spravovaného konektoru EDIFACT v pracovních postupech Consumption přijímají jako vstup zprávu XML. Ve standardních pracovních postupech akce integrovaného konektoru EDIFACT přijímají plochý soubor, zatímco spravovaný konektor EDIFACT přijímá zprávu XML.

Kódování zpráv EDIFACT

Akce spravovaného konektoru EDIFACT s názvem Dekódovat do zprávy EDIFACT a akce vestavěného konektoru EDIFACT s názvem EDIFACT Encode provádějí následující úkoly, s výjimkou případů popsaných v omezeních a známých problémech:

• Vyřešte dohodu porovnáním kvalifikátoru a identifikátoru odesílatele s kvalifikátorem a identifikátorem příjemce.

• Serializujte elektronickou výměnu dat (EDI), která převádí XML kódované zprávy na EDI transakční 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 uživatelských datech.

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

Využití

1. V portálu Azure otevřete prostředek logické aplikace a pracovní postup v návrhovém prostředí.

2. V návrháři postupujte podle těchto obecných kroků k přidání akce EDIFACT s názvem Kódovat do zprávy EDIFACT podle názvu smlouvy do vašeho pracovního postupu.

   Poznámka:

   Pokud chcete místo toho použít akci Zakódovat zprávu do formátu EDIFACT podle identit, budete muset později zadat různé hodnoty, jako je identifikátor odesílatele a identifikátor příjemce určený vaší dohodou EDIFACT. 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. Zadejte následující informace o připojení pro váš účet integrace:

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

   Příklad:

   

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

5. V akci EDIFACT zadejte následující hodnoty vlastností:

   Vlastnost	Požadováno	Popis
   Název smlouvy EDIFACT	Ano	Smlouva EDIFACT, která se má použít.
   Zpráva XML pro kódování	Ano	Zpráva XML, která se má kódovat. Konkrétně obchodní identifikátor odesílatele zprávy určený vaší smlouvou EDIFACT.
   Další parametry	Ne	Tato operace zahrnuje následující další parametry: - Oddělovač datových prvků - Indikátor vydání - Oddělovač součástí - Oddělovač opakování - Ukončení segmentu - Přípona ukončovací nástavce segmentu - Desetinná čárka Další informace naleznete v tématu Nastavení zprávy EDIFACT.

   Datová část, která se má kódovat, může být například výstupem základního obsahu z triggeru požadavku :

   

6. Uložte pracovní postup.

Standard

Integrovaný konektor EDIFACT

1. V portálu Azure otevřete prostředek logické aplikace a pracovní postup v návrhovém prostředí.

2. V návrháři podle těchto obecných kroků přidejte do pracovního postupu akci EDIFACT s názvem EDIFACT Encode.

3. V podokně akcí EDIFACT zadejte požadované hodnoty vlastností:

   Vlastnost	Požadováno	Popis
   Zpráva ke kódování	Ano	Obsah plochého souboru, který se má zakódovat. Konkrétně obchodní identifikátor odesílatele zprávy určený vaší smlouvou EDIFACT.
   Pokročilé parametry	Ne	Ze seznamu přidejte všechny další vlastnosti, které chcete použít. Tato operace zahrnuje následující další parametry: - Kvalifikátor identity odesílatele pro příjemce - Identita odesílatele Identifikátor příjemce - Identita příjemce Kvalifikátor příjemce - Identita Příjemce Identifikátor Příjemce - Název smlouvy EDIFACT

   Datová část plochého souboru, která se má zakódovat, může být například výstupem základního obsahu z triggeru požadavku :

   

4. Uložte pracovní postup.

Spravovaný konektor EDIFACT

1. V portálu Azure otevřete prostředek logické aplikace a pracovní postup v návrhovém prostředí.

2. V návrháři postupujte podle těchto obecných kroků k přidání akce EDIFACT s názvem Kódovat do zprávy EDIFACT podle názvu smlouvy do vašeho pracovního postupu.

   Poznámka:

   Pokud chcete místo toho použít akci Zakódovat zprávu do formátu EDIFACT podle identit, budete muset později zadat různé hodnoty, jako je identifikátor odesílatele a identifikátor příjemce určený vaší dohodou EDIFACT. 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. Zadejte následující informace o připojení pro váš účet integrace:

   Vlastnost	Požadováno	Popis
   Název připojení	Ano	Název připojení
   ID účtu integrace	Ano	ID prostředku vašeho integračního účtu, který má následující formát: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Příklad: /subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Pokud chcete najít toto ID prostředku, postupujte takto: 1. Na webu Azure Portal otevřete svůj účet integrace. 2. V nabídce účtu integrace vyberte Přehled. 3. Na stránce Přehled vyberte zobrazení JSON. 4. Z vlastnosti identifikátor prostředku zkopírujte hodnotu.
   Adresa URL SAS integračního účtu	Ano	Adresa URL koncového bodu požadavku, která používá ověřování sdíleného přístupového podpisu (SAS) k poskytnutí přístupu k vašemu účtu integrace. Tato adresa URL zpětného volání má následující formát: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Příklad: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=ZZZZZZZZZZZZZZZZZZZZZZZZZZZ Chcete-li najít tuto adresu URL, postupujte takto: 1. Na webu Azure Portal otevřete svůj účet integrace. 2. V nabídce účtu integrace v části Nastavení vyberte adresu URL zpětného volání. 3. Z vygenerované vlastnosti URL zpětného volání zkopírujte hodnotu.
   Velikost bloku řídicího čísla	Ne	Velikost bloku kontrolních čísel, která se mají rezervovat ze smlouvy pro scénáře s vysokou propustností

   Příklad:

   

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

5. V podokně akcí EDIFACT zadejte následující hodnoty vlastností:

   Vlastnost	Požadováno	Popis
   Název smlouvy EDIFACT	Ano	Smlouva EDIFACT, která se má použít.
   Zpráva XML pro kódování	Ano	Zpráva XML, která se má kódovat. Konkrétně obchodní identifikátor odesílatele zprávy určený vaší smlouvou EDIFACT.
   Další parametry	Ne	Tato operace zahrnuje následující další parametry: - Oddělovač datových prvků - Indikátor vydání - Oddělovač součástí - Oddělovač opakování - Ukončení segmentu - Přípona ukončovací nástavce segmentu - Desetinná čárka Další informace naleznete v tématu Nastavení zprávy EDIFACT.

   Datová část, která se má kódovat, může být například výstupem základního obsahu z triggeru požadavku :

   

6. Uložte pracovní postup.

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 ve vztahu ke smlouvě obchodního partnera.

• Upravte smlouvu porovnáním kvalifikátoru a identifikátoru odesílatele 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 křižovatku.

• 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 pro výměny, skupiny a sady transakcí nejsou duplicitní (pokud je nakonfigurováno pro spravovaný konektor), například:

  • Zkontrolujte identifikační číslo výměny ve srovnání s dříve obdrženými výměnami.

  • Zkontrolujte kontrolní číslo skupiny proti jiným kontrolním číslům skupiny v rámci výměny.

  • Zkontrolujte číslo řízení sady transakcí s ostatními čísly řízení sad transakcí v dané skupině.

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

  • Rozdělit výměnu na transakční sady - pozastavit transakční sady při chybě.

    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 do badMessages, a zbývající sady transakcí vypíše do goodMessages.

  • Rozdělit výměnu jako sady transakcí - pozastavit výměnu při chybě.

    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 seskupenou výměnu. Akce vypíše pouze ty sady transakcí, které se nepodaří ověřit do badMessages, a zbývající sady transakcí vypíše do 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 seskupenou 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í, známé jako ACK CONTRL, které hlásí výsledky ze syntaktické kontroly kompletního přijímaného přenosu.

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

Využití

1. V portálu Azure otevřete prostředek logické aplikace a pracovní postup v návrhovém prostředí.

2. V návrháři postupujte podle těchto obecných kroků, abyste přidali do svého pracovního postupu akci Dekódovat zprávu EDIFACT.

3. Zadejte následující informace o připojení pro váš účet integrace:

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

   Příklad:

   

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

5. V akci EDIFACT zadejte následující hodnoty vlastností:

   Vlastnost	Požadováno	Popis
   Zpráva EDIFACT flat file k dekódování	Ano	Zpráva plochého souboru XML k dekódování.
   Další parametry	Ne	Tato operace zahrnuje následující další parametry: - Oddělovač součástí - Oddělovač datových prvků - Indikátor vydání - Oddělovač opakování - Ukončení segmentu - Přípona ukončovací nástavce segmentu - Desetinná čárka - Znaková sada datové části - Přípona ukončovací nástavce segmentu - Zachování výměny - Pozastavit výměnu při chybě Další informace naleznete v tématu Nastavení zprávy EDIFACT.

   Datová část pro dekódování může být například výstupem základního obsahu z triggeru Požadavku :

   

Standard

Integrovaný konektor EDIFACT

1. V portálu Azure otevřete prostředek logické aplikace a pracovní postup v návrhovém prostředí.

2. V návrháři podle těchto obecných kroků přidejte do pracovního postupu akciEDIFACT s názvem EDIFACT Dekódovat.

3. V akci EDIFACT zadejte následující hodnoty vlastností:

   Vlastnost	Požadováno	Popis
   Zpráva k dekódování	Ano	Plochý soubor k dekódování.
   Další parametry	Ne	Tato operace zahrnuje následující další parametry: - Oddělovač součástí - Oddělovač datových prvků - Indikátor uvolnění - Oddělovač opakování - Oddělovač segmentů - Přípona ukončujícího segmentu - Desetinný ukazatel - Znaková sada datové části - Přípona ukončujícího segmentu - Zachování výměny - Pozastavit výměnu při chybě Další informace naleznete v tématu Nastavení zprávy EDIFACT.

   Datová část pro dekódování může být například výstupem základního obsahu z triggeru Požadavku :

   

4. Uložte pracovní postup.

Spravovaný konektor EDIFACT

1. V portálu Azure otevřete prostředek logické aplikace a pracovní postup v návrhovém prostředí.

2. V návrháři postupujte podle těchto obecných kroků, abyste přidali do svého pracovního postupu akci Dekódovat zprávu EDIFACT.

3. Zadejte následující informace o připojení pro váš účet integrace:

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

   Příklad:

   

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

5. V podokně akcí EDIFACT zadejte následující hodnoty vlastností:

   Vlastnost	Požadováno	Popis
   Název smlouvy EDIFACT	Ano	Smlouva EDIFACT, která se má použít.
   Zpráva EDIFACT flat file k dekódování	Ano	Zpráva plochého souboru XML k dekódování.
   Další parametry	Ne	Tato operace zahrnuje následující další parametry: - Oddělovač součástí - Oddělovač datových prvků - Indikátor vydání - Oddělovač opakování - Ukončení segmentu - Přípona ukončovací nástavce segmentu - Desetinná čárka - Znaková sada datové části - Přípona ukončovací nástavce segmentu - Zachování výměny - Pozastavit výměnu při chybě Další informace naleznete v tématu Nastavení zprávy EDIFACT.

   Datová část pro dekódování může být například výstupem základního obsahu z triggeru Požadavku :

   

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 zprávě EDIFACT je pole UNH EAN008:

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éma.

2. V portálu Azure přidejte schéma do prostředku účtu integrace nebo prostředku logické aplikace v závislosti na tom, zda máte pracovní postup logické aplikace ve verzi Consumption nebo Standard.

3. Bez ohledu na to, zda používáte akci dekódování nebo kódování EDIFACT, nahrajte schéma a nastavte nastavení schématu ve vašem Nastavení příjmu nebo Nastavení odesílání smlouvy EDIFACT.

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 část schemaReferences a přidejte hodnotu UNH2.5.

     

   • V části smlouvy sendAgreement vyhledejte oddíl schemaReferences a přidejte hodnotu UNH2.5.

     

Další kroky

• Nastavení zpráv EDIFACT