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

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.

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.

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

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>

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"
    },
    <...>
],