Hinzufügen von Zuordnungen für Transformationen in Workflows mit Azure Logic Apps

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

Workflowaktionen wie XML transformieren und Liquid erfordern eine Zuordnung, damit die Aufgaben ausgeführt werden können. Die Aktion XML transformieren erfordert beispielsweise eine Zuordnung zum Konvertieren von XML zwischen Formaten. Eine Kartendatei ist ein XML-Dokument, das beschreibt, wie Daten aus XML in ein anderes Format konvertiert werden. Der Karteninhalt enthält das XML-Quellschema als Eingabe und ein XML-Zielschema als Ausgabe. Sie können eine einfache Transformation definieren, z.B. das Kopieren eines Namens und einer Adresse von einem Dokument in ein anderes. Oder Sie können mithilfe der standardmäßigen Zuordnungsvorgänge komplexere Transformationen erstellen. Sie können Daten mit Hilfe verschiedener integrierter Funktionen manipulieren oder steuern, z.B. mit String-Manipulationen, bedingten Zuweisungen, arithmetischen Ausdrücken, Datums- und Zeitformatierungen und sogar Schleifenkonstrukten.

Stellen Sie sich beispielsweise vor, dass Sie regelmäßige B2B-Aufträge oder -Rechnungen von einem Kunden erhalten, der das Format „YearMonthDay“ (JahrMonatTag, JJJJMMTT) für Datumsangaben verwendet. Ihre Organisation verwendet jedoch das Datumsformat „MonthDayYear“ (MonatTagJahr,MMTTJJJJ). Mithilfe einer Zuordnung können Sie das Format JJJJMMTT in das Format MMTTJJJJ transformieren, bevor Auftrags- oder Rechnungsdetails in Ihrer Kundenaktivitätsdatenbank gespeichert werden.

In diesem Leitfaden wird gezeigt, wie Sie Ihrem Workflow eine Zuordnung hinzufügen. Sie können Ihrem verknüpften Integrationskonto Zuordnungen hinzufügen, oder Sie können Ihrer Logik-App-Ressource Zuordnungen direkt hinzufügen, wenn Sie über eine Standard-Logik-App verfügen.

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.

• Die Karte, die Sie hochladen möchten.

  • Verbrauchsworkflows unterstützen die folgenden Kartentypen: Liquid, XSLT, XSLT 2.0, XSLT 3.0 oder HIDX.

  • Standard Workflows unterstützen die folgenden Kartentypen: XSLT, XSLT 2.0 und XSLT 3.0.

  • Um Zuordnungen zu erstellen, können Sie eines der folgenden Tools verwenden:

    • Visual Studio Code und die Datenmapper-Erweiterung. Um die mit dem Datenmapper erstellten Zuordnungen über Ihren Workflow aufzurufen, müssen Sie die Aktion für Datenmappervorgänge mit dem Namen Mithilfe von Datenmapper-XSLT tranformieren und nicht die Aktion für XML-Vorgänge mit dem Namen XML transformieren verwenden. Weitere Informationen finden Sie unter Create maps to transform data in Azure Logic Apps with Visual Studio Code (preview) (Erstellen von Zuordnungen zum Transformieren von Daten in Azure Logic Apps mit Visual Studio Code (Vorschau)).

    • Visual Studio 2019 und die Erweiterung „Microsoft Azure Logic Apps Enterprise Integration Tools“

      Hinweis

      Installieren Sie die Erweiterung „Microsoft Azure Logic Apps Enterprise Integration Tools“ nicht zusammen mit der BizTalk Server-Erweiterung. Sind beide Erweiterungen installiert, kann dies zu unerwartetem Verhalten führen. Stellen Sie sicher, dass nur eine dieser Erweiterungen installiert ist.

      Auf Monitoren mit hoher Auflösung kann ein Anzeigeproblem des Zuordnungs-Designers in Visual Studio auftreten. Um dieses Anzeigeproblem zu beheben, starten Sie Visual Studio im nicht DPI-fähigen Modus neu, oder fügen Sie den DPIUNAWARE-Registrierungswert hinzu.

      Weitere Informationen finden Sie im Abschnitt Erstellen von Zuordnungen in diesem Artikel.

