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.

Anslut eller teknisk referens

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

Logikapp	Environment	Anslut ellerversion
Förbrukning	Azure Logic Apps med flera klientorganisationer	EDIFACT-hanterad anslutningsapp (standardklass). EDIFACT-anslutningsappen innehåller endast åtgärder, 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 anslutningsapp - EDIFACT-meddelandegränser
Förbrukning	Integration Service Environment (ISE)	EDIFACT-hanterad anslutningsapp (standardklass) och EDIFACT ISE-version, som har andra meddelandegränser än standardklassen. EDIFACT-anslutningsappen innehåller endast åtgärder, 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 anslutningsapp - EDIFACT-meddelandegränser
Standard	Azure Logic Apps för en klientorganisation och App Service-miljön v3 (endast Windows-abonnemang)	Inbyggd EDIFACT-anslutningsapp (förhandsversion) och EDIFACT-hanterad anslutningsapp. 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. – 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 anslutningsapp - Inbyggda EDIFACT-anslutningsåtgärder - EDIFACT-meddelandegränser

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	Anslut ion och länk till integrationskontot krävs. Du kan skapa anslutningen när du lägger till EDIFACT-åtgärden i arbetsflödet.
  Standard	Anslut ion till integrationskontot 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.

Förbrukning

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

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

   Kommentar

   Om du vill använda Encode till EDIFACT-meddelande efter identitetsåtgärd i stället måste du senare ange olika värden, till exempel avsändarens identifierare och mottagaridentifierare 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:

   Property	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:

   Property	Obligatoriskt	Beskrivning
   Namn på EDIFACT-avtal	Ja	EDIFACT-avtalet som ska användas.
   XML-meddelande som ska kodas	Ja	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.

   Xml-meddelandenyttolasten som ska kodas kan till exempel vara brödtextinnehållsutdata från utlösaren Begäran:

   

6. Spara arbetsflödet.

Standard

Inbyggd EDIFACT-anslutningsapp (förhandsversion)

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

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

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

   Property	Obligatoriskt	Beskrivning
   Meddelande som ska kodas	Ja	DET XML-meddelandeinnehåll som du vill koda. 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ändaridentitetsmottagare – kvalificerare - Identifierare för avsändarens identitetsmottagare - Mottagaridentitetsmottagare – kvalificerare - Identifierare för mottagaridentitetsmottagare - Namn på EDIFACT-avtal

   Xml-meddelandenyttolasten som ska kodas kan till exempel vara brödtextinnehållsutdata från utlösaren Begäran:

   

4. Spara arbetsflödet.

EDIFACT-hanterad anslutningsapp

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

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

   Kommentar

   Om du vill använda Encode till EDIFACT-meddelande efter identitetsåtgärd i stället måste du senare ange olika värden, till exempel avsändarens identifierare och mottagaridentifierare 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:

   Property	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-portalen. 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-portalen. 2. På menyn för integrationskontot går du till Inställningar och väljer Återanrops-URL. 3. Kopiera värdet från egenskapen Genererad motringnings-URL .
   Storlek på kontrollnummerblock	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:

   Property	Obligatoriskt	Beskrivning
   Namn på EDIFACT-avtal	Ja	EDIFACT-avtalet som ska användas.
   XML-meddelande som ska kodas	Ja	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.

   Xml-meddelandenyttolasten som ska kodas kan till exempel vara brödtextinnehållsutdata från utlösaren Begäran:

   

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 Ta emot Instä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.

Förbrukning

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

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:

   Property	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:

   Property	Obligatoriskt	Beskrivning
   EDIFACT flat filmeddelande 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 - Versionsindikator - 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.

   Xml-meddelandets nyttolast för avkodning kan till exempel vara brödtextinnehållsutdata från utlösaren Förfrågning:

   

Standard

Inbyggd EDIFACT-anslutningsapp (förhandsversion)

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

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:

   Property	Obligatoriskt	Beskrivning
   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 - Versionsindikator - Upprepningsavgränsare - Segmentavgränsare - Segment terminator-suffix - Decimalindikator - Teckenuppsättning för nyttolast - Segment terminator-suffix - Bevara utbyte - Pausa utbyte vid fel Mer information finns i EDIFACT-meddelandeinställningar.

   Xml-meddelandets nyttolast för avkodning kan till exempel vara brödtextinnehållsutdata från utlösaren Förfrågning:

   

4. Spara arbetsflödet.

EDIFACT-hanterad anslutningsapp

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

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:

   Property	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:

   Property	Obligatoriskt	Beskrivning
   Namn på EDIFACT-avtal	Ja	EDIFACT-avtalet som ska användas.
   XML-meddelande som ska kodas	Ja	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.

   Xml-meddelandets nyttolast för avkodning kan till exempel vara brödtextinnehållsutdata från utlösaren Förfrågning:

   

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