Gegevens vormgeven in werkstromen voor Azure Logic Apps

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Om met verschillende data in je workflows te werken, gebruik je de ingebouwde Data Operations-acties zodat je niet je eigen code hoeft te schrijven.

Deze gids introduceert en laat zien hoe je elke actie gebruikt:

Vereisten

• Een Azure-account en -abonnement. Ontvang een gratis Azure-account.

• De werkstroom van de logische app waar u de gegevensbewerking wilt uitvoeren.

  Voordat je een data-operatie gebruikt, moet je workflow een trigger als eerste stap bevatten. Voeg na deze trigger alle andere noodzakelijke acties toe om uitvoer te maken die door de gegevensbewerking als invoer wordt gebruikt.

Acties voor gegevensbewerking

In de volgende secties vindt u een overzicht van de gegevensbewerkingen die u kunt gebruiken. De bewerkingen worden ingedeeld op basis van de brongegevenstypen waaraan de bewerkingen werken, maar elke beschrijving wordt alfabetisch weergegeven. Selecteer een willekeurige actienaam om direct naar een stapsgewijs voorbeeld te gaan.

JSON-acties

Met de volgende acties kunt u werken met gegevens in JSON-indeling (JavaScript Object Notation).

Zie Geavanceerde JSON-transformaties uitvoeren met Liquid-sjablonen om complexere JSON-transformaties te maken.

Matrixacties

Met de volgende acties kunt u werken met gegevens in matrices.

Actie opstellen

Gebruik de Compose-actie om één enkele output te creëren, zoals een JSON-object, uit meerdere inputs. Je invoer kan verschillende typen hebben, zoals gehele getallen, Booleans, arrays, JSON-objecten en elk ander native type dat Azure Logic Apps ondersteunt, inclusief binair en XML. Je kunt de output gebruiken in acties die volgen op de Compose-actie . Met de actie Opstellen kunt u ook voorkomen dat u herhaaldelijk dezelfde invoer invoer invoert terwijl u de werkstroom van uw logische app bouwt.

U kunt bijvoorbeeld een JSON-bericht maken 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>" }

Maakt de volgende uitvoer:

{"age":35,"fullName":"Owens,Sophia"}

Als u de actie Opstellen wilt uitproberen, volgt u deze stappen met behulp van de werkstroomontwerper. Of, als je liever in de codeweergave-editor werkt, kun je het voorbeeld van de Compose-actie en variabeledefinities voor de actie Initialiseer variabelen uit deze gids kopiëren naar de onderliggende workflowdefinitie van je eigen logica-app: Voorbeelden van Data operatiecode - Compose. Voor meer informatie over de Compose actie in de onderliggende JSON-werkstroomdefinitie, zie de Compose action.

Uw werkstroom testen

Als u wilt controleren of de actie Opstellen de verwachte resultaten maakt, stuurt u uzelf een melding met uitvoer van de actie Opstellen .

1. Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie Opstellen kunt verzenden.

   In dit voorbeeld wordt de Office 365 Outlook-actie met de naam Een e-mail verzenden (V2) voortgezet:

   

2. In deze actie selecteert u voor elk vak waarin u de resultaten wilt weergeven in elk vak en selecteert u vervolgens de lijst met dynamische inhoud (bliksempictogram).

3. Selecteer in de dynamische contentlijst onder de Compose-actieOutputs.

   In dit voorbeeld wordt het resultaat weergegeven in de hoofdtekst van de e-mail, zodat u het veld Uitvoer toevoegt aan het vak Hoofdtekst :

   

4. Sla uw werkstroom op en voer uw werkstroom handmatig uit. Klik op de ontwerpgereedschapbalk op Run>Run.

Als je de actie Office 365 Outlook - Send an email (V2) gebruikt, toont het volgende voorbeeld het resultaat:

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. Vervolgens kunt u de resulterende tabel gebruiken in acties die de actie CSV-tabel maken volgen.

Als u de actie CSV-tabel maken wilt proberen, volgt u deze stappen met behulp van de werkstroomontwerper. Of, als je liever in de codeweergave-editor werkt, kun je het voorbeeld van de actie ' Create CSV-tabel ' en variabelendefinities voor de actie Initialize variables uit deze gids kopiëren naar de onderliggende workflowdefinitie van je eigen logica-app: Voorbeelden van data-operatiecode - Create CSV-tabel. Voor meer informatie over de actie CSV-tabel maken in de onderliggende JSON-werkstroomdefinitie, zie de Actie Tabel.