• Je nachdem, ob Sie an einem Logik-App-Workflow des Typs „Verbrauch“ oder „Standard“ arbeiten, 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 im selben Azure-Abonnement und in derselben Azure-Region vorliegen.

  • Für einen App-Workflow der Verbrauchslogik benötigen Sie ein Integrationskonto, das mit Ihrer Logik-App-Ressource verknüpft ist.

  • Bei einem Standard-Logik-App-Workflow können Sie Ihr Integrationskonto mit Ihrer Logik-App-Ressource verknüpfen, Zuordnungen direkt zu Ihrer Logik-App-Ressource hochladen, oder beides tun, basierend auf den folgenden Szenarien:

    • Wenn Sie bereits über ein Integrationskonto mit den benötigten oder zu verwendenden Artefakten verfügen, können Sie dieses mit mehreren Standard-Logik-App-Ressourcen verknüpfen, in denen Sie die Artefakte verwenden möchten. Auf diese Weise müssen Sie keine Zuordnungen 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 Liquid-Connector können Sie eine Zuordnung auswählen, die Sie zuvor in Ihre Logik-App-Ressource oder in ein verknüpftes Integrationskonto (aber nicht in beides), hochgeladen haben.

    Wenn Sie also über kein Integrationskonto verfügen 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 nutzen.

• Verwendungs- und Standardworkflows unterstützen Maps, die auf externe Assemblies verweisen und so das direkte Aufrufen von benutzerdefiniertem .NET-Code aus Maps ermöglichen. Um diese Funktion zu unterstützen, gelten für Verbrauchsworkflows auch folgende Anforderungen:

  • Sie benötigen eine 64-Bit-Assembly. Der Transformationsdienst führt einen 64-Bit-Prozess aus, deshalb werden 32-Bit-Assemblys nicht unterstützt. Wenn Ihr Quellcode für eine 32-Bit-Assembly vorgesehen ist, kompilieren Sie den Code erneut in eine 64-Bit-Assembly. Wenn Sie nicht über den Quellcode verfügen, aber die Binärdatei von einem anderen Anbieter erhalten haben, rufen Sie die 64-Bit-Version von diesem Anbieter ab. Einige Anbieter stellen beispielsweise Assemblys in Paketen bereit, die sowohl 32-Bit- als auch 64-Bit-Versionen enthalten. Wenn es die Option gibt, verwenden Sie stattdessen die 64-Bit-Version.

  • Sie müssen sowohl die Assembly als auch die Zuordnung in einer bestimmten Reihenfolge in Ihr Integrationskonto hochladen. Stellen Sie sicher, dass Sie zuerst Ihre Assembly hochladen und dann die Zuordnung, die auf die Assembly verweist, hochladen.

  • Wenn Ihre Assembly oder Zuordnung 2 MB oder kleiner ist, können Sie die Assembly bzw. Zuordnung Ihrem Integrationskonto direkt über das Azure-Portal hinzufügen.

  • Wenn Ihre Assembly größer als 2 MB ist, aber die Größenbeschränkung für Assemblys nicht überschreitet, benötigen Sie ein Azure-Speicherkonto und einen Blobcontainer, in den Sie die Assembly hochladen können. Den Speicherort dieses Containers können Sie später bereitstellen, wenn Sie die Assembly Ihrem Integrationskonto hinzufügen. In der folgenden Tabelle werden die für diese Aufgabe benötigten Elemente beschrieben:

    Element	BESCHREIBUNG
    Azure-Speicherkonto	Unter diesem Konto erstellen Sie einen Azure-Blobcontainer für Ihre Assembly. Hier erfahren Sie, wie Sie ein Speicherkonto erstellen.
    BLOB-Container	In diesen Container können Sie Ihre Assembly hochladen. Außerdem benötigen Sie den Inhalts-URI und Speicherort dieses Containers, wenn Sie die Assembly Ihrem Integrationskonto hinzufügen. Hier erfahren Sie, wie Sie einen Blobcontainer erstellen.
    Azure Storage-Explorer	Mit diesem Tool lassen sich Speicherkonten und Blobcontainer einfacher verwalten. Um den Speicher-Explorer zu verwenden, laden Sie den Azure Storage-Explorer herunter, und installieren Sie den Azure Storage-Explorer lokal. Verbinden Sie dann den Storage-Explorer mit Ihrem Speicherkonto, indem Sie die Schritte unter Erste Schritte mit dem Storage-Explorer ausführen. Weitere Informationen finden Sie in der Schnellstartanleitung: Erstellen eines Blobs im Objektspeicher mit Dem Azure Storage-Explorer.

    Größere Zuordnungen können Sie mit Azure Logic Apps-REST-API – Zuordnungen hinzufügen. Für Standardworkflows ist die Azure Logic Apps-REST-API derzeit nicht verfügbar.

