Exchange EDIFACT-meddelanden med hjälp av arbetsflöden i Azure Logic Apps

Om du vill skicka och ta emot EDIFACT-meddelanden i arbetsflöden som du skapar med Hjälp av Azure Logic Apps använder du EDIFACT-anslutningsappen, som tillhandahåller åtgärder som stöder och hanterar EDIFACT-kommunikation.

Den här guiden visar hur du lägger till EDIFACT-kodnings- och avkodningsåtgärder i ett befintligt logikapparbetsflöde. När ingen EDIFACT-utlösare är tillgänglig kan du valfri utlösare starta arbetsflödet. Exemplen i den här guiden använder utlösaren Förfrågning.

Teknisk referens för anslutningsprogram

EDIFACT-anslutningsappen har olika versioner, baserat på logikapptyp och värdmiljö.

Inbyggda EDIFACT-åtgärder (endast standardarbetsflöden – förhandsversion)

Den inbyggda förhandsversionen av EDIFACT-anslutningsappen har följande åtgärder, som liknar deras motsvarande EDIFACT-hanterade anslutningsåtgärder, förutom där det anges i Begränsningar och kända problem.

• EDIFACT-kodningsåtgärd
• EDIFACT-avkodningsåtgärd

Begränsningar och kända problem

• Förhandsversion av inbyggd EDIFACT-anslutning

  • Den här funktionen är i förhandsversion och omfattas av kompletterande användningsvillkor för Förhandsversioner av Microsoft Azure.

  • Den här anslutningsappens åtgärder stöder för närvarande nyttolaster på upp till minst 100 MB.

  • Förhandsgranskningen av EDIFACT-avkodningsåtgärden innehåller för närvarande inte följande funktioner:

    • Sök efter dubbletter av kontrollnummer för utbyte, grupp och transaktionsuppsättning, om det är konfigurerat.

    • Bevara hela utbytet.

    I annat fall har förhandsversionen av EDIFACT-kodning och EDIFACT-avkodning av inbyggda anslutningsappar funktioner som liknar motsvarande åtgärder för EDIFACT-hanterade anslutningsappar.

  • Den här anslutningsappens åtgärder stöder för närvarande inte utbyten med flera transaktioner eller batchmeddelanden.

  • Den här anslutningsappens åtgärder genererar för närvarande inte EDI-specifik spårning.

Förutsättningar

• Ett Azure-konto och prenumeration. Om du inte har någon prenumeration än registrerar du dig för ett kostnadsfritt Azure-konto.

• En integrationskontoresurs där du definierar och lagrar artefakter, till exempel handelspartner, avtal, certifikat och så vidare, för användning i dina företagsintegrerings- och B2B-arbetsflöden. Den här resursen måste uppfylla följande krav:

  • Både integrationskontot och logikappresursen måste finnas i samma Azure-prenumeration och Azure-region.

  • Definierar minst två handelspartner som deltar i EDIFACT-åtgärden som används i arbetsflödet. Definitionerna för båda partnerna måste använda samma företagsidentitetskvalificerare , som är ZZZ – Ömsesidigt definierad för det här scenariot.

  • Definierar ett EDIFACT-avtal mellan de handelspartner som deltar i ditt arbetsflöde. Varje avtal kräver en värdpartner och en gästpartner. Innehållet i meddelandena mellan dig och den andra partnern måste matcha avtalstypen. Information om avtalsinställningar som ska användas när du tar emot och skickar meddelanden finns i EDIFACT-meddelandeinställningar.

    Viktigt!

    EDIFACT-anslutningsappen stöder endast UTF-8-tecken. Om dina utdata innehåller oväntade tecken kontrollerar du att dina EDIFACT-meddelanden använder UTF-8-teckenuppsättningen.

• Beroende på om du arbetar med ett arbetsflöde för förbrukning eller standardlogikapp kan logikappresursen kräva en länk till ditt integrationskonto:

  Arbetsflöde för logikapp	Krävs länk?
  Förbrukning	Anslutning och länk till integrationskonto krävs. Du kan skapa anslutningen när du lägger till EDIFACT-åtgärden i arbetsflödet.
  Standard	Anslutning till integrationskonto krävs, men ingen länk krävs. Du kan skapa anslutningen när du lägger till EDIFACT-åtgärden i arbetsflödet.

• Logikappens resurs och arbetsflöde där du vill använda EDIFACT-åtgärderna.

  Mer information finns i följande dokumentation:

  • Skapa ett exempel på arbetsflöde för förbrukningslogikapp i Azure Logic Apps med flera klientorganisationer

  • Skapa ett exempel på ett standardarbetsflöde för logikappar i Azure Logic Apps med en enda klientorganisation

Koda EDIFACT-meddelanden

Åtgärden EDIFACT-hanterad anslutningsapp med namnet Koda till EDIFACT-meddelandeåtgärden och den inbyggda EDIFACT-anslutningsåtgärden med namnet EDIFACT Encode utför följande uppgifter, förutom där det anges i Begränsningar och kända problem:

• Lös avtalet genom att matcha avsändarens kvalificerare och identifierare och mottagarkvalificerare och identifierare.

• Serialisera EDI (Electronic Data Interchange), som konverterar XML-kodade meddelanden till EDI-transaktionsuppsättningar i utbytet.

• Använd rubrik- och trailersegment för transaktionsuppsättningar.

• Generera ett utbyteskontrollnummer, ett gruppkontrollnummer och ett transaktionsuppsättningskontrollnummer för varje utgående utbyte.

• Ersätt avgränsare i nyttolastdata.

• Verifiera EDI- och partnerspecifika egenskaper, till exempel schemat för transaktionsuppsättningsdataelement mot meddelandeschemat, transaktionsuppsättningsdataelement och utökad validering av transaktionsuppsättningsdataelement.

