Austauschen von EDIFACT-Nachrichten mithilfe von Workflows in Azure Logic Apps

Wenn Sie EDIFACT-Nachrichten in Workflows, die Sie mit Azure Logic Apps erstellen, senden und empfangen möchten, können Sie den EDIFACT-Connector verwenden. Dieser stellt Vorgänge bereit, die die EDIFACT-Kommunikation unterstützen und verwalten.

In diesem Leitfaden wird gezeigt, wie Sie einem vorhandenen Logik-App-Workflow die EDIFACT-Codierungs- und Decodierungsaktionen hinzufügen. Wenn kein EDIFACT-Trigger verfügbar ist, können Sie jeden Trigger zum Starten des Workflows ausführen. In den Beispielen dieses Leitfadens wird der Anforderungstrigger verwendet.

Technische Referenz für den Connector

Der EDIFACT-Connector verfügt über verschiedene Versionen, basierend auf dem Logik-App-Typ und der Hostumgebung.

Logik-App Environment Connector-Version
Verbrauch Mehrinstanzenfähige Azure Logic Apps EDIFACT managed connector (Standard class). Der EDIFACT-Connector bietet nur Aktionen, Sie können jedoch jeden Trigger verwenden, der für Ihr Szenario funktioniert. Weitere Informationen finden Sie in der folgenden Dokumentation:

- Referenz zu verwaltetem EDIFACT-Connector
- EDIFACT-Nachrichtengrenzwerte
Verbrauch Integrationsdienstumgebung (Integration Service Environment, ISE) EDIFACT managed connector (Standard class) and EDIFACT ISE version, which has different message limits than the Standard class. Der EDIFACT-Connector bietet nur Aktionen, Sie können jedoch jeden Trigger verwenden, der für Ihr Szenario funktioniert. Weitere Informationen finden Sie in der folgenden Dokumentation:

- Referenz zu verwaltetem EDIFACT-Connector
- EDIFACT-Nachrichtengrenzwerte
Standard Einzelmandanten-Azure Logic Apps und App Service-Umgebung v3 (nur Windows-Pläne) EDIFACT integrierter Connector (Vorschau) und EDIFACT verwalteter Connector. Die integrierte Version unterscheidet sich wie folgt:

– Die intergrierte Version bietet nur Aktionen, aber Sie können jeden Trigger verwenden, der für Ihr Szenario funktioniert.

- Die integrierte Version kann direkt auf virtuelle Azure-Netzwerke zugreifen. Sie benötigen kein lokales Datengateway.

Weitere Informationen finden Sie in der folgenden Dokumentation:

- Referenz zu verwaltetem EDIFACT-Connector
- INTEGRIERTE EDIFACT-Verbindervorgänge
- EDIFACT-Nachrichtengrenzwerte

INTEGRIERTE EDIFACT-Vorgänge (nur Standardworkflows – Vorschau)

Der integrierte Vorschau-EDIFACT-Connector verfügt über die folgenden Aktionen, die mit den von ediFACTverwalteten Connectoraktionen vergleichbar sind, mit Ausnahme von Einschränkungen und bekannten Problemen.

Einschränkungen und bekannte Probleme

  • Vorschau des integrierten EDIFACT-Connectors

    • Diese Funktion befindet sich in der Vorschauphase und unterliegt den Zusätzlichen Nutzungsbedingungen für Microsoft Azure-Vorschauversionen.

    • Die Aktionen dieses Connectors unterstützen derzeit Nutzlasten bis zu mindestens 100 MB.

    • Die Vorschau-EDIFACT-Decodierungsaktion enthält derzeit nicht die folgenden Funktionen:

      • Überprüfen Sie bei Konfiguration auf doppelte Austausch-, Gruppen- und Transaktionssatzsteuerungsnummern.

      • Bewahren Sie den gesamten Austausch auf.

      Andernfalls weisen die integrierten EdiFACT-Codierungs- und EDIFACT-Decodierungsaktionen ähnliche Funktionen wie die von EDIFACT verwalteten Connectoraktionen auf.

    • Die Aktionen dieses Connectors unterstützen derzeit keine Austauschvorgänge mit mehreren Transaktionen oder batchierten Nachrichten.

    • Die Aktionen dieses Connectors geben derzeit keine EDI-spezifische Nachverfolgung aus.

