Utbyta EDIFACT-meddelanden med 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 använda valfri utlösare för att starta arbetsflödet. Exemplen i den här guiden använder Förfrågningsutlösaren.

Teknisk referens för anslutningar

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

Logik app	Miljö	Anslutningsversion
Förbrukning	Azure Logic Apps för många användare	EDIFACT-hanterad anslutning (standardklass). EDIFACT-anslutningsappen har bara en utlösare, men du kan använda alla utlösare som fungerar för ditt scenario. Mer information finns i följande dokumentation: - Referens för EDIFACT-hanterad anslutning - EDIFACT-meddelandegränser
Standard	Azure Logic Apps för en klientorganisation och App Service-miljön v3 (endast Windows-abonnemang)	Inbyggd EDIFACT-anslutning och EDIFACT-hanterad anslutning. Den inbyggda versionen skiljer sig åt på följande sätt: – Den inbyggda versionen innehåller endast åtgärder, men du kan använda alla utlösare som fungerar för ditt scenario. – Accepterar en platt fil som indata jämfört med XML för den hanterade versionen. – Den inbyggda versionen kan komma åt virtuella Azure-nätverk direkt. Du behöver ingen lokal datagateway. Mer information finns i följande dokumentation: - Referens för EDIFACT-hanterad anslutning - Inbyggda EDIFACT-anslutningsåtgärder - EDIFACT-meddelandegränser

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

Den inbyggda EDIFACT-anslutningsappen har följande åtgärder, som liknar 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

• Inbyggd EDIFACT-anslutning

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

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

    Annars har de inbyggda anslutningsapparnas EDIFACT-kodning- och EDIFACT-avkodning samma kapacitet som deras motsvarande EDIFACT-hanterade åtgärder för anslutningsappar.

  • Den här anslutningens å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 Consumption eller Standard logikapp 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.

• Logikappsresursen och arbetsflödet där du vill använda EDIFACT-åtgärder.

  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

• Innehållet som ska kodas eller avkodas. I arbetsflöden för konsumtion accepterar åtgärder för hanterade EDIFACT-anslutningar ett XML-meddelande som indata. I Standard-arbetsflöden accepterar de inbyggda EDIFACT-anslutningsåtgärderna en platt fil, medan den hanterade EDIFACT-anslutningsappen accepterar ett XML-meddelande.

Koda EDIFACT-meddelanden

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

• Hantera avtalet genom att matcha avsändarens kvalificerare och identifierare med mottagarens kvalificerare 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.

Förbrukning

1. Öppna logikappresursen och arbetsflödet i designern i Azure Portal.

2. I designern följer du de här allmänna stegen för att lägga till EDIFACT-åtgärden med namnet Koda till EDIFACT-meddelande efter avtalsnamn i ditt arbetsflöde.

   Anteckning

   Om du vill använda Kodning till EDIFACT-meddelande efter identiteter i stället måste du senare ange olika värden, till exempel avsändarens identifierare och mottagaridentifierare som anges av ditt EDIFACT-avtal. Du måste också ange XML-meddelandet som ska kodas, vilket kan vara utdata från utlösaren eller en föregående åtgärd.

3. Ange följande anslutningsinformation för ditt integrationskonto:

   Egendom	Obligatoriskt	Beskrivning
   Anslutningens namn	Ja	Ett namn på anslutningen
   Integrationskonto	Ja	I listan över tillgängliga integrationskonton väljer du det konto som ska användas.

   Till exempel:

   

4. Välj Skapa när du är klar.

5. Ange följande egenskapsvärden i EDIFACT-åtgärden :

   Fastighet	Obligatoriskt	Beskrivning
   Namn på EDIFACT-avtal	Ja	EDIFACT-avtalet som ska användas.
   XML-meddelande som ska kodas	Ja	XML-meddelandet som ska kodas. Mer specifikt affärsidentifieraren för meddelandesändaren enligt EDIFACT-avtalet.
   Andra parametrar	Nej	Den här åtgärden innehåller följande andra parametrar: - Avgränsare för dataelement - Utgåveindikator - Komponentavgränsare - Upprepningsavgränsare - Segmentavgränsare - Segmentavslutarsuffix - Decimalindikator Mer information finns i EDIFACT-meddelandeinställningar.

   Till exempel kan nyttolasten som ska kodas vara utdata från brödtextinnehållet i utlösaren Förfrågning.

   

6. Spara arbetsflödet.

Standard

Inbyggd EDIFACT-anslutning

1. Öppna logikappresursen och arbetsflödet i designern i Azure Portal.

2. I designern följer du de här allmänna stegen för att lägga till EDIFACT-åtgärden med namnet EDIFACT Encode till ditt arbetsflöde.

