EDIFACT-berichten uitwisselen met behulp van werkstromen in Azure Logic Apps

Als u EDIFACT-berichten wilt verzenden en ontvangen in werkstromen die u maakt met behulp van Azure Logic Apps, gebruikt u de EDIFACT-connector , die bewerkingen biedt die EDIFACT-communicatie ondersteunen en beheren.

Deze handleiding laat zien hoe u de EDIFACT-coderings- en decoderingsacties toevoegt aan een bestaande werkstroom voor logische apps. Wanneer er geen EDIFACT-trigger beschikbaar is, kunt u elke trigger gebruiken om uw werkstroom te starten. In de voorbeelden in deze handleiding wordt de aanvraagtrigger gebruikt.

Verbinding maken of technische naslaginformatie

De EDIFACT-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.

Logische apps	Omgeving	Verbinding maken orversie
Verbruik	multitenant Azure Logic Apps	Beheerde EDIFACT-connector (Standard-klasse). De EDIFACT-connector biedt alleen acties, maar u kunt elke trigger gebruiken die geschikt is voor uw scenario. Zie de volgende documentatie voor meer informatie: - Naslaginformatie voor beheerde EDIFACT-connector - EDIFACT-berichtlimieten
Verbruik	Integratieserviceomgeving (ISE)	EDIFACT Managed Connector (Standard-klasse) en EDIFACT ISE-versie, die verschillende berichtlimieten heeft dan de Standard-klasse. De EDIFACT-connector biedt alleen acties, maar u kunt elke trigger gebruiken die geschikt is voor uw scenario. Zie de volgende documentatie voor meer informatie: - Naslaginformatie voor beheerde EDIFACT-connector - EDIFACT-berichtlimieten
Standaard	Azure Logic Apps en App Service Environment v3 met één tenant (alleen Windows-abonnementen)	Ingebouwde EDIFACT-connector (preview) en door EDIFACT beheerde connector. De ingebouwde versie verschilt op de volgende manieren: - De ingebouwde versie biedt alleen acties, maar u kunt elke trigger gebruiken die geschikt is voor uw scenario. - De ingebouwde versie heeft rechtstreeks toegang tot virtuele Azure-netwerken. U hebt geen on-premises gegevensgateway nodig. Zie de volgende documentatie voor meer informatie: - Naslaginformatie voor beheerde EDIFACT-connector - Ingebouwde EDIFACT-connectorbewerkingen - EDIFACT-berichtlimieten

Ingebouwde EDIFACT-bewerkingen (alleen standaardwerkstromen - preview)

De ingebouwde EDIFACT-previewconnector heeft de volgende acties, die vergelijkbaar zijn met de acties van de door EDIFACT beheerde connector, behalve waar vermeld in Beperkingen en bekende problemen.

• EDIFACT-codeeractie
• EDIFACT-decodeeractie

Beperkingen en bekende problemen

• Preview van ingebouwde EDIFACT-connector

  • Deze mogelijkheid is in preview en is onderworpen aan de aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews.

  • De acties van deze connector ondersteunen momenteel nettoladingen tot ten minste 100 MB.

  • De preview-actie EDIFACT-decoderen bevat momenteel niet de volgende mogelijkheden:

    • Controleer op dubbele uitwisselings-, groeps- en transactiesetbeheernummers, indien geconfigureerd.

    • Behoud de gehele uitwisseling.

    Anders hebben de ingebouwde connectoracties voor EDIFACT-codering en EDIFACT-coderen mogelijkheden die vergelijkbaar zijn met de equivalente acties van ediFACT beheerde connector.

  • De acties van deze connector bieden momenteel geen ondersteuning voor uitwisselingen met meerdere transacties of batchberichten.

  • De acties van deze connector verzenden momenteel geen EDI-specifieke tracering.

Vereisten

• Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meldt u zich aan voor een gratis Azure-account.

• Een integratieaccountresource waarin u artefacten definieert en opslaat, zoals handelspartners, overeenkomsten, certificaten, enzovoort, voor gebruik in uw bedrijfsintegratie en B2B-werkstromen. Deze resource moet voldoen aan de volgende vereisten:

  • Zowel uw integratieaccount als de resource van de logische app moeten zich in hetzelfde Azure-abonnement en dezelfde Azure-regio bevinden.

  • Definieert ten minste twee handelspartners die deelnemen aan de EDIFACT-bewerking die in uw werkstroom wordt gebruikt. De definities voor beide partners moeten dezelfde kwalificatie voor bedrijfsidentiteiten gebruiken, namelijk ZZZ - Wederzijds gedefinieerd voor dit scenario.

  • Definieert een EDIFACT-overeenkomst tussen de handelspartners die deelnemen aan uw werkstroom. Voor elke overeenkomst zijn een hostpartner en een gastpartner vereist. De inhoud in de berichten tussen u en de andere partner moet overeenkomen met het overeenkomsttype. Zie EDIFACT-berichtinstellingen voor informatie over overeenkomstinstellingen die u kunt gebruiken bij het ontvangen en verzenden van berichten.

    Belangrijk

    De EDIFACT-connector ondersteunt alleen UTF-8 tekens. Als uw uitvoer onverwachte tekens bevat, controleert u of uw EDIFACT-berichten de UTF-8-tekenset gebruiken.

