Omforma data i arbetsflöden för Azure Logic Apps

Gäller för: Azure Logic Apps (Förbrukning + Standard)

För att arbeta med olika data i dina arbetsflöden, använd de inbyggda Data Operations-åtgärderna så att du slipper skriva egen kod.

Denna guide introducerar och visar hur man använder varje åtgärd:

Förutsättningar

• Ett Azure-konto och prenumeration. Skaffa ett kostnadsfritt Azure-konto.

• Arbetsflödet för logikappen där du vill utföra dataåtgärden.

  Innan du använder en dataoperation måste ditt arbetsflöde inkludera en trigger som första steg. Efter denna trigger, inkludera andra nödvändiga åtgärder för att skapa utdata som dataoperationen använder som indata.

Åtgärder för dataoperationer

I följande avsnitt sammanfattas de dataåtgärder som du kan använda. Åtgärderna organiseras baserat på de källdatatyper som åtgärderna fungerar med, men varje beskrivning visas alfabetiskt. Välj ett åtgärdsnamn för att gå direkt till ett steg-för-steg-exempel.

JSON-åtgärder

Följande åtgärder hjälper dig att arbeta med data i JSON-format (JavaScript Object Notation).

Information om hur du skapar mer komplexa JSON-transformeringar finns i Utföra avancerade JSON-transformeringar med Liquid-mallar.

Arrayåtgärder

Följande åtgärder hjälper dig att arbeta med data i matriser.

Skapa åtgärd

Använd Compose-åtgärden för att skapa en enda utdata, till exempel ett JSON-objekt, från flera indata. Dina indata kan ha olika typer, såsom heltal, booleska filer, arrayer, JSON-objekt och alla andra inbyggda typer som Azure Logic Apps stödjer, inklusive binärt och XML. Du kan använda utdata i handlingar som följer efter Compose-åtgärden . Åtgärden Skriv hjälper dig också att undvika att upprepade gånger ange samma indata när du skapar logikappens arbetsflöde.

Du kan till exempel skapa ett JSON-meddelande från flera variabler, till exempel strängvariabler som lagrar personers förnamn och efternamn, och en heltalsvariabel som lagrar personers ålder. I det här exemplet tar åtgärden Skriv emot följande ingångar:

{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }

Och skapar följande utdata:

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

Om du vill prova åtgärden Skapa, följer du de här stegen med hjälp av arbetsflödesdesignern. Eller, om du föredrar att arbeta i kodvyeditorn, kan du kopiera exemplet Compose-åtgärd och variabeldefinitioner för åtgärden Initialize variables från denna guide till din egen logikapps underliggande arbetsflödesdefinition: Data operation code examples - Compose. Mer information om åtgärden Skriv i den underliggande JSON-arbetsflödesdefinitionen finns i åtgärden Skriv.

Testa arbetsflödet

Om du vill bekräfta om åtgärden Skriv skapar det förväntade resultatet skickar du ett meddelande till dig själv som innehåller utdata från åtgärden Skriv .

1. Lägg till en åtgärd i ditt arbetsflöde som kan skicka resultaten från Compose-åtgärden.

   Det här exemplet fortsätter med åtgärden Office 365 Outlook med namnet Skicka ett e-postmeddelande (V2):

   

2. I den här åtgärden, för varje ruta där du vill att resultatet ska visas, väljer du inuti varje ruta och väljer sedan listan med dynamiskt innehåll (blixtikonen).

3. Från listan med dynamiskt innehåll, under åtgärden Compose, väljer du Outputs.

   I det här exemplet visas resultatet i e-postmeddelandets brödtext, så du lägger till fältet Utdata i rutan Brödtext :

   

4. Spara arbetsflödet och kör sedan arbetsflödet manuellt. På designverktygsfältet, välj Kör>Kör.

Om du använder åtgärden Office 365 Outlook - Skicka ett e-post (V2) visar följande exempel resultatet:

Skapa CSV-tabellåtgärd

Om du vill skapa en CSV-tabell (kommaavgränsat värde) som har egenskaper och värden från JSON-objekt (JavaScript Object Notation) i en matris använder du åtgärden Skapa CSV-tabell. Du kan sedan använda den resulterande tabellen i åtgärder som följer åtgärden Skapa CSV-tabell .