Einschränkungen

• Für die Anzahl von Artefakten – wie z. B. Zuordnungen – gelten Grenzwerte pro Integrationskonto. Weitere Informationen finden Sie unter Grenzwerte und Konfigurationsinformationen für Azure Logic Apps.

• Je nachdem, ob Sie mit einem Workflow für Verbrauchs- oder Standard-Logik-Apps arbeiten, gelten die folgenden Einschränkungen:

  • Verbrauchsworkflows

    • Azure Logic Apps ordnet begrenzten Arbeitsspeicher für die Verarbeitung von XML-Transformationen zu. Wenn Sie Verbrauchsworkflows erstellen und Ihre Zuordnungs- oder Payloadtransformationen einen höheren Arbeitsspeicherverbrauch aufweisen, können diese Transformationen möglicherweise nicht erfolgreich ausgeführt werden, wodurch Arbeitsspeicherfehler auftreten. Um dieses Szenario zu vermeiden, sollten Sie die folgenden Optionen in Betracht ziehen:

      • Bearbeiten Sie Ihre Zuordnungen oder Nutzdaten, um den Arbeitsspeicherverbrauch zu senken.

      • Erstellen Sie Standard-Logik-App-Workflows, die in einer Azure Logic Apps-Instanz für nur einen Mandanten ausgeführt werden und dedizierte und flexible Optionen für Compute- und Arbeitsspeicherressourcen bieten.

  • Standard-Workflows unterstützen weniger Kartentypen als Verbrauchs-Workflows, jedoch gibt es keine Beschränkungen für die Kartendateigrößen. Weitere Informationen finden Sie unter Voraussetzungen.

Erstellen von Zuordnungen

Sie können Zuordnungen entweder mit Visual Studio Code mit der Datenmappererweiterung oder mit Visual Studio mit der Erweiterung „Microsoft Azure Logic Apps Enterprise Integration Tools“ erstellen.

Visual Studio Code

Wenn Sie Zuordnungen mithilfe von Visual Studio Code und der Datenmappererweiterung erstellen, können Sie diese Zuordnungen aus Ihrem Workflow aufrufen, jedoch nur mit der Aktion für Datenmappervorgänge mit dem Namen Mithilfe von Datenmapper-XSLT transformieren , nicht mit der Aktion für XML-Vorgänge namens XML transformieren. Weitere Informationen finden Sie unter Create maps to transform data in Azure Logic Apps with Visual Studio Code (preview) (Erstellen von Zuordnungen zum Transformieren von Daten in Azure Logic Apps mit Visual Studio Code (Vorschau)).

Visual Studio

Wenn Sie Zuordnungen mit Visual Studio erstellen, müssen Sie ein Integrationsprojekt mit Visual Studio 2019 und der Erweiterung „Microsoft Azure Logic Apps Enterprise Integration Tools“ erstellen.

