Skapa parametrar mellan miljöer för arbetsflödesindata i Azure Logic Apps

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

I Azure Logic Apps kan du abstrahera värden som kan ändras i arbetsflöden i utvecklings-, test- och produktionsmiljöer genom att definiera parametrar. När du använder parametrar i stället för miljöspecifika variabler kan du först fokusera mer på att utforma dina arbetsflöden och infoga dina miljöspecifika variabler senare.

Den här artikeln beskriver hur du skapar, använder och redigerar parametrar för logikapparbetsflöden för förbrukning för flera klientorganisationer och för logikapparbetsflöden med standardlogik för en klient. Du får också lära dig hur du hanterar miljövariabler.

Mer information om Azure Logic Apps för flera klientorganisationer och en enskild klientorganisation finns i En klientorganisation jämfört med flera klientorganisationer och integrationstjänstmiljön för Azure Logic Apps.

Förutsättningar

• Ett Azure-konto och prenumeration. Om du inte har någon prenumeration kan du registrera ett kostnadsfritt Azure-konto.

• Ett arbetsflöde för förbruknings- eller standardlogikapp

  Om du inte har ett arbetsflöde för logikappar ännu kan du läsa Skapa ett exempel på arbetsflöde för förbrukningslogikapp med hjälp av Azure Portal eller Skapa ett exempel på ett arbetsflöde för standardlogikapp med hjälp av Azure Portal.

  Anteckning

  För närvarande kan du bara skapa parametrar för arbetsflöden för förbrukningslogikappar med hjälp av Azure Portal. Du kan bara skapa parametrar för standardarbetsflöden för logikappar med hjälp av Azure Portal eller Visual Studio Code.

Parametrar för arbetsflöden för förbrukning kontra standardlogikapp

För både förbruknings- och standardlogikapparbetsflöden kan du definiera parametrar med hjälp av designern. När du har definierat parametern kan du referera till den parametern från alla arbetsflöden eller anslutningar som finns i samma logikappresurs.

När du har skapat och använt parametrar i designern i logikapparbetsflöden för förbrukning för flera klientorganisationer definierar och anger du miljövariablerna i filerna azure Resource Manager-mall (ARM-mall) och mallparametrar. I det här scenariot måste du definiera och ange parametrarna vid distributionen, vilket innebär att även om du bara behöver ändra en variabel måste du distribuera om logikappens ARM-mall.

I logikapparbetsflöden med en enda klientorganisation kan du arbeta med miljövariabler både vid körning och distribution med hjälp av parametrar och appinställningar. Appinställningar innehåller globala konfigurationsalternativ för alla arbetsflöden i samma logikappresurs. Mer information finns i Redigera värd- och appinställningar för logikappar baserade på en klientorganisation.

Anteckning

I arbetsflöden för standardlogikappar stöds inte säkra datatyper som securestring och secureobject. Men som ett alternativt alternativ kan du använda appinställningar med Azure Key Vault. Du kan sedan direkt referera till säkra strängar, till exempel anslutningssträngar och nycklar. På samma sätt som med ARM-mallar, där du kan definiera miljövariabler vid distributionen, kan du definiera appinställningar i logikappens arbetsflödesdefinition. Du kan sedan samla in dynamiskt genererade infrastrukturvärden, till exempel anslutningsslutpunkter, lagringssträngar med mera.

Appinställningar har dock storleksgränser och kan inte refereras från vissa områden i Azure Logic Apps. Parametrar erbjuder ett bredare utbud av användningsfall än appinställningar, till exempel stöd för stora värdestorlekar och komplexa objekt.

Om du till exempel använder Visual Studio Code som ditt lokala utvecklingsverktyg för att köra arbetsflöden lokalt kan du definiera parametrar med hjälp av filen parameters.json i logikappsprojektet. Du kan sedan referera till valfri parameter i den här parameterfilen från valfritt arbetsflöde i projektets workflow.json-fil eller från valfritt anslutningsobjekt i projektets connections.json-fil . I följande lista beskrivs några vanliga användningsfall:

• Ha en testparameterfil som innehåller alla värden som du använder under testningen. Vid distributionen kan du ersätta testparameterfilen med filen med produktionsparametrar.

• Parametrisera olika delar av filen connections.json . Du kan sedan kontrollera filen connections.json i källkontrollen och sedan hantera alla anslutningar via filen parameters.json .

• Parametrisera komplexa objekt, till exempel JSON-objektet authentication . Du kan till exempel ersätta authentication objektvärdet med en sträng som innehåller ett enda parameteruttryck, till exempel @parameters('api-auth').

• Granska och redigera appinställningarna i projektets local.settings.json-fil . Du kan sedan referera till dessa appinställningar i dina parametrar.

Anteckning

Som en allmän rekommendation bör du överväga att använda parametrar som standardsätt för att parametrisera värden, inte appinställningar. På så sätt kan du följa rekommendationen för att referera till appinställningar från dina parametrar när du behöver lagra säkra nycklar eller strängar. Om du vill kan du använda båda alternativen i din lösning genom att använda parametrar för att referera till appinställningar.

Definiera, använda och redigera parametrar

Förbrukning

Azure Portal

1. Öppna logikappens arbetsflöde i Azure Portal. Under Arbetsflöden väljer du och öppnar arbetsflödet i designern.

2. Välj Parametrar i designerverktygsfältet.

   

3. I fönstret Parametrar väljer du Lägg till parameter.

4. Ange följande information om parametern som ska skapas:

   Egenskap	Krävs	Beskrivning
   Namn	Ja	Namnet på parametern som ska skapas.
   Typ	Ja	Datatypen för parametern, till exempel Array, Bool, Float, Int, Object, Secure Object, Secure String och String.
   Standardvärdet	Ja	Standardvärdet för parametern . Du måste ange standardparametervärdet eftersom arbetsflödeslogik, anslutningsinformation och parametervärden inte finns på en enda plats. Designern måste kunna matcha parametervärdena innan den läses in. Viktigt! Undvik att ange ett standardvärde för datatyperna Secure Object och Secure String eftersom värdet lagras som oformaterad text.
   Faktiskt värde	Nej	Det faktiska värdet för parametern .

   I följande exempel visas en definition för en strängparameter:

   

5. Om du har fler parametrar att lägga till väljer du Lägg till parameter. Annars stänger du parameterfönstret, men se till att spara arbetsflödet för att spara den nya parameterdefinitionen.

6. Följ dessa steg om du vill referera till parametern från en utlösare eller åtgärd som finns i samma arbetsflöde:

   1. Öppna önskat arbetsflöde i designern och expandera utlösaren eller åtgärden.

   2. I egenskapen där du vill använda parametern klickar du i den egenskapens redigeringsruta.

   3. I listan med dynamiskt innehåll som öppnas, under Parametrar, väljer du den tidigare skapade parametern, till exempel:

      

7. Följ dessa steg om du vill visa eller redigera parametrarna i ett logikappsarbetsflöde:

   1. Öppna logikappens arbetsflöde i designern. I designerverktygsfältet väljer du Parametrar.

      Fönstret Parametrar öppnas och visar alla parametrar som du har definierat för arbetsflödet.

   2. Gör dina ändringar, stäng parameterfönstret och spara logikappens arbetsflöde.

Standard

Azure Portal

1. Öppna logikappresursen i Azure Portal. Under Arbetsflöden öppnar du arbetsflödet i designern.

2. Välj Parametrar i designerverktygsfältet.

   

3. I fönstret Parametrar väljer du Skapa parameter.

4. Ange följande information om parametern som ska skapas:

   Egenskap	Krävs	Beskrivning
   Namn	Ja	Namnet på parametern som ska skapas.
   Typ	Ja	Datatypen för parametern, till exempel Array, Bool, Float, Int, Object och String. Obs! I arbetsflöden för standardlogikappar stöds inte säkra datatyper som securestring och secureobject.
   Värde	Ja	Värdet för parametern . I arbetsflöden för standardlogikappar måste du ange parametervärdet eftersom arbetsflödeslogik, anslutningsinformation och parametervärden inte finns på en enda plats. Designern måste kunna matcha parametervärdena innan den läses in.

   I följande exempel visas en definition för en strängparameter:

   