• Op basis van of u aan een werkstroom voor een logische of standaard logische app werkt, is voor uw logische app-resource mogelijk een koppeling naar uw integratieaccount vereist:

  Werkstroom voor logische apps	Koppeling vereist?
  Verbruik	Verbinding maken ion en koppeling naar integratieaccount zijn vereist. U kunt de verbinding maken wanneer u de EDIFACT-bewerking aan uw werkstroom toevoegt.
  Standaard	Verbinding maken ion to integration account required, but no link required. U kunt de verbinding maken wanneer u de EDIFACT-bewerking aan uw werkstroom toevoegt.

• De resource en werkstroom van de logische app waarin u de EDIFACT-bewerkingen wilt gebruiken.

  Voor meer informatie raadpleegt u de volgende documentatie:

  • Een voorbeeldwerkstroom voor logische apps voor verbruik maken in multitenant Azure Logic Apps

  • Een voorbeeld van een standaardwerkstroom voor logische apps maken in Azure Logic Apps met één tenant

EDIFACT-berichten coderen

De door EDIFACT beheerde connectoractie Coderen naar EDIFACT-berichtactie en de ingebouwde EDIFACT-connectoractie EDIFACT-codering voert de volgende taken uit, behalve waar vermeld in Beperkingen en bekende problemen:

• Los de overeenkomst op door de kwalificatie en id van de afzender en ontvanger te vergelijken.

• Serialiseer de EDI (Electronic Data Interchange), waarmee XML-gecodeerde berichten worden geconverteerd naar EDI-transactiesets in de uitwisseling.

• Pas header- en trailersegmenten van transactiesets toe.

• Genereer een uitwisselingsbeheernummer, een groepsbeheernummer en een transactiesetbeheernummer voor elke uitgaande uitwisseling.

• Vervang scheidingstekens in de nettoladinggegevens.

• Valideer EDI- en partnerspecifieke eigenschappen, zoals het schema voor transactiesetgegevenselementen op basis van het berichtschema, transactiesetgegevenselementen en uitgebreide validatie van gegevenselementen voor transactiesets.

• Genereer een XML-document voor elke transactieset.

• Vraag een technische bevestiging, functionele bevestiging of beide aan, indien geconfigureerd.

  • Als technische bevestiging geeft het CONTRL-bericht het ontvangstbewijs voor een uitwisseling aan.

  • Als functionele bevestiging geeft het CONTRL-bericht de acceptatie of afwijzing aan voor de ontvangen uitwisseling, groep of bericht, met inbegrip van een lijst met fouten of niet-ondersteunde functionaliteit.

Verbruik

1. Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.

2. Volg deze algemene stappen in de ontwerpfunctie om de EDIFACT-actie Encode toe te voegen aan EDIFACT-bericht op overeenkomstnaam aan uw werkstroom.

   Notitie

   Als u in plaats daarvan de actie Coderen wilt gebruiken voor EDIFACT-bericht op basis van identiteiten , moet u later verschillende waarden opgeven, zoals de afzender-id en ontvanger-id die is opgegeven door uw EDIFACT-overeenkomst. U moet ook het XML-bericht opgeven om te coderen. Dit kan de uitvoer zijn van de trigger of een voorgaande actie.

3. Geef de volgende verbindingsgegevens op voor uw integratieaccount:

   Eigenschappen	Vereist	Beschrijving
   Verbindingsnaam	Ja	Een naam voor de verbinding
   Integratieaccount	Ja	Selecteer in de lijst met beschikbare integratieaccounts het account dat u wilt gebruiken.

   Voorbeeld:

   

4. Selecteer Maken als u klaar bent.

