Gegevensbewerkingen uitvoeren in Azure Logic Apps
Van toepassing op: Azure Logic Apps (verbruik + standaard)
In deze handleiding ziet u hoe u op de volgende manieren met gegevens in de werkstroom van uw logische app kunt werken:
- Maak een tekenreeks of JSON-object (JavaScript Object Notation) op basis van meerdere invoergegevens met verschillende gegevenstypen. U kunt deze tekenreeks vervolgens gebruiken als één invoer, in plaats van herhaaldelijk dezelfde invoer in te voeren.
- Maak gebruiksvriendelijke tokens van JSON-objecteigenschappen (JavaScript Object Notation), zodat u deze eigenschappen eenvoudig in uw werkstroom kunt gebruiken.
- Maak een HTML- of CSV-tabel op basis van een matrix.
- Maak een matrix van een andere matrix op basis van een opgegeven filter of voorwaarde.
- Maak een matrix op basis van de opgegeven eigenschappen voor alle items in een andere matrix.
- Maak een tekenreeks van alle items in een matrix en scheid deze items met behulp van een opgegeven teken.
Bekijk de functies voor gegevensbewerking die Azure Logic Apps biedt voor andere manieren om met gegevens te werken.
Vereisten
Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meld u dan aan voor een gratis Azure-account.
De werkstroom van de logische app waarin u de gegevensbewerking wilt uitvoeren. Deze werkstroom moet al een trigger hebben als eerste stap in uw werkstroom. De logische app-werkstromen Verbruik en Standaard ondersteunen de gegevensbewerkingen die in deze handleiding worden beschreven.
Alle gegevensbewerkingen zijn alleen beschikbaar als acties. Voordat u deze acties kunt gebruiken, moet uw werkstroom dus al beginnen met een trigger en alle andere acties bevatten die nodig zijn om de uitvoer te maken die u in de gegevensbewerking wilt gebruiken.
Bewerkingsacties voor gegevens
De volgende secties bevatten een overzicht van de gegevensbewerkingen die u kunt gebruiken en zijn geordend op basis van de brongegevenstypen waarop de bewerkingen worden uitgevoerd, maar elke beschrijving wordt alfabetisch weergegeven.
JSON-acties
Met de volgende acties kunt u werken met gegevens in de JSON-indeling (JavaScript Object Notation).
Actie | Beschrijving |
---|---|
Compose | Maak een bericht of tekenreeks op basis van meerdere invoerwaarden die verschillende gegevenstypen kunnen hebben. U kunt deze tekenreeks vervolgens gebruiken als één invoer, in plaats van herhaaldelijk dezelfde invoer in te voeren. U kunt bijvoorbeeld één JSON-bericht maken op basis van verschillende invoergegevens. |
JSON parseren | Maak gebruiksvriendelijke gegevenstokens voor eigenschappen in JSON-inhoud, zodat u de eigenschappen in uw logische apps eenvoudiger kunt gebruiken. |
Zie Geavanceerde JSON-transformaties uitvoeren met Liquid-sjablonen als u complexere JSON-transformaties wilt maken.
Matrixacties
Met de volgende acties kunt u werken met gegevens in matrices.
Actie | Beschrijving |
---|---|
CSV-tabel maken | Maak een csv-tabel (door komma's gescheiden waarden) van een matrix. |
HTML-tabel maken | Maak een HTML-tabel op basis van een matrix. |
Matrix filteren | Maak een matrixsubset van een matrix op basis van het opgegeven filter of de opgegeven voorwaarde. |
Deelnemen | Maak een tekenreeks van alle items in een matrix en scheid elk item met het opgegeven teken. |
Selecteer | Maak een matrix van de opgegeven eigenschappen voor alle items in een andere matrix. |
Actie opstellen
Als u één uitvoer wilt maken, zoals een JSON-object, op basis van meerdere invoerwaarden, gebruikt u de actie Opstellen. Uw invoer kan verschillende typen hebben, zoals gehele getallen, Booleaanse waarden, matrices, JSON-objecten en elk ander systeemeigen type dat azure Logic Apps ondersteunt, bijvoorbeeld binair en XML. U kunt de uitvoer vervolgens gebruiken in acties die volgen na de actie Opstellen . Met de actie Opstellen voorkomt u ook dat u herhaaldelijk dezelfde invoert tijdens het bouwen van de werkstroom van uw logische app.
U kunt bijvoorbeeld een JSON-bericht samenstellen op basis van meerdere variabelen, zoals tekenreeksvariabelen waarin de voor- en achternamen van personen worden opgeslagen, en een variabele met gehele getallen waarin de leeftijden van personen worden opgeslagen. In dit voorbeeld accepteert de actie Opstellen de volgende invoer:
{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }
en maakt de volgende uitvoer:
{"age":35,"fullName":"Owens,Sophia"}
Als u de actie Opstellen wilt proberen, volgt u deze stappen met behulp van de werkstroomontwerper. Als u liever in de codeweergave-editor werkt, kunt u de voorbeelddefinities van de actie voor het opstellen en initialiseren van variabelen uit deze handleiding kopiëren naar de onderliggende werkstroomdefinitie van uw eigen logische app: Voorbeelden van gegevensbewerkingscode - Opstellen. Zie de actie Opstellen voor meer informatie over de actie Opstellen in de onderliggende JSON-werkstroomdefinitie.
Open in de Azure Portal, Visual Studio of Visual Studio Code de werkstroom van uw logische app in de ontwerpfunctie.
In dit voorbeeld wordt gebruikgemaakt van de Azure Portal en een voorbeeldwerkstroom met de trigger Terugkeerpatroon, gevolgd door verschillende acties voor het initialiseren van variabelen. Deze acties zijn ingesteld om twee tekenreeksvariabelen en een geheel getal te maken.
Voer een van deze stappen uit in de werkstroom waarin u de uitvoer wilt maken:
Als u een actie wilt toevoegen onder de laatste stap, selecteert u Nieuwe stap.
Als u een actie tussen stappen wilt toevoegen, beweegt u de muisaanwijzer over de verbindingspijl zodat het plusteken (+) wordt weergegeven. Selecteer het plusteken en selecteer vervolgens Een actie toevoegen.
Selecteer in het zoekvak Kies een bewerkingde optie Ingebouwd. Voer opstellen in het zoekvak in.
Selecteer in de lijst met acties de actie Met de naam Opstellen.
Voer in het vak Invoer de invoer in die moet worden gebruikt voor het maken van de uitvoer.
Voor dit voorbeeld selecteert u in het vak Invoer , waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabelen:
In de volgende schermopname ziet u het voltooide voorbeeld van de actie Opstellen :
Sla uw werkstroom op. Selecteer Opslaan op de werkbalk van de ontwerper.
Uw werkstroom testen
Als u wilt controleren of de actie Opstellen de verwachte resultaten oplevert, stuurt u uzelf een melding met uitvoer van de actie Opstellen .
Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie Opstellen kunt verzenden.
In dit voorbeeld wordt verder gebruikgemaakt van de outlook-actie Office 365 met de naam Een e-mail verzenden.
Selecteer in deze actie voor elk vak waarin u de resultaten wilt weergeven in elk vak, zodat de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst onder de actie Opstellen de optie Uitvoer.
In dit voorbeeld wordt het resultaat weergegeven in de hoofdtekst van de e-mail, dus voeg het veld Uitvoer toe aan het vak Hoofdtekst .
Sla uw werkstroom op en voer de werkstroom vervolgens handmatig uit. Selecteer triggeruitvoering> uitvoeren op de werkbalk van de ontwerpfunctie.
Als u de actie Office 365 Outlook hebt gebruikt, krijgt u een resultaat dat vergelijkbaar is met de volgende schermafbeelding:
Actie CSV-tabel maken
Als u een csv-tabel (door komma's gescheiden waarden) wilt maken met de eigenschappen en waarden van JSON-objecten (JavaScript Object Notation) in een matrix, gebruikt u de actie CSV-tabel maken. U kunt de resulterende tabel vervolgens gebruiken in acties die volgen op de actie CSV-tabel maken .
Als u de actie CSV-tabel maken wilt proberen, volgt u deze stappen met behulp van de werkstroomontwerper. Als u liever in de codeweergave-editor werkt, kunt u het voorbeeld CSV-tabel maken en definities van variabelenactie initialiseren uit deze handleiding kopiëren naar de onderliggende werkstroomdefinitie van uw eigen logische app: Voorbeelden van gegevensbewerkingscode - CSV-tabel maken. Zie de actie Tabel voor meer informatie over de actie CSV-tabel maken in de onderliggende JSON-werkstroomdefinitie.
Open in de Azure Portal, Visual Studio of Visual Studio Code de werkstroom van uw logische app in de ontwerpfunctie.
In dit voorbeeld wordt gebruikgemaakt van de Azure Portal en een voorbeeldwerkstroom met de trigger Terugkeerpatroon, gevolgd door de actie Variabele initialiseren. De actie wordt ingesteld om een variabele te maken waarbij de initiële waarde een matrix is met enkele eigenschappen en waarden in JSON-indeling.
Voer een van deze stappen uit in de werkstroom waarin u de CSV-tabel wilt maken:
Als u een actie wilt toevoegen onder de laatste stap, selecteert u Nieuwe stap.
Als u een actie tussen stappen wilt toevoegen, beweegt u de muisaanwijzer over de verbindingspijl zodat het plusteken (+) wordt weergegeven. Selecteer het plusteken en selecteer vervolgens Een actie toevoegen.
Selecteer in het zoekvak Kies een bewerkingde optie Ingebouwd. Voer csv-tabel maken in het zoekvak in.
Selecteer in de lijst met acties de actie met de naam CSV-tabel maken.
Voer in het vak Van de matrix of expressie in die moet worden gebruikt voor het maken van de tabel.
In dit voorbeeld selecteert u in het vak Van , waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:
Notitie
Als u gebruiksvriendelijke tokens wilt maken voor de eigenschappen in JSON-objecten, zodat u deze eigenschappen als invoer kunt selecteren, gebruikt u de actie JSON parseren voordat u de actie CSV-tabel maken gebruikt.
In de volgende schermopname ziet u het voltooide voorbeeld van de actie CSV-tabel maken :
Sla uw werkstroom op. Selecteer Opslaan op de werkbalk van de ontwerper.
Tabelindeling aanpassen
Standaard is de eigenschap Kolommen zo ingesteld dat de tabelkolommen automatisch worden gemaakt op basis van de matrixitems. Voer de volgende stappen uit om aangepaste headers en waarden op te geven:
Als de eigenschap Kolommen niet wordt weergegeven in het actie-informatievak, selecteert u Kolommen in de lijst Nieuwe parameters toevoegen.
Open de lijst Kolommen en selecteer Aangepast.
Geef in de eigenschap Koptekst de aangepaste koptekst op die in plaats daarvan moet worden gebruikt.
Geef in de eigenschap Waarde de aangepaste waarde op die in plaats daarvan moet worden gebruikt.
Als u waarden wilt retourneren uit de matrix, kunt u de item()
functie gebruiken met de actie CSV-tabel maken . In een For_each
lus kunt u de items()
functie gebruiken.
Stel dat u tabelkolommen wilt die alleen de eigenschapswaarden bevatten en niet de eigenschapsnamen uit een matrix. Als u alleen deze waarden wilt retourneren, volgt u deze stappen voor het werken in de ontwerpweergave of in de codeweergave.
In dit voorbeeld wordt het volgende resultaat geretourneerd:
Apples,1
Oranges,2
Werken in de ontwerpweergave
Houd in de actie CSV-tabel maken de kolom Koptekst leeg. Wijs in elke rij in de kolom Waarde elke gewenste matrixeigenschap af. Elke rij onder Waarde retourneert alle waarden voor de opgegeven matrixeigenschap en wordt een kolom in de tabel.
Selecteer voor elke gewenste matrixeigenschap in de kolom Waarde de optie in het invoervak, waarmee de lijst met dynamische inhoud wordt geopend.
Selecteer expressie in die lijst om in plaats daarvan de expressie-editor te openen.
Voer in de expressie-editor de volgende expressie in, maar vervang door
<array-property-name>
de naam van de matrixeigenschap voor de gewenste waarde.Syntaxis:
item()?['<array-property-name>']
Voorbeelden:
item()?['Description']
item()?['Product_ID']
Herhaal de voorgaande stappen voor elke matrixeigenschap. Wanneer u klaar bent, ziet uw actie eruit zoals in het volgende voorbeeld:
Als u expressies wilt omzetten in meer beschrijvende versies, schakelt u over naar de codeweergave en terug naar de ontwerpweergave en opent u de samengevouwen actie opnieuw:
De actie CSV-tabel maken lijkt nu op het volgende voorbeeld:
Werken in de codeweergave
Stel in de JSON-definitie van de actie in de columns
matrix de header
eigenschap in op een lege tekenreeks. Deductie voor elke gewenste matrixeigenschap voor elke value
eigenschap.
Schakel vanuit de ontwerpfunctie over naar de codeweergave.
- Verbruik: selecteer codeweergave op de werkbalk van de ontwerper.
- Standaard: selecteer in het navigatiemenu van de werkstroom onder Ontwikkelaarde optie Code.
Zoek in de code-editor de matrix van
columns
de actie. Voeg voor elke gewenste kolom met matrixwaarden een legeheader
eigenschap en de volgende expressie toe voor devalue
eigenschap:Syntaxis:
{ "header": "", "value": "@item()?['<array-property-name>']" }
Voorbeeld:
"Create_CSV_table": { "inputs": { "columns": [ { "header": "", "value": "@item()?['Description']" }, { "header": "", "value": "@item()?['Product_ID']" } ], "format": "CSV", "from": "@variables('myJSONArray')" } }
Ga terug naar de ontwerpweergave om de resultaten te bekijken.
Uw werkstroom testen
Als u wilt controleren of de actie CSV-tabel maken de verwachte resultaten oplevert, stuurt u uzelf een melding met uitvoer van de actie CSV-tabel maken .
Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie CSV-tabel maken kunt verzenden.
In dit voorbeeld wordt verder gebruikgemaakt van de Office 365 Outlook-actie met de naam Een e-mail verzenden.
In deze actie selecteert u voor elk vak waarin u de resultaten wilt weergeven, in het vak, zodat de lijst met dynamische inhoud wordt geopend. Selecteer uitvoer onder de actie CSV-tabel maken.
Notitie
Als in de lijst met dynamische inhoud het bericht Wordt geen uitvoer gevonden die overeenkomt met deze invoerindeling, selecteert u Meer weergeven naast het label CSV-tabel maken in de lijst.
Sla uw werkstroom op en voer de werkstroom handmatig uit. Selecteer Op de werkbalk van de ontwerper de optie Trigger uitvoeren>Uitvoeren.
Als u de Office 365 Outlook-actie hebt gebruikt, krijgt u een resultaat dat vergelijkbaar is met de volgende schermafbeelding:
Notitie
Als de tabel wordt geretourneerd met een onjuiste opmaak, raadpleegt u de opmaak van de tabelgegevens controleren.
Html-tabelactie maken
Als u een HTML-tabel wilt maken met de eigenschappen en waarden van JSON-objecten (JavaScript Object Notation) in een matrix, gebruikt u de actie HTML-tabel maken . Vervolgens kunt u de resulterende tabel gebruiken in acties die volgen op de actie HTML-tabel maken .
Als u de actie HTML-tabel maken wilt proberen , volgt u deze stappen met behulp van de werkstroomontwerper. Als u liever in de codeweergave-editor werkt, kunt u het voorbeeld HTML-tabel maken en definities van variabeleacties uit deze handleiding kopiëren naar de onderliggende werkstroomdefinitie van uw eigen logische app: Voorbeelden van gegevensbewerkingscode - HTML-tabel maken. Zie de actie Tabel voor meer informatie over de actie HTML-tabel maken in de onderliggende JSON-werkstroomdefinitie.
Open in de Azure Portal, Visual Studio of Visual Studio Code de werkstroom van uw logische app in de ontwerpfunctie.
In dit voorbeeld wordt gebruikgemaakt van de Azure Portal en een voorbeeldwerkstroom met de trigger Terugkeerpatroon, gevolgd door de actie Variabele initialiseren. De actie is ingesteld om een variabele te maken waarbij de oorspronkelijke waarde een matrix is met enkele eigenschappen en waarden in JSON-indeling.
Voer een van de volgende stappen uit in de werkstroom waarin u een HTML-tabel wilt maken:
Als u een actie wilt toevoegen onder de laatste stap, selecteert u Nieuwe stap.
Als u een actie tussen stappen wilt toevoegen, beweegt u de muisaanwijzer over de verbindingspijl, zodat het plusteken (+) wordt weergegeven. Selecteer het plusteken en selecteer vervolgens Een actie toevoegen.
Selecteer in het zoekvak Kies een bewerkingde optie Ingebouwd. Voer html-tabel maken in het zoekvak in.
Selecteer in de lijst met acties de actie met de naam HTML-tabel maken.
Voer in het vak Van de matrix of expressie in die u wilt gebruiken voor het maken van de tabel.
Voor dit voorbeeld selecteert u in het vak Van , waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:
Notitie
Als u gebruiksvriendelijke tokens wilt maken voor de eigenschappen in JSON-objecten, zodat u deze eigenschappen als invoer kunt selecteren, gebruikt u de actie JSON parseren voordat u de actie HTML-tabel maken gebruikt.
In de volgende schermopname ziet u de voltooide voorbeeldactie HTML-tabel maken :
Sla uw werkstroom op. Selecteer Opslaan op de werkbalk van de ontwerper.
Tabelindeling aanpassen
De eigenschap Kolommen is standaard ingesteld op het automatisch maken van de tabelkolommen op basis van de matrixitems. Voer de volgende stappen uit om aangepaste headers en waarden op te geven:
Open de lijst Kolommen en selecteer Aangepast.
Geef in de eigenschap Header de aangepaste koptekst op die in plaats daarvan moet worden gebruikt.
Geef in de eigenschap Waarde de aangepaste waarde op die in plaats daarvan moet worden gebruikt.
Als u waarden uit de matrix wilt retourneren, kunt u de item()
functie gebruiken met de actie HTML-tabel maken . In een For_each
lus kunt u de items()
functie gebruiken.
Stel dat u tabelkolommen wilt die alleen de eigenschapswaarden bevatten en niet de eigenschapsnamen uit een matrix. Als u alleen deze waarden wilt retourneren, volgt u deze stappen voor het werken in de ontwerpweergave of in de codeweergave.
In dit voorbeeld wordt het volgende resultaat geretourneerd:
Apples,1
Oranges,2
Werken in de ontwerpweergave
Houd in de actie HTML-tabel maken de kolom Koptekst leeg. Deductie van elke gewenste matrixeigenschap in elke rij in de kolom Waarde . Elke rij onder Waarde retourneert alle waarden voor de opgegeven matrixeigenschap en wordt een kolom in de tabel.
Voor elke gewenste matrixeigenschap selecteert u in de kolom Waarde in het invoervak, waarmee de lijst met dynamische inhoud wordt geopend.
Selecteer expressie in die lijst om in plaats daarvan de expressie-editor te openen.
Voer in de expressie-editor de volgende expressie in, maar vervang door
<array-property-name>
de naam van de matrixeigenschap voor de gewenste waarde en selecteer vervolgens OK. Zie de functie item() voor meer informatie.Syntaxis:
item()?['<array-property-name>']
Voorbeelden:
item()?['Description']
item()?['Product_ID']
Herhaal de voorgaande stappen voor elke matrixeigenschap. Wanneer u klaar bent, ziet uw actie eruit zoals in het volgende voorbeeld:
Als u expressies wilt omzetten in meer beschrijvende versies, schakelt u over naar de codeweergave en terug naar de ontwerpweergave en opent u de samengevouwen actie opnieuw:
De actie HTML-tabel maken lijkt nu op het volgende voorbeeld:
Werken in de codeweergave
Stel in de JSON-definitie van de actie in de columns
matrix de header
eigenschap in op een lege tekenreeks. Deductie voor elke gewenste matrixeigenschap voor elke value
eigenschap.
Schakel vanuit de ontwerpfunctie over naar de codeweergave.
- Verbruik: selecteer codeweergave op de werkbalk van de ontwerper.
- Standaard: selecteer in het navigatiemenu van de werkstroom onder Ontwikkelaarde optie Code.
Zoek in de code-editor de matrix van
columns
de actie. Voeg voor elke gewenste kolom met matrixwaarden een legeheader
eigenschap en de volgende expressie toe voor devalue
eigenschap:Syntaxis:
{ "header": "", "value": "@item()?['<array-property-name>']" }
Voorbeeld:
"Create_HTML_table": { "inputs": { "columns": [ { "header": "", "value": "@item()?['Description']" }, { "header": "", "value": "@item()?['Product_ID']" } ], "format": "HTML", "from": "@variables('myJSONArray')" } }
Ga terug naar de ontwerpweergave om de resultaten te bekijken.
Uw werkstroom testen
Als u wilt controleren of de actie HTML-tabel maken de verwachte resultaten maakt, stuurt u uzelf een melding met uitvoer van de actie HTML-tabel maken .
Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie HTML-tabel maken kunt verzenden.
In dit voorbeeld wordt verder gebruikgemaakt van de Office 365 Outlook-actie met de naam Een e-mail verzenden.
In deze actie selecteert u voor elk vak waarin u de resultaten wilt weergeven in elk vak, zodat de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst onder de actie HTML-tabel makende optie Uitvoer.
Notitie
Als in de lijst met dynamische inhoud het bericht Wordt geen uitvoer gevonden die overeenkomt met deze invoerindeling, selecteert u Meer weergeven naast het label HTML-tabel maken in de lijst.
Wanneer u de uitvoer van de HTML-tabel opneemt in een e-mailactie, moet u ervoor zorgen dat u de eigenschap HTML is ingesteld op Ja in de geavanceerde opties van de e-mailactie. Op die manier wordt de HTML-tabel correct opgemaakt met de e-mailactie. Als uw tabel echter wordt geretourneerd met een onjuiste opmaak, raadpleegt u hoe u de tabelgegevensopmaak controleert.
Sla uw werkstroom op en voer de werkstroom handmatig uit. Selecteer Op de werkbalk van de ontwerper de optie Trigger uitvoeren>Uitvoeren.
Als u de Office 365 Outlook-actie hebt gebruikt, krijgt u een resultaat dat vergelijkbaar is met de volgende schermafbeelding:
Matrixactie filteren
Als u een subsetmatrix wilt maken op basis van een bestaande matrix waarbij de subsetitems voldoen aan specifieke criteria, gebruikt u de actie Matrix filteren . U kunt vervolgens de resulterende gefilterde matrix gebruiken in acties die volgen op de actie Matrix filteren .
Als u de actie Matrix filteren wilt proberen, volgt u deze stappen met behulp van de ontwerpfunctie voor werkstromen. Als u liever in de codeweergave-editor werkt, kunt u het voorbeeld van matrix filteren en definities van variabeleacties uit deze handleiding kopiëren naar de onderliggende werkstroomdefinitie van uw eigen logische app: Voorbeelden van gegevensbewerkingscode - Filtermatrix. Zie de actie Query voor meer informatie over de actie Matrix filteren in de onderliggende JSON-werkstroomdefinitie.
Notitie
Alle filtertekst die u in uw voorwaarde gebruikt, is hoofdlettergevoelig. Bovendien kan deze actie de indeling of onderdelen van items in de matrix niet wijzigen.
Voor acties die de matrixuitvoer van de actie Matrix filteren willen gebruiken, moeten deze acties matrices als invoer accepteren of moet u de uitvoermatrix mogelijk transformeren in een andere compatibele indeling.
Als u een HTTP-eindpunt aanroept en een JSON-antwoord ontvangt, gebruikt u de actie JSON parseren om het JSON-antwoord te verwerken. Anders kan de actie Matrix filteren alleen de hoofdtekst van het antwoord lezen en niet de structuur van de JSON-nettolading.
Open in de Azure Portal, Visual Studio of Visual Studio Code de werkstroom van uw logische app in de ontwerpfunctie.
In dit voorbeeld wordt gebruikgemaakt van de Azure Portal en een voorbeeldwerkstroom met de trigger Terugkeerpatroon, gevolgd door de actie Variabele initialiseren. De actie is ingesteld om te maken waarbij de beginwaarde een matrix is met enkele voorbeeldwaarden voor gehele getallen.
Notitie
Hoewel in dit voorbeeld een eenvoudige matrix met gehele getallen wordt gebruikt, is deze actie vooral handig voor JSON-objectmatrices waar u kunt filteren op basis van de eigenschappen en waarden van de objecten.
Voer een van de volgende stappen uit in de werkstroom waarin u de gefilterde matrix wilt maken:
Als u een actie wilt toevoegen onder de laatste stap, selecteert u Nieuwe stap.
Als u een actie tussen stappen wilt toevoegen, beweegt u de muisaanwijzer over de verbindingspijl zodat het plusteken (+) wordt weergegeven. Selecteer het plusteken en selecteer vervolgens Een actie toevoegen.
Selecteer in het zoekvak Kies een bewerkingde optie Ingebouwd. Voer filtermatrix in het zoekvak in.
Selecteer in de lijst met acties de actie met de naam Matrix filteren.
Voer in het vak Van de matrix of expressie in die u als filter wilt gebruiken.
Selecteer voor dit voorbeeld het vak Van , waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:
Geef voor de voorwaarde de matrixitems op die u wilt vergelijken, selecteer de vergelijkingsoperator en geef de vergelijkingswaarde op.
In dit voorbeeld wordt de functie item() gebruikt om toegang te krijgen tot elk item in de matrix, terwijl met de actie Matrixfilter wordt gezocht naar matrixitems waarvan de waarde groter is dan één. In de volgende schermopname ziet u het voltooide voorbeeld van de actie Matrix filteren :
Sla uw werkstroom op. Selecteer Opslaan op de werkbalk van de ontwerper.
Uw werkstroom testen
Als u wilt controleren of de actie Matrix filteren de verwachte resultaten maakt, stuurt u uzelf een melding met uitvoer van de actie Matrix filteren .
Voeg in uw werkstroom een actie toe waarmee u de resultaten van de matrixactie Filter kunt verzenden.
In dit voorbeeld wordt verder gebruikgemaakt van de outlook-actie Office 365 met de naam Een e-mail verzenden.
Voer in deze actie de volgende stappen uit:
Voor elk vak waarin u de resultaten wilt weergeven, selecteert u in elk vak, zodat de lijst met dynamische inhoud wordt geopend.
Selecteer expressie in die lijst om in plaats daarvan de expressie-editor te openen.
Als u de matrixuitvoer van de actie Matrix filteren wilt ophalen, voert u de volgende expressie in, waarbij de functie actionBody() wordt gebruikt met de naam van de actie Filtermatrix en selecteert u vervolgens OK.
actionBody('Filter_array')
De opgeloste expressie geeft aan om de uitvoer van de Filter_array actie weer te geven in de hoofdtekst van de e-mail wanneer deze wordt verzonden:
Sla uw werkstroom op en voer de werkstroom vervolgens handmatig uit. Selecteer triggeruitvoering> uitvoeren op de werkbalk van de ontwerpfunctie.
Als u de actie Office 365 Outlook hebt gebruikt, krijgt u een resultaat dat vergelijkbaar is met de volgende schermafbeelding:
Deelnemen aan actie
Als u een tekenreeks wilt maken die alle items uit een matrix bevat en deze items wilt scheiden met een specifiek scheidingsteken, gebruikt u de actie Samenvoegen . Vervolgens kunt u de tekenreeks gebruiken in acties die volgen op de actie Join .
Als u de actie Join wilt proberen, volgt u deze stappen met behulp van de werkstroomontwerper. Of, als u liever in de codeweergave-editor werkt, kunt u de voorbeelddefinities van de actie Toevoegen en initialiseren uit deze handleiding kopiëren naar de onderliggende werkstroomdefinitie van uw eigen logische app: Voorbeelden van gegevensbewerkingscode - Deelnemen. Zie de actie Deelnemen voor meer informatie over de actie Deelnemen in de onderliggende werkstroomdefinitie.
Open in de Azure Portal, Visual Studio of Visual Studio Code de werkstroom van uw logische app in de ontwerpfunctie.
In dit voorbeeld wordt gebruikgemaakt van de Azure Portal en een voorbeeldwerkstroom met de trigger Terugkeerpatroon, gevolgd door de actie Variabele initialiseren. Deze actie is ingesteld om een variabele te maken waarbij de initiële waarde een matrix is met enkele voorbeeldwaarden voor gehele getallen.
Voer een van de volgende stappen uit in de werkstroom waarin u de tekenreeks wilt maken van een matrix:
Als u een actie wilt toevoegen onder de laatste stap, selecteert u Nieuwe stap.
Als u een actie tussen stappen wilt toevoegen, beweegt u de muisaanwijzer over de verbindingspijl zodat het plusteken (+) wordt weergegeven. Selecteer het plusteken en selecteer vervolgens Een actie toevoegen.
Selecteer in het zoekvak Kies een bewerkingde optie Ingebouwd. Voer join in het zoekvak in.
Selecteer in de lijst met acties de actie met de naam Deelnemen.
Voer in het vak Van de matrix in met de items die u wilt samenvoegen als een tekenreeks.
In dit voorbeeld selecteert u in het vak Van , waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:
Voer in het vak Samenvoegen met het teken in dat moet worden gebruikt om elk matrixitem te scheiden.
In dit voorbeeld wordt een dubbele punt (:) gebruikt als scheidingsteken.
Sla uw werkstroom op. Selecteer Opslaan op de werkbalk van de ontwerper.
Uw werkstroom testen
Als u wilt controleren of de actie Deelnemen de verwachte resultaten oplevert, stuurt u uzelf een melding met uitvoer van de actie Deelnemen .
Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie Deelnemen kunt verzenden.
In dit voorbeeld wordt verder gebruikgemaakt van de outlook-actie Office 365 met de naam Een e-mail verzenden.
Selecteer in deze actie voor elk vak waarin u de resultaten wilt weergeven in elk vak, zodat de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst onder de actie Deelnemen de optie Uitvoer.
Notitie
Als in de lijst met dynamische inhoud het bericht Wordt geen uitvoer gevonden die overeenkomt met deze invoerindeling, selecteert u Meer weergeven naast het label Join in de lijst.
Sla uw werkstroom op en voer de werkstroom vervolgens handmatig uit. Selecteer triggeruitvoering> uitvoeren op de werkbalk van de ontwerpfunctie.
Als u de actie Office 365 Outlook hebt gebruikt, krijgt u een resultaat dat vergelijkbaar is met de volgende schermafbeelding:
JSON-actie parseren
Als u wilt verwijzen naar eigenschappen in JSON-inhoud (JavaScript Object Notation), kunt u gebruiksvriendelijke velden of tokens voor deze eigenschappen maken met behulp van de actie JSON parseren . Op die manier kunt u deze eigenschappen selecteren in de lijst met dynamische inhoud wanneer u invoer voor volgende acties in uw werkstroom opgeeft. Voor deze actie kunt u een JSON-schema opgeven of een JSON-schema genereren op basis van uw JSON-voorbeeldinhoud of -nettolading.
Als u de actie JSON parseren wilt proberen, volgt u deze stappen met behulp van de werkstroomontwerper. Als u liever in de codeweergave-editor werkt, kunt u de voorbeelddefinities van JSON parseren en variabeleactiedefinities uit deze handleiding initialiseren naar de onderliggende werkstroomdefinitie van uw eigen logische app kopiëren: Voorbeelden van gegevensbewerkingscode - JSON parseren. Zie JSON-actie parseren voor meer informatie over deze actie in de onderliggende werkstroomdefinitie.
Open in de Azure Portal, Visual Studio of Visual Studio Code de werkstroom van uw logische app in de ontwerpfunctie.
In dit voorbeeld wordt gebruikgemaakt van de Azure Portal en een voorbeeldwerkstroom met een trigger Terugkeerpatroon, gevolgd door de actie Variabele initialiseren. Deze actie is ingesteld om een variabele te maken waarvan de initiële waarde het volgende JSON-object is met eigenschappen en waarden:
{ "Member": { "Email": "Sophia.Owen@fabrikam.com", "FirstName": "Sophia", "LastName": "Owen" } }
Voer een van de volgende stappen uit in de werkstroom waarin u het JSON-object wilt parseren:
Als u een actie wilt toevoegen onder de laatste stap, selecteert u Nieuwe stap.
Als u een actie tussen stappen wilt toevoegen, beweegt u de muisaanwijzer over de verbindingspijl zodat het plusteken (+) wordt weergegeven. Selecteer het plusteken en selecteer vervolgens Een actie toevoegen.
Selecteer in het zoekvak Kies een bewerkingde optie Ingebouwd. Voer json parseren in het zoekvak in.
Selecteer in de lijst met acties de actie met de naam JSON parseren.
Voer in het vak Inhoud het JSON-object in dat u wilt parseren.
Voor dit voorbeeld selecteert u in het vak Inhoud , waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:
Voer in het vak Schema het JSON-schema in dat het JSON-object of de nettolading beschrijft die u wilt parseren.
Gebruik voor dit voorbeeld het volgende schema voor het JSON-voorbeeldobject:
{ "type": "object", "properties": { "Member": { "type": "object", "properties": { "Email": { "type": "string" }, "FirstName": { "type": "string" }, "LastName": { "type": "string" } } } } }
Als u geen schema hebt, kunt u het schema genereren op basis van het JSON-object:
Selecteer in de actie JSON parseren onder het vak Schema de optie Voorbeeldpayload gebruiken om een schema te genereren.
Voer in het vak Een voorbeeld van een JSON-nettolading invoeren of plakken de JSON-inhoud of het JSON-object in en selecteer gereed, bijvoorbeeld:
{ "Member": { "Email": "Sophia.Owen@fabrikam.com", "FirstName": "Sophia", "LastName": "Owen" } }
Sla uw werkstroom op. Selecteer Opslaan op de werkbalk van de ontwerper.
Uw werkstroom testen
Als u wilt controleren of de actie JSON parseren de verwachte resultaten maakt, stuurt u uzelf een melding met uitvoer van de actie JSON parseren .
Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie JSON parseren kunt verzenden.
In dit voorbeeld wordt verder gebruikgemaakt van de outlook-actie Office 365 met de naam Een e-mail verzenden.
In deze actie selecteert u voor elk invoervak waarin u de resultaten wilt weergeven in elk vak, zodat de lijst met dynamische inhoud wordt geopend. In die lijst, onder de actie JSON parseren , kunt u nu de eigenschappen van het geparseerde JSON-object selecteren.
In dit voorbeeld worden de volgende eigenschappen geselecteerd: FirstName, LastName en Email
Notitie
Als in de lijst met dynamische inhoud het bericht Wordt geen uitvoer gevonden die overeenkomt met deze invoerindeling, selecteert u Meer weergeven naast het JSON-label parseren in de lijst.
Wanneer u klaar bent, ziet de actie Een e-mail verzenden er ongeveer uit zoals in het volgende voorbeeld:
Sla uw werkstroom op en voer de werkstroom vervolgens handmatig uit. Selecteer triggeruitvoering> uitvoeren op de werkbalk van de ontwerpfunctie.
Als u de actie Office 365 Outlook hebt gebruikt, krijgt u een resultaat dat vergelijkbaar is met de volgende schermafbeelding:
Actie selecteren
Als u een matrix wilt maken die JSON-objecten bevat die zijn gebouwd op basis van de waarden in een bestaande matrix, gebruikt u de actie Selecteren . U kunt bijvoorbeeld een JSON-object maken voor elke waarde in een matrix met gehele getallen door de eigenschappen op te geven die elk JSON-object moet hebben en de waarden uit de bronmatrix toe te stellen aan deze eigenschappen.
Hoewel u de JSON-onderdelenobjecten kunt wijzigen, heeft de uitvoermatrix altijd hetzelfde aantal items als de bronmatrix. Als u de uitvoermatrix van de actie Selecteren wilt gebruiken, moeten volgende acties matrices als invoer accepteren of moet u de uitvoermatrix mogelijk transformeren in een andere compatibele indeling.
Als u de actie Selecteren wilt proberen, volgt u deze stappen met behulp van de werkstroomontwerper. Als u liever in de codeweergave-editor werkt, kunt u het voorbeeld van de actiedefinities voor het selecteren en initialiseren van variabelen uit deze handleiding kopiëren naar de onderliggende werkstroomdefinitie van uw eigen logische app: Voorbeelden van gegevensbewerkingscode - Selecteren. Zie Actie selecteren voor meer informatie over deze actie in de onderliggende werkstroomdefinitie.
Open in de Azure Portal, Visual Studio of Visual Studio Code de werkstroom van uw logische app in de ontwerpfunctie.
In dit voorbeeld wordt gebruikgemaakt van de Azure Portal en een voorbeeldwerkstroom met de trigger Terugkeerpatroon, gevolgd door de actie Variabele initialiseren. De actie is ingesteld voor het maken van een variabele waarbij de initiële waarde een matrix is met enkele voorbeeld gehele getallen.
Voer een van deze stappen uit in de werkstroom waarin u de JSON-objectmatrix wilt maken:
Als u een actie wilt toevoegen onder de laatste stap, selecteert u Nieuwe stap.
Als u een actie tussen stappen wilt toevoegen, beweegt u de muisaanwijzer over de verbindingspijl zodat het plusteken (+) wordt weergegeven. Selecteer het plusteken en selecteer vervolgens Een actie toevoegen.
Selecteer in het zoekvak Kies een bewerkingde optie Ingebouwd. Typ select in het zoekvak.
Selecteer in de lijst met acties de actie met de naam Selecteren.
Voer in het vak Van de bronmatrix in die u wilt gebruiken.
In dit voorbeeld selecteert u in het vak Van , waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:
Voer voor de eigenschap Kaart in de linkerkolom een eigenschapsnaam in om alle waarden in de bronmatrix te beschrijven.
In dit voorbeeld wordt Product_ID gebruikt als de naam van de eigenschap voor de gehele waarden in de bronmatrix. Elke waarde, bijvoorbeeld 1, 2, 3 en 4, is dus een product-id.
Voer in de rechterkolom een expressie in waarmee de waarde in de bronmatrix voor de eigenschapsnaam in de linkerkolom wordt opgegeven.
In dit voorbeeld wordt de functie item() gebruikt om elk item in de matrix te doorlopen en te openen.
Selecteer in de rechterkolom, waarmee de lijst met dynamische inhoud wordt geopend.
Selecteer expressie in die lijst om in plaats daarvan de expressie-editor te openen.
Voer in de expressie-editor de functie item() in en selecteer OK.
De actie Selecteren lijkt nu op het volgende voorbeeld:
Sla uw werkstroom op. Selecteer Opslaan op de werkbalk van de ontwerper.
Uw werkstroom testen
Als u wilt bevestigen of de actie Selecteren de verwachte resultaten oplevert, stuurt u uzelf een melding met uitvoer van de actie Selecteren .
Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie Selecteren kunt verzenden.
In dit voorbeeld wordt verder gebruikgemaakt van de outlook-actie Office 365 met de naam Een e-mail verzenden.
Voer in deze actie de volgende stappen uit:
Voor elk vak waarin u de resultaten wilt weergeven, selecteert u in elk vak, zodat de lijst met dynamische inhoud wordt geopend.
Selecteer expressie in die lijst om in plaats daarvan de expressie-editor te openen.
Als u de matrixuitvoer van de actie Selecteren wilt ophalen, voert u de volgende expressie in, die gebruikmaakt van de functie actionBody() met de naam van de actie Selecteren en selecteert u OK:
actionBody('Select')
De opgeloste expressie geeft aan dat de uitvoer van de actie Selecteren wordt weergegeven in de hoofdtekst van de e-mail wanneer deze wordt verzonden:
Wanneer u klaar bent, ziet de actie Een e-mail verzenden eruit als in het volgende voorbeeld:
Sla uw werkstroom op en voer de werkstroom handmatig uit. Selecteer Op de werkbalk van de ontwerper de optie Trigger uitvoeren>Uitvoeren.
Als u de Office 365 Outlook-actie hebt gebruikt, krijgt u een resultaat dat vergelijkbaar is met de volgende schermafbeelding:
Problemen oplossen
Tabelgegevens opmaken
Als uw CSV-tabel of HTML-tabel een onjuiste opmaak heeft, moet u ervoor zorgen dat de invoergegevens regeleinden tussen rijen bevatten.
Onjuiste opmaak:
Fruit,Number Apples,1 Oranges,2
Juiste opmaak:
Fruit,Number
Apples,1
Oranges,2
Als u regeleinden tussen rijen wilt toevoegen, voegt u een van de volgende expressies toe aan de tabel:
replace(body('Create_CSV_table'),'','<br/>')
replace(body('Create_HTML_table'),'','<br/>')
Bijvoorbeeld:
{
"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"
}
}
}
}