Skapa variabler för att lagra och hantera värden i Azure Logic Apps

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

Den här instruktionsguiden visar hur du skapar och arbetar med variabler så att du kan lagra och använda värden i logikappens arbetsflöde. Variabler kan till exempel hjälpa dig att spåra antalet gånger som en loop körs. Om du vill iterera över en matris eller kontrollera en matris för ett visst objekt kan du använda en variabel för att referera till indexnumret för varje matrisobjekt.

Du kan skapa variabler för datatyper som heltal, flyttal, boolesk, sträng, matris och objekt. När du har skapat en variabel kan du utföra andra uppgifter, som:

• Hämta eller referera till variabelns värde.
• Öka eller minska variabeln med ett konstant värde, även kallat ökning och minskning.
• Tilldela ett annat värde till variabeln.
• Infoga eller lägga till variabelns värde som det sista objektet i en sträng eller matris.

Variabler finns och är endast globala i arbetsflödesinstansen som skapar dem. Dessutom finns de kvar i alla loop-iterationer i en arbetsflödesinstans. När du refererar till en variabel använder du variabelns namn som token, inte åtgärdens namn, vilket är det vanliga sättet att referera till en åtgärds utdata.

Förutsättningar

• Ett Azure-konto och prenumeration. Om du inte har en prenumeration registrerar du dig för ett kostnadsfritt Azure-konto.

• Ett arbetsflöde för logikappen där du vill skapa variabeln och en utlösare som startar arbetsflödet.

  Innan du kan lägga till åtgärder för att skapa och arbeta med variabler måste arbetsflödet börja med en utlösare som det första steget i arbetsflödet. Mer information finns i Skapa ett arbetsflöde med en utlösare eller åtgärd.

Följande steg använder Azure Portal, men med rätt Azure Logic Apps-tillägg kan du också använda följande verktyg för att skapa arbetsflöden för logikappar:

• Förbrukningsarbetsflöden: Visual Studio Code
• Standardarbetsflöden: Visual Studio Code

Baserat på om du har ett förbruknings- eller standardarbetsflöde följer du motsvarande steg:

Initiera variabel

Du kan skapa en variabel och deklarera dess datatyp och initialvärde med hjälp av en enda åtgärd i arbetsflödet. Du kan endast ange variabler på global nivå, inte inom omfattningar, villkor och loopar.

Om du växlar från designern till kodvyn visar följande exempel hur åtgärden Initiera variabel visas i arbetsflödesdefinitionen, som är i JSON-format (JavaScript Object Notation):

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ 
            {
               "name": "Count",
               "type": "Integer",
               "value": 0
            }
         ]
      },
      "runAfter": {}
   }
},

I följande exempel visas andra variabeltyper:

Boolesk variabel

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myBooleanVariable",
               "type": "boolean",
               "value": false
            }
         ]
      },
      "runAfter": {}
   }
},

Flyttalvariabel

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myFloatVariable",
               "type": "float",
               "value": 1.99999
            }
         ]
      },
      "runAfter": {}
   }
},

Strängvariabel

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myStringVariable",
               "type": "string",
               "value": "lorem ipsum"
            }
         ]
      },
      "runAfter": {}
   }
},

Objektvariabel

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "MyObjectVariable",
               "type": "object",
               "value": {
                  "ProductItem": {
                     "Name": "myProductName",
                     "ProductID": "000000"
                  }
               }
            }
         ]
      },
      "runAfter": {}
   }
},

Matris med heltal

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myArrayVariable",
               "type": "array",
               "value": [1, 2, 3]
            }
         ]
      },
      "runAfter": {}
   }
},

Matris med strängar

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myArrayVariable",
               "type": "array",
               "value": ["red", "orange", "yellow"]
            }
         ]
      },
      "runAfter": {}
   }
},

Hämta en variabels värde

Om du vill hämta eller referera till en variabels innehåll kan du använda funktionen variables() i arbetsflödesdesignern och kodvisningsredigeraren. När du refererar till en variabel använder du variabelns namn som token, inte åtgärdens namn, vilket är det vanliga sättet att referera till en åtgärds utdata.

Följande uttryck hämtar till exempel objekten från matrisvariabeln som skapas i den här guiden med hjälp variables() av funktionen. Funktionen string() returnerar variabelns innehåll i strängformat: "1, 2, 3, red"

@{string(variables('myArrayVariable'))}

Öka variabel

Om du vill öka eller öka en variabel med ett specifikt konstant värde lägger du till åtgärden Öka variabel i arbetsflödet. Den här åtgärden fungerar endast med heltals- och flyttalsvariabler.

Om du växlar från designern till kodvyn visar följande exempel hur åtgärden Öka variabel visas i arbetsflödesdefinitionen, som är i JSON-format:

"actions": {
   "Increment_variable": {
      "type": "IncrementVariable",
      "inputs": {
         "name": "Count",
         "value": 1
      },
      "runAfter": {}
   }
},

