Delen via


Gegevensbewerkingen uitvoeren in Azure Logic Apps

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

In deze instructiegids ziet u hoe u op de volgende manieren met gegevens in uw werkstroom voor logische apps 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 op basis 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 op basis 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.

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 waar u de gegevensbewerking wilt uitvoeren. Zowel werkstromen voor verbruik als standaard logische apps ondersteunen de gegevensbewerkingen die in deze handleiding worden beschreven.

    Alle gegevensbewerkingen zijn alleen beschikbaar als acties. Dus voordat u deze acties kunt gebruiken, moet uw werkstroom al beginnen met een trigger als eerste stap en alle andere acties opnemen die nodig zijn om de uitvoer te maken die u wilt gebruiken in de gegevensbewerking.

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.

JSON-acties

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

Actie Beschrijving
Compose Maak een bericht of tekenreeks op basis van meerdere invoergegevens 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 invoerwaarden.
JSON parseren Maak gebruiksvriendelijke gegevenstokens voor eigenschappen in JSON-inhoud, zodat u de eigenschappen in uw logische apps gemakkelijker kunt gebruiken.

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 Beschrijving
CSV-tabel maken Een csv-tabel (door komma's gescheiden waarden) maken op basis van een matrix.
HTML-tabel maken Maak een HTML-tabel op basis van een matrix.
Array filteren Maak een matrixsubset van een matrix op basis van het opgegeven filter of de opgegeven voorwaarde.
Join Maak een tekenreeks van alle items in een matrix en scheid elk item met het opgegeven teken.
Selecteren Maak een matrix op basis van de opgegeven eigenschappen voor alle items in een andere matrix.

Actie opstellen

Als u één uitvoer wilt maken, zoals een JSON-object van meerdere invoer, 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 Door Azure Logic Apps wordt ondersteund, bijvoorbeeld binair en XML. U kunt vervolgens de uitvoer gebruiken in acties die volgen na de actie Opstellen . 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. Als u liever in de codeweergave-editor werkt, kunt u de voorbeelddefinities van Opstellen en Initialiseer variabele acties uit deze handleiding kopiëren naar de onderliggende workflowdefinitie van uw eigen Logic App: Voorbeelden van gegevensbewerkingscode - Opstellen. Voor meer informatie over de Compose actie in de onderliggende JSON-werkstroomdefinitie, zie de Compose action.

  1. Open uw werkstroom voor logische apps in Azure Portal of Visual Studio Code in de ontwerpfunctie.

    In dit voorbeeld wordt gebruikgemaakt van de Azure portal en een voorbeeldwerkstroom met de trigger Herhaling, gevolgd door verschillende variabelenacties genaamd Initialize-variabele. Deze acties zijn ingesteld om twee tekenreeksvariabelen en een geheel getalvariabele te maken.

    Operatie Eigenschappen en waarden
    Variabele initialiseren - Naam: firstNameVar
    - Type: Tekenreeks
    - Waarde: Sophia
    Variabele initialiseren - Naam: lastNameVar
    - Type: Tekenreeks
    - Waarde: Owens
    Variabele initialiseren - Naam: ageVar
    - Type: Geheel getal
    - Waarde: 35

    Schermopname toont azure-portal, de consumptieworkstroomontwerper en een voorbeeldwerkstroom voor de actie Samenstellen.

  2. Volg deze algemene stappen om de actie Gegevensbewerkingen met de naam Opstellen toe te voegen.

  3. Selecteer in de ontwerpfunctie de actie Opstellen als deze nog niet is geselecteerd. Voer in het vak Invoer de invoer in die moet worden gebruikt voor het maken van de uitvoer.

    Voer voor dit voorbeeld de volgende stappen uit:

    1. Voer in het vak Invoer het volgende JSON-voorbeeldobject in, inclusief de afstand zoals weergegeven:

      {
          "age": ,
          "fullName": " , "
      }
      
    2. Plaats de cursor in het JSON-object op de bijbehorende locaties, selecteer de lijst met dynamische inhoud (bliksempictogram) en selecteer vervolgens de bijbehorende variabele in de lijst:

      JSON-eigenschap Variabel
      age ageVar
      fullName "lastNameVar, firstNameVar"

      In het volgende voorbeeld ziet u zowel toegevoegde als nog niet toegevoegde variabelen:

      Schermopname toont verbruikswerkstroom, actie Opstellen, lijst met dynamische inhoud en geselecteerde invoer.

      In het volgende voorbeeld ziet u definities die zijn toegevoegd voor twee variabelen en het proces voor het toevoegen van de derde variabele:

      Schermopname toont verbruikswerkstroom, actie Opstellen, lijst met dynamische inhoud en geselecteerde invoer.

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

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:

    Schermopname van de standaardwerkstroom, actie toevoegen, Office 365 Outlook, Een e-mail verzenden (V2).

  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). Selecteer Uitvoer in de lijst onder de actie Opstellen.

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

    Schermopname van de werkstroomontwerper, de actie Een e-mail verzenden en uitvoer van de voorgaande actie Opstellen.

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