5. Geef in de EDIFACT-actie de volgende eigenschapswaarden op:

   Eigenschappen	Vereist	Beschrijving
   Naam van EDIFACT-overeenkomst	Ja	De EDIFACT-overeenkomst die moet worden gebruikt.
   XML-bericht om te coderen	Ja	De zakelijke id voor de afzender van het bericht zoals opgegeven door uw EDIFACT-overeenkomst
   Andere parameters	Nee	Deze bewerking bevat de volgende andere parameters: - Scheidingsteken voor gegevenselementen - Release-indicator - Onderdeelscheidingsteken - Scheidingsteken voor herhaling - Segmenteindteken - Achtervoegsel segmenteindteken - Decimale indicator Zie EDIFACT-berichtinstellingen voor meer informatie.

   De nettolading van het XML-bericht om te coderen kan bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger zijn:

   

6. Sla uw werkstroom op.

Standaard

Ingebouwde EDIFACT-connector (preview)

1. Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.

2. Volg deze algemene stappen in de ontwerpfunctie om de EDIFACT-actie EDIFACT-codering toe te voegen aan uw werkstroom.

3. Geef in het actievenster EDIFACT de vereiste eigenschapswaarden op:

   Eigenschappen	Vereist	Beschrijving
   Bericht om te coderen	Ja	De inhoud van het XML-bericht dat u wilt coderen. Met name de zakelijke id voor de afzender van het bericht, zoals opgegeven door uw EDIFACT-overeenkomst.
   Geavanceerde parameters	Nee	Voeg in de lijst eventuele andere eigenschappen toe die u wilt gebruiken. Deze bewerking bevat de volgende andere parameters: - Kwalificatie van afzenderidentiteitsontvanger - Id van afzenderidentiteitsontvanger - Kwalificatie voor ontvangeridentiteitsontvanger - Ontvanger-id van ontvanger-id - Naam van EDIFACT-overeenkomst

   De nettolading van het XML-bericht om te coderen kan bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger zijn:

   

4. Sla uw werkstroom op.

Beheerde EDIFACT-connector

1. Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.

2. Volg deze algemene stappen in de ontwerpfunctie om de EDIFACT-actie Encode toe te voegen aan EDIFACT-bericht op overeenkomstnaam aan uw werkstroom.

   Notitie

   Als u in plaats daarvan de actie Coderen wilt gebruiken voor EDIFACT-bericht op basis van identiteiten , moet u later verschillende waarden opgeven, zoals de afzender-id en ontvanger-id die is opgegeven door uw EDIFACT-overeenkomst. U moet ook het XML-bericht opgeven om te coderen. Dit kan de uitvoer zijn van de trigger of een voorgaande actie.

3. Geef de volgende verbindingsgegevens op voor uw integratieaccount:

   Eigenschappen	Vereist	Beschrijving
   Verbindingsnaam	Ja	Een naam voor de verbinding
   Id van integratieaccount	Ja	De resource-id voor uw integratieaccount, die de volgende indeling heeft: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Bijvoorbeeld: /subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Volg deze stappen om deze resource-id te vinden: 1. Open uw integratieaccount in Azure Portal. 2. Selecteer Overzicht in het menu van het integratieaccount. 3. Selecteer JSON-weergave op de pagina Overzicht. 4. Kopieer de waarde uit de eigenschap Resource-id .
   SAS-URL van integratieaccount	Ja	De eindpunt-URL van de aanvraag die gebruikmaakt van SAS-verificatie (Shared Access Signature) om toegang te bieden tot uw integratieaccount. Deze callback-URL heeft de volgende indeling: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Bijvoorbeeld: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=ZZZZZZZZZZZZZZZZZZZZZZZZZZZ Volg deze stappen om deze URL te vinden: 1. Open uw integratieaccount in Azure Portal. 2. Selecteer in het menu integratieaccount onder Instellingen de callback-URL. 3. Kopieer de waarde uit de eigenschap Gegenereerde callback-URL .
   Grootte van besturingselementnummerblok	Nee	De blokgrootte van controlenummers die moeten worden gereserveerd vanuit een overeenkomst voor scenario's met hoge doorvoer

   Voorbeeld:

   

4. Selecteer Maken als u klaar bent.

5. Geef in het actievenster EDIFACT de volgende eigenschapswaarden op:

   Eigenschappen	Vereist	Beschrijving
   Naam van EDIFACT-overeenkomst	Ja	De EDIFACT-overeenkomst die moet worden gebruikt.
   XML-bericht om te coderen	Ja	De zakelijke id voor de afzender van het bericht zoals opgegeven door uw EDIFACT-overeenkomst
   Andere parameters	Nee	Deze bewerking bevat de volgende andere parameters: - Scheidingsteken voor gegevenselementen - Release-indicator - Onderdeelscheidingsteken - Scheidingsteken voor herhaling - Segmenteindteken - Achtervoegsel segmenteindteken - Decimale indicator Zie EDIFACT-berichtinstellingen voor meer informatie.

   De nettolading van het XML-bericht om te coderen kan bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger zijn:

   

