Durchführen von Datenvorgängen in Azure Logic Apps
Gilt für: Azure Logic Apps (Verbrauch + Standard)
In dieser Schrittanleitung wird gezeigt, wie Sie in Ihrem Logik-App-Workflow folgendermaßen mit Daten arbeiten können:
- Erstellen einer Zeichenfolge oder eines JSON-Objekts (JavaScript Object Notation) aus mehreren Eingaben, die unterschiedliche Datentypen aufweisen. Sie können diese Zeichenfolge dann als einzelne Eingabe verwenden, anstatt immer wieder die gleichen Eingaben vornehmen zu müssen.
- Erstellen von benutzerfreundlichen Token aus JSON-Objekteigenschaften, damit Sie diese Eigenschaften problemlose in Ihrem Workflow nutzen können.
- Erstellen einer HTML- oder CSV-Tabelle aus einem Array.
- Erstellen eines Arrays aus einem anderen Array, basierend auf einem angegebenen Filter oder einer Bedingung.
- Erstellen eines Arrays auf Grundlage der angegebenen Eigenschaften für alle Elemente in einem anderen Array.
- Erstellen einer Zeichenfolge aus allen Elementen in einem Array und Trennen dieser Elemente durch ein bestimmtes Zeichen.
Weitere Möglichkeiten zum Arbeiten mit Daten bieten die Funktionen zur Datenmanipulation, die Azure Logic Apps bereitstellt.
Voraussetzungen
Ein Azure-Konto und ein Azure-Abonnement. Falls Sie kein Abonnement besitzen, können Sie sich für ein kostenloses Azure-Konto registrieren.
Der Logik-App-Workflow, in dem Sie den Datenvorgang ausführen möchten. Dieser Workflow muss bereits einen Trigger als ersten Schritt in Ihrem Workflow umfassen. Sowohl die Logik-App-Workflows des Typs „Verbrauch“ als auch die Workflows des Typs „Standard“ unterstützen die in diesem Leitfaden beschriebenen Datenvorgänge.
Alle Datenvorgänge stehen ausschließlich als Aktionen zur Verfügung. Bevor Sie also diese Aktionen verwenden können, muss Ihr Workflow bereits mit einem Trigger gestartet werden und alle weiteren Aktionen enthalten, die zum Erstellen der Ausgaben benötigt werden, die Sie für den Datenvorgang verwenden möchten.
Datenvorgangsaktionen
In den folgenden Abschnitten finden Sie eine Zusammenfassung der Datenvorgänge, die Sie nutzen können. Sie sind nach den Quelldatentypen geordnet, für die die Vorgänge ausgeführt werden, die Beschreibungen sind jedoch alphabetisch geordnet.
JSON-Aktionen
Die folgenden Aktionen erleichtern Ihnen die Arbeit mit Daten im JSON-Format (JavaScript Object Notation).
| Aktion | BESCHREIBUNG |
|---|---|
| Compose | Dient zum Erstellen einer Nachricht oder Zeichenfolge aus mehreren Eingaben, die unterschiedliche Datentypen aufweisen können. Sie können diese Zeichenfolge dann als einzelne Eingabe verwenden, anstatt immer wieder die gleichen Eingaben vornehmen zu müssen. Beispielsweise können Sie eine einzelne JSON-Nachricht aus unterschiedlichen Eingaben erstellen. |
| Parse JSON | Dient zum Erstellen von benutzerfreundlichen Datentoken für Eigenschaften in JSON-Inhalten, damit Sie die Eigenschaften leichter in Ihren Logik-Apps nutzen können. |
Informationen zur Erstellung von komplexeren JSON-Transformationen finden Sie unter Perform advanced JSON transformations with Liquid templates (Durchführen von erweiterten JSON-Transformationen mit Liquid-Vorlagen).
Arrayaktionen
Die folgenden Aktionen erleichtern Ihnen die Arbeit mit Daten in Arrays.
| Aktion | BESCHREIBUNG |
|---|---|
| Create CSV table | Dient zum Erstellen einer CSV-Tabelle (durch Trennzeichen getrennt) aus einem Array. |
| Create HTML table | Dient zum Erstellen einer HTML-Tabelle aus einem Array. |
| Filter array | Dient zum Erstellen einer Arrayteilmenge aus einem Array basierend auf dem angegebenen Filter bzw. der Bedingung. |
| Join | Dient zum Erstellen einer Zeichenfolge aus allen Elementen eines Arrays und Trennen der Elemente mit dem angegebenen Zeichen. |
| Select | Dient zum Erstellen eines Arrays aus den angegebenen Eigenschaften für alle Elemente eines anderen Arrays. |
Compose-Aktion
Zum Erstellen eines einzelnen Ausgabe, z. B. eines JSON-Objekts aus mehreren Eingaben, verwenden Sie die Aktion Compose. Ihre Eingaben können unterschiedliche Typen aufweisen, z.B. Integer, boolesche Wert, Arrays, JSON-Objekte und andere native Typen, die von Azure Logic Apps unterstützt werden. Beispiele hierfür sind Binärdateien und XML. Anschließend können Sie die Ausgabe in Aktionen verwenden, die nach der Aktion Compose folgen. Mithilfe der Aktion Compose können Sie zudem beim Erstellen des Workflows Ihrer Logik-App die wiederholte Eingabe derselben Eingaben vermeiden.
Sie können beispielsweise eine JSON-Nachricht aus mehreren Variablen erstellen, z.B. Zeichenfolgenvariablen, in denen die Vor- und Nachnamen von Benutzern gespeichert werden, und einer Integer-Variablen zum Speichern des Alters der Benutzer. In diesem Beispiel akzeptiert die Aktion Compose die folgenden Eingaben:
{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }
und erstellt die folgende Ausgabe:
{"age":35,"fullName":"Owens,Sophia"}
Führen Sie die folgenden Schritte im Workflow-Designer aus, um die Aktion Compose auszuprobieren. Falls Sie den Codeansicht-Editor bevorzugen, können Sie die beispielhaften Aktionsdefinitionen Compose und Initialize variable aus diesem Leitfaden in die Workflowdefinition kopieren, die Ihrer eigenen Logik-App zugrunde liegt: Datenvorgänge: Codebeispiele – Compose. Weitere Informationen zur Aktion Compose in der zugrunde liegenden JSON-Workflowdefinition finden Sie unter Compose-Aktion.
Öffnen Sie (sofern nicht bereits geschehen) im Azure-Portal, in Visual Studio oder Visual Studio Code Ihren Logik-App-Workflow im Designer.
In diesem Beispiel werden das Azure-Portal und ein Beispielworkflow mit einem Trigger des Typs Wiederholung verwendet, gefolgt von mehreren Aktionen des Typs Initialize variable. Diese Aktionen sind für die Erstellung von zwei Zeichenfolgenvariablen und einer Integer-Variablen eingerichtet.
Führen Sie in dem Workflow, in dem Sie die Ausgabe erstellen möchten, einen der folgenden Schritte aus:
Zum Hinzufügen einer Aktion unter dem letzten Schritt wählen Sie Neuer Schritt aus.
Zum Hinzufügen einer Aktion zwischen Schritten bewegen Sie den Mauszeiger über den Verbindungspfeil, sodass das Pluszeichen ( + ) angezeigt wird. Wählen Sie das Pluszeichen und dann die Option Aktion hinzufügen aus.
Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Integriert aus. Geben Sie im Suchfeld compose ein.
Wählen Sie in der Liste der Aktionen die Aktion Compose aus.
Nehmen Sie im Feld Eingaben die gewünschten Eingaben zum Erstellen der Ausgabe vor.
Klicken Sie in diesem Beispiel in das Feld Eingaben, wodurch die Liste dynamischer Inhalte geöffnet wird. Wählen Sie in dieser Liste die zuvor erstellten Variablen aus:
Der folgende Screenshot zeigt die fertige Beispielaktion Compose:
Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.
Testen Ihres Workflows
Sie können sich vergewissern, dass mit der Aktion Compose die erwarteten Ergebnisse erstellt werden, indem Sie an sich selbst eine Benachrichtigung senden, die die Ausgabe der Aktion Compose enthält.
Fügen Sie in Ihrem Workflow eine Aktion hinzu, mit der die Ergebnisse der Aktion Compose an Sie gesendet werden können.
In diesem Beispiel wird die Office 365 Outlook-Aktion E-Mail senden verwendet.
Klicken Sie in dieser Aktion für jedes Feld, in dem die Ergebnisse angezeigt werden sollen, in das jeweilige Feld, wodurch die Liste mit den dynamischen Inhalten geöffnet wird. Wählen Sie in dieser Liste unter der Aktion Compose (Verfassen) die Option Ausgaben aus.
In diesem Beispiel wird das Ergebnis im Text der E-Mail angezeigt, also fügen Sie das Feld Ausgaben in das Feld Text ein.
Speichern Sie Ihren Workflow, und führen Sie den Workflow dann manuell aus. Wählen Sie auf der Symbolleiste des Designers Trigger ausführen>Ausführen aus.
Wenn Sie die Office 365 Outlook-Aktion verwendet haben, erhalten Sie ein Ergebnis ähnlich wie im folgenden Screenshot:
Aktion „Create CSV table“
Verwenden Sie die Aktion Create CSV table, um eine CSV-Tabelle (durch Trennzeichen getrennte Werte) zu erstellen, die die Eigenschaften und Werte aus JSON-Objekten in einem Array enthält. Sie können die sich ergebende Tabelle dann in Aktionen verwenden, die auf die Aktion Create CSV table folgen.
Führen Sie die folgenden Schritte im Workflow-Designer aus, um die Aktion Create CSV table auszuprobieren. Falls Sie den Codeansicht-Editor bevorzugen, können Sie die beispielhaften Aktionsdefinitionen Create CSV table und Initialize variable aus diesem Leitfaden in die Workflowdefinition kopieren, die Ihrer eigenen Logik-App zugrunde liegt: Datenvorgänge: Codebeispiele – Create CSV table. Weitere Informationen zur Aktion Create CSV table in der zugrunde liegenden Workflowdefinition finden Sie unter Table-Aktion.
Öffnen Sie (sofern nicht bereits geschehen) im Azure-Portal, in Visual Studio oder Visual Studio Code Ihren Logik-App-Workflow im Designer.
In diesem Beispiel werden das Azure-Portal und ein Beispielworkflow mit einem Trigger des Typs Wiederholung verwendet, gefolgt von einer Aktion Initialize variable. Die Aktion ist zur Erstellung einer Variablen konzipiert, deren Ausgangswert ein Array mit einigen Eigenschaften und Werten im JSON-Format ist.
Führen Sie in dem Workflow, in dem Sie die CSV-Tabelle erstellen möchten, einen der folgenden Schritte aus:
Zum Hinzufügen einer Aktion unter dem letzten Schritt wählen Sie Neuer Schritt aus.
Zum Hinzufügen einer Aktion zwischen Schritten bewegen Sie den Mauszeiger über den Verbindungspfeil, sodass das Pluszeichen ( + ) angezeigt wird. Wählen Sie das Pluszeichen und dann die Option Aktion hinzufügen aus.
Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Integriert aus. Geben Sie im Suchfeld create csv table ein.
Wählen Sie in der Liste der Aktionen die Aktion Create CSV table aus.
Geben Sie im Feld Aus das Array oder den Ausdruck ein, das bzw. der zum Erstellen der Tabelle verwendet werden soll.
Klicken Sie in diesem Beispiel in das Feld Von, wodurch die Liste dynamischer Inhalte geöffnet wird. Wählen Sie in dieser Liste die zuvor erstellte Variable aus:
Hinweis
Verwenden Sie die Aktion Parse JSON, bevor Sie die Aktion Create CSV table aufrufen, um benutzerfreundliche Token für die Eigenschaften in JSON-Objekten zu erstellen. Sie können diese Eigenschaften anschließend als Eingaben auswählen.
Der folgende Screenshot zeigt die fertige Beispielaktion Create CSV table:
Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.
Tabellenformat anpassen
Standardmäßig wird die Eigenschaft Spalten auf das automatische Erstellen der Tabellenspalten basierend auf den Arrayelementen festgelegt. Führen Sie die folgenden Schritte aus, um benutzerdefinierte Header und Werte anzugeben:
Wenn die Eigenschaft Spalten (Columns) nicht im Aktionsinformationsfeld angezeigt wird, wählen Sie in der Liste Neue Parameter hinzufügen die Option Spalten aus.
Öffnen Sie die Liste Spalten, und wählen Sie Benutzerdefiniert aus.
Geben Sie in der Eigenschaft Header den benutzerdefinierten Headertext an, der stattdessen verwendet werden soll.
Geben Sie in der Value-Eigenschaft den benutzerdefinierten Wert an, der stattdessen verwendet werden soll.
Um Werte aus dem Array zurückzugeben, können Sie die item()-Funktion mit der Aktion CSV-Tabelle erstellen verwenden. In einer For_each-Schleife können Sie die items()-Funktion verwenden.
Angenommen, Sie benötigen z. B. in einem Array die Tabellenspalten, die nur die Eigenschaftswerte und nicht die Eigenschaftennamen enthalten. Um nur diese Werte zurückzugeben, führen Sie die folgenden Schritte aus, um in der Designeransicht oder in der Codeansicht zu arbeiten.
Dieses Beispiel gibt das folgende Ergebnis zurück:
Apples,1
Oranges,2
In der Designeransicht
Lassen Sie in der Aktion Create CSV table die Spalte Überschrift leer. Dereferenzieren Sie für jede Zeile in der Spalte Value alle gewünschten Arrayeigenschaften. Jede Zeile unter Value gibt alle Werte für die angegebene Arrayeigenschaft zurück und wird zu einer Spalte in Ihrer Tabelle.
Klicken Sie für jede gewünschte Arrayeigenschaft in der Spalte Wert in das Bearbeitungsfeld, wodurch die Liste der dynamischen Inhalte angezeigt wird.
Wählen Sie in dieser Liste Ausdruck aus, um stattdessen den Ausdrucks-Editor zu öffnen.
Geben Sie im Ausdrucks-Editor den folgenden Ausdruck ein, ersetzen Sie jedoch
<array-property-name>durch den Namen der Arrayeigenschaft für den gewünschten Wert.Syntax:
item()?['<array-property-name>']Beispiele:
item()?['Description']item()?['Product_ID']
Wiederholen Sie die vorherigen Schritte für jede Arrayeigenschaft. Wenn Sie fertig sind, sieht Ihre Aktion ähnlich wie im folgenden Beispiel aus:
Wechseln Sie zum Auflösen von Ausdrücken in aussagekräftigere Versionen zur Codeansicht und wieder zurück zur Designeransicht, und öffnen Sie dann die reduzierte Aktion erneut:
Die Aktion Create CSV table ähnelt nun dem folgenden Beispiel:
In der Codeansicht
Legen Sie in der JSON-Definition der Aktion innerhalb des columns-Arrays die header-Eigenschaft auf eine leere Zeichenfolge fest. Dereferenzieren Sie für jede value-Eigenschaft alle gewünschten Arrayeigenschaften.
Wechseln Sie vom Designer zur Codeansicht.
- Verbrauch: Wählen Sie auf der Symbolleiste des Designers Codeansicht aus.
- Standard: Wählen Sie im Navigationsmenü des Workflows unter Entwickler die Option Code aus.
Suchen Sie im Code-Editor das Array
columnsder Aktion. Fügen Sie für jede Spalte, die gewünschte Arraywerte enthält, eine leereheader-Eigenschaft und den folgenden Ausdruck für dievalue-Eigenschaft hinzu:Syntax:
{ "header": "", "value": "@item()?['<array-property-name>']" }Beispiel:
"Create_CSV_table": { "inputs": { "columns": [ { "header": "", "value": "@item()?['Description']" }, { "header": "", "value": "@item()?['Product_ID']" } ], "format": "CSV", "from": "@variables('myJSONArray')" } }Wechseln Sie zurück zur Designer-Ansicht, um die Ergebnisse zu überprüfen.
Testen Ihres Workflows
Sie können sich vergewissern, dass mit der Aktion Create CSV table die erwarteten Ergebnisse erstellt werden, indem Sie an sich selbst eine Benachrichtigung senden, die die Ausgabe der Aktion Create CSV table enthält.
Fügen Sie in Ihrem Workflow eine Aktion hinzu, mit der die Ergebnisse der Aktion Create CSV table an Sie gesendet werden können.
In diesem Beispiel wird die Office 365 Outlook-Aktion E-Mail senden verwendet.
Klicken Sie in dieser Aktion für jedes Feld, in dem die Ergebnisse angezeigt werden sollen, in das jeweilige Feld, wodurch die Liste mit den dynamischen Inhalten geöffnet wird. Wählen Sie unter der Aktion CSV-Tabelle erstellen die Option Ausgabe aus.
Hinweis
Wenn in der Liste der dynamischen Inhalte die Meldung Es wurden keine Ausgaben gefunden, die diesem Eingabeformat entsprechen angezeigt wird, klicken Sie in der Liste neben Create CSV table auf Mehr anzeigen.
Speichern Sie Ihren Workflow, und führen Sie den Workflow dann manuell aus. Wählen Sie auf der Symbolleiste des Designers Trigger ausführen>Ausführen aus.
Wenn Sie die Office 365 Outlook-Aktion verwendet haben, erhalten Sie ein Ergebnis ähnlich wie im folgenden Screenshot:
Hinweis
Wenn die Tabelle mit einer falschen Formatierung zurückgegeben wird, sehen Sie unter Überprüfen der Tabellendatenformatierung nach.
Aktion „Create HTML table“
Verwenden Sie die Aktion Create HTML table, um eine HTML-Tabelle zu erstellen, die die Eigenschaften und Werte aus JSON-Objekten (JavaScript Object Notation) in einem Array enthält. Sie können die sich ergebende Tabelle dann in Aktionen verwenden, die auf die Aktion Create HTML table folgen.
Führen Sie die folgenden Schritte im Workflow-Designer aus, um die Aktion Create HTML table auszuprobieren. Falls Sie den Codeansicht-Editor bevorzugen, können Sie die beispielhaften Aktionsdefinitionen Create HTML table und Initialize variable aus diesem Leitfaden in die Workflowdefinition kopieren, die Ihrer eigenen Logik-App zugrunde liegt: Datenvorgänge: Codebeispiele – Create HTML table. Weitere Informationen zur Aktion Create HTML table in der zugrunde liegenden JSON-Workflowdefinition finden Sie unter Table-Aktion.
Öffnen Sie (sofern nicht bereits geschehen) im Azure-Portal, in Visual Studio oder Visual Studio Code Ihren Logik-App-Workflow im Designer.
In diesem Beispiel werden das Azure-Portal und ein Beispielworkflow mit einem Trigger des Typs Wiederholung verwendet, gefolgt von einer Aktion Initialize variable. Die Aktion ist zur Erstellung einer Variablen konzipiert, deren Ausgangswert ein Array mit einigen Eigenschaften und Werten im JSON-Format ist.
Führen Sie in dem Workflow, in dem Sie eine HTML-Tabelle erstellen möchten, einen der folgenden Schritte aus:
Zum Hinzufügen einer Aktion unter dem letzten Schritt wählen Sie Neuer Schritt aus.
Zum Hinzufügen einer Aktion zwischen Schritten bewegen Sie den Mauszeiger über den Verbindungspfeil, sodass das Pluszeichen ( + ) angezeigt wird. Wählen Sie das Pluszeichen und dann die Option Aktion hinzufügen aus.
Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Integriert aus. Geben Sie im Suchfeld create html table ein.
Wählen Sie in der Liste der Aktionen die Aktion Create HTML table aus.
Geben Sie im Feld Aus das Array oder den Ausdruck ein, das bzw. der zum Erstellen der Tabelle verwendet werden soll.
Klicken Sie in diesem Beispiel in das Feld Von, wodurch die Liste dynamischer Inhalte geöffnet wird. Wählen Sie in dieser Liste die zuvor erstellte Variable aus:
Hinweis
Verwenden Sie die Aktion Parse JSON, bevor Sie die Aktion Create HTML table aufrufen, um benutzerfreundliche Token für die Eigenschaften in JSON-Objekten zu erstellen. Sie können diese Eigenschaften anschließend als Eingaben auswählen.
Der folgende Screenshot zeigt die fertige Beispielaktion Create HTML table:
Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.
Tabellenformat anpassen
Standardmäßig wird die Eigenschaft Spalten auf das automatische Erstellen der Tabellenspalten basierend auf den Arrayelementen festgelegt. Führen Sie die folgenden Schritte aus, um benutzerdefinierte Header und Werte anzugeben:
Öffnen Sie die Liste Spalten, und wählen Sie Benutzerdefiniert aus.
Geben Sie in der Eigenschaft Header den benutzerdefinierten Headertext an, der stattdessen verwendet werden soll.
Geben Sie in der Value-Eigenschaft den benutzerdefinierten Wert an, der stattdessen verwendet werden soll.
Um Werte aus dem Array zurückzugeben, können Sie die item()-Funktion mit der Aktion HTML-Tabelle erstellen verwenden. In einer For_each-Schleife können Sie die items()-Funktion verwenden.
Angenommen, Sie benötigen z. B. in einem Array die Tabellenspalten, die nur die Eigenschaftswerte und nicht die Eigenschaftennamen enthalten. Um nur diese Werte zurückzugeben, führen Sie die folgenden Schritte aus, um in der Designeransicht oder in der Codeansicht zu arbeiten.
Dieses Beispiel gibt das folgende Ergebnis zurück:
Apples,1
Oranges,2
In der Designeransicht
Lassen Sie in der Aktion Create HTML table die Spalte Überschrift leer. Dereferenzieren Sie für jede Zeile in der Spalte Value alle gewünschten Arrayeigenschaften. Jede Zeile unter Value gibt alle Werte für die angegebene Arrayeigenschaft zurück und wird zu einer Spalte in Ihrer Tabelle.
Klicken Sie für jede gewünschte Arrayeigenschaft in der Spalte Wert in das Bearbeitungsfeld, wodurch die Liste der dynamischen Inhalte angezeigt wird.
Wählen Sie in dieser Liste Ausdruck aus, um stattdessen den Ausdrucks-Editor zu öffnen.
Geben Sie im Ausdrucks-Editor den folgenden Ausdruck ein, ersetzen Sie dabei jedoch
<array-property-name>durch den Namen der Arrayeigenschaft für den gewünschten Wert, und wählen Sie dann OK aus. Weitere Informationen finden Sie unter Funktion item().Syntax:
item()?['<array-property-name>']Beispiele:
item()?['Description']item()?['Product_ID']
Wiederholen Sie die vorherigen Schritte für jede Arrayeigenschaft. Wenn Sie fertig sind, sieht Ihre Aktion ähnlich wie im folgenden Beispiel aus:
Wechseln Sie zum Auflösen von Ausdrücken in aussagekräftigere Versionen zur Codeansicht und wieder zurück zur Designeransicht, und öffnen Sie dann die reduzierte Aktion erneut:
Die Aktion Create HTML table ähnelt nun dem folgenden Beispiel:
In der Codeansicht
Legen Sie in der JSON-Definition der Aktion innerhalb des columns-Arrays die header-Eigenschaft auf eine leere Zeichenfolge fest. Dereferenzieren Sie für jede value-Eigenschaft alle gewünschten Arrayeigenschaften.
Wechseln Sie vom Designer zur Codeansicht.
- Verbrauch: Wählen Sie auf der Symbolleiste des Designers Codeansicht aus.
- Standard: Wählen Sie im Navigationsmenü des Workflows unter Entwickler die Option Code aus.
Suchen Sie im Code-Editor das Array
columnsder Aktion. Fügen Sie für jede Spalte, die gewünschte Arraywerte enthält, eine leereheader-Eigenschaft und den folgenden Ausdruck für dievalue-Eigenschaft hinzu:Syntax:
{ "header": "", "value": "@item()?['<array-property-name>']" }Beispiel:
"Create_HTML_table": { "inputs": { "columns": [ { "header": "", "value": "@item()?['Description']" }, { "header": "", "value": "@item()?['Product_ID']" } ], "format": "HTML", "from": "@variables('myJSONArray')" } }Wechseln Sie zurück zur Designer-Ansicht, um die Ergebnisse zu überprüfen.
Testen Ihres Workflows
Sie können sich vergewissern, dass mit der Aktion Create HTML table die erwarteten Ergebnisse erstellt werden, indem Sie an sich selbst eine Benachrichtigung senden, die die Ausgabe der Aktion Create HTML table enthält.
Fügen Sie in Ihrem Workflow eine Aktion hinzu, mit der die Ergebnisse der Aktion Create HTML table an Sie gesendet werden können.
In diesem Beispiel wird die Office 365 Outlook-Aktion E-Mail senden verwendet.
Klicken Sie in dieser Aktion für jedes Feld, in dem die Ergebnisse angezeigt werden sollen, in das jeweilige Feld, wodurch die Liste mit den dynamischen Inhalten geöffnet wird. Wählen Sie in dieser Liste unter der Aktion HTML-Tabelle erstellen die Option Ausgabe aus.
Hinweis
Wenn in der Liste der dynamischen Inhalte die Meldung Es wurden keine Ausgaben gefunden, die diesem Eingabeformat entsprechen angezeigt wird, klicken Sie in der Liste neben Create HTML table auf Mehr anzeigen.
Stellen Sie beim Einschließen der Ausgabe der HTML-Tabelle in eine E-Mail-Aktion sicher, dass Sie die Eigenschaft Ist HTML in den erweiterten Optionen der E-Mail-Aktion auf Ja festlegen. Die HTML-Tabelle wird dann von der E-Mail-Aktion richtig formatiert. Wenn die Tabelle mit einer falschen Formatierung zurückgegeben wird, finden Sie weitere Informationen unter Überprüfen der Tabellendatenformatierung.
Speichern Sie Ihren Workflow, und führen Sie den Workflow dann manuell aus. Wählen Sie auf der Symbolleiste des Designers Trigger ausführen>Ausführen aus.
Wenn Sie die Office 365 Outlook-Aktion verwendet haben, erhalten Sie ein Ergebnis ähnlich wie im folgenden Screenshot:
Aktion „Filter array“
Verwenden Sie die Aktion Filter array, um aus einem vorhandenen Array ein Teilmengenarray zu erstellen, bei dem die Elemente der Teilmenge bestimmte Kriterien erfüllen. Anschließend können Sie das resultierende gefilterte Array in Aktionen verwenden, die auf die Aktion Filter array folgen.
Führen Sie die folgenden Schritte im Workflow-Designer aus, um die Aktion Filter array auszuprobieren. Falls Sie den Codeansicht-Editor bevorzugen, können Sie die beispielhaften Aktionsdefinitionen Filter array und Initialize variable aus diesem Leitfaden in die Workflowdefinition kopieren, die Ihrer eigenen Logik-App zugrunde liegt: Datenvorgänge: Codebeispiele – Filter array. Weitere Informationen zur Aktion Filter array in der zugrunde liegenden JSON-Workflowdefinition finden Sie unter Abfrageaktion.
Hinweis
Für den Filtertext, den Sie in Ihrer Bedingung verwenden, wird die Groß-/Kleinschreibung berücksichtigt. Mit dieser Aktion können außerdem keine Formate oder Komponenten von Elementen im Array geändert werden.
Wenn die Arrayausgabe der Aktion Filter array für Aktionen verwendet werden soll, müssen diese Aktionen entweder Arrays als Eingabe akzeptieren, oder Sie müssen die Arrayausgabe ggf. in ein anderes kompatibles Format konvertieren.
Wenn Sie einen HTTP-Endpunkt aufrufen und eine JSON-Antwort erhalten, verwenden Sie die Aktion Parse JSON, um die JSON-Antwort zu verarbeiten. Andernfalls kann die Aktion Array filtern nur den Antworttext und nicht die Struktur der JSON-Nutzlast lesen.
Öffnen Sie (sofern nicht bereits geschehen) im Azure-Portal, in Visual Studio oder Visual Studio Code Ihren Logik-App-Workflow im Designer.
In diesem Beispiel werden das Azure-Portal und ein Beispielworkflow mit einem Trigger des Typs Wiederholung verwendet, gefolgt von einer Aktion Initialize variable. Die Aktion ist zur Erstellung eines Arrays konzipiert, das einige ganzzahlige Beispielwerte als Ausgangswert enthält.
Hinweis
In diesem Beispiel wird zwar ein einfaches Integer-Array verwendet, aber diese Aktion ist besonders nützlich für JSON-Objektarrays, bei denen Sie basierend auf den Eigenschaften und Werten der Objekte filtern können.
Führen Sie in Ihrem Workflow, in dem Sie das gefilterte Array erstellen möchten, einen dieser Schritte aus:
Zum Hinzufügen einer Aktion unter dem letzten Schritt wählen Sie Neuer Schritt aus.
Zum Hinzufügen einer Aktion zwischen Schritten bewegen Sie den Mauszeiger über den Verbindungspfeil, sodass das Pluszeichen ( + ) angezeigt wird. Wählen Sie das Pluszeichen und dann die Option Aktion hinzufügen aus.
Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Integriert aus. Geben Sie im Suchfeld filter array ein.
Wählen Sie in der Liste der Aktionen die Aktion Filter array aus.
Geben Sie im Feld Aus das Array oder den Ausdruck ein, das bzw. der als Filter verwendet werden soll.
Wählen Sie in diesem Beispiel das Feld Von aus, wodurch die Liste dynamischer Inhalte geöffnet wird. Wählen Sie in dieser Liste die zuvor erstellte Variable aus:
Geben Sie für die Bedingung die zu vergleichenden Arrayelemente an, wählen Sie den Vergleichsoperator aus, und geben Sie den Vergleichswert an.
In diesem Beispiel wird die Funktion item() zum Zugreifen auf die einzelnen Elemente im Array verwendet, während mit der Aktion Filter array nach Arrayelementen gesucht wird, deren Wert größer als 1 ist: Der folgende Screenshot zeigt die fertige Beispielaktion Filter array:
Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.
Testen Ihres Workflows
Sie können sich vergewissern, dass mit der Aktion Filter array die erwarteten Ergebnisse erstellt werden, indem Sie an sich selbst eine Benachrichtigung senden, die die Ausgabe der Aktion Filter array enthält.
Fügen Sie in Ihrem Workflow eine Aktion hinzu, mit der die Ergebnisse der Aktion Filter array an Sie gesendet werden können.
In diesem Beispiel wird die Office 365 Outlook-Aktion E-Mail senden verwendet.
Führen Sie in dieser Aktion die folgenden Schritte aus:
Klicken Sie für jedes Feld, in dem die Ergebnisse angezeigt werden sollen, in das jeweilige Feld, wodurch die Liste mit den dynamischen Inhalten geöffnet wird.
Wählen Sie in dieser Liste Ausdruck aus, um stattdessen den Ausdrucks-Editor zu öffnen.
Um die Arrayausgabe der Aktion Filter array abzurufen, geben Sie den folgenden Ausdruck ein, der die Funktion actionBody() mit dem Aktionsnamen Filter array verwendet. Klicken Sie anschließend auf OK.
actionBody('Filter_array')
Der aufgelöste Ausdruck legt fest, dass die Ausgaben der Aktion Filter_array im E-Mail-Text angezeigt werden, wenn sie gesendet wird:
Speichern Sie Ihren Workflow, und führen Sie den Workflow dann manuell aus. Wählen Sie auf der Symbolleiste des Designers Trigger ausführen>Ausführen aus.
Wenn Sie die Office 365 Outlook-Aktion verwendet haben, erhalten Sie ein Ergebnis ähnlich wie im folgenden Screenshot:
Join-Aktion
Verwenden Sie die Aktion Join, um eine Zeichenfolge zu erstellen, die alle Elemente eines Arrays enthält. Die Elemente sind jeweils mit einem spezifischen Trennzeichen voneinander getrennt. Anschließend können Sie die Zeichenfolge in Aktionen verwenden, die nach der Aktion Join folgen.
Führen Sie die folgenden Schritte im Workflow-Designer aus, um die Aktion Join auszuprobieren. Falls Sie den Codeansicht-Editor bevorzugen, können Sie die beispielhaften Aktionsdefinitionen Join und Initialize variable aus diesem Leitfaden in die Workflowdefinition kopieren, die Ihrer eigenen Logik-App zugrunde liegt: Datenvorgänge: Codebeispiele – Join. Weitere Informationen zur Aktion Join un Ihrer zugrunde liegenden Workflowdefinition finden Sie unter Join-Aktion.
Öffnen Sie (sofern nicht bereits geschehen) im Azure-Portal, in Visual Studio oder Visual Studio Code Ihren Logik-App-Workflow im Designer.
In diesem Beispiel werden das Azure-Portal und ein Beispielworkflow mit einem Trigger des Typs Wiederholung verwendet, gefolgt von einer Aktion Initialize variable. Die Aktion ist zur Erstellung einer Variablen konzipiert, deren Ausgangswert ein Array mit einigen ganzzahligen Beispielwerten ist.
Führen Sie in Ihrem Workflow, in dem Sie eine Zeichenfolge aus einem Array erstellen möchten, einen dieser Schritte aus:
Zum Hinzufügen einer Aktion unter dem letzten Schritt wählen Sie Neuer Schritt aus.
Zum Hinzufügen einer Aktion zwischen Schritten bewegen Sie den Mauszeiger über den Verbindungspfeil, sodass das Pluszeichen ( + ) angezeigt wird. Wählen Sie das Pluszeichen und dann die Option Aktion hinzufügen aus.
Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Integriert aus. Geben Sie im Suchfeld join ein.
Wählen Sie in der Liste der Aktionen die Aktion Join aus.
Geben Sie im Feld Aus das Array an, dessen Elemente Sie als Zeichenfolge verknüpfen möchten.
Klicken Sie in diesem Beispiel in das Feld Von, wodurch die Liste dynamischer Inhalte geöffnet wird. Wählen Sie in dieser Liste die zuvor erstellte Variable aus:
Geben Sie im Feld Verknüpfen mit das Zeichen ein, das Sie zum Trennen der einzelnen Arrayelemente verwenden möchten.
In diesem Beispiel wird ein Doppelpunkt (:) als Trennzeichen verwendet.
Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.
Testen Ihres Workflows
Sie können sich vergewissern, dass mit der Aktion Join die erwarteten Ergebnisse erstellt werden, indem Sie an sich selbst eine Benachrichtigung senden, die die Ausgabe der Aktion Join enthält.
Fügen Sie in Ihrem Workflow eine Aktion hinzu, mit der die Ergebnisse der Aktion Join an Sie gesendet werden können.
In diesem Beispiel wird die Office 365 Outlook-Aktion E-Mail senden verwendet.
Klicken Sie in dieser Aktion für jedes Feld, in dem die Ergebnisse angezeigt werden sollen, in das jeweilige Feld, wodurch die Liste mit den dynamischen Inhalten geöffnet wird. Wählen Sie in dieser Liste unter der Aktion Join (Verknüpfen) die Option Ausgabe aus.
Hinweis
Wenn in der Liste der dynamischen Inhalte die Meldung Es wurden keine Ausgaben gefunden, die diesem Eingabeformat entsprechen angezeigt wird, klicken Sie in der Liste neben Join auf Mehr anzeigen.
Speichern Sie Ihren Workflow, und führen Sie den Workflow dann manuell aus. Wählen Sie auf der Symbolleiste des Designers Trigger ausführen>Ausführen aus.
Wenn Sie die Office 365 Outlook-Aktion verwendet haben, erhalten Sie ein Ergebnis ähnlich wie im folgenden Screenshot:
Aktion „Parse JSON“
Um auf Eigenschaften in JSON-Inhalten (JavaScript Object Notation) zu verweisen oder darauf zuzugreifen, können Sie benutzerfreundliche Felder oder Token für diese Eigenschaften erstellen, indem Sie die Aktion Parse JSON verwenden. Dadurch können Sie diese Eigenschaften in der Liste mit den dynamischen Inhalten auswählen, wenn Sie Eingaben für nachfolgende Aktionen in Ihrem Workflow angeben. Für diese Aktion können Sie entweder ein JSON-Schema angeben oder aus dem JSON-Inhalt oder der Nutzlast Ihres Beispiels generieren.
Führen Sie die folgenden Schritte im Workflow-Designer aus, um die Aktion Parse JSON auszuprobieren. Falls Sie den Codeansicht-Editor bevorzugen, können Sie die beispielhaften Aktionsdefinitionen Parse JSON und Initialize variable aus diesem Leitfaden in die Workflowdefinition kopieren, die Ihrer eigenen Logik-App zugrunde liegt: Datenvorgänge: Codebeispiele – Parse JSON. Weitere Informationen zu dieser Aktion in Ihrer zugrunde liegenden Workflowdefinition finden Sie unter Aktion „Parse JSON“.
Öffnen Sie (sofern nicht bereits geschehen) im Azure-Portal, in Visual Studio oder Visual Studio Code Ihren Logik-App-Workflow im Designer.
In diesem Beispiel werden das Azure-Portal und ein Beispielworkflow mit einem Trigger des Typs Wiederholung verwendet, gefolgt von einer Aktion Initialize variable. Die Aktion ist zur Erstellung einer Variablen konzipiert, deren Ausgangswert das folgende JSON-Objekt mit Eigenschaften und Werten ist:
{ "Member": { "Email": "Sophia.Owen@fabrikam.com", "FirstName": "Sophia", "LastName": "Owen" } }
Führen Sie in Ihrem Workflow, in dem Sie das JSON-Objekt analysieren möchten, einen dieser Schritte aus:
Zum Hinzufügen einer Aktion unter dem letzten Schritt wählen Sie Neuer Schritt aus.
Zum Hinzufügen einer Aktion zwischen Schritten bewegen Sie den Mauszeiger über den Verbindungspfeil, sodass das Pluszeichen ( + ) angezeigt wird. Wählen Sie das Pluszeichen und dann die Option Aktion hinzufügen aus.
Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Integriert aus. Geben Sie im Suchfeld parse json ein.
Wählen Sie in der Liste der Aktionen die Aktion Parse JSON aus.
Geben Sie im Feld Inhalt das JSON-Objekt an, das Sie analysieren möchten.
Klicken Sie in diesem Beispiel in das Feld Inhalt, wodurch die Liste dynamischer Inhalte geöffnet wird. Wählen Sie in dieser Liste die zuvor erstellte Variable aus:
Geben Sie im Feld Schema das JSON-Schema ein, das das JSON-Objekt oder die Nutzdaten beschreibt, das bzw. die Sie analysieren möchten.
Verwenden Sie für dieses Beispiel das folgende Schema für das JSON-Beispielobjekt:
{ "type": "object", "properties": { "Member": { "type": "object", "properties": { "Email": { "type": "string" }, "FirstName": { "type": "string" }, "LastName": { "type": "string" } } } } }
Wenn Sie über kein Schema verfügen, können Sie das Schema aus dem JSON-Objekt generieren:
Wählen Sie in der Aktion Parse JSON im Feld Schema die Option Beispielnutzlast zum Generieren eines Schemas verwenden aus.
Geben Sie im Feld Geben oder fügen Sie eine JSON-Beispielnutzlast ein den JSON-Inhalt oder das JSON-Objekt ein, und wählen Sie dann Fertig aus. Beispiel:
{ "Member": { "Email": "Sophia.Owen@fabrikam.com", "FirstName": "Sophia", "LastName": "Owen" } }
Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.
Testen Ihres Workflows
Sie können sich vergewissern, dass mit der Aktion Parse JSON die erwarteten Ergebnisse erstellt werden, indem Sie an sich selbst eine Benachrichtigung senden, die die Ausgabe der Aktion Parse JSON enthält.
Fügen Sie in Ihrem Workflow eine Aktion hinzu, mit der die Ergebnisse der Aktion Parse JSON an Sie gesendet werden können.
In diesem Beispiel wird die Office 365 Outlook-Aktion E-Mail senden verwendet.
Klicken Sie in dieser Aktion für jedes Bearbeitungsfeld, in dem die Ergebnisse angezeigt werden sollen, in das jeweilige Feld, wodurch die Liste mit den dynamischen Inhalten geöffnet wird. In dieser Liste können Sie unter der Aktion Parse JSON (JSON analysieren) nun die Eigenschaften des analysierten JSON-Objekts auswählen.
In diesem Beispiel werden die folgenden Eigenschaften ausgewählt: FirstName, LastName und Email
Hinweis
Wenn in der Liste der dynamischen Inhalte die Meldung Es wurden keine Ausgaben gefunden, die diesem Eingabeformat entsprechen angezeigt wird, klicken Sie in der Liste neben Parse JSON auf Mehr anzeigen.
Wenn Sie fertig sind, ähnelt die Aktion Send an email dem folgenden Beispiel:
Speichern Sie Ihren Workflow, und führen Sie den Workflow dann manuell aus. Wählen Sie auf der Symbolleiste des Designers Trigger ausführen>Ausführen aus.
Wenn Sie die Office 365 Outlook-Aktion verwendet haben, erhalten Sie ein Ergebnis ähnlich wie im folgenden Screenshot:
Aktion select
Standardmäßig erstellt die Auswahlaktion ein Array, das JSON-Objekte enthält, die aus den Werten in einem vorhandenen Array erstellt wurden. Sie können zum Beispiel für jeden Wert in einem Integer-Array ein JSON-Objekt erstellen, indem Sie die Eigenschaften angeben, die jedes JSON-Objekt aufweisen muss, und die Werte aus dem Quellarray diesen Eigenschaften zuordnen. Sie können die Komponenten in diesen JSON-Objekten zwar ändern, aber das Ausgabearray weist immer die gleiche Anzahl von Elementen wie das Quellarray auf. Um die Arrayausgabe der Aktion Select zu verwenden, müssen nachfolgende Aktionen entweder Arrays als Eingabe akzeptieren, oder Sie müssen die Arrayausgabe ggf. in ein anderes, kompatibles Format konvertieren.
Führen Sie die folgenden Schritte im Workflow-Designer aus, um die Aktion Select auszuprobieren. Falls Sie den Codeansicht-Editor bevorzugen, können Sie die beispielhaften Aktionsdefinitionen Select und Initialize variable aus diesem Leitfaden in die Workflowdefinition kopieren, die Ihrer eigenen Logik-App zugrunde liegt: Datenvorgänge: Codebeispiele – Select. Weitere Informationen zu dieser Aktion in Ihrer zugrunde liegenden Workflowdefinition finden Sie unter Aktion „Select“.
Tipp
Ein Beispiel zum Erstellen eines Arrays mit Zeichenfolgen oder ganzzahligen Zahlen, die aus den Werten in einem JSON-Objektarray erstellt werden, finden Sie in den Aktionsdefinitionen "Auswählen" und "Initliaze"-Variablen in Codebeispielen für Datenoperationen – Select.
Öffnen Sie (sofern nicht bereits geschehen) im Azure-Portal, in Visual Studio oder Visual Studio Code Ihren Logik-App-Workflow im Designer.
In diesem Beispiel werden das Azure-Portal und ein Beispielworkflow mit einem Trigger des Typs Wiederholung verwendet, gefolgt von einer Aktion Initialize variable. Die Aktion ist zur Erstellung einer Variablen konzipiert, deren Ausgangswert ein Array mit einigen ganzzahligen Beispielwerten ist.
Führen Sie in Ihrem Workflow, in dem Sie das JSON-Objektarray erstellen möchten, einen dieser Schritte aus:
Zum Hinzufügen einer Aktion unter dem letzten Schritt wählen Sie Neuer Schritt aus.
Zum Hinzufügen einer Aktion zwischen Schritten bewegen Sie den Mauszeiger über den Verbindungspfeil, sodass das Pluszeichen ( + ) angezeigt wird. Wählen Sie das Pluszeichen und dann die Option Aktion hinzufügen aus.
Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Integriert aus. Geben Sie im Suchfeld select ein.
Wählen Sie in der Liste der Aktionen die Aktion Select aus.
Geben Sie im Feld Aus das Quellarray ein, das Sie verwenden möchten.
Klicken Sie in diesem Beispiel in das Feld Von, wodurch die Liste dynamischer Inhalte geöffnet wird. Wählen Sie in dieser Liste die zuvor erstellte Variable aus:
Geben Sie für die Eigenschaft Map in der linken Spalte einen Eigenschaftennamen ein, um alle Werte im Quellarray zu beschreiben.
In diesem Beispiel wird Product_ID als Eigenschaftenname für die ganzzahligen Werte im Quellarray verwendet. Daher handelt es sich bei jedem Wert, z. B. 1, 2, 3 und 4, um eine Produkt-ID.
Geben Sie in der rechten Spalte einen Ausdruck ein, der den Wert im Quellarray für den Eigenschaftennamen in der linken Spalte angibt.
In diesem Beispiel wird die Funktion item() verwendet, um jedes Element im Array zu durchlaufen und darauf zuzugreifen.
Klicken Sie in die rechte Spalte, wodurch die Liste dynamischer Inhalte geöffnet wird.
Wählen Sie in dieser Liste Ausdruck aus, um stattdessen den Ausdrucks-Editor zu öffnen.
Geben Sie im Ausdrucks-Editor die Funktion item() ein, und wählen Sie dann OK aus.
Die Aktion Select ähnelt nun dem folgenden Beispiel:
Speichern Sie den Workflow. Wählen Sie auf der Symbolleiste des Designers Speichern aus.
Testen Ihres Workflows
Sie können sich vergewissern, dass mit der Aktion Select die erwarteten Ergebnisse erstellt werden, indem Sie an sich selbst eine Benachrichtigung senden, die die Ausgabe der Aktion Select enthält.
Fügen Sie in Ihrem Workflow eine Aktion hinzu, mit der die Ergebnisse der Aktion Select an Sie gesendet werden können.
In diesem Beispiel wird die Office 365 Outlook-Aktion E-Mail senden verwendet.
Führen Sie in dieser Aktion die folgenden Schritte aus:
Klicken Sie für jedes Feld, in dem die Ergebnisse angezeigt werden sollen, in das jeweilige Feld, wodurch die Liste mit den dynamischen Inhalten geöffnet wird.
Wählen Sie in dieser Liste Ausdruck aus, um stattdessen den Ausdrucks-Editor zu öffnen.
Um die Arrayausgabe der Aktion Select abzurufen, geben Sie den folgenden Ausdruck ein, der die Funktion actionBody() mit dem Aktionsnamen Select verwendet. Klicken Sie anschließend auf OK.
actionBody('Select')
Der aufgelöste Ausdruck legt fest, dass die Ausgaben der Aktion Select im E-Mail-Text angezeigt werden, wenn sie gesendet wird:
Wenn Sie fertig sind, ähnelt die Aktion Send an email dem folgenden Beispiel:
Speichern Sie Ihren Workflow, und führen Sie den Workflow dann manuell aus. Wählen Sie auf der Symbolleiste des Designers Trigger ausführen>Ausführen aus.
Wenn Sie die Office 365 Outlook-Aktion verwendet haben, erhalten Sie ein Ergebnis ähnlich wie im folgenden Screenshot:
Problembehandlung
Formatieren von Tabellendaten
Wenn Ihre CSV-Tabelle oder HTML-Tabelle mit einer falschen Formatierung zurückgegeben wird, stellen Sie sicher, dass Ihre Eingabedaten Zeilenumbrüche zwischen den Zeilen aufweisen.
Falsche Formatierung:
Fruit,Number Apples,1 Oranges,2
Richtige Formatierung:
Fruit,Number
Apples,1
Oranges,2
Um Zeilenumbrüche zwischen Zeilen hinzuzufügen, fügen Sie Ihrer Tabelle einen der folgenden Ausdrücke hinzu:
replace(body('Create_CSV_table'),'','<br/>')
replace(body('Create_HTML_table'),'','<br/>')
Beispiel:
{
"Send_an_email_": {
"inputs": {
"body": {
"Body": "<p>Results from Create CSV table action:<br/>\n<br/>\n<br/>\n@{replace(body('Create_CSV_table'),'\r\n','<br/>')}</p>",
"Subject": "Create CSV table results",
"To": "sophia.owen@fabrikam.com"
}
}
}
}