Megosztás a következőn keresztül:


É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 ciklusok futási idejének számát. Ha egy tömbön át szeretne iterálni, vagy ellenőrizni szeretne egy adott elemet, egy változóval hivatkozhat az egyes tömbelemek indexszámára.

Létrehozhat változókat adattípusokhoz, például egész számhoz, lebegőpontoshoz, logikai értékhez, sztringhez, tömbhöz és objektumhoz. A változó létrehozása után más feladatokat is végrehajthat, például:

  • A változó értékének lekérése vagy hivatkozása.
  • Növelje vagy csökkentse a változót állandó értékkel, más néven növekménysel és decrementel.
  • Rendeljen hozzá egy másik értéket a változóhoz.
  • Szúrja be vagy fűzze hozzá a változó értékét egy sztring vagy tömb utolsó elemeként.

A változók csak az őket létrehozó munkafolyamat-példányon belül léteznek és globálisak. Emellett a munkafolyamat-példányokon belül minden ciklus iterációban megmaradnak. 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 ciklusokban, futtassa a ciklust egymás után , hogy a változók kiszámítható eredményeket adjanak vissza.

Előfeltételek

Az alábbi lépések az Azure Portalt használják, de a megfelelő Azure Logic Apps-bővítménysel a következő eszközökkel is létrehozhat logikaialkalmazás-munkafolyamatokat:

Egyes lépések kissé eltérnek attól függően, hogy használatalapú vagy standard munkafolyamattal rendelkezik-e.

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. A változókat csak globális szinten deklarálhatja, hatókörön, feltételeken és hurkokon belül nem.

  1. Az Azure Portalon nyissa meg a logikai alkalmazás munkafolyamatát a tervezőben.

  2. A tervezőben kövesse az alábbi általános lépéseket a Használat vagy a Standard munkafolyamatok esetében a változók 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ónév> Az inicializálandó változó neve
    Típus Igen < változótípus> A változó adattípusa
    Érték Nem < kezdő érték> 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 tisztában legyen a változó kezdőértékével.

    Ha egyszerre több változót szeretne létrehozni, válassza a Változó hozzáadása lehetőséget.

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

    Képernyőkép az Azure Portalról és egy logikai alkalmazás munkafolyamatról a változók inicializálása nevű művelettel.

  4. 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ók 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": {}
   }
}

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 variables() 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 a függvény használatával lekéri az ebben az útmutatóban létrehozott tömbváltozó elemeit variables() . A string() függvény a változó tartalmát sztring formátumban adja vissza: "1, 2, 3, red".

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

Változó értékének növelése

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

  1. A tervezőben kövesse az alábbi általános lépéseket a Használat vagy a Standard munkafolyamatok esetében egy Növekmény változó nevű művelet hozzáadásához.

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

    Tulajdonság Kötelező Érték Leírás
    Név Igen < változónév> 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 az Azure Portalról és egy logikaialkalmazás-munkafolyamatról egy Növekményváltozó nevű művelettel.

  3. Miután végzett, 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 ciklusok 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 ciklus létrehozásával, amely megszámolja a mellékleteket egy e-mailben.

  1. Az Azure Portalon hozza létre a logikai alkalmazás erőforrását egy üres munkafolyamattal. Adjon hozzá egy eseményindítót, amely ellenőrzi az új e-maileket és a mellékleteket.

    Ez a példa az Office 365 Outlook eseményindítót használja, amikor új e-mail érkezik. Ezt az eseményindítót csak akkor állíthatja be, ha az e-mail mellékletekkel rendelkezik. Azonban bármilyen összekötőt használhat, amely mellékletekkel, például Outlook.com összekötővel ellenőrzi az új e-maileket.

  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 az Azure Portal és a logikai alkalmazás munkafolyamatairól, amelyen az Office 365 Outlook-eseményindító tulajdonságai vannak kiválasztva a mellékletek kereséséhez és belefoglalásához.

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

  4. A tervezőben kövesse az alábbi általános lépéseket a Használat vagy a Standard munkafolyamatok esetében az egyes hurkokhoz tartozó művelet hozzáadásához .

  5. A hurokban válassza ki az Előző lépések kimenetének kiválasztása nevű mezőben a bemeneti beállítások megtekintéséhez. A dinamikus tartalomlista megtekintéséhez válassza a villám ikont. A listából válassza a Mellékletek lehetőséget az Új e-mail érkezésekor csoportban.

    Képernyőkép az Azure Portal és a logikai alkalmazás munkafolyamatáról, minden ciklushoz, megnyitott dinamikus tartalomlistával és a kiválasztott Mellékletek kimenettel.

    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 ciklusába, hogy átterjedjen.

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

  7. A Használat vagy a Standard munkafolyamat általános lépéseit követve adjon hozzá egy Növekményváltozó nevű műveletet a hurokhoz.

    Feljegyzés

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

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

    Képernyőkép az Azure Portalról és a logikai alkalmazás munkafolyamatról a Count 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:

    Az Azure Portal és a logikai alkalmazás munkafolyamatának képernyőképe egy találatokat küldő művelettel.

  10. Miután végzett, 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 a tervező eszköztárán válassza a Futtatás futtatása> lehetőséget a munkafolyamat manuális futtatásához.

  2. Küldjön egy e-mailt egy vagy több melléklettel 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, 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, valamint a munkafolyamat-definíció növekményes változóművelete , 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" ]
      }
   }
},

Változó értékének csökkentése

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égekkel, hogy ehelyett a Decrement változó műveletet adja hozzá a munkafolyamathoz. Ez a művelet csak egész számmal é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ónév> A decrement változó neve
Érték Nem < érték-csökkentés> A változó dekrementálásának é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 tisztában legyen a változó dekrementálásának konkrét értékével.

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 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 helyette 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.

Az alábbi 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ónév> A módosítandó változó neve
Érték Igen < új érték> A változóhoz hozzárendelni kívánt érték. Mindkét adattípusnak azonosnak kell lennie.

Feljegyzés

Ha nem növeli vagy hanyatlja a változókat, a ciklusokon belüli változók módosítása váratlan eredményeket eredményezhet , mivel a ciklusok 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 cikluson belüli változóértékre, és ugyanazt az értéket szeretné elvárni a cikluspéldány elején és végén, kövesse az alábbi lépéseket a ciklus futtatásának módosításához:

  1. Válassza ki a hurkot az információs panel megtekintéséhez, majd válassza a Beállítások lehetőséget.

  2. Az Általános szakaszban az Egyidejűség vezérlőelem alatt módosítsa a beállítást Ki állásró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 összefűzheti a változó értékét az adott sztringek vagy tömbök utolsó elemeként. A változók növekményének lépéseit a következő kivételekkel hajthatja végre:

  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:

    • Sztringváltozó hozzáfűzése
    • Hozzáfűzés tömbváltozóhoz
  2. Adja meg a hozzáfűzni kívánt é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ő műveletek adatait ismerteti:

Tulajdonság Kötelező Érték Leírás
Név Igen < változónév> A módosítandó változó neve
Érték Igen < hozzáfűzési érték> 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 a 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" ]
      }
   }
},