Freigeben über


Erstellen Sie Zuordnungen zum Transformieren von Daten in Logik-App-Workflows mit Visual Studio Code

Gilt für: Azure Logic Apps (Standard)

Wenn Sie Nachrichten austauschen, die unterschiedliche XML- oder JSON-Formate in einem Logik-App-Workflow verwenden, müssen Sie angeben, wie die Daten aus dem Quellformat in das Zielformat transformiert konvertiert werden, zum Beispiel zwischen XML-Dokumenten oder zwischen JSON-Dokumenten. Diese Aufgabe ist besonders dann wichtig, wenn Sie Lücken zwischen den Datenstrukturen in den Quell- und Zielschemas haben. Ein Schema beschreibt die Datenelemente, Attribute und Datentypen in einem XML- oder JSON-Dokument.

Um Transformationen zwischen Datenstrukturen und Lücken zu definieren, können Sie eine Zuordnung (XSLT-Datei) erstellen, die die Beziehungen zwischen den Datenelementen in den Quell- und Zielschemas angibt. Sie können eine Zuordnung visuell erstellen oder bearbeiten, indem Sie Visual Studio Code mit der Azure Logic Apps (Standard)-Erweiterung im Kontext eines Standardlogik-App-Projekts verwenden. Das Data Mapper-Tool bietet eine einheitliche Oberfläche für die Zuordnung und Transformation mithilfe von Zieh- und Dropgesten, vordefinierten Funktionen zum Erstellen von Ausdrücken und eine Möglichkeit zum manuellen Testen von Karten, bevor Sie sie in Ihren Workflows verwenden.

Nachdem Sie Ihre Karte erstellt haben, können Sie diese Karte direkt aus einem Workflow in Ihrem Logik-App-Projekt oder aus einem Standardlogik-App-Workflow im Azure-Portal aufrufen. Für diese Aufgabe können Sie die Aktion Data Mapper Operations (Data Mapper-Vorgänge) namens Transform using Data Mapper XSLT (Mit Data Mapper XSLT transformieren) in Ihrem Workflow verwenden.

In dieser Anleitung wird gezeigt, wie Sie eine leere Datenzuordnung erstellen, Ihre Quell- und Zielschemas auswählen, verschiedene Arten von Zuordnungen zwischen Schemaelementen erstellen, Ihre Karte speichern und testen und dann die Karte aus einem Workflow in Ihrem Logik-App-Projekt aufrufen.

Einschränkungen und bekannte Probleme

  • Data Mapper funktioniert derzeit nur in Visual Studio Code auf Windows-Betriebssystemen.

  • Data Mapper ist derzeit nur in Visual Studio Code und nicht über das Azure-Portal verfügbar und wird nur innerhalb von Logik-App-Projekten im Tarif „Standard“ bereitgestellt, aber nicht in Logik-App-Projekten im Tarif „Verbrauch“.

  • Data Mapper unterstützt derzeit keine Schemas, die das Durch Trennzeichen getrennte Werte (.csv)-Dateiformat verwenden.

  • Der Codebereich in Data Mapper ist zurzeit schreibgeschützt.

  • Die Layout- und Elementpositionen in Data Mapper sind derzeit automatisch und schreibgeschützt.

  • Die Filterfunktion verarbeitet ordnungsgemäß numerische Bedingungen, die durch doppelte Anführungszeichen eingeschlossen werden, zum Beispiel ">=10". Diese Funktion verhält sich derzeit jedoch nicht konsistent für Zeichenfolgenvergleiche, zum Beispiel eine Überprüfung, ob ein Elementname "= 'Pen'"ist.

  • Wenn Sie eine Zuordnung zwischen den übergeordneten Arrayelementen in den Quell- und Zielschemas erstellen, fügt der Mapper automatisch eine Schleife zum Durchlaufen der Arrayelementelemente hinzu. Sie müssen jedoch weiterhin explizit Zuordnungen zwischen quell- und Zielarrayelementelementen erstellen.

  • Zum Aufrufen von Zuordnungen, die mit Data Mapper erstellt wurden, können Sie nur die Data Mapper Operations Aktion namens Transformieren mithilfe von Data Mapper XSLT-verwenden. Verwenden Sie für Zuordnungen, die mit einem anderen Tool erstellt wurden, die Aktion der XML Operations (XML-Vorgänge) mit dem Namen Transform XML (XML transformieren).

  • Um die Zuordnungen zu verwenden, die Sie mit Data Mapper mit Workflows im Azure-Portal erstellen, müssen Sie sie direkt zu Ihrer Standardlogik-App-Ressourcehinzufügen.

  • Benutzerdefinierte Funktionen werden in dieser Version derzeit nicht unterstützt.