Om du vill prova åtgärden Skapa CSV-tabell följer du de här stegen med hjälp av arbetsflödesdesignern. Eller, om du föredrar att arbeta i kodvyeditorn, kan du kopiera exemplet Skapa CSV-tabell och variabeldefinitioner för åtgärden Initialisera variabler från denna guide till din egen logikapps underliggande arbetsflödesdefinition: Exempel på dataoperationskoder – Skapa CSV-tabell. Mer information om åtgärden Skapa CSV-tabell i den underliggande JSON-arbetsflödesdefinitionen finns i tabellåtgärden.

Anpassa CSV-tabellkolumner och headers

Som standard skapar Kolumner automatiskt tabellkolumnerna i åtgärden Skapa CSV-tabell baserat på array-elementen. Följ dessa steg om du vill ange anpassade rubriker och värden:

1. Om egenskapen Kolumner inte visas i åtgärdsinformationsrutan väljer du Kolumner i listan Avancerade parametrar.

   

2. Öppna listan Kolumner och välj Anpassad.

3. I egenskapen Header , ange den anpassade headertexten som ska användas.

4. I egenskapen Värde , ange det anpassade värde som ska användas.

För att returnera värden från arrayen, använd item() funktionen med åtgärden Create CSV-tabellen . I en For_each loop, använd items() funktionen.

Anta till exempel att du vill ha tabellkolumner som bara har egenskapsvärdena och inte egenskapsnamnen från en matris. Om du bara vill returnera dessa värden följer du de här stegen för att arbeta i designervyn eller i kodvyn.

Det här exemplet returnerar följande resultat:

Apples,1
Oranges,2

Arbeta i designervyn

I åtgärden Skapa CSV-tabell håller du kolumnen Rubrik tom. På varje rad i kolumnen Värde avreferera varje matrisegenskap som du vill använda. Varje rad under Värde returnerar alla värden för den angivna matrisegenskapen och blir en kolumn i tabellen.

1. För varje matrisegenskap som du vill använda väljer du i kolumnen Värde i redigeringsrutan och väljer sedan funktionsikonen, som öppnar uttrycksredigeraren. Kontrollera att funktionslistan visas markerad.

   

2. I uttrycksredigeraren anger du följande uttryck, men ersätter <array-property-name> med matrisens egenskapsnamn för det värde som du vill använda. När du är klar med varje uttryck väljer du Lägg till.

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

   Exempelvärden:

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

   

   Mer information finns i funktionen item().

3. Upprepa föregående steg för varje matrisegenskap. När du är klar ser åtgärden ut ungefär som i följande exempel:

   

4. Spara arbetsflödet. I verktygsfältet för designern väljer du Spara.

Arbeta i kodvyn

I JSON-definitionen för åtgärden Create CSV-tabell , inom arrayen columns , ställ in egenskapen header till en tom sträng. För varje value egenskap avreferering av varje matrisegenskap som du vill använda.

1. I designerverktygsfältet väljer du Kodvy.

2. Leta reda på åtgärdens columns matris i kodredigeraren. För varje kolumn med matrisvärden som du vill använda lägger du till en tom header egenskap och följande uttryck för value egenskapen:

   Syntax:

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

   Exempel:

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

   Kommentar

   Om du kopierar exemplet till koden kontrollerar du att du inkluderar runAfter åtgärden i slutet av Create_CSV_table definitionen.

3. Gå tillbaka till designern för att granska resultaten.

Testa arbetsflödet

För att bekräfta om åtgärden Skapa CSV-tabell skapar det förväntade resultatet skickar du ett meddelande till dig själv som innehåller utdata från åtgärden Skapa CSV-tabell .

1. I arbetsflödet lägger du till en åtgärd som kan skicka resultatet från åtgärden Skapa CSV-tabell .

   Det här exemplet fortsätter med åtgärden Office 365 Outlook med namnet Skicka ett e-postmeddelande (V2).

2. I den här åtgärden, för varje ruta där du vill att resultatet ska visas, väljer du inuti varje ruta, vilket öppnar listan med dynamiskt innehåll. I den listan går du till åtgärden Skapa CSV-tabell och väljer Utdata.

   

3. Spara arbetsflödet och kör sedan arbetsflödet manuellt. På designverktygsfältet, välj Kör>Kör.

Om du använder åtgärden Office 365 Outlook - Skicka ett e-post (V2) visar följande exempel resultatet:

Skapa EN HTML-tabellåtgärd

Om du vill skapa en HTML-tabell med egenskaper och värden från JSON-objekt (JavaScript Object Notation) i en matris använder du åtgärden Skapa HTML-tabell . Du kan sedan använda den resulterande tabellen i åtgärder som följer åtgärden Skapa HTML-tabell .