3. I åtgärdsfönstret EDIFACT anger du de egenskapsvärden som krävs:

   Fastighet	Obligatoriskt	Beskrivning
   Meddelande som ska kodas	Ja	Det flata filinnehållet som ska kodas. Mer specifikt affärsidentifieraren för meddelandesändaren enligt EDIFACT-avtalet.
   Avancerade parametrar	Nej	I listan lägger du till andra egenskaper som du vill använda. Den här åtgärden innehåller följande andra parametrar: - Avsändaridentitet Mottagarkvalificerare - Avsändaridentitet Mottagaridentifierare - Mottagaridentitet Kvalificeringsbeteckning - Mottagarens identitet Mottagarens identifierare - Namn på EDIFACT-avtal

   Till exempel kan den flata filnyttolasten som ska kodas vara brödtextinnehållets utdata från utlösaren Begäran :

   

4. Spara arbetsflödet.

EDIFACT-hanterad kontakt

1. Öppna logikappresursen och arbetsflödet i designern i Azure Portal.

2. I designern följer du de här allmänna stegen för att lägga till EDIFACT-åtgärden med namnet Koda till EDIFACT-meddelande enligt avtalsnamn i arbetsflödet.

   Anteckning

   Om du vill använda Koda till EDIFACT-meddelande efter identiteter åtgärden i stället, måste du senare ange olika värden, till exempel avsändarens identifierare och mottagarens identifierare som anges i ditt EDIFACT-avtal. Du måste också ange XML-meddelandet som ska kodas, vilket kan vara utdata från utlösaren eller en föregående åtgärd.

3. Ange följande anslutningsinformation för ditt integrationskonto:

   Fastighet	Obligatoriskt	Beskrivning
   Anslutningens namn	Ja	Ett namn på anslutningen
   Integrationskonto-ID	Ja	Resurs-ID:t för ditt integrationskonto, som har följande format: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Till exempel: /subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Följ dessa steg för att hitta det här resurs-ID:t: 1. Öppna ditt integrationskonto i Azure Portal. 2. Välj Översikt på menyn för integrationskontot. 3. På sidan Översikt väljer du JSON-vy. 4. Kopiera värdet från egenskapen Resurs-ID .
   SAS-URL för integrationskonto	Ja	URL:en för begärandeslutpunkt som använder SAS-autentisering (signatur för delad åtkomst) för att ge åtkomst till ditt integrationskonto. Den här motringnings-URL:en har följande format: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Till exempel: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=ZZZZZZZZZZZZZZZZZZZZZZZZZZZ Följ dessa steg för att hitta den här URL:en: 1. Öppna ditt integrationskonto i Azure Portal. 2. På menyn för integrationskonto går du till Inställningar och väljer Återanrops-URL. 3. Från egenskapen Genererad motringnings-URL, kopiera värdet.
   Kontrollnummerblockets storlek	Nej	Blockstorleken för kontrollnummer som ska reserveras från ett avtal för scenarier med högt dataflöde

   Till exempel:

   

4. Välj Skapa när du är klar.

5. I åtgärdsfönstret EDIFACT anger du följande egenskapsvärden:

   Fastighet	Obligatoriskt	Beskrivning
   Namn på EDIFACT-avtal	Ja	EDIFACT-avtalet som ska användas.
   XML-meddelande som ska kodas	Ja	XML-meddelandet som ska kodas. Mer specifikt affärsidentifieraren för meddelandesändaren enligt EDIFACT-avtalet.
   Andra parametrar	Nej	Den här åtgärden innehåller följande andra parametrar: - Avgränsare för dataelement - Versionsindikator - Komponentavgränsare - Upprepningsavgränsare - Segmentavgränsare - Segmentavslutarsuffix - Decimalindikator Mer information finns i EDIFACT-meddelandeinställningar.

   Nyttolasten som ska kodas kan till exempel vara innehållet i Body från Förfrågningsutlösaren

   

6. Spara arbetsflödet.

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 växeln.

• 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 koppling), och 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 interchangen i transaktionsuppsättningar, eller bevara hela interchangen (endast för hanterad anslutning), till exempel:

  • Dela upp utbyte som transaktionsuppsättningar – avbryt 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.

  • Dela upp växlingen som transaktionsuppsättningar – suspendera utbytet vid fel.

    Avkodningsåtgärden delar upp utbytet i transaktionsuppsättningar och parsar varje transaktionsuppsättning. Om en eller flera transaktionsuppsättningar i utbytet inte klarar valideringen, returneras alla transaktionsuppsättningar i det utbytet till badMessages.

  • Bevara datautbyte – avbryta transaktioner vid fel.

    Avkodningsåtgärden bevarar utbytet och bearbetar hela batchväxlingen. Å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 datautbytet och bearbetar hela batchen av datautbytet. Om en eller flera transaktionsuppsättningar i utbytet misslyckas med valideringen, 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 hela det mottagna utbytet.

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

