Codieren und Decodieren von Flatfiles in Azure Logic Apps

Gilt für: Azure Logic Apps (Verbrauch + Standard)

Bevor Sie XML-Inhalt in einem B2B-Szenario (Business-to-Business) an einen Geschäftspartner senden, möchten Sie den Inhalt eventuell zuerst codieren. Wenn Sie codierten XML-Inhalt erhalten, müssen Sie diesen Inhalt zuerst decodieren. Wenn Sie einen Logik-App-Workflow in Azure Logic Apps erstellen, können Sie Flatfiles mithilfe der integrierten Flatfile-Connectoraktionen und eines Flatfile-Schemas für die Codierung und Decodierung codieren und decodieren. Sie können Flatfile-Aktionen in mehrinstanzenfähigen Verbrauchs-Logik-App-Workflows und Standard-Logik-App-Workflows mit Einzelinstanz verwenden.

Solange keine Flatfile-Trigger verfügbar sind, können Sie beliebige Trigger oder Aktionen verwenden, um den XML-Quellinhalt in Ihren Workflow zu übergeben. Sie können beispielsweise einen integrierten Connectortrigger, einen verwalteten oder von Azure gehosteten Connectortrigger, der für Azure Logic Apps verfügbar ist, oder sogar eine andere App verwenden.

In diesem Artikel wird gezeigt, wie Sie Ihrem Workflow die Flatfile-Aktionen für die Codierung und Decodierung hinzufügen.

• Fügen Sie Ihrem Workflow eine Flatfile-Codierungs- oder -Decodierungsaktion hinzu.
• Wählen Sie das gewünschte Schema aus.

Weitere Informationen finden Sie in der folgenden Dokumentation:

• Verbrauchs- und Standard-Logik-Apps
• Integrierte Connectors für Integrationskonten
• Übersicht über integrierte Connectors für Azure Logic Apps
• Verwaltete oder von Azure gehostete Connectors in Azure Logic Apps

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.

• Der Logik-App-Workflow (leer oder bereits vorhanden), in dem Sie die Flatfile-Aktion verwenden möchten.

  Wenn Sie über einen leeren Workflow verfügen, verwenden Sie einen beliebigen Trigger zum Starten des Workflows. In diesem Beispiel wird der Anforderungstrigger verwendet.

• Ihre Logik-App-Ressource und Ihr Workflow. Flatfile-Vorgänge beinhalten keine Trigger, sodass Ihr Workflow zumindest einen Trigger enthalten muss. Weitere Informationen finden Sie in der folgenden Dokumentation:

  • Erstellen eines Beispiels eines Verbrauchs-Logik-App-Workflows in Azure Logic Apps mit mehreren Mandanten

  • Erstellen eines Standard-Logik-App-Beispielworkflows in Azure Logic Apps für einen einzelnen Mandanten

• Das Flatfile-Schema, das zum Codieren und Decodieren des XML-Inhalts verwendet werden soll. Weitere Informationen finden Sie unter Hinzufügen von Schemas für die Verwendung mit Workflows in Azure Logic Apps .

• Basierend darauf, ob Sie einen Verbrauchs- oder Standard-Logik-App-Workflow erstellen, benötigen Sie eine Integrationskontoressource. Normalerweise benötigen Sie diese Ressource, wenn Sie Artefakte für die Verwendung in Unternehmensintegrations- und B2B-Workflows definieren und speichern möchten.

  Wichtig

  Für die Zusammenarbeit müssen sowohl Ihre Integrationskonto- als auch Ihre Logik-App-Ressource in demselben Azure-Abonnement und in derselben Azure-Region vorhanden sein.

  • Wenn Sie an einem Verbrauchs-Logik-App-Workflow arbeiten, muss Ihre Logik-App-Ressource mit Ihrem Integrationskonto verknüpft werden.

  • Wenn Sie an einem Standard-Logik-App-Workflow arbeiten, können Sie Ihre Logik-App-Ressource mit Ihrem Integrationskonto verknüpfen, Schemas direkt in Ihre Logik-App-Ressource hochladen oder beides, basierend auf den folgenden Szenarien:

    • Wenn Sie bereits über ein Integrationskonto mit den Artefakten verfügen, die Sie benötigen oder verwenden möchten, können Sie Ihr Integrationskonto mit mehreren Standard-Logik-App-Ressourcen verknüpfen, in denen Sie die Artefakte verwenden möchten. Auf diese Weise müssen Sie keine Schemas in die einzelnen Logik-Apps hochladen. Weitere Informationen finden Sie im Artikel zum Verknüpfen Ihrer Logik-App-Ressource mit Ihrem Integrationskonto.

    • Mit dem integrierten Flatfile-Connector können Sie ein Schema auswählen, das Sie zuvor in Ihre Logik-App-Ressource oder in ein verknüpftes Integrationskonto (aber nicht in beides), hochgeladen haben. Sie können dieses Artefakt anschließend in allen untergeordneten Workflows innerhalb derselben Logik-App-Ressource nutzen.

    Wenn Sie also kein Integrationskonto haben oder benötigen, können Sie die Uploadoption verwenden. Andernfalls können Sie die Verknüpfungsoption verwenden. In beiden Fällen können Sie diese Artefakte in allen untergeordneten Workflows innerhalb derselben Logik-App-Ressource verwenden.