Voraussetzungen

  • Ein Azure-Konto und ein Azure-Abonnement. Sollten Sie noch kein Abonnement besitzen, können Sie sich für ein kostenloses Azure-Konto registrieren.

  • Eine Integrationskontoressource, in der Sie Artefakte wie Handelspartner, Vereinbarungen, Zertifikate usw. für die Verwendung in Ihrer Unternehmensintegration und in B2B-Workflows definieren und speichern. Diese Ressource muss die folgenden Anforderungen erfüllen:

    • Sowohl Ihre Integrationskonto- als auch Ihre Logik-App-Ressource müssen im selben Azure-Abonnement und in derselben Azure-Region vorliegen.

    • Es definiert mindestens zwei Handelspartner, die an dem EDIFACT-Vorgang teilnehmen, der in Ihrem Workflow verwendet wird. Die Definitionen für beide Partner müssen denselben Qualifizierer für die Geschäftsidentität verwenden, der für dieses Szenario ZZZ - Mutually Defined lautet.

    • Es definiert eine EDIFACT-Vereinbarung zwischen den Handelspartnern, die an Ihrem Workflow teilnehmen. Jede Vereinbarung erfordert sowohl einen Host- als auch einen Gastpartner. Der Inhalt der Nachrichten zwischen Ihnen und dem*der Partner*in muss mit dem Vereinbarungstyp übereinstimmen. Informationen zu den Vereinbarungseinstellungen, die beim Empfangen und Senden von Nachrichten verwendet werden sollen, finden Sie unter EDIFACT-Nachrichteneinstellungen.

      Wichtig

      Der EDIFACT-Connector unterstützt nur UTF-8-Zeichen. Wenn Ihre Ausgabe unerwartete Zeichen enthält, überprüfen Sie, ob Ihre EDIFACT-Nachrichten den UTF-8-Zeichensatz verwenden.

  • Basierend darauf, ob Sie an einem Verbrauchs- oder Standard-Logik-App-Workflow arbeiten, erfordert Ihre Logik-App-Ressource möglicherweise einen Link zu Ihrem Integrationskonto:

    Logik-App-Workflow Link erforderlich?
    Verbrauch Verbinden ion und Verknüpfung mit dem Integrationskonto sind erforderlich. Sie können die Verbindung erstellen, wenn Sie Ihrem Workflow den EDIFACT-Vorgang hinzufügen.
    Standard Es ist eine Verbindung mit dem Integrationskonto erforderlich, aber kein Link. Sie können die Verbindung erstellen, wenn Sie Ihrem Workflow den EDIFACT-Vorgang hinzufügen.
  • Die Logik-App-Ressource und der Workflow, in der bzw. dem Sie die EDIFACT-Vorgänge verwenden möchten.

    Weitere Informationen finden Sie in der folgenden Dokumentation:

Codierung von EDIFACT-Nachrichten