Pas kolommen en headers van de CSV-tabel aan

Standaard maakt de eigenschap Columns in de actie 'Create CSV'-tabel automatisch de kolommen aan op basis van de array-items. Voer de volgende stappen uit om aangepaste headers en waarden op te geven:

1. Als de eigenschap Kolommen niet wordt weergegeven in het informatievak van de actie, selecteert u Kolommen in de lijst Geavanceerde parameters.

   

2. Open de Kolommenlijst en selecteer Aangepast.

3. Voer in de eigenschap Header de aangepaste headertekst in die gebruikt moet worden.

4. Voer in de Value-eigenschap de aangepaste waarde in die gebruikt moet worden.

Om waarden uit de array terug te geven, gebruik je de item() functie met de actie 'Create CSV-tabel '. Gebruik in een For_each lus de items() functie.

Stel dat u tabelkolommen wilt met alleen de eigenschapswaarden 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

Maak in de actie CSV-tabel maken de koptekstkolom leeg. Maak in elke rij in de Waarde kolom dereferentie van elke eigenschap van de array die u wilt. Elke rij onder Waarde retourneert alle waarden voor de opgegeven matrixeigenschap en wordt een kolom in de tabel.

1. Voor elke gewenste matrixeigenschap selecteert u in de kolom Waarde in het invoervak en selecteert u vervolgens het functiepictogram, waarmee de expressie-editor wordt geopend. Zorg ervoor dat de Functielijst geselecteerd is.

   

2. Voer in de expressie-editor de volgende expressie in, maar vervang deze door <array-property-name> de naam van de matrixeigenschap voor de gewenste waarde. Wanneer u klaar bent met elke expressie, selecteert u Toevoegen.

   Syntaxis: item()?['<array-property-name>']

   Voorbeeldwaarden:

   • item()?['Description']
   • item()?['Product_ID']

   

   Zie de functie item() voor meer informatie.

3. Herhaal de voorgaande stappen voor elke matrixeigenschap. Wanneer u klaar bent, ziet uw actie er ongeveer als volgt uit:

   

4. Sla uw werkstroom op. Selecteer in de werkbalk van de ontwerper Opslaan.

Werken in de codeweergave

In de JSON-definitie van de actie Create CSV-tabel , binnen de columns array, stel je de header eigenschap in op een lege string. Voor elke value eigenschap, derefereer elke array-eigenschap die je wilt.

1. Selecteer Codeweergave op de ontwerperstoolbar.

2. Zoek in de code-editor de array van de actie columns. Voeg voor elke gewenste kolom met matrixwaarden een lege header eigenschap en de volgende expressie voor de value eigenschap toe:

   Syntaxis:

   {
      "header": "",
      "value": "@item()?['<array-property-name>']"
   }
   

   Voorbeeld:

   "Create_CSV_table": {
      "type": "Table",
      "inputs": {
         "columns": [
            { 
               "header": "",
               "value": "@item()?['Description']"
            },
            { 
               "header": "",
               "value": "@item()?['Product_ID']"
            }
         ],
         "format": "CSV",
         "from": "@variables('myJSONArray')"
      }
   }
   

   Notitie

   Als u het voorbeeld kopieert naar uw code, moet u ervoor zorgen dat u de runAfter actie aan het einde van de Create_CSV_table definitie opneemt.

3. Keer terug naar de ontwerper om de resultaten te bekijken.

Uw werkstroom testen

Als u wilt controleren of de actie CSV-tabel maken de verwachte resultaten maakt, stuurt u uzelf een melding met uitvoer van de actie CSV-tabel maken.

1. Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie CSV-tabel maken kunt verzenden.

   In dit voorbeeld wordt de actie Office 365 Outlook gebruikt met de naam Een e-mail verzenden (V2).

2. In deze actie selecteert u binnen elk vak waarin u de resultaten wilt weergeven, waardoor de lijst met dynamische inhoud wordt geopend. Selecteer Uitvoer in die lijst onder de actie CSV-tabel maken.

   

3. Sla uw werkstroom op en voer uw werkstroom handmatig uit. Klik op de ontwerpgereedschapbalk op Run>Run.

Als je de actie Office 365 Outlook - Send an email (V2) gebruikt, toont het volgende voorbeeld het resultaat:

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 de actie HTML-tabel maken volgen.