6. Sla uw werkstroom op.

EDIFACT-berichten decoderen

De actie voor de beheerde EDIFACT-connector met de naam EDIFACT-berichtactie decoderen en de ingebouwde EDIFACT-connectoractieEDIFACT-decode voert de volgende taken uit, behalve als vermeld in Beperkingen en bekende problemen:

• Valideer de envelop aan de handelspartnerovereenkomst.

• Los de overeenkomst op door de kwalificatie en id van de afzender te vergelijken met de ontvangerkwalificatie en -id.

• Splits een uitwisseling in meerdere transactiesets wanneer de uitwisseling meer dan één transactie heeft, op basis van de ontvangst-Instellingen van de overeenkomst.

• De uitwisseling demonteren.

• Valideer electronic Data Interchange (EDI) en partnerspecifieke eigenschappen, zoals de structuur van de uitwisselingsenvelop, het envelopschema tegen het controleschema, het schema voor de gegevenselementen van de transactieset op basis van het berichtschema en uitgebreide validatie van gegevenselementen voor transactiesets.

• Controleer of de besturingsnummers voor de uitwisseling, groep en transactieset geen duplicaten zijn (alleen beheerde connector), indien geconfigureerd, bijvoorbeeld:

  • Controleer het uitwisselingsbeheernummer tegen eerder ontvangen uitwisselingen.

  • Controleer het groepsbeheernummer op basis van andere groepsbeheernummers in de uitwisseling.

  • Controleer het controlenummer van de transactieset op andere transactiesetbeheernummers in die groep.

• Splits de uitwisseling in transactiesets of behoud de volledige uitwisseling (alleen beheerde connector), bijvoorbeeld:

  • Split Interchange as transaction sets - suspend transaction sets on error.

    De decoderingsactie splitst de uitwisseling in transactiesets en parseert elke transactieset. De actie voert alleen de transactiesets uit waarop de validatie badMessagesmislukt en voert de resterende transactiesets uit op goodMessages.

  • Split Interchange as transaction sets - suspend interchange on error.

    De decoderingsactie splitst de uitwisseling in transactiesets en parseert elke transactieset. Als een of meer transactiesets in de uitwisselingsvalidatie mislukken, voert de actie alle transactiesets in die uitwisseling uit naar badMessages.

  • Interchange behouden: transactiesets onderbreken bij fout.

    De decoderingsactie behoudt de uitwisseling en verwerkt de gehele batchgewijze uitwisseling. De actie voert alleen de transactiesets uit waarop de validatie badMessagesmislukt en voert de resterende transactiesets uit op goodMessages.

  • Interchange behouden - uitwisseling onderbreken bij fout.

    De decoderingsactie behoudt de uitwisseling en verwerkt de gehele batchgewijze uitwisseling. Als een of meer transactiesets in de uitwisselingsvalidatie mislukken, voert de actie alle transactiesets in die uitwisseling uit naar badMessages.

• Genereer een technische bevestiging, functionele bevestiging of beide, indien geconfigureerd.

  • Een technische bevestiging of de CONTRL ACK, die de resultaten rapporteert van een syntactische controle over de volledige ontvangen uitwisseling.

  • Een functionele bevestiging die de acceptatie of afwijzing voor de ontvangen uitwisseling of groep bevestigt.

Verbruik

1. Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.

2. Volg deze algemene stappen in de ontwerpfunctie om de EDIFACT-actie met de naam EDIFACT-bericht aan uw werkstroom toe te voegen.

3. Geef de volgende verbindingsgegevens op voor uw integratieaccount:

   Eigenschappen	Vereist	Beschrijving
   Verbindingsnaam	Ja	Een naam voor de verbinding
   Integratieaccount	Ja	Selecteer in de lijst met beschikbare integratieaccounts het account dat u wilt gebruiken.

   Voorbeeld:

   

4. Selecteer Maken als u klaar bent.

5. Geef in de EDIFACT-actie de volgende eigenschapswaarden op:

   Eigenschappen	Vereist	Beschrijving
   EdiFACT-bericht met plat bestand om te decoderen	Ja	Het bericht van het xml-platte bestand dat moet worden gedecodeerd.
   Andere parameters	Nee	Deze bewerking bevat de volgende andere parameters: - Onderdeelscheidingsteken - Scheidingsteken voor gegevenselementen - Release-indicator - Scheidingsteken voor herhaling - Segmenteindteken - Achtervoegsel segmenteindteken - Decimale indicator - Tekenset nettolading - Achtervoegsel segmenteindteken - Interchange behouden - Interchange on Error onderbreken Zie EDIFACT-berichtinstellingen voor meer informatie.

   De nettolading van het XML-bericht om te decoderen kan bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger zijn:

   

