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

Gäller för: Azure Logic Apps (Förbrukning + 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 arbetsflöden och infoga miljöspecifika variabler senare.

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

Mer information om Azure Logic Apps för flera klienter och en klientorganisation finns i Single-tenant versus multitenant in Azure Logic Apps (Enkel klientorganisation jämfört med flera klientorganisationer i 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 logikappen ännu kan du läsa Skapa ett exempel på arbetsflöde för förbrukningslogikapp med hjälp av Azure-portalen eller Skapa ett exempel på ett standardarbetsflöde för logikappar med Hjälp av Azure-portalen.

  Kommentar

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

Parametrar för förbrukning jämfört med standardarbetsflöden för logikappar

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

När du har skapat och använt parametrar i designern definierar och anger du miljövariablerna i din Azure Resource Manager-mall (ARM-mall) och mallparametrar i arbetsflöden för logikappen för flera klienter. 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 standardlogikapparbetsflöden för en 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 en klientbaserade logikappar.

Viktigt!

När du har känslig information, till exempel niska veze som innehåller användarnamn och lösenord, bör du använda det säkraste tillgängliga autentiseringsflödet. I standardarbetsflöden för logikappar stöds till exempel inte säkra datatyper, till exempel securestring och secureobject. Microsoft rekommenderar att du autentiserar åtkomst till Azure-resurser med en hanterad identitet när det är möjligt och tilldelar en roll som har minsta möjliga behörighet.

Om den här funktionen inte är tillgänglig måste du skydda niska veze via andra mått, till exempel Azure Key Vault, som du kan använda med appinställningar. Du kan sedan direkt referera till säkra strängar, till exempel niska veze och nycklar. På samma sätt som 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. Mer information finns i Programtyper för Microsoft platforma za identitete.

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 i logikappprojektet definiera parametrar med hjälp av filen parameters.json . 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 testparametrarfil som innehåller alla värden som du använder under testningen. Vid distributionen kan du ersätta testparametrarfilen med filen med produktionsparametrar.

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

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

Kommentar

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 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 lösningen genom att använda parametrar för att referera till appinställningar.

Definiera, använda och redigera parametrar

Förbrukning

Azure Portal

1. Öppna arbetsflödet för logikappen i Azure-portalen. Under Arbetsflöden väljer du och öppnar arbetsflödet i designern.

2. I designerverktygsfältet väljer du Parametrar.

   

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

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

   Property	Obligatoriskt	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ärde	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.
   Verkligt 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 spara arbetsflödet för att spara den nya parameterdefinitionen.

6. Följ dessa steg för att 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 din tidigare skapade parameter, till exempel:

      

7. Följ dessa steg om du vill visa eller redigera parametrarna i ett logikapparbetsflö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-portalen. Öppna arbetsflödet i designern under Arbetsflöden.

2. I designerverktygsfältet väljer du Parametrar.

   

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

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

   Property	Obligatoriskt	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 standardarbetsflöden för logikappar stöds inte säkra datatyper, till exempel securestring och secureobject.
   Värde	Ja	Värdet för parametern. I standardarbetsflöden för logikappar 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 för att 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 din tidigare skapade parameter, 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.

Visual Studio-koden

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 en deklaration.

   Viktigt!

   Din parameters.json-fil 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>')" 
           }
       }
    }
   

   Kommentar

   I filen parameters.json @appsetting är den enda giltiga uttryckstypen.

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

Parameterisera anslutningsfil

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

Viktigt!

Om du parameteriserar connections.json-filen under utvecklingen blir designerupplevelsen begränsad, både lokalt och i Azure-portalen. Om du behöver använda designern för utveckling använder du en icke-parametriserad connections.json fil i stället. Ersätt sedan med den parametriserade filen i dina distributionspipelines. 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ällningar 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')"
      }
   }
}

Kommentar

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 till 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 logikappsprojekt måste du uppdatera projektfilen (<logic-app-name.csproj>) för att inkludera parameterfilen i byggutdata, till exempel:

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

Kommentar

För närvarande är funktionen för att dynamiskt ersätta parameterfiler ännu inte tillgänglig i Azure-portalen eller arbetsflödesdesignern.

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

• DevOps-distributionsöversikt för logikappar med en klientorganisation
• Konfigurera DevOps-distribution för en klientbaserade logikappar

Hantera appinställningar

I Azure Logic Apps för en 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-portalen, Azure CLI eller ARM-mallen (Bicep).

Azure Portal

Följ dessa steg för att granska appinställningarna för din logikappresurs i Azure-portalen:

1. Öppna logikappresursen i Azure-portalen.

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 läser appinställningarna för logikappen.

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 för att 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. Som 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 appinställningarna i en ARM-mall eller 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 ANTINGEN ARM-mallar eller Bicep-mallar:

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

Relaterat innehåll

• Enskild klientorganisation jämfört med flera klienter i Azure Logic Apps