Voraussetzungen

  • Visual Studio Code und die Erweiterung „Azure Logic Apps (Standard)“ zum Erstellen von Logik-App-Workflows im Tarif „Standard“.

    Hinweis

    Die vorherige separate Data Mapper-Erweiterung wurde mit der Erweiterung „Azure Logic Apps (Standard)“ zusammengeführt. Um Konflikte zu vermeiden, werden alle ggf. vorhandenen Versionen der Data Mapper-Erweiterung entfernt, wenn Sie die Erweiterung „Azure Logic Apps (Standard)“ installieren oder aktualisieren. Starten Sie Visual Studio Code nach der Installation oder Aktualisierung der Erweiterung neu.

  • Die Quell- und Zielschemadateien, die die zu transformierenden Datentypen beschreiben. Diese Dateien können die folgenden Formate aufweisen:

    • Eine XML-Schemadefinitionsdatei mit der XSD-Dateierweiterung
    • Eine JavaScript Object Notation-Datei mit der JSON-Dateierweiterung
  • Ein Logik-App-Projekt im Tarif „Standard“, das einen zustandsbehafteten oder zustandslosen Workflow mit mindestens einem Auslöser enthält. Wenn Sie über kein Projekt verfügen, führen Sie die folgenden Schritte in Visual Studio Code aus:

    1. Stellen Sie eine Verbindung mit Ihrem Azure-Konto her, sofern Sie diesen Schritt noch nicht ausgeführt haben.

    2. Erstellen Sie einen lokalen Ordner, ein lokales Logik-App-Projekt im Tarif „Standard“ und einen zustandsbehafteten oder zustandslosen Workflow. Wählen Sie während der Workflowerstellung Open in current window (Im aktuellen Fenster öffnen) aus.

  • Beispieleingabedaten, wenn Sie die Zuordnung testen und überprüfen möchten, ob die Transformation erwartungsgemäß funktioniert.

  • Um die Funktion XSLT ausführen verwenden zu können, müssen sich Ihre XSLT-Codeschnipsel in Dateien mit der Erweiterung .xml oder .xslt befinden. Sie müssen Ihre XSLT-Codeschnipsel in der lokalen Projektordnerstruktur im Ordner InlineXslt platzieren: Artifacts>DataMapper>Extensions>InlineXslt. Sollte diese Ordnerstruktur nicht vorhanden sein, erstellen Sie die fehlenden Ordner.

