Share via


Értékek tárolására és kezelésére szolgáló változók létrehozása az Azure Logic Appsben

A következőkre vonatkozik: Azure Logic Apps (Használat + Standard)

Ez az útmutató bemutatja, hogyan hozhat létre és használhat változókat, hogy értékeket tárolhasson és használhasson a logikai alkalmazás munkafolyamatában. A változók például segíthetnek nyomon követni a ciklus futási idejének számát. Ha át szeretne iterálni egy tömböt, vagy ellenőrizni szeretne egy adott elemet, egy változóval hivatkozhat az egyes tömbelemek indexszámára.

Olyan adattípusokhoz hozhat létre változókat, mint az egész szám, az lebegőpontos, a logikai, a sztring, a tömb és az objektum. A változó létrehozása után más feladatokat is végrehajthat, például:

  • Kérje le vagy hivatkozzon a változó értékére.
  • Növelje vagy csökkentse a változót állandó értékkel, más néven növekménysel és csökkenéssel.
  • Rendeljen hozzá egy másik értéket a változóhoz.
  • Sztring vagy tömb utolsó elemeként szúrja be vagy fűzze hozzá a változó értékét.

A változók léteznek, és csak az őket létrehozó munkafolyamat-példányon belül globálisak. Emellett megmaradnak a munkafolyamat-példányokon belüli hurkok iterációi között is. Amikor egy változóra hivatkozik, a változó nevét használja jogkivonatként, nem pedig a művelet nevét, amely a művelet kimenetére való hivatkozás szokásos módja.

Fontos

Alapértelmezés szerint az egyes ciklusok iterációi párhuzamosan futnak. Ha változókat használ a hurkokban, futtassa a ciklust egymás után , hogy a változók kiszámítható eredményeket adjanak vissza.

Előfeltételek

A következő lépések a Azure Portal használják, de a megfelelő Azure Logic Apps-bővítménnyel a következő eszközökkel is létrehozhat logikaialkalmazás-munkafolyamatokat:

Attól függően, hogy Használat vagy Standard munkafolyamattal rendelkezik-e, kövesse a megfelelő lépéseket:

Változó inicializálása

A munkafolyamat egyetlen műveletével létrehozhat egy változót, és deklarálhatja annak adattípusát és kezdeti értékét. Változókat csak globális szinten deklarálhat, hatókörökön, feltételeken és hurkokon belül nem.

  1. A Azure Portal nyissa meg a munkafolyamatot a tervezőben.

  2. A tervezőben kövesse az alábbi általános lépéseket a változó inicializálása nevű művelet hozzáadásához.

  3. Adja meg a következő információkat a változóról:

    Tulajdonság Kötelező Érték Leírás
    Név Igen <változó neve> A növekményes változó neve
    Típus Igen <változótípus> A változó adattípusa
    Érték Nem <start-value> A változó kezdeti értéke

    Tipp: Bár nem kötelező, állítsa be az értéket ajánlott eljárásként, hogy mindig tudja a változó kezdőértékét.

    Az alábbi példa a mintaváltozó kezdeti értékeit mutatja be:

    Képernyőkép a Azure Portal, a fogyasztói munkafolyamatról és a változó inicializálása nevű műveletről.

  4. Most folytassa a forgatókönyvhöz használni kívánt műveletek hozzáadását. Ha elkészült, a tervező eszköztárán válassza a Mentés lehetőséget.

Ha a tervezőről kódnézetre vált, az alábbi példa bemutatja, hogyan jelenik meg a változó inicializálása művelet a munkafolyamat-definícióban, amely JavaScript Object Notation (JSON) formátumban van:

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

Megjegyzés

Bár a Változó inicializálása művelet egy tömbként strukturált objektummal rendelkezik "variables" , a művelet egyszerre csak egy változót hozhat létre. Minden új változóhoz egyéni inicializálási változóművelet szükséges.

Az alábbi példák más változótípusokat mutatnak be:

Logikai változó

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

Lebegőpontos változó

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

Sztringváltozó

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

Objektumváltozó

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

Tömb egész számokkal

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

Tömb sztringekkel

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

Változó értékének lekérése

Egy változó tartalmának lekéréséhez vagy hivatkozásához használhatja a változók() függvényt a munkafolyamat-tervezőben és a kódnézet-szerkesztőben. Amikor egy változóra hivatkozik, a változó nevét használja jogkivonatként, nem pedig a művelet nevét, amely a művelet kimenetére való hivatkozás szokásos módja.

Az alábbi kifejezés például lekéri az ebben az útmutatóban létrehozott tömbváltozó elemeit a variables() függvény használatával. A string() függvény sztringformátumban adja vissza a változó tartalmát: "1, 2, 3, red"

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

Növekményes változó