• Installieren oder verwenden Sie ein Tool, das HTTP-Anforderungen senden kann, um Ihre Lösung zu testen, z. B.:

  • Visual Studio Code mit einer Erweiterung von Visual Studio Marketplace
  • PowerShell Invoke-RestMethod
  • Microsoft Edge – Netzwerkkonsolentool
  • Bruno
  • curl

  Achtung

  Für Szenarien, in denen Sie über vertrauliche Daten wie Anmeldeinformationen, Geheimnisse, Zugriffstoken, API-Schlüssel und andere ähnliche Informationen verfügen, sollten Sie ein Tool verwenden, das Ihre Daten mit den erforderlichen Sicherheitsfunktionen schützt, offline oder lokal funktioniert, Ihre Daten nicht mit der Cloud synchronisiert und keine Anmeldung bei einem Onlinekonto erfordert. Auf diese Weise verringern Sie das Risiko, dass vertrauliche Daten an die Öffentlichkeit gelangen.

Begrenzungen

• XML-Inhalte, die Sie decodieren möchten, müssen im UTF-8-Format codiert werden.

• Vergewissern Sie sich in Ihrem Flatfile-Schema, dass in den enthaltenen XML-Gruppen die max count-Eigenschaft nicht zu häufig auf einen Wert größer als 1 festgelegt ist. Vermeiden Sie die Verschachtelung einer XML-Gruppe mit einem max count Eigenschaftswert größer als 1 innerhalb einer anderen XML-Gruppe mit einer max count Eigenschaft größer als 1.

• Bei jedem Parsen des Flatfile-Schemas durch Azure Logic Apps und immer, wenn das Schema die Wahl des nächsten Fragments zulässt, generiert Azure Logic Apps ein Symbol und eine Vorhersage für dieses Fragment. Wenn das Schema zu viele solche Konstrukte zulässt, z. B. mehr als 100.000, wird die Schemaerweiterung übermäßig groß, was zu viel Ressourcen und Zeit verbraucht.

Schema hochladen

Nachdem Sie Ihr Schema erstellt haben, müssen Sie nun das Schema basierend auf dem folgenden Szenario hochladen:

• Wenn Sie an einem Verbrauchs-Logik-App-Workflow arbeiten, fügen Sie Ihr Schema zu Ihrem Integrationskonto hinzu.

• Wenn Sie an einem Standard-Logik-App-Workflow arbeiten, können Sie Ihr Schema Ihrem Integrationskonto hinzufügen oder Ihr Schema zu Ihrer Logik-App-Ressource hinzufügen.

Hinzufügen einer Flatfile-Codierungsaktion

Hinzufügen einer Flatfile-Decodierungsaktion

Das Einrichten der Aktion „Flatfile decodieren“ ist damit abgeschlossen. In einer echten App empfiehlt es sich ggf., die decodierten Daten in einer branchenspezifischen App wie Salesforce zu speichern. Sie können die decodierten Daten auch an einen Handelspartner senden. Um die Ausgabe der Decodieraktion an Salesforce oder Ihren Handelspartner zu senden, verwenden Sie die anderen in Azure Logic Apps verfügbaren Connectors:

• Integrierte Trigger und Aktionen für Azure Logic Apps
• Integrierte Connectors für Azure Logic Apps

Testen Ihres Workflows

Führen Sie die folgenden Schritte aus, um Ihren Workflow auszulösen:

1. Suchen Sie im Trigger Anforderung die Eigenschaft HTTP POST URL, und kopieren Sie die URL.

2. Öffnen Sie Ihr HTTP-Anforderungstool, und verwenden Sie dessen Anweisungen, um eine HTTP-Anforderung an die kopierte URL zu senden, einschließlich der Methode, die der Trigger Anforderung erwartet.

   In diesem Beispiel wird die Methode POST mit der URL verwendet.

3. Schließen Sie den XML-Inhalt ein, den Sie im Anforderungstext codieren oder decodieren möchten.

4. Nach Abschluss der Ausführung Ihres Workflows wechseln Sie zum Ausführungsverlauf des Workflows, und untersuchen Sie die Ein- und Ausgaben der Flatfile-Aktion.

Nächste Schritte

• Weitere Informationen zum Enterprise Integration Pack