Om du vill prova åtgärden Skapa HTML-tabell följer du de här stegen med hjälp av arbetsflödesdesignern. Eller, om du föredrar att arbeta i kodvyeditorn, kan du kopiera exemplet Create HTML-tabell och variabeldefinitioner för åtgärden Initialize variables från denna guide till din egen logikapps underliggande arbetsflödesdefinition: Exempel på dataoperationkod - Skapa HTML-tabell. Mer information om åtgärden Skapa HTML-tabell i den underliggande JSON-arbetsflödesdefinitionen finns i tabellåtgärden.

Anpassa HTML-tabellkolumner och headers

Som standard skapar Kolumner-egenskapen automatiskt tabellkolumnerna i åtgärden Skapa HTML-tabeller baserat på array-elementen. Följ dessa steg om du vill ange anpassade rubriker och värden:

1. Om egenskapen Kolumner inte visas i åtgärdsinformationsrutan väljer du Kolumner i listan Avancerade parametrar.

2. Öppna listan Kolumner och välj Anpassad.

3. I egenskapen Header , ange den anpassade headertexten som ska användas.

4. I egenskapen Värde , ange det anpassade värde som ska användas.

För att returnera värden från arrayen, använd item() funktionen med åtgärden Create HTML-tabell . I en For_each loop, använd items() funktionen.

Anta till exempel att du vill ha tabellkolumner som bara har egenskapsvärdena och inte egenskapsnamnen från en matris. Om du bara vill returnera dessa värden följer du de här stegen för att arbeta i designervyn eller i kodvyn.

Det här exemplet returnerar följande resultat:

Apples,1
Oranges,2

Arbeta i designervyn

I åtgärden Skapa HTML-tabell håller du kolumnen Rubrik tom. På varje rad i kolumnen Värde avreferera varje matrisegenskap som du vill använda. Varje rad under Värde returnerar alla värden för den angivna matrisegenskapen och blir en kolumn i tabellen.

1. För varje matrisegenskap som du vill använda väljer du i kolumnen Värde i redigeringsrutan och väljer sedan funktionsikonen, som öppnar uttrycksredigeraren. Kontrollera att funktionslistan visas markerad.

2. I uttrycksredigeraren anger du följande uttryck, men ersätter <array-property-name> med matrisens egenskapsnamn för det värde som du vill använda. När du är klar med varje uttryck väljer du Lägg till.

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

   Exempel:

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

   

   Mer information finns i funktionen item().

3. Upprepa föregående steg för varje matrisegenskap. När du är klar ser åtgärden ut ungefär som i följande exempel:

   

Arbeta i kodvyn

I JSON-definitionen för åtgärden Skapa HTML-tabell, i columns-arrayen, ställer du in egenskapen header till en tom sträng. För varje value egenskap avreferering av varje matrisegenskap som du vill använda.

1. I designerverktygsfältet väljer du Kodvy.

2. Leta reda på åtgärdens columns matris i kodredigeraren. För varje kolumn med matrisvärden som du vill använda lägger du till en tom header egenskap och följande uttryck för value egenskapen:

   Syntax:

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

   Exempel:

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

   Kommentar

   Om du kopierar exemplet till koden kontrollerar du att du inkluderar runAfter åtgärden i slutet av Create_HTML_table definitionen.

3. Gå tillbaka till designervyn för att granska resultaten.

Testa arbetsflödet

Om du vill bekräfta om åtgärden Skapa HTML-tabell skapar det förväntade resultatet skickar du ett meddelande till dig själv som innehåller utdata från åtgärden Skapa HTML-tabell .

1. I arbetsflödet lägger du till en åtgärd som kan skicka resultatet från åtgärden Skapa HTML-tabell .

   Det här exemplet fortsätter med åtgärden Office 365 Outlook med namnet Skicka ett e-postmeddelande (V2).

2. I den här åtgärden, för varje ruta där du vill att resultatet ska visas, väljer du inuti varje ruta och väljer sedan blixtikonen, som öppnar listan med dynamiskt innehåll. I den listan går du till åtgärden Skapa HTML-tabell och väljer Utdata.

   

3. Spara arbetsflödet och kör sedan arbetsflödet manuellt. På designverktygsfältet, välj Kör>Kör.

Om du använder åtgärden Office 365 Outlook - Skicka ett e-post (V2) visar följande exempel resultatet:

Filtermatrisåtgärd