5. När du är klar stänger du fönstret Parametrar , men se till att spara arbetsflödet för att spara den nya parameterdefinitionen.

6. Följ dessa steg om du vill referera till parametern från en utlösare eller åtgärd som finns i ett arbetsflöde i samma logikapp:

   1. Öppna önskat arbetsflöde i designern och expandera utlösaren eller åtgärden.

   2. I egenskapen där du vill använda parametern klickar du i den egenskapens redigeringsruta.

   3. I listan med dynamiskt innehåll som öppnas, under Parametrar, väljer du den tidigare skapade parametern, till exempel:

      

7. Om du vill visa eller redigera parametrar i samma logikapp följer du något av stegen:

   • Öppna alla arbetsflöden i logikappen. På arbetsflödesmenyn väljer du Designer. I designerverktygsfältet väljer du Parametrar.

     Fönstret Parametrar öppnas och visar alla parametrar som du har definierat från arbetsflöden i logikappen.

   • Om du vill visa eller redigera i mass-JSON går du till logikappens huvudmeny och väljer Parametrar.

     JSON-vyn Parametrar öppnas och visar alla parametrar som du har definierat från arbetsflöden i logikappen.

Visuell Studio-kod

1. I en JSON-fil på projektrotnivå med namnet parameters.json definierar du alla parametrar och deras värden. Den här filen har ett -objekt som innehåller nyckel/värde-par . Varje nyckel är namnet på varje parameter, medan varje värde är strukturen för varje parameter. Varje struktur måste innehålla både en type - och value -deklaration.

   Viktigt

   Filen parameters.json måste definiera och inkludera alla parametrar och deras värden som du refererar till eller använder någon annanstans i projektet, till exempel i arbetsflödesdefinitioner eller anslutningar.

   I följande exempel visas en grundläggande parameterfil:

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

   Anteckning

   I filen @appsettingparameters.json är den enda giltiga uttryckstypen.

2. Om du vill referera till parametrar i utlösaren eller åtgärdsindata använder du uttrycket @parameters('<parameter-name>').

Parameterisera anslutningsfil

Om du vill parametrisera filen connections.json ersätter du värdena för literaler, till exempel ConnectionRuntimeUrl, med ett enda parameters() uttryck, till exempel @parameters('api-runtimeUrl'). I filen connections.json är @parameters de enda giltiga uttryckstyperna och @appsetting.

Viktigt

Om du parameteriserar filen connections.json under utvecklingen blir designerupplevelsen begränsad, både lokalt och i Azure Portal. Om du behöver använda designern för utveckling använder du en icke-parametriserad connections.json-fil i stället. I dina distributionspipelines ersätter du sedan med den parametriserade filen. Körningen fungerar fortfarande med parameterisering. Designerförbättringar är under utveckling.

I följande exempel visas en parametriserad connections.json-fil som använder både appinställningar och parametrar. Även om du vill använda parametrar där det är möjligt är det här scenariot ett undantags- eller gränsfall där du använder appinställningar över parametrar eftersom appinställningarna genereras under distributionen och är enklare att dynamiskt fylla i i en utvecklingspipeline. Den här exempelfilen använder en parameter för det komplexa blob_auth autentiseringsobjektet och appinställningarna för de andra värdena. I det här fallet kan du använda en parameter för autentiseringsobjektet eftersom det är osannolikt att du refererar till parametern i arbetsflödet:

{
   "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')"
      }
   }
}

Anteckning

När du har ett uttryck som är infogat med oformaterad text ska du använda det interpolerade formatet för uttrycket genom att omsluta uttrycket med klammerparenteser ({}). Det här formatet hjälper dig att undvika parsningsproblem.

