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

Azure Portal

1. Az Azure Portalon 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	Igen	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 információk és a paraméterértékek nem léteznek egyetlen helyen. A tervezőnek a betöltés előtt meg kell tudnia oldani a paraméterértékeket. 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 további paramétereket 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. Az ugyanabban a munkafolyamatban található eseményindító vagy művelet paraméterére az alábbi lépéseket követve hivatkozhat:

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

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

   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 definiált ö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.

Azure Portal

1. Nyissa meg a logikai alkalmazás erőforrását az Azure Portalon. 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	Igen	A létrehozandó paraméter neve.
   Típus	Igen	A paraméter adattípusa, például Tömb, Bool, Lebegőpontos, Int, Objektum és Sztring. Megjegyzés: A standard logikai alkalmazás munkafolyamataiban a biztonságos adattípusok( például securestring és secureobject) nem támogatottak.
   Érték	Igen	A paraméter értéke. A Standard logikai alkalmazás munkafolyamataiban meg kell adnia a paraméter értékét, mert a munkafolyamat logikája, a kapcsolati adatok és a paraméterértékek nem léteznek egyetlen helyen. A tervezőnek a betöltés előtt meg kell tudnia oldani a paraméterértékeket.

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

   

5. Ha elkészült, 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 ugyanazon 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. A tulajdonságban, ahol a paramétert használni szeretné, kattintson a tulajdonság szerkesztési mezőjébe.

   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-fájlban való megtekintéshez vagy szerkesztéshez válassza a logikai alkalmazás főmenüjében 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. Egy parameters.json nevű projekt gyökérszintű JSON-fájljában adja 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 a projekt más részein hivatkozott vagy használt összes paramétert és értéküket, 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>')" 
           }
       }
    }
   

   Feljegyzés

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

2. Az eseményindító vagy a műveleti bemenet paramétereinek hivatkozásához használja a kifejezést @parameters('<parameter-name>').

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 ConnectionRuntimeUrlegyetlen parameters() kifejezésre, például @parameters('api-runtimeUrl'). A connections.json fájlban az egyetlen érvényes kifejezéstípus és @parameters @appsetting.

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 egyaránt 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 a 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 egy paramétert használhat 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')"
      }
   }
}

Paraméterek fájljainak kezelése

Általában több paraméterfájl-verziót kell kezelnie. Előfordulhat, hogy különböző üzembehelyezési környezetek, például fejlesztés, tesztelés és éles környezetek célzott értékei vannak. Ezeknek a paraméterfájloknak a kezelése gyakran úgy működik, mint az ARM-sablonparaméterek fájljainak kezelése. Egy adott környezetben való üzembe helyezéskor 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>

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

• A DevOps üzembe helyezésének áttekintése egy-bérlős logikai alkalmazásokhoz
• A DevOps üzembe helyezésének beállítása egy-bérlős 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 az ugyanabban a logikai alkalmazásban található összes munkafolyamathoz. 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.

Az 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, az 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 az Azure Portalon való áttekintéséhez kövesse az alábbi lépéseket:

1. Nyissa meg a logikai alkalmazás erőforrását az Azure Portalon.

2. A logikai alkalmazás menü Beállítások területén 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ásait.

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 használatával szeretné áttekinteni az aktuális alkalmazásbeállításokat, futtassa a parancsot. az logicapp config appsettings list Győződjön meg arról, hogy a parancs tartalmazza a --name -n paramétereket, --resource-group -g például:

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

Ha az Azure CLI használatával 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 paramétereket és --resource-group -g a --name n paramétereket. A következő parancs például létrehoz egy beállítást a következő értékkel 12345elnevezett CUSTOM_LOGIC_APP_SETTING kulccsal:

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ás beállításait, keresse meg a logikai alkalmazás erőforrásdefinícióját, és frissítse a appSettings JSON-objektumot. A teljes erőforrásdefinícióért tekintse meg az ARM-sablon hivatkozását.

Ez a példa arm- vagy Bicep-sablonok fájlbeállítását mutatja be:

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