Die aktion "EDIFACT verwalteter Connector" mit dem Namen "Codieren von EDIFACT-Nachrichten" und die integrierte EDIFACT-Connectoraktion mit dem Namen "EDIFACT Encode" führt die folgenden Aufgaben aus, es sei denn, es werden Einschränkungen und bekannte Probleme aufgeführt:

  • Lösen Sie die Vereinbarung durch Abgleich von Senderqualifizierer und -bezeichner sowie von Empfängerqualifizierer und -bezeichner auf.

  • Serialisieren Sie den elektronischen Datenaustausch (Electronic Data Interchange, EDI), der XML-codierte Nachrichten im Austausch in EDI-Transaktionssätze konvertiert.

  • Wenden Sie Header- und Nachspannsegmente für den Transaktionssatz an.

  • Generieren Sie eine Austauschkontrollnummer, eine Gruppenkontrollnummer und eine Transaktionssatz-Kontrollnummer für jeden ausgehenden Austausch.

  • Ersetzen Sie Trennzeichen in den Nutzlastdaten.

  • Überprüfen Sie EDI- und partnerspezifische Eigenschaften, z. B. das Schema für Transaktionssatz-Datenelemente anhand des Nachrichtenschemas, Transaktionssatz-Datenelemente und die erweiterte Überprüfung für Transaktionssatz-Datenelemente.

  • Generieren Sie ein XML-Dokument für jeden Transaktionssatz.

  • Fordern Sie eine technische Bestätigung, Funktionsbestätigung oder beides an, sofern konfiguriert.

    • Als technische Bestätigung kennzeichnet die CONTRL-Nachricht den Empfang für einen Austauschvorgang.

    • Als Funktionsbestätigung kennzeichnet die CONTRL-Nachricht die Annahme oder Ablehnung für den empfangenen Austausch, die Gruppe oder Nachricht, einschließlich einer Liste von Fehlern oder nicht unterstützten Funktionen.

  1. Öffnen Sie im Azure-Portal Ihre Logik-App-Ressource und den Workflow im Designer.

  2. Führen Sie im Designer diese allgemeinen Schritte aus, um Ihrem Workflow die EDIFACT-Aktion mit dem Namen In EDIFACT-Nachricht nach Vereinbarungsname codieren hinzuzufügen.

    Hinweis

    Wenn Sie stattdessen die Aktion In EDIFACT-Nachricht nach Identitäten codieren verwenden möchten, müssen Sie später andere Werte angeben, z. B. Absenderbezeichner und Empfängerbezeichner, der in Ihrer EDIFACT-Vereinbarung angegeben sind. Sie müssen auch die zu codierende XML-Nachrichtangeben, bei der es sich um die Ausgabe des Triggers oder einer vorherigen Aktion handeln kann.

  3. Geben Sie die folgenden Verbindungsinformationen für Ihr Integrationskonto an:

    Eigenschaft Erforderlich BESCHREIBUNG
    Verbindungsname Ja Ein Name für die Verbindung
    Integrationskonto Ja Wählen Sie in der Liste der verfügbaren Integrationskonten das Konto aus, das Sie nutzen möchten.

    Beispiel:

    Screenshot shows Azure portal, Consumption workflow, and connection box for action named Encode to EDIFACT message by agreement name.

  4. Wählen Sie Erstellen, wenn Sie fertig sind.

  5. Geben Sie in der EDIFACT-Aktion die folgenden Eigenschaftswerte an:

    Eigenschaft Erforderlich BESCHREIBUNG
    Name der EDIFACT-Vereinbarung Ja Die zu verwendende EDIFACT-Vereinbarung.
    Zu codierende XML-Nachricht Ja Der Geschäftsbezeichner für den Absender der Nachricht, wie in Ihrer EDIFACT-Vereinbarung angegeben
    Weitere Parameter Nein Dieser Vorgang enthält die folgenden anderen Parameter:

    - Datenelementtrennzeichen
    - Freigabeindikator
    - Komponententrennzeichen
    - Wiederholungstrennzeichen
    - Segmentabschlusszeichen
    - Segmentabschlusszeichensuffix
    - Dezimalindikator

    Weitere Informationen finden Sie unter EDIFACT-Nachrichteneinstellungen.

    Die zu codierenden XML-Nachrichtennutzlast kann z. B. die Ausgabe des Textkörperinhalts aus dem Anforderungstrigger sein:

    Screenshot shows Consumption workflow, action named Encode to EDIFACT message by agreement name, and message encoding properties.

  6. Speichern Sie den Workflow.

Decodieren von EDIFACT-Nachrichten