Om du till exempel har "<text>/@<function-name>('<parameter-name>')/<text>"använder du följande version i stället: "<text>/@{<function-name>('<parameter-name>')}/<text>".

Mer information finns i Överväganden för att använda funktioner.

Hantera parameterfiler

Normalt behöver du hantera flera versioner av parameterfiler. Du kan ha målvärden för olika distributionsmiljöer, till exempel utveckling, testning och produktion. Att hantera dessa parameterfiler fungerar ofta som att hantera ARM-mallparametrar. När du distribuerar till en specifik miljö höjer du upp motsvarande parameterfil, vanligtvis via en pipeline för DevOps.

Kör följande kommando för att dynamiskt ersätta parameterfiler med hjälp av Azure CLI:

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

Om du har ett NuGet-baserat logikappprojekt måste du uppdatera projektfilen (<logic-app-name.csproj>) så att den inkluderar parameterfilen i byggutdata, till exempel:

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

Anteckning

För närvarande är möjligheten att dynamiskt ersätta parameterfiler ännu inte tillgänglig i Azure Portal eller arbetsflödesdesignern.

Mer information om hur du konfigurerar logikappar för DevOps-distributioner finns i följande dokumentation:

• DevOps-distributionsöversikt för logikappar baserade på en klientorganisation
• Konfigurera DevOps-distribution för logikappar baserade på en klientorganisation

Hantera appinställningar

I Azure Logic Apps för en enda klientorganisation innehåller appinställningarna globala konfigurationsalternativ för alla arbetsflöden i samma logikapp. När du kör arbetsflöden lokalt i Visual Studio Code kan du komma åt dessa appinställningar som lokala miljövariabler i filen local.settings.json . Du kan sedan referera till dessa appinställningar i dina parametrar.

Om du vill lägga till, uppdatera eller ta bort appinställningar väljer du och granskar följande avsnitt för Visual Studio Code-, Azure Portal-, Azure CLI- eller ARM-mall (Bicep).

Azure Portal

Så här granskar du appinställningarna för logikappresursen i Azure Portal:

1. Öppna logikappresursen i Azure Portal.

2. På logikappmenyn går du till Inställningar och väljer Konfiguration.

3. På sidan Konfiguration går du till fliken Programinställningar och granskar appinställningarna för din logikapp.

4. Om du vill visa alla värden väljer du Visa värden. Om du vill visa ett enda värde väljer du det värdet.

Följ dessa steg om du vill lägga till en ny inställning:

1. På fliken Programinställningar går du till Programinställningar och väljer Ny programinställning.

2. I Namn anger du nyckeln eller namnet för den nya inställningen.

3. För Värde anger du värdet för den nya inställningen.

4. När du är redo att skapa det nya nyckel/värde-paret väljer du OK.

   

5. När du är klar väljer du Spara i verktygsfältet Konfiguration.

Azure CLI

Om du vill granska dina aktuella appinställningar med hjälp av Azure CLI kör du kommandot , az logicapp config appsettings list. Kontrollera att kommandot innehåller parametrarna --name -n och --resource-group -g , till exempel:

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

Om du vill lägga till eller uppdatera en appinställning med hjälp av Azure CLI kör du kommandot az logicapp config appsettings set. Kontrollera att kommandot innehåller parametrarna --name n och --resource-group -g . Följande kommando skapar till exempel en inställning med en nyckel med namnet CUSTOM_LOGIC_APP_SETTING med värdet 12345:

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

Resource Manager- eller Bicep-mall

Om du vill granska och definiera dina appinställningar i en ARM-mall eller en Bicep-mall letar du upp logikappens resursdefinition och uppdaterar appSettings JSON-objektet. Den fullständiga resursdefinitionen finns i ARM-mallreferensen.

I det här exemplet visas filinställningar för ARM-mallar eller Bicep-mallar:

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

Nästa steg

• Tjänstmiljö för enskild klientorganisation jämfört med flera klientorganisationer och integreringstjänst för Azure Logic Apps