Környezetközi paraméterek létrehozása munkafolyamat-bemenetekhez az Azure Logic Appsben

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

Az Azure Logic Appsben a paraméterek definiálásával absztraktálhatja azokat az értékeket, amelyek a fejlesztési, tesztelési és éles környezetek munkafolyamataiban változhatnak. Ha a környezetspecifikus változók helyett paramétereket használ, kezdetben jobban összpontosíthat a munkafolyamatok tervezésére, és később beszúrhatja a környezetspecifikus változókat.

Ez a cikk bemutatja, hogyan hozhat létre, használhat és szerkeszthet paramétereket a több-bérlős Használat logikai alkalmazás munkafolyamataihoz és az egybérlős Standard logikai alkalmazás munkafolyamataihoz. Azt is megtudhatja, hogyan kezelheti a környezeti változókat.

A több-bérlős és az egybérlős Azure Logic Appsszel kapcsolatos további információkért tekintse át az Egy-bérlő és a több-bérlős és integrációs szolgáltatási környezet az Azure Logic Appshez című témakört.

Előfeltételek

• Azure-fiók és -előfizetés. Ha még nincs előfizetése, regisztráljon egy ingyenes Azure-fiókra.

• Használat vagy standard logikai alkalmazás munkafolyamata

  Ha még nem rendelkezik logikaialkalmazás-munkafolyamattal, olvassa el a Példa Használati logikai alkalmazás munkafolyamat létrehozása a Azure Portal vagy Példa standard logikai alkalmazás munkafolyamatának létrehozása a Azure Portal használatával című témakört.

  Megjegyzés

  Jelenleg csak a Azure Portal használatával hozhat létre paramétereket a Használat logikai alkalmazás munkafolyamataihoz. A standard logikai alkalmazás munkafolyamataihoz csak a Azure Portal vagy a Visual Studio Code használatával hozhat létre paramétereket.

A használat és a standard logikai alkalmazás munkafolyamatainak paraméterei

A Használat és a Standard logikai alkalmazás munkafolyamataihoz a tervezővel is definiálhat paramétereket. A paraméter definiálása után hivatkozhat erre a paraméterre bármely munkafolyamatból vagy kapcsolatból, amely ugyanabban a logikaialkalmazás-erőforrásban található.

A több-bérlős Használat logikai alkalmazás munkafolyamataiban, miután paramétereket hoz létre és használ a tervezőben, definiálja és beállítja a környezeti változókat az Azure Resource Manager-sablonban (ARM-sablon) és a sablonparaméter-fájlokban. Ebben a forgatókönyvben meg kell határoznia és be kell állítania a paramétereket az üzembe helyezéskor, ami azt jelenti, hogy még ha csak egy változót is módosítania kell, újra üzembe kell helyeznie a logikai alkalmazás ARM-sablonját.

Az egybérlős Standard logikai alkalmazás munkafolyamataiban a környezeti változókkal futtatáskor és üzembe helyezéskor is dolgozhat paraméterek és alkalmazásbeállítások használatával. Az alkalmazásbeállítások globális konfigurációs beállításokat tartalmaznak az ugyanabban a logikaialkalmazás-erőforrásban található összes munkafolyamathoz . További információ: Gazdagép- és alkalmazásbeállítások szerkesztése egybérlős alapú logikai alkalmazásokhoz.

Megjegyzés

A Standard logikaialkalmazás-munkafolyamatokban a biztonságos adattípusok, például securestring a és secureobjecta nem támogatottak. Alternatív lehetőségként azonban használhatja az alkalmazásbeállításokat az Azure Key Vault. Ezután közvetlenül hivatkozhat biztonságos sztringekre, például kapcsolati sztringekre és kulcsokra. Az ARM-sablonokhoz hasonlóan, ahol az üzembe helyezéskor környezeti változókat definiálhat, az alkalmazásbeállításokat a logikai alkalmazás munkafolyamat-definíciójában határozhatja meg. Ezután rögzítheti a dinamikusan létrehozott infrastruktúra-értékeket, például a kapcsolati végpontokat, a tárolási sztringeket stb.

Az alkalmazásbeállítások azonban méretkorlátokkal rendelkeznek, és nem hivatkozhatók az Azure Logic Apps bizonyos területeiről. A paraméterek az alkalmazásbeállításoknál szélesebb körű használati eseteket kínálnak, például nagy értékméretek és összetett objektumok támogatását.