Als u Office 365 Outlook - Een e-mailactie verzenden gebruikt, wordt in het volgende voorbeeld het resultaat weergegeven:

Schermopname van e-mail met resultaten van de actie Opstellen.

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. Als u liever in de codeweergave-editor werkt, kunt u de voorbeeldtabel CSV-tabel maken kopiëren en variabelenactiedefinities initialiseren vanuit deze handleiding naar de onderliggende werkstroomdefinitie van uw eigen logische app: voorbeelden van gegevensbewerkingscode - CSV-tabel maken. Voor meer informatie over de actie CSV-tabel maken in de onderliggende JSON-werkstroomdefinitie, zie de Actie Tabel.

  1. Open uw werkstroom voor logische apps in Azure Portal of Visual Studio Code in de ontwerpfunctie.

    In dit voorbeeld wordt gebruikgemaakt van de Azure portal en een voorbeeldwerkstroom met de trigger Herhaling, gevolgd door een variabele initialiseren actie. De actie wordt ingesteld om een variabele te maken waarbij de initiële waarde een matrix is die een aantal eigenschappen en waarden in JSON-indeling heeft.

    Operatie Eigenschappen en waarden
    Variabele initialiseren - Naam: myJSONArray
    - Type: Array
    - Waarde: [ { "Description": "Apples", "Product_ID": 1 }, { "Description": "Oranges", "Product_ID": 2 }]

    De schermafbeelding toont de ontwerper voor consumptieworkflow en een voorbeeldwerkstroom voor de actie genaamd CSV-tabel aanmaken.

  2. Volg deze algemene stappen om de actie Gegevensbewerkingen toe te voegen met de naam CSV-tabel maken.

  3. Selecteer in de ontwerpfunctie de actie CSV-tabel maken als deze nog niet is geselecteerd. 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 en selecteert u de lijst met dynamische inhoud (bliksempictogram). Selecteer in die lijst de variabele myJSONArray :

    Schermopname toont de verbruikswerkstroom, de actie genaamd CSV-tabel maken, en de geselecteerde invoer om te gebruiken.

    Tip

    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 de voltooide voorbeeldactie CSV-tabel maken:

    Schermopname van de werkstroom Verbruik en voltooide voorbeeldactie met de naam CSV-tabel maken.

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

Tabelopmaak aanpassen

De eigenschap Kolommen is standaard ingesteld om automatisch de tabelkolommen te maken op basis van de matrixitems. 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.

    Schermopname van de standaardwerkstroom en de parameter Kolommen geselecteerd in de lijst Geavanceerde parameters.

  2. Open de Kolommenlijst en selecteer Aangepast.

  3. Geef in de eigenschap Koptekst de aangepaste koptekst op die u wilt gebruiken.

  4. Geef in de eigenschap Waarde de aangepaste waarde op die u wilt gebruiken.

Als u waarden uit de matrix wilt retourneren, 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 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.

    Schermopname van de standaardwerkstroom, de parameter Kolommen, de functie-expressie geselecteerd voor het veld Kolomwaarde.

  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']

    Schermopname van de werkstroomontwerper, de actie CSV-tabel maken en de deductiematrixeigenschap Beschrijving.

    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:

    Schermopname van een actie met de naam CSV-tabel en functie met de naam item().

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

Werken in de codeweergave

Stel in de JSON-definitie van de actie in de columns matrix de header eigenschap in op een lege tekenreeks. 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. 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 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.

    Schermopname van de werkstroom met de actie Een e-mailbericht verzenden. De eigenschap Hoofdtekst bevat het veld Uitvoer van de voorgaande actie met de naam CSV-tabel maken.

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