Als u de actie HTML-tabel maken wilt proberen, volgt u deze stappen met behulp van de werkstroomontwerper. Of, als je liever in de codeweergave-editor werkt, kun je het voorbeeld van de actie HTML-tabel aanmaken en variabelendefinities voor de actie Variabelen initialiseren uit deze gids kopiëren naar de onderliggende workflowdefinitie van je eigen logica-app: Voorbeelden van gegevensoperatiecode - Maak HTML-tabel aan. Zie de actie Tabel voor meer informatie over de actie HTML-tabel maken in de onderliggende JSON-werkstroomdefinitie.

Pas kolommen en kopteksten van HTML-tabellen aan

Standaard maakt de eigenschap Columns in de actie 'Create HTML' automatisch de kolommen van de tabel aan op basis van de array-items. Voer de volgende stappen uit om aangepaste headers en waarden op te geven:

1. Als de eigenschap Kolommen niet wordt weergegeven in het informatievak van de actie, selecteert u Kolommen in de lijst Geavanceerde parameters.

2. Open de Kolommenlijst en selecteer Aangepast.

3. Voer in de eigenschap Header de aangepaste headertekst in die gebruikt moet worden.

4. Voer in de Value-eigenschap de aangepaste waarde in die gebruikt moet worden.

Om waarden uit de array terug te geven, gebruik je de item() functie met de actie 'Create HTML'-tabel . Gebruik in een For_each lus de items() functie.

Stel dat u tabelkolommen wilt met alleen de eigenschapswaarden 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

Laat in de actie HTML-tabel maken de kolom Koptekst leeg. Maak in elke rij in de Waarde kolom dereferentie van elke eigenschap van de array die u wilt. Elke rij onder Waarde retourneert alle waarden voor de opgegeven matrixeigenschap en wordt een kolom in de tabel.

1. Voor elke gewenste matrixeigenschap selecteert u in de kolom Waarde in het invoervak en selecteert u vervolgens het functiepictogram, waarmee de expressie-editor wordt geopend. Zorg ervoor dat de Functielijst geselecteerd is.

2. Voer in de expressie-editor de volgende expressie in, maar vervang deze door <array-property-name> de naam van de matrixeigenschap voor de gewenste waarde. Wanneer u klaar bent met elke expressie, selecteert u Toevoegen.

   Syntaxis: item()?['<array-property-name>']

   Voorbeelden:

   • item()?['Description']
   • item()?['Product_ID']

   

   Zie de functie item() voor meer informatie.

3. Herhaal de voorgaande stappen voor elke matrixeigenschap. Wanneer u klaar bent, ziet uw actie er ongeveer als volgt uit:

   

Werken in de codeweergave

In de JSON-definitie van de actie Create HTML-tabel , binnen de columns array, zet je de header eigenschap op een lege string. Voor elke value eigenschap, derefereer elke array-eigenschap die je wilt.

1. Selecteer Codeweergave op de ontwerperstoolbar.

2. Zoek in de code-editor de array van de actie columns. Voeg voor elke gewenste kolom met matrixwaarden een lege header eigenschap en de volgende expressie voor de value eigenschap toe:

   Syntaxis:

   {
      "header": "",
      "value": "@item()?['<array-property-name>']"
   }
   

   Voorbeeld:

   "Create_HTML_table": {
      "type": "Table",
      "inputs": {
         "columns": [
            { 
               "header": "",
               "value": "@item()?['Description']"
            },
            { 
               "header": "",
               "value": "@item()?['Product_ID']"
            }
         ],
         "format": "HTML",
         "from": "@variables('myJSONArray')"
      }
   }
   

   Notitie

   Als u het voorbeeld kopieert naar uw code, moet u ervoor zorgen dat u de runAfter actie aan het einde van de Create_HTML_table definitie opneemt.

3. Keer terug naar de ontwerperweergave 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.

1. Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie HTML-tabel maken kunt verzenden.

   In dit voorbeeld wordt de actie Office 365 Outlook gebruikt met de naam Een e-mail verzenden (V2).

2. In deze actie selecteert u elk vak waarin u de resultaten wilt weergeven en klikt u vervolgens op het bliksempictogram, waarmee de lijst met dynamische inhoud wordt geopend. Selecteer Uitvoer in die lijst onder de actie HTML-tabel maken.

   

3. Sla uw werkstroom op en voer uw werkstroom handmatig uit. Klik op de ontwerpgereedschapbalk op Run>Run.

Als je de actie Office 365 Outlook - Send an email (V2) gebruikt, toont het volgende voorbeeld het resultaat:

Matrixactie filteren