Ha például a Visual Studio Code-ot használja helyi fejlesztési eszközként a munkafolyamatok helyi futtatásához, a logikai alkalmazás projektjében a parameters.json fájl használatával definiálhat paramétereket. Ezután hivatkozhat a paraméterfájl bármely paraméterére a projekt workflow.json fájljának munkafolyamatából vagy a projekt connections.json fájljának bármely kapcsolatobjektumából. Az alábbi lista néhány gyakori használati esetet ismertet:

• Rendelkezik egy tesztparaméter-fájllal, amely tartalmazza a tesztelés során használt összes értéket. Az üzembe helyezéskor lecserélheti a tesztparaméter-fájlt az éles paraméterfájlra.

• A connections.json fájl különböző részeinek paraméterezése. Ezután ellenőrizheti a connections.json fájlt a forrásvezérlőben, majd kezelheti a kapcsolatokat a parameters.json fájlon keresztül.

• Az összetett objektumok, például a JSON-objektum paraméterezése authentication . Lecserélheti például az authentication objektumértéket egy sztringre, amely egyetlen paraméterkifejezést tartalmaz, például @parameters('api-auth'): .

• Tekintse át és szerkessze az alkalmazásbeállításokat a projekt local.settings.json fájljában. Ezután hivatkozhat ezekre az alkalmazásbeállításokra a paraméterekben.

Megjegyzés

Általános javaslatként érdemes lehet paramétereket használni az értékek paraméterezésének alapértelmezett módjaként, nem pedig az alkalmazásbeállításokat. Így, ha biztonságos kulcsokat vagy sztringeket kell tárolnia, kövesse az ajánlást, hogy hivatkozzon az alkalmazásbeállításokra a paraméterekből. Ha szeretné, mindkét lehetőséget használhatja a megoldásban paraméterek használatával az alkalmazásbeállításokra való hivatkozáshoz.

Paraméterek definiálása, használata és szerkesztése

Használat

Azure Portal

1. A Azure Portal nyissa meg a logikai alkalmazás munkafolyamatát. A Munkafolyamatok területen válassza ki és nyissa meg a munkafolyamatot a tervezőben.

2. A tervező eszköztárán válassza a Paraméterek lehetőséget.

   

3. A Paraméterek panelen válassza a Paraméter hozzáadása lehetőséget.

4. Adja meg a következő információkat a létrehozandó paraméterről:

   Tulajdonság	Kötelező	Leírás
   Név	Yes	A létrehozandó paraméter neve.
   Típus	Igen	A paraméter adattípusa, például Tömb, Bool, Lebegőpontos, Int, Objektum, Biztonságos objektum, Biztonságos sztring és Sztring.
   Alapértelmezett érték	Igen	A paraméter alapértelmezett értéke. Meg kell adnia az alapértelmezett paraméterértéket, mert a munkafolyamat logikája, a kapcsolati adatok és a paraméterértékek nem léteznek egyetlen helyen. A tervezőnek meg kell tudnia oldani a paraméterértékeket a betöltés előtt. Fontos: A Biztonságos objektum és a Biztonságos sztring adattípusok esetében kerülje az alapértelmezett érték beállítását, mert az érték egyszerű szövegként van tárolva.
   Tényleges érték	Nem	A paraméter tényleges értéke.

   Az alábbi példa egy sztringparaméter definícióját mutatja be:

   

5. Ha több paramétert szeretne hozzáadni, válassza a Paraméter hozzáadása lehetőséget. Ellenkező esetben zárja be a paraméterek panelt, de mentse a munkafolyamatot az új paraméterdefiníció mentéséhez.

6. Ha egy ugyanazon munkafolyamatban található eseményindítóból vagy műveletből szeretne hivatkozni a paraméterre, kövesse az alábbi lépéseket:

   1. A tervezőben nyissa meg a kívánt munkafolyamatot, és bontsa ki az eseményindítót vagy a műveletet.

   2. Kattintson a tulajdonság szerkesztési mezőjébe abban a tulajdonságban, ahol a paramétert használni szeretné.

   3. A megnyíló dinamikus tartalomlistában a Paraméterek területen válassza ki a korábban létrehozott paramétert, például:

      