Als u Office 365 Outlook - Een e-mailactie verzenden gebruikt, wordt in het volgende voorbeeld het resultaat weergegeven:

Schermopname van e-mail met resultaten van de actie CSV-tabel maken.

Notitie

Als uw tabel wordt geretourneerd met onjuiste opmaak, raadpleegt u hoe u de tabelgegevensopmaak controleert.

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. Als u liever in de codeweergave-editor werkt, kunt u het voorbeeld html-tabel maken kopiëren en definities van variabelenactie initialiseren vanuit deze handleiding 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.

  1. Open uw werkstroom voor logische apps in Azure Portal of Visual Studio Code in de ontwerpfunctie.

    In dit voorbeeld wordt gebruikgemaakt van de Azure portal en een voorbeeldwerkstroom met de trigger Herhaling, gevolgd door een variabele initialiseren actie. De actie wordt ingesteld om een variabele te maken waarbij de initiële waarde een matrix is die een aantal eigenschappen en waarden in JSON-indeling heeft.

    Operatie Eigenschappen en waarden
    Variabele initialiseren - Naam: myJSONArray
    - Type: Array
    - Waarde: [ { "Description": "Apples", "Product_ID": 1 }, { "Description": "Oranges", "Product_ID": 2 }]

    Schermopname van De Azure-portal, de ontwerpfunctie voor verbruikswerkstromen en een voorbeeldwerkstroom voor actie met de naam HTML-tabel maken.

  2. Volg deze algemene stappen om de actie Gegevensbewerkingen toe te voegen met de naam HTML-tabel maken.

  3. Selecteer in de ontwerpfunctie de actie HTML-tabel maken als deze nog niet is geselecteerd. 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 en selecteert u de lijst met dynamische inhoud (bliksempictogram). Selecteer in die lijst de variabele myJSONArray :

    Schermopname van de werkstroom Verbruik, de actie HTML-tabel maken en de geselecteerde invoer die u wilt gebruiken.

    Tip

    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 het voltooide voorbeeld van de actie HTML-tabel maken:

    Schermopname toont de werkstroom Consumptie en de voltooide voorbeeldactie met de naam Maak een HTML-tabel.

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

Tabelopmaak aanpassen

De eigenschap Kolommen is standaard ingesteld om automatisch de tabelkolommen te maken op basis van de matrixitems. 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. Geef in de eigenschap Koptekst de aangepaste koptekst op die u wilt gebruiken.

  4. Geef in de eigenschap Waarde de aangepaste waarde op die u wilt gebruiken.

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 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']

    Schermopname van de werkstroomontwerper, de actie HTML-tabel maken en het deductie van matrixeigenschap Beschrijving.

    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:

    Schermopname van de actie Create HTML table and function named item().

Werken in de codeweergave

Stel in de JSON-definitie van de actie in de columns matrix de header eigenschap in op een lege tekenreeks. 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. 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.

  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.

    Schermopname van de werkstroom met de actie Een e-mailbericht verzenden. De eigenschap Hoofdtekst bevat het uitvoerveld van de voorgaande actie met de naam HTML-tabel maken.

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

Als u Office 365 Outlook - Een e-mailactie verzenden gebruikt, wordt in het volgende voorbeeld het resultaat weergegeven:

Schermopname van e-mail met resultaten van de actie HTML-tabel maken.

Matrixactie filteren

Als u een subsetmatrix wilt maken op basis van een bestaande matrix waarin de subsetitems voldoen aan specifieke criteria, gebruikt u de actie Matrix filteren. Vervolgens kunt u de resulterende gefilterde matrix gebruiken in acties die de filtermatrixactie volgen.

Om de actie Filter array te proberen, volgt u deze stappen met de workflow ontwerper. Als u liever in de codeweergave-editor werkt, kunt u de voorbeeldmatrix kopiëren en variabelenactiedefinities uit deze handleiding initialiseren in 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. Deze actie kan ook de indeling of onderdelen van items in de matrix niet wijzigen.