Använd åtgärden Filterarray för att skapa en delmängdsarray från en befintlig array där delmängdsobjekten uppfyller specifika kriterier. Du kan sedan använda den resulterande filtrerade matrisen i handlingar som följer efter åtgärden Filterarray .

Om du vill prova åtgärden Filtermatris följer du de här stegen med hjälp av arbetsflödesdesignern. Eller, om du föredrar att arbeta i kodvyeditorn, kan du kopiera exemplet Filter array-åtgärd och variabeldefinitioner för åtgärden Initialisera variabler från denna guide till din egen logikapplikations underliggande arbetsflödesdefinition: Data operation code examples - Filter array. Mer information om åtgärden Filtermatris i den underliggande JSON-arbetsflödesdefinitionen finns i frågeåtgärden.

Testa arbetsflödet

För att bekräfta om åtgärden Filterarray skapar förväntade resultat, skicka en notifikation till dig själv som inkluderar utdata från Filterarray-åtgärden .

1. I arbetsflödet lägger du till en åtgärd som kan skicka resultatet från åtgärden Filtermatris .

   Det här exemplet fortsätter med åtgärden Office 365 Outlook med namnet Skicka ett e-postmeddelande (V2).

2. Slutför följande steg i den här åtgärden:

   1. För varje ruta där du vill att resultaten ska visas, markera rutan och sedan funktionsikonen. Ikonen öppnar uttrycksredigeraren. Kontrollera att funktionslistan visas markerad.

   2. Om du vill hämta matrisens utdata från åtgärden Filtermatris anger du följande uttryck, som använder funktionen body() med åtgärdsnamnet Filtermatris och väljer sedan Lägg till.

      body('Filter_array')

      

      Det lösta uttrycket anger att utdata från åtgärden Filter_array visas i brödtexten av e-post vid utskick:

      

3. Spara arbetsflödet och kör sedan arbetsflödet manuellt. På designverktygsfältet, välj Kör>Kör.

Om du använder åtgärden Office 365 Outlook - Skicka ett e-post (V2) visar följande exempel resultatet:

Anslut till åtgärden

För att skapa en sträng som innehåller alla objekt från en array, använd åtgärden Join och separera varje objekt med en specifik avgränsare. Du kan använda denna sträng i handlingar som följer handlingen Join.

För att prova åtgärden Join , följ dessa steg i arbetsflödesdesignern. Eller, om du föredrar att arbeta i kodvyeditorn, kan du kopiera exemplet Join-åtgärden och variabeldefinitionerna för åtgärden Initialisera variabler från denna guide till din egen logikapplikations underliggande arbetsflödesdefinition: Dataoperationkodexempel - Join. Mer information om join-åtgärden i din underliggande arbetsflödesdefinition finns i åtgärden Anslut.

Testa arbetsflödet

Om du vill bekräfta om join-åtgärden skapar det förväntade resultatet skickar du ett meddelande till dig själv som innehåller utdata från åtgärden Anslut .

1. I arbetsflödet lägger du till en åtgärd som kan skicka resultatet från åtgärden Anslut .

   Det här exemplet fortsätter med åtgärden Office 365 Outlook med namnet Skicka ett e-postmeddelande (V2).

2. I den här åtgärden, för varje ruta där du vill att resultatet ska visas, väljer du inuti varje ruta och väljer sedan blixtikonen, som öppnar listan med dynamiskt innehåll. I den listan går du till åtgärden Anslut och väljer Utdata.

   

3. Spara arbetsflödet och kör sedan arbetsflödet manuellt. På designverktygsfältet, välj Kör>Kör.

Om du använder åtgärden Office 365 Outlook - Skicka ett e-post (V2) visar följande exempel resultatet:

Parsa JSON-åtgärd

För att referera till eller komma åt egenskaper i JavaScript Object Notation (JSON)-innehåll, skapa användarvänliga fält eller tokens för dessa egenskaper genom att använda åtgärden Parse JSON . Du kan välja dessa egenskaper från listan över dynamiskt innehåll när du anger indata för efterföljande åtgärder i ditt arbetsflöde. För den här åtgärden kan du antingen ange ett JSON-schema eller generera ett JSON-schema från ditt JSON-exempelinnehåll eller din nyttolast.