Im Integrationsprojekt können Sie eine Integrationszuordnungsdatei erstellen, mit deren Hilfe Sie Elemente zwischen zwei XML-Schemadateien visuell zuordnen können. Diese Tools bieten die folgenden Zuordnungsfunktionen:

• Sie arbeiten mit einer grafischen Darstellung der Zuordnung, die alle erstellten Beziehungen und Links anzeigt.

• Sie können eine direkte Datenkopie zwischen den XML-Schemata erstellen, die Sie zur Erstellung der Zuordnung verwenden. Das Unternehmensintegrations-SDK für Visual Studio enthält einen Mapper, mit dem diese Aufgabe so einfach wie das Zeichnen einer Linie ist, die die Elemente im XML-Quellschema mit ihren Gegenstücken im XML-Zielschema verbindet.

• Vorgänge oder Funktionen für mehrere Zuordnungen sind verfügbar, einschließlich Zeichenfolgenfunktionen, Datums-/Uhrzeitfunktionen usw.

• Um eine XML-Beispielnachricht hinzuzufügen, können Sie die Zuordnungstestfunktion verwenden. Mit nur einem Klick können Sie die erstellte Zuordnung testen und die erstellte Ausgabe überprüfen.

• Nachdem Sie Ihr Projekt erstellt haben, verfügen Sie über ein XSLT-Dokument.

Ihre Zuordnung muss über die folgenden Attribute und einen CDATA-Abschnitt verfügen, der den Aufruf des Assemblycodes enthält:

• name ist der Name der benutzerdefinierten Assembly.

• namespace ist der Namespace in Ihrer Assembly, der den benutzerdefinierten Code enthält.

Das folgende Beispiel enthält eine Zuordnung, in der auf eine Assembly mit dem Namen XslUtilitiesLib verwiesen und die circumference-Methode der Assembly aufgerufen wird.

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
<msxsl:script language="C#" implements-prefix="user">
    <msxsl:assembly name="XsltHelperLib"/>
    <msxsl:using namespace="XsltHelpers"/>
    <![CDATA[public double circumference(int radius){ XsltHelper helper = new XsltHelper(); return helper.circumference(radius); }]]>
</msxsl:script>
<xsl:template match="data">
<circles>
    <xsl:for-each select="circle">
        <circle>
            <xsl:copy-of select="node()"/>
                <circumference>
                    <xsl:value-of select="user:circumference(radius)"/>
                </circumference>
        </circle>
    </xsl:for-each>
</circles>
</xsl:template>
</xsl:stylesheet>

Hinzufügen referenzierter Assemblys

Hinzufügen von Zuordnungen

• Wenn Sie mit einem Verbrauchsworkflow arbeiten, müssen Sie Ihre Zuordnung zu einem verknüpften Integrationskonto hinzufügen.

• Wenn Sie mit einem Standardworkflow arbeiten, haben Sie die folgenden Optionen:

  • Fügen Sie Ihre Zuordnung zu einem verknüpften Integrationskonto hinzu. Sie können die Zuordnung und das Integrationskonto für mehrere Standard-Logik-App-Ressourcen und deren untergeordnete Workflows freigeben.

  • Fügen Sie Ihre Zuordnung direkt zu Ihrer Logik-App-Ressource hinzu. Sie können diese Zuordnung jedoch nur für untergeordnete Workflows in derselben Logik-App-Ressource freigeben.

Hinzufügen einer Zuordnung zum Integrationskonto

1. Melden Sie sich beim Azure-Portal mit den Anmeldeinformationen Ihres Azure-Kontos an.

2. Geben Sie im Azure-Portal im Suchfeld Integrationskonten ein, und wählen Sie den Eintrag Integrationskonten aus.

3. Suchen Sie Ihr Integrationskonto, und wählen Sie es aus.

4. Wählen Sie im Menü "Integrationskonto" unter "Einstellungen" die Option "Karten" aus.

5. Wählen Sie auf der Symbolleiste der Seite "Karten"die Option "Hinzufügen" aus.