Gebruik de Filter-arrayactie om een deelset-array te creëren uit een bestaande array waarbij de subset-items aan specifieke criteria voldoen. Je kunt vervolgens de resulterende gefilterde array gebruiken in acties die volgen op de Filter-arrayactie .

Om de actie Filter array te proberen, volgt u deze stappen met de workflow ontwerper. Of, als je liever in de codeweergave-editor werkt, kun je het voorbeeld van de Filterarray-actie en variabeledefinities voor de Initialiseren van variabelen uit deze gids kopiëren naar de onderliggende workflowdefinitie van je eigen logica-app: Voorbeelden van data-operatiecode - Filterarray. Zie de actie Query voor meer informatie over de actie Matrix filteren in de onderliggende JSON-werkstroomdefinitie.

Uw werkstroom testen

Om te bevestigen of de Filterarray-actie de verwachte resultaten genereert, stuur je jezelf een melding met output van de Filterarray-actie .

1. Voeg in uw werkstroom een actie toe waarmee u de resultaten van de filtermatrixactie kunt verzenden.

   In dit voorbeeld wordt de actie Office 365 Outlook gebruikt met de naam Een e-mail verzenden (V2).

2. Voer in deze actie de volgende stappen uit:

   1. Voor elk vakje waarin je de resultaten wilt laten verschijnen, selecteer je het vakje en selecteer je vervolgens het functie-icoon. Het pictogram opent de expressie-editor. Zorg ervoor dat de Functielijst geselecteerd is.

   2. Als u de matrixuitvoer van de filtermatrixactie wilt ophalen, voert u de volgende expressie in, waarbij de functie body() wordt gebruikt met de naam van de filtermatrixactie en selecteert u Vervolgens Toevoegen.

      body('Filter_array')

      

      De opgeloste expressie geeft aan dat de uitvoer van de Filter_array actie in de hoofdtekst van de e-mail wordt weergegeven wanneer deze wordt verzonden:

      

3. Sla uw werkstroom op en voer uw werkstroom handmatig uit. Klik op de ontwerpgereedschapbalk op Run>Run.

Als je de actie Office 365 Outlook - Send an email (V2) gebruikt, toont het volgende voorbeeld het resultaat:

Doe mee aan actie

Om een string te maken die alle items uit een array bevat, gebruik je de Join-actie en scheid je elk item door een specifiek scheidingsteken te gebruiken. Je kunt deze string gebruiken in acties die volgen op de Join-actie .

Om de Join-actie te proberen, volg je deze stappen in de workflow-ontwerper. Of, als je liever in de codeweergave-editor werkt, kun je het voorbeeld van de Join-actie en variabelendefinities voor de actie Initialiseer variabelen uit deze gids kopiëren naar de onderliggende workflowdefinitie van je eigen logica-app: Voorbeelden van Data operatiecode - Join. Zie de actie Deelnemen voor meer informatie over de actie Deelnemen in de onderliggende werkstroomdefinitie.

Uw werkstroom testen

Als u wilt controleren of de joinactie de verwachte resultaten oplevert, stuurt u uzelf een melding met uitvoer van de joinactie.

1. Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie Deelnemen kunt verzenden.

   In dit voorbeeld wordt de actie Office 365 Outlook gebruikt met de naam Een e-mail verzenden (V2).

2. In deze actie selecteert u elk vak waarin u de resultaten wilt weergeven en klikt u vervolgens op het bliksempictogram, waarmee de lijst met dynamische inhoud wordt geopend. Van die lijst, onder de actie Deelnemen, selecteer Uitvoer.

   

3. Sla uw werkstroom op en voer uw werkstroom handmatig uit. Klik op de ontwerpgereedschapbalk op Run>Run.

Als je de actie Office 365 Outlook - Send an email (V2) gebruikt, toont het volgende voorbeeld het resultaat:

JSON-actie parseren

Om eigenschappen in JavaScript Object Notation (JSON) inhoud te refereren of te benaderen, maak je gebruiksvriendelijke velden of tokens voor die eigenschappen door gebruik te maken van de actie Parse JSON . Je kunt deze eigenschappen selecteren uit de dynamische contentlijst wanneer je invoer specificeert voor volgende acties in je workflow. 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 JSON-actie Parseren wilt uitproberen, volgt u deze stappen met behulp van de werkstroomontwerper. Of, als je liever in de codeweergave-editor werkt, kun je de voorbeeld van de Parse JSON-actie en variabeledefinities voor de Initialize variables-actie uit deze gids kopiëren naar de onderliggende workflowdefinitie van je eigen logica-app: Data operation code examples - Parse JSON. Zie JSON-actie parseren voor meer informatie over deze actie in de onderliggende werkstroomdefinitie.