Om du vill prova åtgärden Parsa JSON följer du de här stegen med hjälp av arbetsflödesdesignern. Eller, om du föredrar att arbeta i kodvyeditorn, kan du kopiera exemplet på Parse JSON-åtgärden och variabeldefinitionerna för åtgärden Initialize variables från denna guide till din egen logikapps underliggande arbetsflödesdefinition: Data operation code examples - Parse JSON. Mer information om den här åtgärden i din underliggande arbetsflödesdefinition finns i Parsa JSON-åtgärd.

Testa arbetsflödet

Om du vill bekräfta om parsa JSON-åtgärden skapar det förväntade resultatet skickar du ett meddelande till dig själv som innehåller utdata från åtgärden Parsa JSON .

1. I arbetsflödet lägger du till en åtgärd som kan skicka resultatet från åtgärden Parsa JSON .

   Det här exemplet fortsätter med åtgärden Office 365 Outlook med namnet Skicka ett e-postmeddelande (V2).

2. I den här åtgärden, för varje ruta där du vill att resultatet ska visas, väljer du i varje redigeringsruta och väljer sedan blixtikonen, som öppnar listan med dynamiskt innehåll. I den listan går du till åtgärden Parsa JSON och väljer egenskaperna från det parsade JSON-objektet.

   Detta exempel väljer följande egenskaper: Body FirstName, Body LastName och Body Email.

   

   När du är klar ser åtgärden Skicka ett e-postmeddelande ut ungefär som i följande exempel:

   

3. Spara arbetsflödet och kör sedan arbetsflödet manuellt. På designverktygsfältet, välj Kör>Kör.

Om du använder åtgärden Office 365 Outlook - Skicka ett e-post (V2) visar följande exempel resultatet:

Välj åtgärd

Som standard skapar åtgärden Välj en matris som innehåller JSON-objekt som skapats från värdena i en befintlig matris. Du kan till exempel skapa ett JSON-objekt för varje värde i en heltalsmatris. Ange de egenskaper som varje JSON-objekt måste ha och mappa värdena från källmatrisen till egenskaperna. Även om du kan ändra komponentens JSON-objekt har utdatamatrisen alltid samma antal objekt som källmatrisen. Om du vill använda utdatamatrisen från åtgärden Välj måste efterföljande åtgärder antingen acceptera matriser som indata, eller så måste du omvandla utdatamatrisen till ett annat kompatibelt format.

Om du vill prova åtgärden Välj följer du de här stegen med hjälp av arbetsflödesdesignern. Eller, om du föredrar att arbeta i kodvyeditorn, kan du kopiera exemplet Select-åtgärden och variabeldefinitionerna för åtgärden Initialisera variabler från denna guide till din egen logikapplikations underliggande arbetsflödesdefinition: Dataoperationskodexempel - Select. Mer information om den här åtgärden i din underliggande arbetsflödesdefinition finns i Välj åtgärd.

Testa arbetsflödet

Om du vill bekräfta om åtgärden Välj skapar det förväntade resultatet skickar du ett meddelande till dig själv som innehåller utdata från åtgärden Välj .

1. I arbetsflödet lägger du till en åtgärd som kan skicka resultatet från åtgärden Välj .

2. Slutför följande steg i den här åtgärden:

   1. För varje ruta där du vill att resultaten ska visas, markera rutan och sedan funktionsikonen. Ikonen öppnar uttrycksredigeraren. Kontrollera att funktionslistan visas markerad.

   2. Om du vill hämta matrisens utdata från åtgärden Select anger du följande uttryck, som använder funktionen body() med åtgärdsnamnet Select, och välj Lägg till:

      body('Select')

      

      Det lösta uttrycket anger att visa utdata från åtgärden Välj i e-postens huvudinnehåll när det skickas.

      

3. Spara arbetsflödet och kör sedan arbetsflödet manuellt. På designverktygsfältet, välj Kör>Kör.

Om du använder åtgärden Office 365 Outlook - Skicka ett e-post (V2) visar följande exempel resultatet:

Felsökning av dataoperationer

Rätta felaktigt formaterad CSV- eller HTML-tabellutdata

Om åtgärden Skapa CSV-tabell eller Skapa HTML-tabell returnerar felaktigt formaterad data, se till att din indata innehåller radbrytningar mellan raderna.

Felaktig formatering:

Fruit,Number Apples,1 Oranges,2

Korrekt formatering:

Fruit,Number
Apples,1
Oranges,2

Om du vill lägga till radbrytningar mellan rader lägger du till något av följande uttryck i tabellen:

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

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

Till exempel:

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

Relaterat innehåll

• Hanterade kopplingar för Azure Logic Apps
• Inbyggda anslutningar för Azure Logic Apps