7. A logikaialkalmazás-munkafolyamat paramétereinek megtekintéséhez vagy szerkesztéséhez kövesse az alábbi lépéseket:

   1. Nyissa meg a logikai alkalmazás munkafolyamatát a tervezőben. A tervező eszköztárán válassza a Paraméterek lehetőséget.

      Megnyílik a Paraméterek panel, és megjeleníti az adott munkafolyamathoz megadott összes paramétert.

   2. Végezze el a módosításokat, zárja be a paraméterek panelt, és mentse a logikai alkalmazás munkafolyamatát.

Standard

Azure Portal

1. A Azure Portal nyissa meg a logikai alkalmazás erőforrását. A Munkafolyamatok területen nyissa meg a munkafolyamatot a tervezőben.

2. A tervező eszköztárán válassza a Paraméterek lehetőséget.

   

3. A Paraméterek panelen válassza a Paraméter létrehozása lehetőséget.

4. Adja meg a következő információkat a létrehozandó paraméterről:

   Tulajdonság	Kötelező	Leírás
   Név	Yes	A létrehozandó paraméter neve.
   Típus	Yes	A paraméter adattípusa, például Tömb, Bool, Float, Int, Object és String. Megjegyzés: A Standard logikai alkalmazás munkafolyamataiban a biztonságos adattípusok( például securestring és secureobject) nem támogatottak.
   Érték	Yes	A paraméter értéke. A Standard logikai alkalmazás munkafolyamataiban meg kell adnia a paraméterértéket, mert a munkafolyamat logikája, a kapcsolati adatok és a paraméterértékek nem léteznek egyetlen helyen. A tervezőnek meg kell tudnia oldani a paraméterértékeket a betöltés előtt.

   Az alábbi példa egy sztringparaméter definícióját mutatja be:

   

5. Ha végzett, zárja be a Paraméterek panelt, de mentse a munkafolyamatot az új paraméterdefiníció mentéséhez.

6. Ha egy olyan eseményindítóból vagy műveletből szeretne hivatkozni a paraméterre, amely ugyanabban a logikai alkalmazásban található bármely munkafolyamatban található, kövesse az alábbi lépéseket:

   1. A tervezőben nyissa meg a kívánt munkafolyamatot, és bontsa ki az eseményindítót vagy a műveletet.

   2. Kattintson a tulajdonság szerkesztési mezőjébe abban a tulajdonságban, ahol a paramétert használni szeretné.

   3. A megnyíló dinamikus tartalomlistában a Paraméterek területen válassza ki a korábban létrehozott paramétert, például:

      

7. Ha ugyanabban a logikai alkalmazásban szeretné megtekinteni vagy szerkeszteni a paramétereket, kövesse az alábbi lépéseket:

   • Nyisson meg egy munkafolyamatot a logikai alkalmazásban. A munkafolyamat menüben válassza a Tervező lehetőséget. A tervező eszköztárán válassza a Paraméterek lehetőséget.

     Megnyílik a Paraméterek panel, és megjeleníti az adott logikai alkalmazás munkafolyamataiból definiált összes paramétert.

   • Tömeges JSON-ben való megtekintéshez vagy szerkesztéshez a logikai alkalmazás főmenüjében válassza a Paraméterek lehetőséget.

     Megnyílik a Parameters JSON nézet, és megjeleníti az adott logikai alkalmazás munkafolyamataiból definiált összes paramétert.

Visual Studio Code

1. A parameters.json nevű projekt gyökérszintű JSON-fájljában határozza meg az összes paramétert és azok értékeit. Ez a fájl tartalmaz egy objektumot, amely kulcs-érték párokat tartalmaz. Minden kulcs az egyes paraméterek neve, míg minden érték az egyes paraméterek struktúrája. Minden struktúrának tartalmaznia kell egy és value egy deklarációt type is.

   Fontos

   A parameters.json fájlnak meg kell határoznia és tartalmaznia kell az összes olyan paramétert és azok értékeit, amelyekre hivatkozik, vagy amelyeket a projekt más részén használ, például munkafolyamat-definíciókban vagy kapcsolatokban.

   Az alábbi példa egy alapszintű paraméterfájlt mutat be:

   {
       "responseString": { 
           "type": "string", 
           "value": "hello" 
       },
       "functionAuth": { 
           "type": "object", 
           "value": { 
               "type": "QueryString", 
               "name": "Code", 
               "value": "@appsetting('<AzureFunctionsOperation-FunctionAppKey>')" 
           }
       }
    }
   

   Megjegyzés

   A parameters.json fájlban @appsetting az egyetlen érvényes kifejezéstípus.

