Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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.
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:
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.
Öppna logikappresursen och arbetsflödet i designern i Azure Portal.
-
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.
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:
Välj Skapa när du är klar.
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.
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
badMessages
och matar ut de återstående transaktionsuppsättningarna tillgoodMessages
.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
badMessages
och matar ut de återstående transaktionsuppsättningarna tillgoodMessages
.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.
Öppna logikappresursen och arbetsflödet i designern i Azure Portal.
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:
Välj Skapa när du är klar.
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:
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:
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 varjeD03B_ORDERS
som har ett annat UNH2.5 segment måste du distribuera ett separat schema.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.
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 .
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å avsnittetschemaReferences
och lägger till UNH2.5-värdet.I avtalets
sendAgreement
avsnitt letar du reda på avsnittetschemaReferences
och lägger till UNH2.5-värdet.