Die AKTION "EDIFACT verwalteter Connector" mit dem Namen "EDIFACT-Nachrichtenaktion decodieren" und die integrierte EDIFACT-Connectoraktion mit dem Namen EDIFACT Decode führt die folgenden Aufgaben aus, außer wenn in Einschränkungen und bekannten Problemen angegeben:

  • Überprüfen Sie den Umschlag anhand der Handelspartnervereinbarung.

  • Lösen Sie die Vereinbarung durch Abgleich von Senderqualifizierer und -bezeichner sowie von Empfängerqualifizierer und -bezeichner auf.

  • Teilen Sie einen Austausch in mehrere Transaktionssätze auf, wenn der Austausch entsprechend der Empfangseinstellungen der Vereinbarung mehr als eine Transaktion aufweist.

  • Disassemblieren des Austauschs

  • Überprüfen Sie EDI- (Electronic Data Interchange) und partnerspezifische Eigenschaften, z. B. die Struktur des Austauschumschlags, das Umschlagschema anhand des Kontrollschemas, das Schema für Transaktionssatz-Datenelemente anhand des Nachrichtenschemas und die erweiterte Überprüfung für Transaktionssatz-Datenelemente.

  • Stellen Sie sicher, dass die Steuerelementnummern für Austausch, Gruppe und Transaktion nicht dupliziert sind (nur verwalteter Connector), wenn sie konfiguriert sind, z. B.:

    • Gleicht die Austauschkontrollnummer mit zuvor empfangenen Austauschvorgängen ab.

    • Überprüfen Sie die Gruppenkontrollnummer anhand anderer Gruppenkontrollnummern im Austausch.

    • Überprüfen Sie die Transaktionssatz-Kontrollnummer anhand anderer Transaktionssatz-Kontrollnummern in dieser Gruppe.

  • Teilen Sie den Austausch in Transaktionssätze auf, oder bewahren Sie den gesamten Austausch (nur verwalteter Connector) auf, z. B.:

    • Trennen des Austauschs in Transaktionssätze – Transaktionssätze bei Fehler anhalten

      Die Decodierungsaktion trennt den Austausch in Transaktionssätze und analysiert die einzelnen Transaktionssätze. Die Aktion gibt nur die Transaktionssätze, die die Überprüfung nicht bestehen, in badMessages und die restlichen Transaktionssätze in goodMessages aus.

    • Trennen des Austauschs in Transaktionssätze – Austausch bei Fehler anhalten

      Die Decodierungsaktion trennt den Austausch in Transaktionssätze und analysiert die einzelnen Transaktionssätze. Wenn mindestens ein Transaktionssatz im Austausch die Überprüfung nicht besteht, gibt die Aktion alle Transaktionssätze in diesem Austausch in badMessages aus.

    • Austausch beibehalten – Transaktionssätze bei Fehler anhalten

      Die Decodierungsaktion behält den Austausch bei und verarbeitet den gesamten Batchaustausch. Die Aktion gibt nur die Transaktionssätze, die die Überprüfung nicht bestehen, in badMessages und die restlichen Transaktionssätze in goodMessages aus.

    • Austausch beibehalten – Austausch bei Fehler anhalten

      Die Decodierungsaktion behält den Austausch bei und verarbeitet den gesamten Batchaustausch. Wenn mindestens ein Transaktionssatz im Austausch die Überprüfung nicht besteht, gibt die Aktion alle Transaktionssätze in diesem Austausch in badMessages aus.

  • Generieren Sie eine technische Bestätigung, Funktionsbestätigung oder beides, sofern konfiguriert.

    • Eine technische Bestätigung oder die CONTRL-Bestätigung, die die Ergebnisse einer Syntaxüberprüfung des vollständig empfangenen Austauschs meldet.

    • Eine Funktionsbestätigung, die die Annahme oder Ablehnung für den empfangenen Austausch oder die empfangene Gruppe bestätigt.

  1. Öffnen Sie im Azure-Portal Ihre Logik-App-Ressource und den Workflow im Designer.

  2. Führen Sie im Designer diese allgemeinen Schritte aus, um Ihrem Workflow die EDIFACT-Aktion mit dem Namen EDIFACT-Nachricht decodieren hinzuzufügen.

  3. Geben Sie die folgenden Verbindungsinformationen für Ihr Integrationskonto an:

    Eigenschaft Erforderlich BESCHREIBUNG
    Verbindungsname Ja Ein Name für die Verbindung
    Integrationskonto Ja Wählen Sie in der Liste der verfügbaren Integrationskonten das Konto aus, das Sie nutzen möchten.

    Beispiel:

    Screenshot shows Consumption workflow designer and connection pane for the action named Decode EDIFACT message.

  4. Wählen Sie Erstellen, wenn Sie fertig sind.

  5. Geben Sie in der EDIFACT-Aktion die folgenden Eigenschaftswerte an:

    Eigenschaft Erforderlich BESCHREIBUNG
    Zu decodierende EDIFACT-Flatfilenachricht Ja Die zu decodierende XML-Flatfilenachricht.
    Weitere Parameter Nein Dieser Vorgang enthält die folgenden anderen Parameter:

    - Komponententrennzeichen
    - Datenelementtrennzeichen
    - Freigabeindikator
    - Wiederholungstrennzeichen
    - Segmentabschlusszeichen
    - Segmentabschlusszeichensuffix
    - Dezimalindikator
    - Nutzdatenzeichensatz
    - Segmentabschlusszeichensuffix
    - Austausch beibehalten
    - Austausch bei Fehler anhalten

    Weitere Informationen finden Sie unter EDIFACT-Nachrichteneinstellungen.

    Die zu decodierenden XML-Nachrichtennutzdaten können beispielsweise der Textteil der Inhaltsausgabe vom Anforderungstrigger sein:

    Screenshot shows Consumption workflow, action named Decode EDIFACT message, and message decoding properties.

