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.

Připojení otechnické referenční informace

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

Aplikace logiky	Prostředí	verze Připojení oru
Využití	Azure Logic Apps s více tenanty	Spravovaný konektor EDIFACT (třída Standard). Konektor EDIFACT poskytuje pouze akce, 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
Využití	Prostředí integrační služby (ISE)	Spravovaný konektor EDIFACT (třída Standard) a verze ISE EDIFACT , která má jiné limity zpráv než standardní třída. Konektor EDIFACT poskytuje pouze akce, 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 (Preview) 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ář. – 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 (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 aEDIFACT 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í	Připojení vyžaduje se propojení s účtem integrace. Připojení můžete vytvořit při přidání operace EDIFACT 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 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í.

Využití

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 EDIFACT s názvem Kódovat do zprávy EDIFACT podle názvu smlouvy.

   Poznámka:

   Pokud chcete místo toho použít funkci Encode to EDIFACT message by identityies action, budete muset později zadat různé hodnoty, jako je například identifikátor odesílatele a identifikátor příjemce určený vaší smlouvou 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	Obchodní identifikátor odesílatele zprávy určený vaší smlouvou EDIFACT
   Další parametry	No	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 EDIFACT nastavení zprávy.

   Datová část zprávy XML, 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 (Preview)

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 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 zprávy XML, který chcete kódovat. Konkrétně obchodní identifikátor odesílatele zprávy určený vaší smlouvou EDIFACT.
   Pokročilé parametry	No	Ze seznamu přidejte všechny další vlastnosti, které chcete použít. Tato operace zahrnuje následující další parametry: - Kvalifikátor příjemce identity odesílatele - Identifikátor příjemce identity odesílatele - Kvalifikátor příjemce identity příjemce příjemce - Identifikátor příjemce identity příjemce - Název smlouvy EDIFACT

   Datová část zprávy XML, která se má kó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. 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 EDIFACT s názvem Kódovat do zprávy EDIFACT podle názvu smlouvy.

   Poznámka:

   Pokud chcete místo toho použít funkci Encode to EDIFACT message by identityies action, budete muset později zadat různé hodnoty, jako je například identifikátor odesílatele a identifikátor příjemce určený vaší smlouvou 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 pro váš účet integrace, 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 ID prostředku zkopírujte hodnotu.
   Adresa URL SAS účtu integrace	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	No	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	Obchodní identifikátor odesílatele zprávy určený vaší smlouvou EDIFACT
   Další parametry	No	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 EDIFACT nastavení zprávy.

   Datová část zprávy XML, 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 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ě smlouvy Receive Nastavení.

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

Využití

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 EDIFACT s názvem 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
   EDIFACT flat file message to decode	Ano	Zpráva o plochém souboru XML pro dekódování.
   Další parametry	No	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 EDIFACT nastavení zprávy.

   Datová část zprávy XML, která dekóduje, může být například výstupem základního obsahu z triggeru požadavku:

   

Standard

Integrovaný konektor EDIFACT (Preview)

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 EDIFACT s názvem EDIFACT Dekódovat podle těchto obecných kroků.

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

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

   Datová část zprávy XML, která dekóduje, 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. 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 EDIFACT s názvem 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 XML pro kódování	Ano	Obchodní identifikátor odesílatele zprávy určený vaší smlouvou EDIFACT
   Další parametry	No	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 EDIFACT nastavení zprávy.

   Datová část zprávy XML, která dekóduje, 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 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 dekódovací nebo kódovací akci EDIFACT, nahrajte schéma a nastavte nastavení schématu v částech Příjem Nastavení vaší smlouvy EDIFACT nebo Odeslat Nastavení oddíly.

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