Erstellen einer Datenzuordnung

  1. Öffnen Sie in Visual Studio Code den Ordner für Ihr Standardlogik-App-Projekt.

  2. Wählen Sie im Visual Studio Code-Menü auf der linken Seite das Azure-Symbol aus.

  3. Wählen Sie im Fenster Azure unter Data Mapper-"Datenzuordnung erstellen"aus.

    Screenshot zeigt Visual Studio Code mit Azure-Fenster und ausgewählter Schaltfläche zum Erstellen einer Datenzuordnung.

    Auf der Titelleiste von Visual Studio Code wird ein Eingabeaufforderungsfeld geöffnet, sodass Sie einen Namen für Ihre Karte angeben können.

  4. Geben Sie im Eingabeaufforderungsfeld einen Datenzuordnungsnamen ein.

    Für diese Anleitung verwenden sie den Namen Example-data-map.

    Screenshot des Eingabeaufforderungsfelds und des Beispielnamens der Datenzuordnung.

    Der Data Mapper erstellt und öffnet eine leere Datenzuordnung.

  5. Wählen Sie Ihr Quell- und Zielschema aus, indem Sie die folgenden Schritte ausführen:

    1. Wählen Sie im Bereich Quelle"Neue>Durchsuchen hinzufügen" aus, um das Quellschema zu suchen und hochzuladen.

      Screenshot zeigt den Bereich

      Nachdem Sie Das Quellschema hinzugefügt haben, füllt der Bereich "Quelle " das XML-Element "Knoten" für die Datentypen im Quellschema auf, zum Beispiel:

      Screenshot zeigt den Bereich

    2. Wählen Sie im Bereich ZielNeuen>durchsuchen aus, um Ihr Zielschema zu suchen und hochzuladen.

      Screenshot zeigt den Bereich

      Nachdem Sie das Zielschema hinzugefügt haben, füllt der Zielbereich das XML-Element "Knoten" für die Datentypen im Zielschema auf, zum Beispiel:

      Screenshot zeigt den Bereich

Tipp

Wenn beim Laden Ihrer Schemas Probleme auftreten, können Sie die Quell- und Zielschemadateien lokal zum Artefakte/Ordner Ihres Logik-App-Projekts hinzufügen. Öffnen Sie in diesem Szenario zum Angeben des Quell- und Zielschemas in "Data Mapper" in den Bereichen "Quelle " und "Ziel" die liste "Vorhandene auswählen", anstatt "Neuehinzufügen" zu verwenden, und wählen Sie ihr Schema aus.

Datentypen des Schemas

In der folgenden Tabelle werden die möglichen Datentypen beschrieben, die in einem Schema angezeigt werden können:

Symbol Typ Weitere Informationen
Symbol zur Darstellung eines Arraydatentyps Komplex (Array) Enthält Elemente oder wiederholte Elementknoten.

Ein Arrayelement zeigt auch den folgenden Verbindungspunkt an:

Symbol für Arrayelementverbindungspunkt.
Symbol zur Darstellung eines booleschen Datentyps Bool Nur TRUE oder FALSE
Symbol zur Darstellung eines komplexen Datentyps Complex Ein XML-Objekt mit untergeordneten Eigenschaften, ähnlich dem Objekt-JSON-Typ
Symbol zur Darstellung eines DateTime-Datentyps Datetime
Symbol zur Darstellung eines Dezimaldatentyps Decimal
Symbol zur Darstellung eines Integer-Datentyps Integer Nur ganze Zahlen
Symbol zur Darstellung eines Zeichenfolgendatentyps String

Erstellen einer direkten Zuordnung zwischen Elementen