• Generera ett XML-dokument för varje transaktionsuppsättning.

• Begär en teknisk bekräftelse, funktionell bekräftelse eller båda, om det är konfigurerat.

  • Som en teknisk bekräftelse anger CONTRL-meddelandet kvittot för ett utbyte.

  • Som en funktionell bekräftelse anger CONTRL-meddelandet godkännande eller avvisande för det mottagna utbytet, gruppen eller meddelandet, inklusive en lista över fel eller funktioner som inte stöds.

Avkoda EDIFACT-meddelanden

Åtgärden för EDIFACT-hanterad anslutningsapp med namnet Avkoda EDIFACT-meddelandeåtgärden och den inbyggda EDIFACT-anslutningsåtgärden med namnet EDIFACT-avkodning utför följande uppgifter, förutom där det anges i Begränsningar och kända problem:

• Verifiera kuvertet mot handelspartneravtalet.

• Lös avtalet genom att matcha avsändarens kvalificerare och identifierare tillsammans med mottagarkvalificeraren och identifieraren.

• Dela upp ett utbyte i flera transaktionsuppsättningar när utbytet har mer än en transaktion, baserat på avtalets mottagningsinställningar.

• Demontera utbytet.

• Verifiera EDI(Electronic Data Interchange) och partnerspecifika egenskaper, till exempel kuvertstrukturen för utbyte, kuvertschemat mot kontrollschemat, schemat för transaktionsuppsättningsdataelementen mot meddelandeschemat och utökad validering av transaktionsuppsättningsdataelement.

• Kontrollera att kontrollnumren för utbyten, grupper och transaktionsuppsättningar inte är dubbletter (endast hanterad anslutningsapp) om de konfigureras, till exempel:

  • Kontrollera utbyteskontrollnumret mot tidigare mottagna utbyten.

  • Kontrollera gruppkontrollnumret mot andra gruppkontrollnummer i utbytet.

  • Kontrollera kontrollnumret för transaktionsuppsättningen mot andra kontrollnummer för transaktionsuppsättningar i gruppen.

• Dela upp utbytet i transaktionsuppsättningar eller bevara hela utbytet (endast hanterad anslutningsapp), till exempel:

  • Split Interchange as transaction sets – pausa transaktionsuppsättningar vid fel.

    Avkodningsåtgärden delar upp utbytet i transaktionsuppsättningar och parsar varje transaktionsuppsättning. Åtgärden matar endast ut de transaktionsuppsättningar som inte verifieras till badMessagesoch matar ut de återstående transaktionsuppsättningarna till goodMessages.

  • Split Interchange as transaction sets – pausa utbyte vid fel.

    Avkodningsåtgärden delar upp utbytet i transaktionsuppsättningar och parsar varje transaktionsuppsättning. Om en eller flera transaktionsuppsättningar i verifieringen av utbytesfel returnerar åtgärden alla transaktionsuppsättningar i det utbytet till badMessages.

  • Bevara Interchange – pausa transaktionsuppsättningar vid fel.

    Avkodningsåtgärden bevarar utbytet och bearbetar hela batchutbytet. Åtgärden matar endast ut de transaktionsuppsättningar som inte verifieras till badMessagesoch matar ut de återstående transaktionsuppsättningarna till goodMessages.

  • Bevara Utbyte – pausa utbyte vid fel.

    Avkodningsåtgärden bevarar utbytet och bearbetar hela batchutbytet. Om en eller flera transaktionsuppsättningar i verifieringen av utbytesfel returnerar åtgärden alla transaktionsuppsättningar i det utbytet till badMessages.

• Generera en teknisk bekräftelse, funktionell bekräftelse eller båda, om det är konfigurerat.

  • En teknisk bekräftelse eller CONTRL ACK, som rapporterar resultatet från en syntaktisk kontroll av det fullständiga mottagna utbytet.

  • En funktionell bekräftelse som bekräftar godkännandet eller avvisandet för det mottagna utbytet eller gruppen.

Hantera UNH2.5-segment i EDIFACT-dokument

I ett EDIFACT-dokument används UNH2.5-segmentet för schemasökning. I det här EDIFACT-exempelmeddelandet är EAN008till exempel UNH-fältet :

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

Följ dessa steg för att hantera ett EDIFACT-dokument eller bearbeta ett EDIFACT-meddelande som har ett UN2.5-segment:

1. Uppdatera eller distribuera ett schema som har rotnodnamnet UNH2.5.

   Anta till exempel att schemarotnamnet för UNH-exempelfältet är EFACT_D03B_ORDERS_EAN008. För var och D03B_ORDERS en som har ett annat UNH2.5-segment måste du distribuera ett enskilt schema.

2. I Azure-portalen lägger du till schemat i din integrationskontoresurs eller logikappresurs, baserat på om du har ett arbetsflöde för förbrukning respektive standardlogikapp.

3. Oavsett om du använder EDIFACT-avkodnings- eller kodningsåtgärden laddar du upp schemat och konfigurerar schemainställningarna i EDIFACT-avtalets avsnitt Ta emot inställningar respektive Skicka inställningar .

4. Om du vill redigera ditt EDIFACT-avtal går du till fönstret Avtal och väljer ditt avtal. Välj Redigera som JSON i fönstret Avtal.

   • I avtalets receiveAgreement avsnitt letar du reda på avsnittet schemaReferences och lägger till UNH2.5-värdet.

     

   • I avtalets sendAgreementavsnitt letar du reda på avsnittet schemaReferences och lägger till UNH2.5-värdet.

     

Nästa steg

• EDIFACT-meddelandeinställningar