Exempel: Skapa loopräknare

Variabler används ofta för att räkna antalet gånger som en loop körs. Det här exemplet visar hur du kan skapa och använda variabler för den här uppgiften genom att skapa en loop som räknar de bifogade filerna i ett e-postmeddelande.

Testa arbetsflödet

1. Om du vill utlösa arbetsflödet manuellt följer du motsvarande steg:

   Arbetsflöde för förbrukning

   I verktygsfältet för designerarbetsflödet väljer du Kör utlösarkörning> för att köra arbetsflödet manuellt.

   Standardarbetsflöde

   På arbetsflödesmenyn väljer du Översikt. Välj Kör>kör i verktygsfältet.

2. Skicka ett e-postmeddelande med en eller flera bifogade filer till det e-postkonto som du använde i det här exemplet.

   Det här steget utlöser arbetsflödesutlösaren, som skapar och kör en arbetsflödesinstans. Därför skickar arbetsflödet ett meddelande eller ett e-postmeddelande som visar antalet bifogade filer i e-postmeddelandet som du skickade.

Om du växlar från designern till kodvyn visar följande exempel hur för varje loop visas tillsammans med åtgärden Öka variabel i arbetsflödesdefinitionen, som är i JSON-format:

"actions": {
   "For_each": {
      "type": "Foreach",
      "actions": {
         "Increment_variable": {
           "type": "IncrementVariable",
            "inputs": {
               "name": "Count",
               "value": 1
            },
            "runAfter": {}
         }
      },
      "foreach": "@triggerBody()?['Attachments']",
      "runAfter": {
         "Initialize_variable": [ "Succeeded" ]
      }
   }
},

Minskningsvariabel

Om du vill minska eller minska en variabel med ett specifikt konstant värde följer du stegen för att öka en variabel , förutom att du lägger till åtgärden Decrement variable i arbetsflödet i stället. Den här åtgärden fungerar endast med heltals- och flyttalsvariabler.

I följande tabell beskrivs informationen för åtgärden decrementvariabel :

Om du växlar från designern till kodvyn visar följande exempel hur åtgärden decrementvariabel visas i arbetsflödesdefinitionen, som är i JSON-format:

"actions": {
   "Decrement_variable": {
      "type": "DecrementVariable",
      "inputs": {
         "name": "Count",
         "value": 1
      },
      "runAfter": {}
   }
},

Ange variabel

Om du vill tilldela ett annat värde till en befintlig variabel följer du stegen för att öka en variabel med följande undantag:

1. Hitta och välj åtgärden ange variabel istället.

2. Ange det variabelnamn och värde du vill tilldela. Både det nya värdet och variabeln måste ha samma datatyp. Värdet krävs eftersom den här åtgärden inte har något standardvärde.

I följande tabell beskrivs informationen för åtgärden Ange variabel :

Om du växlar från designern till kodvyn visar följande exempel hur åtgärden Ange variabel visas i arbetsflödesdefinitionen, som är i JSON-format:

I följande exempel ändras Count variabelns aktuella värde till ett annat värde:

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
               "name": "Count",
               "type": "Integer",
               "value": 0
          } ]
      },
      "runAfter": {}
   },
   "Set_variable": {
      "type": "SetVariable",
      "inputs": {
         "name": "Count",
         "value": 100
      },
      "runAfter": {
         "Initialize_variable": [ "Succeeded" ]
      }
   }
},

Lägga till variabel

För variabler som lagrar strängar eller matriser kan du infoga eller lägga till en variabels värde som det sista objektet i de strängarna eller matriserna. Du kan följa stegen för att öka en variabel med följande undantag:

1. Leta upp och välj en av dessa åtgärder baserat på om din variabel är en sträng eller en matris:

   • Lägga till strängvariabel
   • Lägga till matrisvariabel

2. Ange värdet som ska läggas till som det sista objektet i strängen eller matrisen. Detta värde krävs.

I följande tabell beskrivs informationen för åtgärderna Lägg till i ... :

Om du växlar från designern till kodvyn visar följande exempel hur åtgärden Lägg till i matrisvariabel visas i arbetsflödesdefinitionen, som är i JSON-format.

I följande exempel skapas en matrisvariabel och ett annat värde läggs till som det sista objektet i matrisen. Resultatet är en uppdaterad variabel som innehåller den här matrisen: [1,2,3,"red"]

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
            "name": "myArrayVariable",
            "type": "Array",
            "value": [1, 2, 3]
         } ]
      },
      "runAfter": {}
   },
   "Append_to_array_variable": {
      "type": "AppendToArrayVariable",
      "inputs": {
         "name": "myArrayVariable",
         "value": "red"
      },
      "runAfter": {
        "Initialize_variable": [ "Succeeded" ]
      }
   }
},

Nästa steg

• Hanterade anslutningsappar för Azure Logic Apps
• Inbyggda anslutningsappar för Azure Logic Apps