Behandeln von UNH2.5-Segmenten in EDIFACT-Dokumenten

In einem EDIFACT-Dokument wird das UNH2.5-Segment für die Schemasuche verwendet. In der folgenden exemplarischen EDIFACT-Nachricht ist das UNH-Feld beispielsweise EAN008:

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

Führen Sie die folgenden Schritte aus, um ein EDIFACT-Dokument zu behandeln oder eine EDIFACT-Nachricht zu verarbeiten, das bzw. die über ein UN2.5-Segment verfügt:

  1. Aktualisieren Sie ein Schema, oder stellen Sie ein Schema bereit, das über den UNH2.5-Stammknotennamen verfügt.

    Angenommen, der Schemastammname für das exemplarische UNH-Feld lautet beispielsweise EFACT_D03B_ORDERS_EAN008. Für jedes Element vom Typ D03B_ORDERS, das über ein anderes UNH2.5-Segment verfügt, muss ein eigenes Schema bereitgestellt werden.

  2. Fügen Sie im Azure-Portal das Schema ihrer Integrationskontoressource oder Logik-App-Ressource hinzu, je nachdem, ob Sie über einen Verbrauchs- oder Standardlogik-App-Workflow verfügen.

  3. Laden Sie unabhängig davon, ob Sie die EDIFACT-Aktion für die Decodierung oder Codierung verwenden, Ihr Schema hoch, und richten Sie die Schemaeinstellungen in den Abschnitten Empfangseinstellungen bzw. Sendeeinstellungen Ihrer EDIFACT-Vereinbarung ein.

  4. Zur Bearbeitung Ihrer EDIFACT-Vereinbarung wählen Sie im Bereich Vereinbarungen Ihre Vereinbarung aus. Wählen Sie in der Symbolleiste des Bereichs Vereinbarungen die Option Als JSON bearbeiten aus.

    • Suchen Sie im Abschnitt receiveAgreement der Vereinbarung den Abschnitt schemaReferences, und fügen Sie den UNH2.5-Wert hinzu.

      Screenshot showing the Azure portal with an EDIFACT agreement's

    • Suchen Sie im Abschnitt sendAgreement der Vereinbarung den Abschnitt schemaReferences, und fügen Sie den UNH2.5-Wert hinzu.

      Screenshot showing the Azure portal with an EDIFACT agreement's

Nächste Schritte