Führen Sie die folgenden Schritte aus, um eine einfache Transformation zwischen Elementen anzugeben, die denselben Typ in den Quell- und Zielschemas aufweisen:

  1. Um anzuzeigen, was im Code geschieht, während Sie die Zuordnung erstellen, wählen Sie in der oberen rechten Ecke der Zuordnung Code anzeigen aus.

  2. Suchen Sie auf der Zuordnungsoberfläche im Bereich "Quelle " das Quellelement, das Sie zuordnen möchten.

    • Standardmäßig werden übergeordnete Elemente automatisch erweitert, um ihre untergeordneten Elemente anzuzeigen.

    • In diesem Beispiel wird die Zuordnung aus dem Quellelement gestartet, Sie können jedoch die Zuordnung aus dem Zielelement starten.

  3. Bewegen Sie den Mauszeiger über den Kreis neben dem Quellelementnamen, bis der Zeiger zu einem Pluszeichen (+) wechselt.

    In diesem Beispiel wird eine Zuordnung erstellt, die mit dem Quellelement " Mitarbeiter-ID " beginnt.

    Screenshot: Data Mapper mit Zeiger über das Quellelement.

  4. Ziehen und zeichnen Sie eine Linie, damit das Quellelement eine Verbindung mit dem Kreis für das Zielelement im Zielbereich herstellt.

    In diesem Beispiel wird die Zuordnung mit dem ID-Zielelement abgeschlossen, das denselben Datentyp wie das Quellelement aufweist.

    Screenshot zeigt Data Mapper, ein Zeiger über das Zielelement und eine Linie zwischen den Quell- und Zielelementen.

    Sie haben nun eine direkte Zuordnung zwischen beiden Elementen erstellt, die dieselben Datentypen aufweisen.

    Screenshot zeigt eine vollständige Zuordnung zwischen der EmployeeID und der ID in den Quell- bzw. Zielschemas.

    Der Codebereich zeigt die Zuordnungsbeziehung, die Sie erstellt haben:

    Screenshot zeigt den Codebereich mit direkter Zuordnung zwischen EmployeeID und ID in den Quell- bzw. Zielschemas.

    Tipp

    Um zu überprüfen, ob Ihre Zuordnungen Probleme haben, wählen Sie Probleme anzeigenaus. Beispielsweise wird in der Liste "Probleme " auf der Registerkarte "Warnungen " eine Warnung angezeigt, wenn Sie eine Zuordnung zwischen Elementen erstellen, die nicht übereinstimmende Datentypen aufweisen:

    Screenshot zeigt die Zuordnung zwischen nicht übereinstimmenden Datentypen.

Erstellen einer komplexen Zuordnung zwischen Elementen

Wenn Sie eine kompliziertere Transformation zwischen Elementen in den Quell- und Zielschemas angeben möchten, zum Beispiel Elemente, die Sie kombinieren oder über unterschiedliche Datentypen verfügen möchten, können Sie eine oder mehrere Funktionen verwenden, die die gewünschte Transformation in der Zuordnung ausführen.

Auf der Zuordungsoberfläche wird die Funktionsbeschriftung basierend auf der Funktionsgruppe farbcodiert. Neben dem Funktionsnamen wird das Symbol der Funktion angezeigt, zum Beispiel:

Screenshot zeigt ein Beispiel für eine Funktionsbezeichnung.

In der folgenden Tabelle sind die Funktionsgruppen und einige Beispielfunktionen aufgeführt, die Sie verwenden können. Die vollständige Liste finden Sie in der Liste " Funktionen" in "Data Mapper".

Group Beispielfunktionen
Sammlung Average, Count, Direct Access, Distinct values, Filter, Index, Join, Maximum, Minimum, Reverse, Sort, Subsequence, Sum
Konvertierung To Date, To Integer, To Number, To String
Datum und Uhrzeit Tage hinzufügen, aktuelles Datum, aktuelle Uhrzeit, entspricht Datum
Logischer Vergleich Equal, Exists, Greater, Greater or equal, If, If Else, Is Nil, Is Null, Is Number, Is String, Less, Less or Equal, Logical AND, Logical NOT, Logical OR, Not Equal
Mathematisch Absolute, Add, Arctangent, Ceiling, Cosine, Divide, Exponential, Exponential (base 10), Floor, Integer Divide, Log, Log (base 10), Module, Multiply, Power, Round, Sine, Square root, Subtract, Tangent
Zeichenfolge Codepoints to String, Concat, Contains, Ends with, Length, Lowercase, Name, Regular Expression Matches, Regular Expression Replace, Replace, Starts with, String to Codepoints, Substring, Substring after, Substring before, Trim, Trim Left, Trim Right, Uppercase
Utility Copy, Error, Execute XPath, Format DateTime, Format Number, Run XSLT

Hinzufügen einer Funktion ohne Zuordnung