Uw werkstroom testen

Als u wilt controleren of de JSON-actie Parseren de verwachte resultaten maakt, stuurt u uzelf een melding met uitvoer van de JSON-actie Parseren.

1. Voeg in uw werkstroom een actie toe waarmee u de resultaten van de JSON-actie Parseren kunt verzenden.

   In dit voorbeeld wordt de actie Office 365 Outlook gebruikt met de naam Een e-mail verzenden (V2).

2. In deze actie selecteert u voor elk vak waarin u de resultaten wilt weergeven, selecteert u in elk invoervak en selecteert u vervolgens het bliksempictogram, waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst onder de actie JSON parseren de eigenschappen in het geparseerde JSON-object.

   Dit voorbeeld selecteert de volgende eigenschappen: Body FirstName, Body AfterName en Body Email.

   

   Wanneer u klaar bent, ziet de actie Een e-mail verzenden er ongeveer als volgt uit:

   

3. Sla uw werkstroom op en voer uw werkstroom handmatig uit. Klik op de ontwerpgereedschapbalk op Run>Run.

Als je de actie Office 365 Outlook - Send an email (V2) gebruikt, toont het volgende voorbeeld het resultaat:

Actie selecteren

Standaard wordt met de actie Selecteren een matrix gemaakt die JSON-objecten bevat die zijn gebouwd op basis van de waarden in een bestaande matrix. U kunt bijvoorbeeld een JSON-object maken voor elke waarde in een matrix met gehele getallen. Geef de eigenschappen op die elk JSON-object moet hebben en wijs de waarden van de bronmatrix toe aan de eigenschappen. Hoewel u de JSON-objecten van het onderdeel 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 accepteren als invoer of moet u de uitvoermatrix mogelijk omzetten in een andere compatibele indeling.

Als u de actie Selecteren wilt proberen, volgt u deze stappen met behulp van de werkstroomontwerper. Of, als je liever in de codeweergave-editor werkt, kun je het voorbeeld van de Select-actie en variabeledefinities voor de actie Initialiseer variabelen uit deze gids kopiëren naar de onderliggende workflowdefinitie van je eigen logica-app: Voorbeelden van gegevensoperatiecode - Select. Zie Actie selecteren voor meer informatie over deze actie in de onderliggende werkstroomdefinitie.

Uw werkstroom testen

Als u wilt controleren of de actie Selecteren de verwachte resultaten maakt, stuurt u uzelf een melding met uitvoer van de actie Selecteren .

1. Voeg in uw werkstroom een actie toe waarmee u de resultaten van de actie Selecteren kunt verzenden.

2. Voer in deze actie de volgende stappen uit:

   1. Voor elk vakje waarin je de resultaten wilt laten verschijnen, selecteer je het vakje en selecteer je vervolgens het functie-icoon. Het pictogram opent de expressie-editor. Zorg ervoor dat de Functielijst geselecteerd is.

   2. Als u de matrixuitvoer wilt ophalen uit de actie Selecteren, voert u de volgende expressie in, waarin de hoofdtekstfunctie () wordt gebruikt met de actieNaam Selecteren en selecteert u Toevoegen:

      body('Select')

      

      De opgeloste expressie geeft aan dat de uitvoer van de actie Selecteren in de hoofdtekst van de e-mail wordt weergegeven wanneer deze wordt verzonden:

      

3. Sla uw werkstroom op en voer uw werkstroom handmatig uit. Klik op de ontwerpgereedschapbalk op Run>Run.

Als je de actie Office 365 Outlook - Send an email (V2) gebruikt, toont het volgende voorbeeld het resultaat:

Problemen met databewerkingen oplossen

Herstel verkeerd geformatteerde CSV- of HTML-tabeluitvoer

Als de actie ' Create CSV'-tabel of 'Create HTML'-tabel verkeerd opgemaakte gegevens teruggeeft, zorg er dan voor dat je invoergegevens regelafbrekingen tussen rijen bevat.

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'),'\r\n','<br/>')

replace(body('Create_HTML_table'),'\r\n','<br/>')

Voorbeeld:

{
   "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"
         }
      }
   }
}

Gerelateerde inhoud

• Beheerde connectors voor Azure Logic Apps
• Ingebouwde connectors voor Azure Logic Apps