Bei Verbrauchsworkflows befolgen Sie nun je nach Dateigröße der Zuordnung die Schritte zum Hochladen einer Zuordnung, die entweder bis zu 2 MB oder mehr als 2 MB groß ist.

Hinzufügen von Zuordnungen bis zu 2 MB

1. Geben Sie im Bereich Zuordnung hinzufügen einen eindeutigen Namen für Ihre Zuordnung ein.

2. Wählen Sie unter "Zuordnungstyp" den Typ aus, z. B. Liquid, XSLT, XSLT 2.0, XSLT 3.0 oder HIDX.

3. Wählen Sie neben dem Feld Zuordnung das Ordnersymbol aus. Wählen Sie die hochzuladende Karte und dann "Öffnen" aus.

   Wenn die Name-Eigenschaft nicht angegeben wurde, wird der Dateiname der Zuordnung als Eigenschaftswert angezeigt, nachdem Sie die Zuordnungsdatei ausgewählt haben.

4. Wenn Sie fertig sind, wählen Sie OK.

   Nachdem der Upload Ihrer Zuordnungsdatei abgeschlossen ist, wird die Zuordnung in der Liste Zuordnungen angezeigt. Wenn die Karte nicht angezeigt wird, wählen Sie auf der Symbolleiste "Karten " die Option "Aktualisieren" aus. Auf der Seite "Übersicht" ihres Integrationskontos wird unter Artefakte auch Ihre hochgeladene Karte angezeigt.

Hinzufügen von Zuordnungen mit mehr als 2 MB

Um größere Zuordnungen für Verbrauchsworkflows hinzuzufügen, verwenden Sie Azure Logic Apps-REST-API – Zuordnungen.

Hinzufügen einer Zuordnung zu einer Standard-Logik-App-Ressource

Die folgenden Schritte gelten nur, wenn Sie Ihrer Standard-Logik-App-Ressource direkt eine Zuordnung hinzufügen möchten. Andernfalls fügen Sie die Zuordnung zu Ihrem Integrationskonto hinzu.

Azure-Portal

1. Wählen Sie im Menü "Logik-App" unter " Artefakte" die Option "Karten" aus.

2. Wählen Sie auf der Symbolleiste der Seite "Karten"die Option "Hinzufügen" aus.

3. Geben Sie im Bereich "Karte hinzufügen " einen eindeutigen Namen für Ihre Karte ein, und schließen Sie die Dateierweiterung ein, z. B. XSLT, HIDX oder LIQUID.

4. Wählen Sie neben dem Feld Zuordnung das Ordnersymbol aus. Wählen Sie die hochzuladende Zuordnung aus.

5. Wenn Sie fertig sind, wählen Sie OK.

   Nachdem der Upload Ihrer Zuordnungsdatei abgeschlossen ist, wird die Zuordnung in der Liste Zuordnungen angezeigt. Auf der Seite Übersicht Ihres Integrationskontos wird unter Artefakte ebenfalls Ihre hochgeladene Zuordnung angezeigt.

Visual Studio Code

1. Wechseln Sie auf Ihrem Computer zum lokalen Ordner Ihres Projekts, und erweitern Sie die folgenden Ordner: Artifacts>Maps.

2. Fügen Sie im Ordner "Karten" Ihre Kartendatei hinzu.

3. Kehren Sie zu Visual Studio Code zurück.

   Ihre Kartendatei wird nun in Ihrem Projekt angezeigt, z. B.:

   

Bearbeiten von einer Zuordnung

Wenn Sie eine vorhandene Zuordnung aktualisieren möchten, müssen Sie eine neue Zuordnungsdatei hochladen, die über die gewünschten Änderungen verfügt. Allerdings können Sie zuerst die vorhandene Zuordnung zum Bearbeiten herunterladen.

Löschen von einer Zuordnung

Verwandte Inhalte

• Transformieren von XML für Workflows in Azure Logic Apps
• Überprüfen von XML für Workflows in Azure Logic Apps