Voor acties die de array-uitvoer van de Filter array actie kunnen gebruiken, moeten de acties ofwel arrays accepteren als invoer, of moet u de uitvoer-array mogelijk transformeren naar een ander compatibel formaat.

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 filtermatrixactie alleen de hoofdtekst van het antwoord lezen en niet de structuur van de JSON-nettolading.

  1. Open uw werkstroom voor logische apps in Azure Portal of Visual Studio Code in de ontwerpfunctie.

    In dit voorbeeld wordt gebruikgemaakt van de Azure portal en een voorbeeldwerkstroom met de trigger Herhaling, gevolgd door een variabele initialiseren actie. De actie wordt ingesteld om te maken waarbij de initiële waarde een matrix is met een aantal voorbeeldwaarden voor gehele getallen.

    Operatie Eigenschappen en waarden
    Variabele initialiseren - Naam: myIntegerArray
    - Type: Array
    - Waarde: [1,2,3,4]

    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.

    Schermopname van De Azure-portal, de ontwerpfunctie voor verbruikswerkstromen en een voorbeeldwerkstroom voor actie met de naam Filtermatrix.

  2. Volg deze algemene stappen om de actie Gegevensbewerkingen met de naam Filtermatrix te vinden.

  3. Selecteer in de ontwerper de Matrix filteren-actie, als deze nog niet is geselecteerd. Voer in het vak Van de matrix of expressie in die u als filter wilt gebruiken.

    Voor dit voorbeeld selecteert u in het vak Van en selecteert u vervolgens het bliksempictogram, waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:

    Schermopname van verbruikswerkstroom, actie met de naam Filtermatrix en geselecteerde invoer die u wilt gebruiken.

  4. 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 voor toegang tot elk item in de matrix, terwijl met de actie Matrix filteren wordt gezocht naar matrixitems waarbij de waarde groter is dan één. In de volgende schermafbeelding ziet u de voltooide voorbeeldactie voor Filter array:

    Schermopname toont Consumptiewerkstroom en de voltooide voorbeeldactie genaamd Filter-array.

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

Uw werkstroom testen

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

  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 vak waarin u de resultaten wilt weergeven, selecteert u in elk vak en selecteert u vervolgens het functiepictogram, waarmee de expressie-editor wordt geopend. 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')

      Schermopname van de werkstroom met de actie Een e-mailbericht verzenden. De eigenschap Hoofdtekst bevat de functie body(), waarmee de hoofdtekstinhoud van de voorgaande actie Filtermatrix wordt opgehaald.

      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:

      Schermopname van de standaardwerkstroom en de voltooide voorbeeldactie voor Het verzenden van een e-mailbericht.

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

Als u Office 365 Outlook - Een e-mailactie verzenden gebruikt, wordt in het volgende voorbeeld het resultaat weergegeven:

Schermopname van e-mail met resultaten van de actie Filtermatrix.

Doe mee aan actie

Als u een tekenreeks wilt maken die alle items uit een array bevat en die items wilt scheiden met een specifiek scheidingsteken, gebruikt u de Join actie. Vervolgens kunt u de tekenreeks gebruiken in acties die de actie Deelnemen volgen.

Als u de actie Deelnemen 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 join kopiëren en initialiseren vanuit deze handleiding naar de onderliggende werkstroomdefinitie van uw eigen logische app: Voorbeelden van gegevensbewerkingscode - Join. Zie de actie Deelnemen voor meer informatie over de actie Deelnemen in de onderliggende werkstroomdefinitie.

  1. Open uw werkstroom voor logische apps in Azure Portal of Visual Studio Code in de ontwerpfunctie.

    In dit voorbeeld wordt gebruikgemaakt van de Azure portal en een voorbeeldwerkstroom met de trigger Herhaling, gevolgd door een variabele initialiseren actie. Deze actie is ingesteld om een variabele te maken waarbij de initiële waarde een matrix is met enkele waarden voor een geheel getal.

    Operatie Eigenschappen en waarden
    Variabele initialiseren - Naam: myIntegerArray
    - Type: Array
    - Waarde: [1,2,3,4]

    Schermopname van De Azure-portal, de ontwerpfunctie voor verbruikswerkstromen en een voorbeeldwerkstroom voor de actie Join.

  2. Volg deze algemene stappen om de actie Gegevensbewerkingen met de naam Join te vinden.

  3. Selecteer in de ontwerpfunctie de actie Deelnemen als deze nog niet is geselecteerd. Voer in het vak Van de matrix in met de items die u als tekenreeks wilt samenvoegen.

  4. Voer in het vak Van de matrix in met de items die u als tekenreeks wilt samenvoegen.

    Voor dit voorbeeld selecteert u in het vak Van en selecteert u vervolgens het bliksempictogram, waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:

    Schermopname toont de werkstroom Consumptie, de actie genaamd Join, en de geselecteerde matrixuitvoer die als een tekenreeks wordt samengevoegd.

  5. Voer in het vak Samenvoegen met het teken in dat gebruikt moet worden voor het scheiden van elk element van de reeks.

    In dit voorbeeld wordt een dubbele punt (:) gebruikt als scheidingsteken voor de 'Join With'-eigenschap.

    De schermafbeelding toont de werkstroom Verbruik en het voltooide voorbeeld voor de actie genaamd Join.

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

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.

    Een screenshot toont een workflow met de voltooide actie genaamd Een e-mail verzenden voor de actie Join.

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