2. Az eseményindító vagy a művelet bemenetének paramétereire a kifejezéssel @parameters('<parameter-name>')hivatkozhat.

Kapcsolatok fájl paraméterezése

A connections.json fájl paraméterezéséhez cserélje le a literálértékeket, például ConnectionRuntimeUrla értéket egyetlen parameters() kifejezésre, például @parameters('api-runtimeUrl'): . A connections.json fájlban az egyetlen érvényes kifejezéstípus a és @appsettinga@parameters.

Fontos

Ha a fejlesztés során paraméterezi a connections.json fájlt, a tervezői élmény helyileg és a Azure Portal is korlátozott lesz. Ha a tervezőt kell használnia a fejlesztéshez, használjon inkább egy nem paraméterezett connections.json fájlt. Ezután az üzembehelyezési folyamatokban cserélje le a elemet a paraméterezett fájlra. A futtatókörnyezet továbbra is működik a paraméterezéssel. A tervező fejlesztései folyamatban vannak.

Az alábbi példa egy paraméteres connections.json fájlt mutat be, amely az alkalmazásbeállításokat és a paramétereket is használja. Bár lehetőség szerint paramétereket szeretne használni, ez a forgatókönyv kivétel vagy peremhálózati eset, ahol az alkalmazásbeállításokat paraméterek fölé szeretné használni, mivel az alkalmazásbeállítások az üzembe helyezés során jönnek létre, és könnyebben tölthetők fel dinamikusan egy fejlesztési folyamatban. Ez a mintafájl egy paramétert használ a többi érték összetett blob_auth hitelesítési objektumához és alkalmazásbeállításaihoz. Ebben az esetben használhat paramétert a hitelesítési objektumhoz, mivel nem valószínű, hogy hivatkozni fog a paraméterre a munkafolyamatban:

{
   "serviceProviderConnections": {
      "serviceBus": {
         "parameterValues": {
            "connectionString": "@appsetting('serviceBus_connectionString')"
        },
        "serviceProvider": {
           "id": "/serviceProviders/serviceBus"
        },
        "displayName": "servicebus"
     }
   },
   "managedApiConnections": {
      "azureblob": {
         "api": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/providers/Microsoft.Web/locations/@{appsetting('WORKFLOWS_LOCATION_NAME')}/managedApis/azureblob"
         },
         "connection": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/resourceGroups/@{appsetting('WORKFLOWS_RESOURCE_GROUP_NAME')}/providers/Microsoft.Web/connections/azureblob"
         },
         "connectionRuntimeUrl": "@appsetting('BLOB_CONNECTION_RUNTIMEURL')",
         "authentication": "@parameters('blob_auth')"
      }
   }
}

Megjegyzés

Ha egy egyszerű szöveggel beágyazott kifejezéssel rendelkezik, ügyeljen arra, hogy a kifejezés interpolált formátumát használja úgy, hogy a kifejezést kapcsos zárójelekkel ({}) csatolja. Ez a formátum segít elkerülni az elemzési problémákat.

Ha például rendelkezik "<text>/@<function-name>('<parameter-name>')/<text>"a következő verzióval, használja a következő verziót: "<text>/@{<function-name>('<parameter-name>')}/<text>".

További információkért tekintse át a függvények használatának szempontjait ismertető cikket.

Paraméterfájlok kezelése

Általában a paraméterfájlok több verzióját kell kezelnie. Előfordulhat, hogy különböző üzembehelyezési környezetekhez, például fejlesztéshez, teszteléshez és éles környezethez célzott értékekkel rendelkezik. Ezeknek a paraméterfájloknak a kezelése gyakran úgy működik, mint az ARM-sablonparaméterek fájljainak kezelése. Amikor egy adott környezetben helyezi üzembe az üzembe helyezést, előlépteti a megfelelő paraméterfájlt, általában egy DevOps-folyamaton keresztül.

Ha dinamikusan szeretné lecserélni a paraméterfájlokat az Azure CLI használatával, futtassa a következő parancsot:

az functionapp deploy --resource-group MyResourceGroup --name MyLogicApp --src-path C:\parameters.json --type static --target-path parameters.json