Im Beispiel in diesem Abschnitt werden Daten im Quellelement von String in DateTimetransformiert, was der Zielelementtyp ist. Das Beispiel beginnt ohne zuerst eine Zuordnung zu erstellen und verwendet die To Date-Funktion , die eine einzelne Eingabe akzeptiert.

  1. Um anzuzeigen, was im Code geschieht, während Sie die Zuordnung erstellen, wählen Sie in der oberen rechten Ecke der Zuordnung Code anzeigen aus.

  2. Suchen Sie in der Liste Funktionen die Funktion, die Sie verwenden möchten, und wählen Sie sie aus, wodurch die Funktion zur Zuordnungsoberfläche hinzugefügt wird. Wenn die Funktionsliste reduziert ist, wählen Sie in der oberen linken Ecke des Mappers das Funktionssymbol (Symbol für die Funktionsliste.).

    Dieses Beispiel wählt die Funktion An Datum aus, die sich in der Gruppe Konvertierungsfunktion befindet.

    Screenshot zeigt die ausgewählte Funktion namens „To date“.

    Hinweis

    Wenn keine Zuordnung auf der Karte vorhanden ist oder eine Zuordnung ausgewählt ist, wenn Sie der Karte eine Funktion hinzufügen, wird die Funktion angezeigt, aber nicht mit Elementen oder anderen Funktionen verbunden, zum Beispiel:

    Screenshot zeigt die ausgewählte Funktion namens „To date“.

  3. Verbinden Sie die Funktion mit den Quell- und Zielelementen.

    1. Ziehen und zeichnen Sie eine Linie zwischen dem Quellelement und dem Kreis auf dem linken Rand der Funktion. Sie können entweder mit dem Quellelement oder der Funktion beginnen.

      Screenshot zeigt die Zuordnung zwischen einem Quellelement und einer Funktion.

    2. Ziehen Sie eine Linie zwischen dem rechten Rand der Funktion und dem Zielelement. Sie können entweder beim Zielelement oder bei der Funktion beginnen.

      Screenshot zeigt die Zuordnung zwischen Funktion und Zielelement.

    Der Codebereich zeigt die Zuordnungsbeziehung, die Sie erstellt haben:

    Screenshot zeigt den Codebereich mit direkter Zuordnungsbeziehung zwischen Quell- und Zielelementen.

  4. Wählen Sie auf der Zuordnungsoberfläche die Funktionsform aus, um die Funktionsdetails anzuzeigen.

  5. Bestätigen oder bearbeiten Sie auf der Registerkarte Eingabe die zu verwendende Eingabe.

    Screenshot zeigt die Registerkarte Eingabe für die Funktion namens An Datum.

    In einigen Szenarien ist es erforderlich, eine Transformation jenseits des unmittelbaren Quell- und Zielelementpaars zu definieren. Um beispielsweise eine Transformation zwischen einem Arraypaar und ihren Elementen zu definieren, müssen Sie eine Schleife zwischen den Arrayserstellen. Oder um eine Aufgabe auszuführen, wenn der Wert eines Elements eine Bedingung erfüllt, müssen Sie eine Bedingung zwischen Elementenhinzufügen.

Hinzufügen einer Funktion, die mehrere Eingaben verwendet