Als u Office 365 Outlook - Een e-mailactie verzenden gebruikt, wordt in het volgende voorbeeld het resultaat weergegeven:

Schermopname van e-mail met resultaten van de actie Deelnemen.

JSON-actie parseren

Als u wilt verwijzen naar of toegang wilt krijgen tot eigenschappen in JSON-inhoud (JavaScript Object Notation), kunt u gebruiksvriendelijke velden of tokens voor deze eigenschappen maken met behulp van de JSON-actie JSON parseren. Op die manier kunt u deze eigenschappen selecteren in de lijst met dynamische inhoud wanneer u invoer opgeeft voor volgende acties in uw werkstroom. 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. Als u liever in de codeweergave-editor werkt, kunt u het voorbeeld JSON parseren en variabelenactiedefinities uit deze handleiding initialiseren in de onderliggende werkstroomdefinitie van uw eigen logische app: Voorbeelden van gegevensbewerkingscode - JSON parseren. Zie JSON-actie parseren voor meer informatie over deze actie in de onderliggende werkstroomdefinitie.

  1. Open uw werkstroom voor logische apps in Azure Portal of Visual Studio Code in de ontwerpfunctie.

    In dit voorbeeld wordt gebruikgemaakt van Azure Portal en een voorbeeldwerkstroom met een terugkeerpatroontrigger , gevolgd door een actie variabele initialiseren . Deze actie is ingesteld om een variabele te maken waarvan de oorspronkelijke waarde het volgende JSON-object is met eigenschappen en waarden:

    {
        "Member": {
            "Email": "Sophia.Owen@fabrikam.com",
            "FirstName": "Sophia",
            "LastName": "Owen"
        }
    }
    

    Schermopname van De Azure-portal, de ontwerpfunctie voor verbruikswerkstromen en een voorbeeldwerkstroom voor actie met de naam JSON parseren.

  2. Volg deze algemene stappen om de actie Gegevensbewerkingen met de naam JSON parseren te vinden.

  3. Selecteer in de ontwerpfunctie de actie JSON parseren als deze nog niet is geselecteerd. Voer in het vak Inhoud het JSON-object in dat u wilt parseren.

    Voor dit voorbeeld selecteert u in het vak Inhoud en selecteert u vervolgens het bliksempictogram, waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:

    Schermopname van de werkstroom Verbruik, de actie JSON parseren en de geselecteerde JSON-objectvariabele die u wilt parseren.

  4. 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"
                    }
                }
            }
        }
    }
    

    Schermopname van de werkstroom Verbruik, de actie JSON parseren en het JSON-schema voor het JSON-object dat u wilt parseren.

    Als u geen schema hebt, kunt u het schema genereren op basis van het JSON-object:

    1. Selecteer in de actie JSON parseren, onder het vak Schema, voorbeeldpayload gebruiken om een schema te genereren.

    2. In het vak Een voorbeeld van een JSON-payload kun je de JSON-inhoud of het JSON-object invoeren of plakken en vervolgens Gereed selecteren, bijvoorbeeld:

      {
          "Member": {
             "Email": "Sophia.Owens@fabrikam.com",
             "FirstName": "Sophia",
             "LastName": "Owens"
          }
      }
      

      De schermafbeelding toont de werkstroom Verbruik, de actie genaamd 'JSON interpreteren', en het vak 'Voer een JSON-voorbeeld in of plak een JSON-payload', dat een voorbeeld bevat om het schema te genereren.

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

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.

    In dit voorbeeld worden de volgende eigenschappen geselecteerd: Voornaam van hoofdtekst, achternaam en hoofdtekst-e-mail

    Schermopname van de Standaardwerkstroom met JSON-eigenschappen in de actie Een e-mail verzenden.

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

    Schermopname van de werkstroom met de voltooide actie Een e-mail verzenden voor actie met de naam JSON parseren.

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