Ha egy változót egy adott állandó érték alapján szeretne növelni vagy növelni , adja hozzá a Változó növekménye műveletet a munkafolyamathoz. Ez a művelet csak egész számmal és lebegőpontos változókkal működik.

  1. A munkafolyamat-tervezőben kövesse az alábbi általános lépéseket egy Növekményváltozó nevű művelet hozzáadásához.

  2. Adja meg a következő információkat ehhez a művelethez:

    Tulajdonság Kötelező Érték Leírás
    Név Igen <változó neve> A növekményes változó neve
    Érték Nem <növekmény-érték> A változó növeléséhez használt érték. Az alapértelmezett érték 1.

    Tipp: Bár nem kötelező, ezt az értéket ajánlott eljárásként beállítani, hogy mindig tisztában legyen a változó növelésének konkrét értékével.

    Az alábbi példa a művelet mintaértékét mutatja be:

    Képernyőkép Azure Portal, használati munkafolyamatról és növekményváltozó nevű műveletről.

  3. Ha elkészült, mentse a munkafolyamatot. A tervező eszköztárán válassza a Mentés lehetőséget.

Ha a tervezőről kódnézetre vált, az alábbi példa bemutatja, hogyan jelenik meg a Növekmény változóművelet a munkafolyamat-definícióban, amely JSON formátumban van:

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

Példa: Hurokszámláló létrehozása

A változókat gyakran használják a ciklus futási idejének megszámlálásához. Ez a példa bemutatja, hogyan hozhat létre és használhat változókat ehhez a feladathoz egy olyan hurok létrehozásával, amely megszámolja a mellékleteket egy e-mailben.

  1. A Azure Portal hozza létre a Használat logikai alkalmazás erőforrást egy üres munkafolyamattal. Adjon hozzá egy eseményindítót, amely új e-maileket és mellékleteket keres.

    Ez a példa a Office 365 Outlook-eseményindítót használja az Új e-mail érkezésekor beállításhoz. Ezt az eseményindítót beállíthatja úgy, hogy csak akkor aktiválódjon, ha az e-mail mellékletekkel rendelkezik. Azonban bármilyen összekötőt használhat, amely mellékleteket tartalmazó új e-maileket keres, például a Outlook.com összekötőt.

  2. Az eseményindítóban a mellékletek kereséséhez és a mellékletek munkafolyamatba való továbbításához válassza az Igen lehetőséget a következő tulajdonságokhoz:

    • Csak melléklettel
    • Mellékletek is

    Képernyőkép a mellékletek kereséséhez és hozzáadásához kiválasztott Azure Portal, használatalapú munkafolyamatról és tulajdonságokról.

  3. Adja hozzá a Változó inicializálása műveletet egy Darabszám nevű egész szám változó létrehozásához, amelynek kezdőértéke a következőre 0van állítva: .

  4. Az egyes mellékletek iterálásához kövesse az alábbi általános lépéseket egy minden egyes hurokhoz tartozó művelet hozzáadásához.

  5. A hurokban válassza a Select an output from previous steps (Kimenet kiválasztása az előző lépésekből) nevű mezőben. A dinamikus tartalomlista megjelenése után az Új e-mail érkezésekor területen válassza a Mellékletek lehetőséget.

    Képernyőkép a Használat munkafolyamatról, Az egyes hurkokhoz, a megnyitott dinamikus tartalomlistához és a Mellékletek kimenet kiválasztásához.

    A Mellékletek tulajdonság egy tömböt ad át, amely az eseményindító kimenetéből származó e-mail mellékleteket tartalmazza a munkafolyamat ismétlési ciklusába.

  6. Az Egyes hurkok esetében válassza a Művelet hozzáadása lehetőséget.

  7. Az alábbi általános lépéseket követve adjon hozzá egy növekményváltozó nevű műveletet a hurokhoz.

    Megjegyzés

    Győződjön meg arról, hogy a Változó növekménye művelet megjelenik a hurokban. Ha a művelet a hurokon kívül jelenik meg, húzza a műveletet a hurokba.

  8. A Változó növekménye művelet Név listájában válassza ki a Count változót. Állítsa a Value (Érték ) tulajdonságot értékre 1.

    Képernyőkép a Használat munkafolyamatról a Darabszám nevű kiválasztott változóval.

  9. A hurok alatt adjon hozzá minden olyan műveletet, amely a mellékletek számát küldi. A műveletben adja meg a Count változó értékét, például:

    Képernyőkép a Használat munkafolyamatról és egy olyan műveletről, amely eredményeket küld.

  10. Ha elkészült, mentse a munkafolyamatot. A tervező eszköztárán válassza a Mentés lehetőséget.

A munkafolyamat tesztelése

  1. A munkafolyamat manuális aktiválásához kövesse a megfelelő lépést:

    Használati munkafolyamat

    A tervezői munkafolyamat eszköztárán válassza az Eseményindító>futtatása lehetőséget a munkafolyamat manuális futtatásához.

    Standard munkafolyamat

    A munkafolyamat menüjében válassza az Áttekintés lehetőséget. Az eszköztáron válassza a Futtatás parancsot>.

  2. Küldjön egy vagy több mellékletet tartalmazó e-mailt a példában használt e-mail-fiókba.

    Ez a lépés elindítja a munkafolyamat-eseményindítót, amely létrehoz és futtat egy munkafolyamat-példányt. Ennek eredményeképpen a munkafolyamat egy üzenetet vagy e-mailt küld Önnek, amely az elküldött e-mail mellékleteinek számát jeleníti meg.