Förbrukning

1. Öppna logikappresursen och arbetsflödet i designern i Azure Portal.

2. I designern följer du de här allmänna stegen för att lägga till EDIFACT-åtgärden med namnet Avkoda EDIFACT-meddelande i arbetsflödet.

3. Ange följande anslutningsinformation för ditt integrationskonto:

   Egendom	Obligatoriskt	Beskrivning
   Anslutningens namn	Ja	Ett namn på anslutningen
   Integrationskonto	Ja	I listan över tillgängliga integrationskonton väljer du det konto som ska användas.

   Till exempel:

   

4. Välj Skapa när du är klar.

5. Ange följande egenskapsvärden i EDIFACT-åtgärden :

   Egendom	Obligatoriskt	Beskrivning
   EDIFACT flat fil meddelande att avkoda	Ja	Det flata XML-filmeddelandet som ska avkodas.
   Andra parametrar	Nej	Den här åtgärden innehåller följande andra parametrar: - Komponentavgränsare - Avgränsare för dataelement - Utgivningsindikator - Upprepningsavgränsare - Segmentavgränsare - Segmentavslutarsuffix - Decimalindikator - Teckenuppsättning för payload - Segmentavslutarsuffix - Bevara utbyte - Pausa utbyte vid fel Mer information finns i EDIFACT-meddelandeinställningar.

   Nyttolasten som ska avkodas kan till exempel vara Body-innehållet från utlösaren Request:

   

Standard

Inbyggd EDIFACT-anslutning

1. Öppna logikappresursen och arbetsflödet i designern i Azure Portal.

2. I designern följer du de här allmänna stegen för att lägga till EDIFACT-åtgärden med namnet EDIFACT-avkodning i arbetsflödet.

3. Ange följande egenskapsvärden i EDIFACT-åtgärden :

   Egendom	Obligatoriskt	Beskrivning
   Meddelande att avkoda	Ja	Den flata filen som ska avkodas.
   Andra parametrar	Nej	Den här åtgärden innehåller följande andra parametrar: - Komponentavgränsare - Avgränsare för dataelement - Versionsindikator - Upprepningsavgränsare - Segmentavgränsare - Segmentterminatorsuffix - Decimalindikator - Teckenuppsättning för payload - Segment terminator-suffix - Bevara utbyte - Pausa utbyte vid fel Mer information finns i EDIFACT-meddelandeinställningar.

   Till exempel kan innehållet i Body från Request-utlösaren avkodas:

   

4. Spara arbetsflödet.

EDIFACT-kontrollerad koppling

1. Öppna logikappresursen och arbetsflödet i designern i Azure Portal.

2. I designern följer du de här allmänna stegen för att lägga till EDIFACT-åtgärden med namnet Avkoda EDIFACT-meddelande i arbetsflödet.

3. Ange följande anslutningsinformation för ditt integrationskonto:

   Egendom	Obligatoriskt	Beskrivning
   Anslutningens namn	Ja	Ett namn på anslutningen
   Integrationskonto	Ja	I listan över tillgängliga integrationskonton väljer du det konto som ska användas.

   Till exempel:

   

4. Välj Skapa när du är klar.

5. I åtgärdsfönstret EDIFACT anger du följande egenskapsvärden:

   Egendom	Obligatoriskt	Beskrivning
   Namn på EDIFACT-avtal	Ja	EDIFACT-avtalet som ska användas.
   EDIFACT flatfil-meddelande att avkoda	Ja	Det flata XML-filmeddelandet som ska avkodas.
   Andra parametrar	Nej	Den här åtgärden innehåller följande andra parametrar: - Komponentavgränsare - Avgränsare för dataelement - Frisläppningsindikator - Upprepningsavgränsare - Segmentavgränsare - Segmentavslutarsuffix - Decimalindikator - Teckenuppsättning för nyttolast - Segmentavslutarsuffix - Bevara utbyte - Pausa utbyte vid fel Mer information finns i EDIFACT-meddelandeinställningar.

   Nyttolasten som ska avkodas kan till exempel vara innehållet i Body från Begäran-utlösaren:

   

Hantera UNH2.5-segment i EDIFACT-dokument

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

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 varje D03B_ORDERS som har ett annat UNH2.5 segment måste du distribuera ett separat schema.

2. I Azure-portalen lägger du till schemat i din resurs för integrationskonto eller logikapp, beroende på om du har ett förbruknings- eller standardarbetsflöde för logikapplikationer.

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