Als u Office 365 Outlook - Een e-mailactie verzenden gebruikt, wordt in het volgende voorbeeld het resultaat weergegeven:

Schermopname van e-mail met resultaten van de actie JSON parseren.

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. Als u liever in de codeweergave-editor werkt, kunt u de voorbeeldactiedefinities Selecteren en Variabele initialiseren uit deze handleiding kopiëren naar de onderliggende workflowdefinitie van uw eigen logische app: Voorbeelden van gegevensbewerkingscode - Selecteren. Zie Actie selecteren voor meer informatie over deze actie in de onderliggende werkstroomdefinitie.

Tip

Voor een voorbeeld waarmee een matrix wordt gemaakt met tekenreeksen of gehele getallen die zijn gebouwd op basis van de waarden in een JSON-objectmatrix, raadpleegt u de definities van de actievariabelenselecteren en initialiseren in voorbeelden van gegevensbewerkingscode - Selecteren.

  1. Open uw werkstroom voor logische apps in Azure Portal of Visual Studio Code in de ontwerpfunctie.

    In dit voorbeeld wordt gebruikgemaakt van de Azure portal en een voorbeeldwerkstroom met de trigger Herhaling, gevolgd door een variabele initialiseren actie. De actie wordt ingesteld voor het maken van een variabele waarbij de initiële waarde een matrix is met enkele steekproef gehele getallen.

    Operatie Eigenschappen en waarden
    Variabele initialiseren - Naam: myIntegerArray
    - Type: Array
    - Waarde: [1,2,3,4]

    Schermopname van De Azure-portal, de ontwerpfunctie voor verbruikswerkstromen en een voorbeeldwerkstroom voor de actie Selecteren.

  2. Volg deze algemene stappen om de actie Gegevensbewerkingen met de naam Selecteren te vinden.

  3. Selecteer in de ontwerpfunctie de actie Selecteren als deze nog niet is geselecteerd. Voer in het vak Van de bronmatrix in die u wilt gebruiken.

    Voor dit voorbeeld selecteert u in het vak Van en selecteert u vervolgens het bliksempictogram, waarmee de lijst met dynamische inhoud wordt geopend. Selecteer in die lijst de eerder gemaakte variabele:

    Schermopname van de werkstroom Verbruik, de actie Selecteren en de geselecteerde bronmatrixvariabele die u wilt gebruiken.

  4. 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 eigenschapsnaam voor de gehele waarden in de bronmatrix. Elke waarde, bijvoorbeeld 1, 2, 3 en 4, is een product-id.

  5. Voer in de rechterkolom een expressie in waarmee de waarde in de bronmatrix wordt opgegeven voor de naam van de eigenschap in de linkerkolom.

    In dit voorbeeld wordt de functie item() gebruikt om elk item in de matrix te doorlopen en te openen.

    1. Selecteer in de rechterkolom en selecteer vervolgens het functiepictogram, waarmee de expressie-editor wordt geopend. Zorg ervoor dat de Functielijst geselecteerd is.

    2. Voer in de expressie-editor de functie item()in en selecteer Vervolgens Toevoegen.

      Schermopname toont de Verbruik-werkstroom, de actie Selecteren, en de bijbehorende JSON-objecteigenschap en waarden om de JSON-objectarray te maken.

    De actie Selecteren lijkt nu op het volgende voorbeeld:

    Schermopname toont de werkstroom Verbruik en de voltooide voorbeeldactie genaamd Select.

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

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 vak waarin u de resultaten wilt weergeven, selecteert u in elk vak en selecteert u vervolgens het functiepictogram, waarmee de expressie-editor wordt geopend. 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')

      Schermopname van de werkstroom met de actie Een e-mail verzenden en actie-uitvoer van de actie Selecteren.

      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:

      Schermopname van de werkstroom en de voltooide actie Een e-mail verzenden voor de actie Selecteren.

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

Als u Office 365 Outlook - Een e-mailactie verzenden gebruikt, wordt in het volgende voorbeeld het resultaat weergegeven:

Schermopname van e-mail met resultaten van de actie Selecteren.

Probleemoplossing

Tabelgegevens opmaken

Als uw CSV-tabel of HTML-tabel wordt geretourneerd met onjuiste opmaak, controleert u of uw 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/>')

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