Standaard

Ingebouwde EDIFACT-connector (preview)

1. Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.

2. Volg deze algemene stappen in de ontwerpfunctie om de EDIFACT-actie MET de naam EDIFACT Decode toe te voegen aan uw werkstroom.

3. Geef in de EDIFACT-actie de volgende eigenschapswaarden op:

   Eigenschappen	Vereist	Beschrijving
   Bericht om te decoderen	Ja	Het bericht van het xml-platte bestand dat moet worden gedecodeerd.
   Andere parameters	Nee	Deze bewerking bevat de volgende andere parameters: - Onderdeelscheidingsteken - Scheidingsteken voor gegevenselementen - Release-indicator - Herhalingsscheidingsteken - Segmenteindteken - Segmenteindtekenachtervoegsel - Decimale indicator - Tekenset nettolading - Segmenteindtekenachtervoegsel - Interchange behouden - Interchange on Error onderbreken Zie EDIFACT-berichtinstellingen voor meer informatie.

   De nettolading van het XML-bericht om te decoderen kan bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger zijn:

   

4. Sla uw werkstroom op.

Beheerde EDIFACT-connector

1. Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.

2. Volg deze algemene stappen in de ontwerpfunctie om de EDIFACT-actie met de naam EDIFACT-bericht aan uw werkstroom toe te voegen.

3. Geef de volgende verbindingsgegevens op voor uw integratieaccount:

   Eigenschappen	Vereist	Beschrijving
   Verbindingsnaam	Ja	Een naam voor de verbinding
   Integratieaccount	Ja	Selecteer in de lijst met beschikbare integratieaccounts het account dat u wilt gebruiken.

   Voorbeeld:

   

4. Selecteer Maken als u klaar bent.

5. Geef in het actievenster EDIFACT de volgende eigenschapswaarden op:

   Eigenschappen	Vereist	Beschrijving
   Naam van EDIFACT-overeenkomst	Ja	De EDIFACT-overeenkomst die moet worden gebruikt.
   XML-bericht om te coderen	Ja	De zakelijke id voor de afzender van het bericht zoals opgegeven door uw EDIFACT-overeenkomst
   Andere parameters	Nee	Deze bewerking bevat de volgende andere parameters: - Scheidingsteken voor gegevenselementen - Release-indicator - Onderdeelscheidingsteken - Scheidingsteken voor herhaling - Segmenteindteken - Achtervoegsel segmenteindteken - Decimale indicator Zie EDIFACT-berichtinstellingen voor meer informatie.

   De nettolading van het XML-bericht om te decoderen kan bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger zijn:

   

UNH2.5-segmenten verwerken in EDIFACT-documenten

In een EDIFACT-document wordt het UNH2.5-segment gebruikt voor het opzoeken van schema's. In dit EDIFACT-voorbeeldbericht is EAN008het veld UNH bijvoorbeeld:

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

Als u een EDIFACT-document wilt verwerken of een EDIFACT-bericht wilt verwerken dat een UN2.5-segment heeft, voert u de volgende stappen uit:

1. Werk een schema met de naam van het UNH2.5-hoofdknooppunt bij of implementeer dit.

   Stel dat de hoofdnaam van het schema voor het UNH-voorbeeldveld is EFACT_D03B_ORDERS_EAN008. Voor elk D03B_ORDERS segment met een ander UNH2.5-segment moet u een afzonderlijk schema implementeren.

2. Voeg in Azure Portal het schema toe aan uw integratieaccountresource of logische app-resource, op basis van of u respectievelijk een werkstroom voor logische of standaard logische apps hebt.

3. Of u nu de EDIFACT-decoderings- of coderingsactie gebruikt, upload uw schema en stel de schema-instellingen in de secties Ontvangen Instellingen van uw EDIFACT-overeenkomst in of verzend Instellingen secties.

4. Als u uw EDIFACT-overeenkomst wilt bewerken, selecteert u uw overeenkomst in het deelvenster Overeenkomsten . Selecteer Bewerken als JSON op de werkbalk van het deelvenster Overeenkomsten.

   • Zoek in de sectie van receiveAgreement de overeenkomst de schemaReferences sectie en voeg de UNH2.5-waarde toe.

     

   • Zoek in de sectie van sendAgreementde overeenkomst de schemaReferences sectie en voeg de UNH2.5-waarde toe.

     

Volgende stappen

• EDIFACT-berichtinstellingen