Im Beispiel in diesem Abschnitt werden mehrere Quellelemente als Eingaben verkettet und dem Zielelement eine einzelne Ausgabe zugeordnet. Das Beispiel verwendet die Funktion Textkette, die mehrere Eingaben akzeptiert.

  1. Um anzuzeigen, was im Code geschieht, während Sie die Zuordnung erstellen, wählen Sie in der oberen rechten Ecke der Zuordnung Code anzeigen aus.

  2. Suchen Sie in der Liste Funktionen die Funktion, die Sie verwenden möchten, und wählen Sie sie aus, wodurch die Funktion zur Zuordnungsoberfläche hinzugefügt wird.

    Wenn die Funktionsliste reduziert ist, wählen Sie in der oberen linken Ecke des Mappers das Funktionssymbol (Symbol für die Funktionsliste.).

    Dieses Beispiel wählt die Funktion "Textkette " aus, die sich in der Gruppe der Zeichenfolgenfunktion befindet.

    Screenshot zeigt die ausgewählte Funktion namens Textkette.

    Hinweis

    Wenn keine Zuordnung auf der Karte vorhanden ist oder eine Zuordnung ausgewählt ist, wenn Sie der Karte eine Funktion hinzufügen, wird die Funktion angezeigt, aber nicht mit Elementen oder anderen Funktionen verbunden, zum Beispiel:

    Screenshot zeigt die getrennten Funktion namens Textkette.

  3. Wählen Sie auf der Zuordnungsoberfläche die Funktionsform aus, um die Funktionsdetails anzuzeigen.

  4. Wählen Sie auf der Registerkarte Eingabe die Quellschemaelemente aus, die als Eingaben verwendet werden sollen.

    In diesem Beispiel werden die Vorname- und Nachname Quellschemaelemente als Funktionseingaben ausgewählt. Der Mapper fügt automatisch die entsprechenden Zuordnungen zwischen den Quellelementen und der Funktion hinzu.

    Screenshot zeigt mehrere Quellelemente als Funktionseingaben.

  5. Um die Zuordnung abzuschließen, ziehen und zeichnen Sie eine Linie zwischen dem rechten Rand der Funktion und dem Zielelement. Sie können entweder mit dem Zielelement oder der Funktion beginnen.

    Screenshot zeigt die abgeschlossenen Zuordnungen zwischen mehreren Eingaben, der Textkettenfunktion und dem Zielelement.

    Der Codebereich zeigt die von Ihnen erstellten Zuordnungsbeziehungen:

    Screenshot zeigt den Codebereich mit der Funktion Textkette mit mehreren Eingaben und einer einzelnen Ausgabe.

Durchlaufen von Arrays

Wenn Ihre Quell- und Zielschemas Arrays enthalten, können Sie eine Schleife erstellen, um die Elemente der Arrays zu durchlaufen. Das Beispiel in diesem Abschnitt erstellt eine Schleife durch ein Mitarbeiterquellarray und ein Personenzielarray sowie Zuordnungen zwischen den Elementen der Arrays.

  1. Um anzuzeigen, was im Code geschieht, während Sie die Zuordnung erstellen, wählen Sie in der oberen rechten Ecke der Zuordnung Code anzeigen aus.

  2. Suchen Sie auf der Zuordnungsoberfläche im Bereich "Quelle " und "Ziel " die Arrays, die Sie zuordnen möchten.

  3. Ziehen und zeichnen Sie eine Linie zwischen dem Arrayelementpaar. Sie können entweder im Quellbereich oder im Zielbereich beginnen.

    Das folgende Beispiel beginnt im Bereich " Quelle " und ordnet die Elemente "Name " im Quellarray " Mitarbeiter " und dem Zielarray " Person " zu:

    Screenshot zeigt die Zuordnungsoberfläche und das Zeichnen einer Zuordnung zwischen den Namenselementen im Quellarray

    Nachdem Sie die Zuordnung des ersten Arrayelementpaars abgeschlossen haben, fügt der Mapper automatisch eine Schleife zwischen den übergeordneten Elementen der Quelle und dem Zielarray hinzu, die den folgenden Verbindungspunkttyp aufweisen: Symbol für den abgeschlossenen Verbindungspunkt des Arrayelements.

    Im folgenden Beispiel wird die automatisch hinzugefügte Schleife zwischen den übergeordneten Arrays "Mitarbeiter " und "Zielperson" hervorgehoben:

    Screenshot zeigt die Schleifenzuordnung zwischen Quellarrays

    Der Codebereich zeigt die Zuordnung und Schleife an, die Sie erstellt haben:

    Screenshot zeigt den Codebereich mit Schleifenzuordnung zwischen Quell- und übergeordneten Zielarrays sowie Arrayelementen.

  4. Fahren Sie mit dem Zuordnen der anderen Arrayelemente fort, zum Beispiel:

    Screenshot zeigt weitere Zuordnungen zwischen anderen Arrayelementen in Quell- und Zielarrays.

