Hinzufügen von Metadaten zum Suchen von B2B-Artefakten in Workflows für Azure Logic Apps

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

Damit Ihr Workflow während der Laufzeit schnell die richtigen Business-to-Business-Artefakte (B2B) finden kann, können Sie benutzerdefinierte Metadaten als Schlüssel-Wert-Paare zu Artefakten wie Handelspartnern, Vereinbarungen, Schemas und Karten hinzufügen. Benutzerdefinierte Metadaten für Artefakte helfen Ihnen, die folgenden Ziele oder Aufgaben zu erreichen:

• Erzwingen von Benennungskonventionen.
• Unterstützen Sie die Wiederverwendung und vermeiden Sie doppelte Definitionen.
• Leiten Sie Nutzlasten an die richtigen Codierungs- oder Decodierungsschritte weiter.
• Bieten Sie mehr Kontrolle über das Verschieben von Artefakten durch Entwicklung, Test und Produktion.
• Wenden Sie die richtige Überprüfung oder Transformation ohne hartcodierte Logik an.
• Erleichtern Sie Nachverfolgung, Rückverfolgbarkeit, Governance und Auditing.
• Vereinfachen Sie die Migration von BizTalk Server zu Azure Logic Apps.

In der folgenden Liste werden nützliche Metadaten anhand des Artefakttyps beschrieben:

Zur Nachverfolgung und Zuführung von B2B-Nachverfolgungstabellen oder Dashboards umfassen nützliche Metadaten Korrelationseigenschaften wie Austauschnummer, Gruppennummer, Transaktionssatz-ID sowie Workflowausführungs-ID, Partner- und Vereinbarungs-IDs, Status und Zeitstempel.

In diesem Handbuch wird gezeigt, wie Sie einem Artefakt in einem Integrationskonto Metadaten hinzufügen, das Artefakt mithilfe der integrierten Aktion " Integrationskonto " mit dem Namen "Artefaktsuche" des Integrationskontos suchen und auf die Artefaktmetadaten in Ihrem Workflow verweisen.

Voraussetzungen

• Ein Azure Konto und ein Abonnement. Erhalten Sie ein kostenloses Azure-Konto.

• Die Logik-App-Ressource und der Workflow, in der Sie die Artefaktmetadaten abrufen und verwenden möchten.

  Ihr Workflow kann mit jedem Trigger beginnen und benötigt eine Aktion, die nach dem Abruf mit den Metadaten funktioniert. In diesem Beispiel wird der Anforderungstrigger Wenn eine HTTP-Anforderung empfangen wird verwendet, der den Artefaktnamen aus einer eingehenden HTTPS-Anforderung dynamisch übergeben kann.

  Weitere Informationen finden Sie unter:

  • Erstellen eines Verbrauchsworkflows in Azure Logic Apps

  • Erstellen eines Standardworkflows in Azure Logic Apps

• Eine Ressource des Integrationskontos, die die Artefakte enthält, denen Sie Metadaten hinzufügen möchten.

  Sie können den folgenden Artefakten benutzerdefinierte Metadaten hinzufügen:

  • Partner
  • Vereinbarung
  • Schema
  • Landkarte

  Im Beispiel dieses Leitfadens wird ein Partnerartefakt namens TradingPartner1 verwendet.

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

  • Bevor Sie mit der Aktion Artefaktsuche im Integrationskonto arbeiten können, müssen Sie Ihre Logic App zum Verbrauch oder Ihre Logic App zum Standard mit dem Integrationskonto verlinken. Sie können ein Integrationskonto mit mehreren Ressourcen der Verbrauchs- oder Standardlogik-App verknüpfen, um dieselben Artefakte gemeinsam nutzen zu können.

Hinzufügen von Metadaten zu einem Artefakt

Führen Sie die folgenden Schritte aus, um benutzerdefinierte Metadaten für ein B2B-Artefakt in Ihrem Integrationskonto hinzuzufügen.

1. Wechseln Sie im Azure-Portal zu Ihrer Integrationskonto-Ressource.

2. Wählen Sie auf der Ressourcen-Randleiste unter "Einstellungen" die Artefaktkategorie aus.

   In diesem Beispiel werden metadaten zu einem Handelspartnerartefakt hinzugefügt. In diesem Szenario wählt das Beispiel " Partner" aus.

3. Wählen Sie auf der Artefaktkategorieseite das Artefakt und dann "Bearbeiten" aus.

   Das folgende Beispiel zeigt die Bearbeitungsseite für ein Partnerartefakt namens TradingPartner1.

   

4. Geben Sie unter "Metadaten" in den Spalten " Schlüssel " und " Wert " Ihre benutzerdefinierten Metadaten als Schlüsselwertpaar ein. Wählen Sie OK aus, wenn Sie fertig sind.

   Das folgende Beispiel zeigt Beispielmetadaten als Schlüsselwertpaare:

   

5. Um diese Metadaten in der JavaScript Object Notation (JSON)-Definition für das Artefakt anzuzeigen, wählen Sie neben "Bearbeiten" stattdessen "Als JSON bearbeiten" aus.

   

Suchen des Artefakts

Führen Sie die folgenden Schritte aus, um das Artefakt und die zugehörigen Metadaten in Ihrem Integrationskonto zu finden. Im Beispiel wird ein bestimmtes Handelspartnerartefakt abgerufen.

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

2. Führen Sie im Designer die folgenden allgemeinen Schritte aus, um die eingebaute Integrationskonto-Aktion namens „Integrationskonto-Artefakt-Suche“ hinzuzufügen, die das angegebene Artefakt und die Metadaten findet.