Ha NuGet-alapú logikai alkalmazásprojekttel rendelkezik, frissítenie kell a projektfájlt (<logic-app-name.csproj>), hogy a paraméterfájl szerepeljen a build kimenetében, például:

<ItemGroup>
  <None Update="parameters.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

Megjegyzés

Jelenleg a paraméterfájlok dinamikus cseréjének képessége még nem érhető el a Azure Portal vagy a munkafolyamat-tervezőben.

A logikai alkalmazások DevOps-környezetekhez való beállításával kapcsolatos további információkért tekintse át az alábbi dokumentációt:

• A DevOps üzembe helyezésének áttekintése egybérlős alapú logikai alkalmazásokhoz
• DevOps-környezet beállítása egybérlős alapú logikai alkalmazásokhoz

Alkalmazásbeállítások kezelése

Az egybérlős Azure Logic Appsben az alkalmazásbeállítások globális konfigurációs beállításokat tartalmaznak ugyanazon logikai alkalmazás összes munkafolyamatához . Amikor helyileg futtat munkafolyamatokat a Visual Studio Code-ban, ezeket az alkalmazásbeállításokat helyi környezeti változókként érheti el a local.settings.json fájlban. Ezután hivatkozhat ezekre az alkalmazásbeállításokra a paraméterekben.

Alkalmazásbeállítások hozzáadásához, frissítéséhez vagy törléséhez válassza ki és tekintse át a Visual Studio Code, a Azure Portal, az Azure CLI vagy az ARM (Bicep) sablon alábbi szakaszait.

Azure Portal

A logikaialkalmazás-erőforrás alkalmazásbeállításainak áttekintéséhez kövesse az alábbi lépéseket a Azure Portal:

1. A Azure Portal nyissa meg a logikai alkalmazás erőforrását.

2. A logikai alkalmazás menüjében, a Beállítások területen válassza a Konfiguráció lehetőséget.

3. A Konfiguráció lap Alkalmazásbeállítások lapján tekintse át a logikai alkalmazás alkalmazásbeállításainak áttekintését.

4. Az összes érték megtekintéséhez válassza az Értékek megjelenítése lehetőséget. Vagy egyetlen érték megtekintéséhez jelölje ki ezt az értéket.

Új beállítás hozzáadásához kövesse az alábbi lépéseket:

1. Az Alkalmazásbeállítások lap Alkalmazásbeállítások területén válassza az Új alkalmazásbeállítás lehetőséget.

2. A Név mezőbe írja be az új beállítás kulcsát vagy nevét.

3. Az Érték mezőben adja meg az új beállítás értékét.

4. Ha készen áll az új kulcs-érték pár létrehozására, válassza az OK gombot.

   

5. Ha elkészült, a Konfiguráció eszköztáron válassza a Mentés lehetőséget.

Azure CLI

Ha az Azure CLI-vel szeretné áttekinteni az aktuális alkalmazásbeállításokat, futtassa a következő parancsot: az logicapp config appsettings list. Győződjön meg arról, hogy a parancs tartalmazza a és --resource-group -g a --name -n paramétereket, például:

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

Ha az Azure CLI-vel szeretne hozzáadni vagy frissíteni egy alkalmazásbeállítást, futtassa a parancsot az logicapp config appsettings set. Győződjön meg arról, hogy a parancs tartalmazza a és --resource-group -g a --name n paramétereket. A következő parancs például létrehoz egy beállítást egy nevű CUSTOM_LOGIC_APP_SETTING kulccsal, amelynek értéke 12345:

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

Resource Manager vagy Bicep-sablon

Ha ARM-sablonban vagy Bicep-sablonban szeretné áttekinteni és definiálni az alkalmazásbeállításokat, keresse meg a logikai alkalmazás erőforrás-definícióját, és frissítse a appSettings JSON-objektumot. A teljes erőforrás-definícióért tekintse meg az ARM-sablon referenciáját.

Ebben a példában arm- vagy Bicep-sablonok fájlbeállításai láthatók:

"appSettings": [
    {
        "name": "string",
        "value": "string"
    },
    {
        "name": "string",
        "value": "string"
    },
    <...>
], 

Következő lépések

• Egybérlős és több-bérlős és integrációs szolgáltatási környezet az Azure Logic Appshez