Auswerten einer Bedingung zum Durchführen einer Aufgabe

Angenommen, Sie möchten eine Zuordnung hinzufügen, die eine Bedingung auswertet und eine Aufgabe ausführt, wenn die Bedingung erfüllt ist. In diesem Szenario können Sie mehrere Funktionen verwenden.

Im folgenden Beispiel berechnet die Zuordnung, wenn die Einkaufsmenge 20 Artikel überschreitet, einen Rabatt, der mit den folgenden Funktionen angewendet werden soll:

Funktionsgruppe Funktion Zweck in diesem Beispiel
Vergleich Höher Überprüfen Sie, ob die Einkaufsmenge mehr als 20 beträgt.
Vergleich If Überprüfen Sie, ob die funktion Greater true zurückgibt.
Mathematisch Multiplizieren Wenn die Bedingung "true" ist, multiplizieren Sie den Artikelpreis um 10 %, um den Rabatt zu berechnen.
  1. Suchen Sie im Bereich "Quelle " und "Ziel " die Elemente, die in Ihrem Szenario zugeordnet werden sollen.

    In diesem Beispiel werden die folgenden Elemente verwendet:

    • Quellbereich : Artikelpreis und Artikelmenge

    • Ziel Bereich: ItemPrice, ItemQuantityund ItemDiscount

      Screenshot zeigt die Zuordungsoberfläche und Datenelemente, zum Beispiel ein Bedingungsszenario.

  2. Suchen Sie in der Liste Funktionen die Funktionen, die Sie verwenden möchten, und wählen Sie sie aus, wodurch die Funktionen zur Zuordnungsoberfläche hinzugefügt werden.

    • Wenn die Funktionsliste reduziert ist, wählen Sie in der oberen linken Ecke des Mappers das Funktionssymbol (Symbol für den Bereich ).

    • Verschieben Sie bei Bedarf die Funktionsformen auf der Zuordnungsoberfläche, um die Auswahl zu vereinfachen.

    In diesem Beispiel werden der Zuordnungsoberfläche die folgenden Funktionen hinzugefügt: Größer, Wennund Multiplizieren

    Screenshot zeigt die Zuordungsoberfläche, Datenelemente und Funktionen, zum Beispiel ein Bedingungsszenario.

  3. Um anzuzeigen, was im Code geschieht, während Sie die Zuordnungen erstellen, wählen Sie in der oberen rechten Ecke des Mappers Code anzeigenaus.

  4. Verbinden Sie die Quellelemente, Funktionen und Zielelemente in der spezifischen Reihenfolge, wie Für Ihr Szenario erforderlich ist.

    Dieses Beispiel verbindet die folgenden Elemente in der angegebenen Reihenfolge miteinander, um die Zuordnungen ordnungsgemäß zu erstellen:

    Start Ende
    ItemPrice Quellelement ItemPrice Zielelement
    ItemQuantity Quellelement Eingabe einer größeren Funktion am linken Rand der Form. Diese Eingabe stellt die Daten für das Feld Wert 1 in den Funktionsdetails bereit.
    Ausgabe einer größeren Funktion am rechten Rand der Form Wenn die Eingabe der Funktion am linken Rand der Form erfolgt. Diese Eingabe stellt die Daten für das Feld "Bedingung " in den Funktionsdetails bereit.
    ItemPrice Quellelement Multiplizieren Sie die Eingabe der Funktion am linken Rand der Form. Diese Eingabe stellt die Daten für das Multiplicand-Feld in den Funktionsdetails bereit.
    Multiplizieren Sie die Ausgabe der Funktion am rechten Rand der Form. Wenn die Eingabe der Funktion am linken Rand der Form erfolgt. Diese Eingabe stellt die Daten für das Feld "Wert " in den Funktionsdetails bereit.
    Wenn die Ausgabe der Funktion am rechten Rand der Form angezeigt wird. ItemDiscount Zielelement

    Das folgende Beispiel zeigt die Zuordnungen zu diesem Zeitpunkt:

    Screenshot zeigt die Zuordungsoberfläche, Datenelemente und Funktionen mit Zuordnungen, zum Beispiel Bedingungsszenario.

  5. Bestätigen oder geben Sie in den folgenden Funktionsdetails auf der Registerkarte "Eingabe " die folgenden Werte an:

    Funktion Eingabefeld und Wert
    Höher - Wert 1: ItemQuantity Quellelement
    - Wert 2: 20 als benutzerdefinierter Wert
    Multiplizieren - Multiplicand 1: ItemPrice Quellelement
    - Multiplicand 2: .10 als benutzerdefinierter Wert
    If - Bedingung: ist größer als(ItemQuantity,20)
    - Value: multiply(ItemPrice, .10)

    Die folgende Zuordnung zeigt das fertige Beispiel:

    Screenshot zeigt ein Beispiel für die fertige Bedingung.

    Im Codebereich wird die von Ihnen erstellte Zuordnung angezeigt:

    Screenshot zeigt den Codebereich mit bedingter Zuordnung zwischen Quell- und Zielelementen mithilfe der Funktionen