3. Geben Sie die folgenden Informationen für das Artefakt basierend auf Ihrem Workflowtyp an:

   Parameter	Erforderlich	Wert	Description
   - Verbrauch: artifactName - Standard: Artefaktname	Yes	< Artefaktname>	Der Artefaktname, den Sie als hartcodierten Namen oder als dynamische Ausgabe des Triggers oder der vorherigen Aktion im Workflow eingeben können.
   - Verbrauch: artifactType - Standard: Artefakttyp	Yes	Vereinbarung, Karte, Partner oder Schema	Der Artefakttyp.

   1. Führen Sie die folgenden Schritte aus, um den Artefaktnamen als Ausgabe des Triggers oder der vorherigen Aktion anzugeben:

      1. Wählen Sie im artifactName- oder Artifact name-Feld das Blitzsymbol aus, um die dynamische Inhaltsliste zu öffnen.

      2. Wählen Sie in der dynamischen Liste unter dem Trigger- oder Aktionsnamen die Ausgabe aus, die den Artefaktnamen angibt.

   2. Wählen Sie Artefakttyp oder Artefakttyp den Artefakttyp aus. In diesem Beispiel ist der Typ "Partner".

      

4. Speichern Sie den Workflow.

Referenzelementmetadaten im Workflow

Führen Sie die folgenden Schritte aus, um die abgerufenen Artefaktmetadaten in Ihrem Workflow zu verwenden. Im Beispiel wird auf die Metadaten aus dem abgerufenen Artefakt im vorherigen Abschnitt verwiesen.

1. Führen Sie im Designer unter der Aktion Artefaktsuche für das Integrationskonto die folgenden allgemeinen Schritte aus, um die gewünschte Aktion hinzuzufügen.

   In diesem Beispiel wird die integrierte HTTP-Aktion fortgesetzt, die eine HTTP-Anforderung vom Workflow an ein angegebenes Ziel sendet.

2. Geben Sie im Aktionsbereich Informationen dazu an, wie Sie die Artefaktmetadaten verwenden möchten.

   In diesem Beispiel werden die routingUrl Metadaten als HTTP-Anforderungsziel verwendet. In der folgenden Tabelle werden Beispielwerte für die HTTP-Aktion in diesem Beispiel angegeben:

   Parameter	Erforderlich	Wert	Description	Beispielwert
   URI	Yes	< ziel-URL>	Die Endpunkt-URL für die Stelle, an die Sie die Anforderung senden möchten.	Führen Sie die folgenden Schritte aus, um auf die Metadaten des routingUrl Partners zu verweisen: 1. Wählen Sie innerhalb des URI-Felds aus. 2. Wählen Sie das Funktionssymbol aus, um den Ausdrucks-Editor zu öffnen. 3. Geben Sie im Editor basierend auf Ihrem Workflowtyp einen Ausdruck wie das folgende Beispiel ein: Verbrauch outputs('Integration_Account_Artifact_Lookup')?['properties']?['metadata']['routingUrl'] Standard outputs('Integration_account_artifact_lookup')?['properties']?['metadata']['routingUrl'] 4. Wenn Sie fertig sind, wählen Sie "Hinzufügen" aus.
   Methode	Yes	< HTTP-Methode>	Der auszuführende HTTP-Vorgang.	In diesem Beispiel wird der GET-Vorgang verwendet.
   Headers	Nein	< Headerwerte>	Alle Header-Ausgaben des Triggers werden durch die HTTP-Aktion geleitet.	Führen Sie die folgenden Schritte für die erste Zeile unter Headers aus, um den Content-Type Wert aus dem Trigger-Header zu übergeben: In der ersten Spalte geben Sie Content-Type als Kopfzeilennamen ein. 2. Verwenden Sie in der zweiten Spalte den Ausdrucks-Editor, um den folgenden Ausdruck als Kopfzeilenwert einzugeben: triggeroutputs()?['headers']['Content-Type'] Um den Host Wert aus dem Header des Triggers unter Headers einzugeben, folgen Sie diesen Schritten für die zweite Zeile: In der ersten Spalte geben Sie Host als Kopfzeilennamen ein. 2. Verwenden Sie in der zweiten Spalte den Ausdrucks-Editor, um den folgenden Ausdruck als Kopfzeilenwert einzugeben: triggeroutputs()?['headers']['Host']
   Körper	Nein	< Textkörperinhalt>	Jeder andere Inhalt, der über die bodyEigenschaft der HTTP-Aktion übergeben wird.	Führen Sie die folgenden Schritte aus, um die Werte des Artefakts properties an die HTTP-Aktion zu übergeben: 1. Wählen Sie innerhalb des Feldes Body und wählen Sie dann das Symbol mit dem Blitz, um die Liste der dynamischen Inhalte zu öffnen. Wenn keine Ausgaben angezeigt werden, wählen Sie "Weitere Anzeigen" aus. 2. Wählen Sie in der Liste dynamischer Inhalte unter Integration-Kontoartefakt-Nachschlagen die Option Eigenschaften aus.

   Im Beispielszenario verwendet die HTTP-Aktion die folgenden Beispielwerte:

   

3. Um die Informationen in der HTTP-Aktion zu bestätigen, zeigen Sie die zugrunde liegende JSON-Definition des Workflows an. Wählen Sie auf der Designersymbolleiste die Codeansicht aus.

   Die zugrunde liegende JSON-Definition des Workflows wird beispielsweise angezeigt:

   

4. Kehren Sie zum Designer zurück. Wählen Sie auf der Codeansichtssymbolleiste "Designer" aus.

   Alle Ausdrücke, die Sie im Designer eingegeben haben, sind jetzt aufgelöst, zum Beispiel:

   

Verwandte Inhalte

• Hinzufügen von Vereinbarungen zwischen Partnern