Ha a tervezőről kódnézetre vált, az alábbi példa bemutatja, hogyan jelenik meg az Egyes hurkok esetében a Növekmény változóművelet a munkafolyamat-definícióban, amely JSON formátumban van:

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

Decrement változó

Ha egy változót egy adott állandó érték alapján szeretne csökkenteni vagy csökkenteni , kövesse a változók növelésének lépéseit , azzal a különbséget kivéve, hogy a Decrement változó műveletet adja hozzá a munkafolyamathoz. Ez a művelet csak egész és lebegőpontos változókkal működik.

Az alábbi táblázat a Decrement változó művelet adatait ismerteti:

Tulajdonság Kötelező Érték Leírás
Név Igen <változó neve> A decrement változó neve
Érték Nem <növekmény-érték> A változó csökkenésének értéke. Az alapértelmezett érték egy.

Tipp: Bár nem kötelező, ezt az értéket ajánlott eljárásként beállítani, hogy mindig tudja a változó csökkenésének konkrét értékét.

Ha a tervezőről kódnézetre vált, az alábbi példa bemutatja, hogyan jelenik meg a Decrement változó művelet a munkafolyamat-definícióban, amely JSON formátumban van:

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

Változó beállítása

Ha egy másik értéket szeretne hozzárendelni egy meglévő változóhoz, kövesse a változók növelésének lépéseit az alábbi kivételekkel:

  1. Keresse meg és válassza ki a Változó beállítása műveletet.

  2. Adja meg a hozzárendelni kívánt változó nevét és értékét. Az új értéknek és a változónak is ugyanazzal az adattípussal kell rendelkeznie. Az értékre azért van szükség, mert ez a művelet nem rendelkezik alapértelmezett értékkel.

A következő táblázat a Változó beállítása művelet adatait ismerteti:

Tulajdonság Kötelező Érték Leírás
Név Igen <változó neve> A módosítandó változó neve
Érték Igen <new-value> A változóhoz hozzárendelni kívánt érték. Mindkét adattípusnak azonosnak kell lennie.

Megjegyzés

Ha nem növekményes vagy csökkenő változókat ad meg, a ciklusokon belüli változók módosítása váratlan eredményeket eredményezhet , mivel a hurkok alapértelmezés szerint párhuzamosan vagy egyidejűleg futnak. Ezekben az esetekben próbálja meg úgy beállítani a hurkot, hogy egymás után fusson. Ha például hivatkozni szeretne a hurok változóértékére, és ugyanazt az értéket várja el a hurokpéldány elején és végén, kövesse az alábbi lépéseket a hurok futásának módosításához:

  1. A hurokban keresse meg és nyissa meg a hurok beállításait.

  2. A munkafolyamat típusa alapján kövesse a megfelelő lépéseket:

    • Használat: Módosítsa az Egyidejűség-vezérlés beállítást Ki értékről Be értékre.

    • Standard: Az Általános csoportban módosítsa az Egyidejűség-vezérlés beállítást Ki értékről Be értékre.

  3. Húzza a Párhuzamosság foka csúszkát 1-re.

Ha a tervezőről kódnézetre vált, az alábbi példa bemutatja, hogyan jelenik meg a Változó beállítása művelet a munkafolyamat-definícióban, amely JSON formátumban van:

Az alábbi példa a Count változó aktuális értékét egy másik értékre módosítja:

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

Hozzáfűzés változóhoz

A sztringeket vagy tömböket tároló változók esetében beszúrhatja vagy hozzáfűzheti a változó értékét a sztringek vagy tömbök utolsó elemeként. A változók növekményének lépéseit a következő kivételekkel végezheti el:

  1. Keresse meg és válassza ki az alábbi műveletek egyikét attól függően, hogy a változó sztring vagy tömb:

    • Hozzáfűzés sztringváltozóhoz
    • Hozzáfűzés tömbváltozóhoz
  2. Adja meg a hozzáfűzendő értéket a sztring vagy tömb utolsó elemeként. Kötelezően megadandó érték.

Az alábbi táblázat a Hozzáfűzés... műveletekhez tartozó információkat ismerteti:

Tulajdonság Kötelező Érték Leírás
Név Igen <változó neve> A módosítandó változó neve
Érték Igen <append-value> A hozzáfűzni kívánt érték, amely bármilyen típusú lehet

Ha a tervezőről kódnézetre vált, az alábbi példa bemutatja, hogyan jelenik meg a Hozzáfűzés tömbhöz változó művelet a munkafolyamat-definícióban, amely JSON formátumban van.

Az alábbi példa létrehoz egy tömbváltozót, és egy másik értéket ad hozzá a tömb utolsó elemeként. Az eredmény egy frissített változó, amely a következő tömböt tartalmazza: [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" ]
      }
   }
},

Következő lépések