Speichern der Zuordnung

Wenn Sie fertig sind, wählen Sie auf der Zuordnungssymbolleiste Speichern aus.

Visual Studio Code speichert Ihre Zuordnung als die folgenden Artefakte:

  • Eine Datei <Name-ihrer-Zuordnung>.lml im Projektordner Artifacts>MapDefinitions
  • Eine Datei <name-ihrer-zuordnung>.xslt im Projektordner Artifacts>Maps

Testen der Zuordnung

Um zu bestätigen, dass die Transformation erwartungsgemäß funktioniert, benötigen Sie Beispieleingabedaten.

  1. Bevor Sie Ihre Karte testen, speichern Sie die Karte, um einen aktuellen <Ihren Kartennamen>XSLT Dateizu generieren.

  2. Wählen Sie auf der Kartensymbolleiste " Testbereich öffnen"aus.

  3. Fügen Sie im Bereich "Testzuordnung " im Feld "Beispieldaten " Ihre Beispieleingabe ein, und wählen Sie " Testen"aus.

    Das Ergebnisfeld zeigt die Testergebnisse an.

Aufrufen der Zuordnung aus einem Workflow in Ihrem Projekt

  1. Wählen Sie auf der Visual Studio Code-Aktivitätsleiste Explorer- (Dateisymbol) aus, um die Projektstruktur ihrer Logik-App anzuzeigen.

  2. Erweitern Sie den Ordner mit Ihrem Workflownamen. Wählen Sie im Kontextmenü der Datei workflow.json die Option Designer öffnen aus.

  3. Führen Sie im Workflow-Designer die folgenden allgemeinen Schritte zum Hinzufügen der integrierten Aktion Data Mapper-Vorgänge mit dem Namen Mit Data Mapper XSLT transformieren aus.

  4. Wählen Sie im Designer die Aktion Mit Data Mapper XSLT transformieren aus.

  5. Geben Sie im angezeigten Aktionsinformationsbereich den Wert Inhalt an, und lassen Sie Zuordnungsquelle auf Logik-App festgelegt.

  6. Öffnen Sie die Zuordnungsnamenliste , und wählen Sie Ihre Karte (XSLT-Datei) aus.

    Screenshot vom Standard-Workflow-Designer in Visual Studio Code mit ausgewählter Aktion „Transformieren“ mithilfe von XSLT und der Aktionseigenschaften von Data Mapper.

    Wenn Sie die gleiche Aktion vom Typ Mit Data Mapper XSLT transformieren im Azure-Portal verwenden möchten, müssen Sie die Zuordnung zur Standard-Logik-App-Ressource hinzufügen.