Parameters voor meerdere omgevingen maken voor werkstroominvoer in Azure Logic Apps

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Wanneer u waarden wilt abstraheren die kunnen veranderen in werkstromen in ontwikkel-, test- en productieomgevingen, kunt u werkstroomparameters definiëren. Wanneer u deze parameters gebruikt in plaats van omgevingsspecifieke variabelen, kunt u zich meer richten op het ontwerpen van uw werkstroomlogica en later uw omgevingsspecifieke variabelen invoegen.

In dit artikel wordt beschreven hoe u parameters kunt maken, gebruiken en bewerken voor workflows voor multitenant Consumption logic apps en voor single-tenant Standard logic apps. U leert ook hoe u omgevingsvariabelen beheert.

Voor meer informatie over multitenant en single-tenant Azure Logic Apps, zie Single-tenant versus multitenant in Azure Logic Apps.

Vereisten

• Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meld u dan aan voor een gratis Azure-account.

• Een werkstroom voor een logische app verbruik of een standaard-app

  Als u nog geen werkstroom voor logische apps hebt, raadpleegt u Een werkstroom voor logische apps voor verbruikmaken of een standaardwerkstroom voor logische apps maken.

  Notitie

  Op dit moment kunt u alleen parameters maken voor werkstromen van logische apps voor verbruik met behulp van Azure Portal. U kunt parameters maken voor werkstromen voor logische standaard-apps met behulp van Azure Portal of Visual Studio Code.

Parameters voor verbruik versus standaardwerkstromen voor logische apps

Voor werkstromen van zowel Verbruik als Standaard logische apps kunt u parameters definiëren met behulp van de werkstroomontwerper. Nadat u een parameter hebt gedefinieerd, kunt u naar die parameter verwijzen vanuit elke werkstroom of verbinding in dezelfde logische app-resource.

In werkstromen voor logische apps voor multitenantverbruik maakt en gebruikt u parameters in de ontwerpfunctie. Vervolgens definieert en stelt u de omgevingsvariabelen in uw ARM-sjabloon (Azure Resource Manager) en sjabloonparametersbestanden in. In dit scenario moet u de parameters bij de implementatie definiëren en instellen. Deze vereiste betekent dat, zelfs als u slechts één variabele moet wijzigen, u de ARM-sjabloon van uw logische app opnieuw moet implementeren.

In werkstromen voor logische apps met één tenant kunt u zowel tijdens runtime als implementatie met omgevingsvariabelen werken met behulp van parameters en app-instellingen. App-instellingen bevatten globale configuratieopties voor alle werkstromen in dezelfde logische app-resource. Zie Host- en app-instellingen voor logische apps met één tenant bewerken voor meer informatie.

App-instellingen hebben groottelimieten. U kunt er ook niet naar verwijzen vanuit bepaalde gebieden in Azure Logic Apps. Parameters bieden een breder scala aan use cases dan app-instellingen, zoals ondersteuning voor grote waardegrootten en complexe objecten.

Als u Visual Studio Code bijvoorbeeld gebruikt als uw ontwikkelhulpprogramma om werkstromen lokaal uit te voeren, kunt u parameters definiëren met behulp van het parameters.json-bestand . U kunt vervolgens verwijzen naar een parameter in dit parameterbestand vanuit elke werkstroom in het workflow.json-bestand van uw project of vanuit een verbindingsobject in het connections.json-bestand van uw project. In de volgende lijst worden veelvoorkomende use cases beschreven:

• Een testparametersbestand hebben dat alle waarden bevat die u tijdens het testen gebruikt. Vervang tijdens de implementatie het testparametersbestand door het productieparametersbestand.

• Verschillende onderdelen van uw connections.json-bestand parameteriseren. Vervolgens kunt u uw connections.json bestand controleren in broncodebeheer en verbindingen beheren via uw parameters.json-bestand .

• Complexe objecten, zoals het authentication JSON-object, parameteriseren. U kunt bijvoorbeeld de authentication objectwaarde vervangen door een tekenreeks die één parameterexpressie bevat, zoals @parameters('api-auth').

• Controleer en bewerk de app-instellingen in het local.settings.json-bestand van uw project. Verwijs vervolgens naar deze app-instellingen in uw parameters.

Parameters definiëren, gebruiken en bewerken

In deze procedure wordt beschreven hoe u werkt met parameters voor werkstromen voor logische apps voor Verbruik of Standard in Azure Portal.

1. Open uw logische app-resource in Azure Portal.

   • Voor Standaard logische apps selecteert u werkstromen in het zijbalkmenu van de resource onder Werkstromen.

     Selecteer op de pagina Werkstromen de lege werkstroom om de ontwerpfunctie te openen.

   • Voor verbruikslogica-apps selecteert u in het zijbalkmenu van de resource onder Ontwikkelhulpprogramma's de ontwerper om de werkstroom te openen.

2. Selecteer Parameters op de werkbalk van de ontwerpfunctie.

   

3. Selecteer in het deelvenster Parameters de optie Parameter Maken.

4. Geef de volgende informatie op over de parameter die u wilt maken:

   Eigenschappen	Vereist	Beschrijving
   Naam	Ja	De naam voor de parameter die moet worden gemaakt.
   Typ	Ja	Het gegevenstype voor de parameter, zoals Matrix, Bool, Float, Int, Object en String. Opmerking: In standaardwerkstromen voor logische apps worden beveiligde gegevenstypen, zoals securestring en secureobject, niet ondersteund.
   Waarde (standaard)	Ja	De waarde voor de parameter. Geef in de standaard logische app-werkstromen de parameterwaarde op. De werkstroomlogica, verbindingsinformatie en parameterwaarden bestaan niet op één locatie. De ontwerper moet de parameterwaarden kunnen vaststellen voordat de werkstroom wordt geladen.
   Standaardwaarde (verbruik)	Ja	De standaardwaarde voor de parameter. U moet de standaardparameterwaarde opgeven. De werkstroomlogica, verbindingsinformatie en parameterwaarden bestaan niet op één locatie. De ontwerper moet de parameterwaarden kunnen vaststellen voordat de werkstroom wordt geladen. Belangrijk: Voor de gegevenstypen Beveiligd object en Beveiligde tekenreeks moet u voorkomen dat u een standaardwaarde instelt omdat de waarde wordt opgeslagen als tekst zonder opmaak.
   Werkelijke waarde (verbruik)	Nee	De werkelijke waarde voor de parameter.

   In het volgende voorbeeld ziet u een definitie voor een tekenreeksparameter:

   

5. Wanneer u klaar bent, sluit u het deelvenster Parameters . Zorg ervoor dat u uw werkstroom opslaat, zodat u de nieuwe parameterdefinitie opslaat.

Als u wilt verwijzen naar de parameter vanuit een trigger of actie in een werkstroom voor dezelfde logische app, voert u de volgende stappen uit:

1. Open in de ontwerpfunctie de gewenste werkstroom en selecteer de trigger of actie.

2. Selecteer in het informatievenster, op het tabblad Parameters, binnen het invoerveld van de eigenschap waarin u de parameter wilt gebruiken. Selecteer het bliksempictogram om de lijst met dynamische inhoud te openen.

3. Selecteer in die lijst onder Parameters de eerder gemaakte parameter.

   

Parameters weergeven of bewerken in dezelfde logische app:

1. Open een werkstroom in de werkstroomontwerper. Logic apps voor Fon Consumption, selecteer Ontwikkelhulpmiddelen>Designer voor logische apps. Voor standaard logische apps selecteert u Werkstromen>Werkstromen en selecteert u vervolgens een werkstroom om de designer te openen.

2. Selecteer Parameters op de werkbalk van de ontwerpfunctie.

   Het deelvenster Parameters wordt geopend en geeft alle parameters weer die u in die logische app hebt gedefinieerd.

• Alleen standaardwerkstromen: Als u bulk-JSON wilt weergeven of bewerken, selecteert u Parameters in het zijbalkmenu van de resource. Selecteer in het Parameters-deelvenster Bewerken in JSON.

  De JSON-weergave Parameters wordt geopend en geeft alle parameters weer die u hebt gedefinieerd op basis van werkstromen in die logische app.

Visual Studio Code

In deze procedure wordt beschreven hoe u werkt met parameters voor werkstromen van standaard logische apps met behulp van Visual Studio Code.

1. Definieer in een JSON-bestand op hoofdniveau van een project met de naam parameters.json alle parameters en de bijbehorende waarden. Dit bestand heeft een object dat sleutel-waardeparen bevat. Elke sleutel is de naam voor elke parameter. Elke waarde is de structuur voor de parameter. Elke structuur moet zowel een als een typevalue declaratie bevatten.

   Belangrijk

   Uw parameters.json-bestand moet alle parameters en de bijbehorende waarden definiëren en opnemen die u ergens anders in uw project gebruikt of waarnaar u verwijst. Deze vereiste omvat werkstroomdefinities en verbindingen.

   In het volgende voorbeeld ziet u een basisparametersbestand:

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

   Notitie

   In het bestand parameters.json @appsetting is dit het enige geldige expressietype.

2. Als u wilt verwijzen naar parameters in uw trigger- of actie-invoer, gebruikt u de expressie @parameters('<parameter-name>').

Verbindingsbestand parameteriseren

Als u uw connections.json-bestand wilt parameteriseren, vervangt u de waarden voor letterlijke waarden, zoals ConnectionRuntimeUrl, door één parameters() expressie, bijvoorbeeld @parameters('api-runtimeUrl'). In het bestand connections.json zijn @parameters@appsettingen zijn de enige geldige expressietypen.

In het volgende voorbeeld ziet u een geparameteriseerd connections.json-bestand dat zowel app-instellingen als parameters gebruikt. In dit voorbeeldbestand wordt een parameter gebruikt voor het complexe blob_auth verificatieobject en de app-instellingen voor de andere waarden.

U wilt waar mogelijk parameters gebruiken. Omdat app-instellingen worden gegenereerd tijdens de implementatie en gemakkelijker dynamisch kunnen worden ingevuld in een ontwikkelingspijplijn, moet u app-instellingen gebruiken voor parameters in dit scenario. In dit geval kunt u een parameter voor het verificatieobject gebruiken omdat u waarschijnlijk niet naar de parameter in uw werkstroom verwijst:

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

Parametersbestanden beheren

Normaal gesproken moet u meerdere versies van parametersbestanden beheren. U kunt doelwaarden gebruiken voor verschillende implementatieomgevingen, zoals ontwikkeling, testen en productie. Het beheren van deze parameterbestanden werkt vaak als het beheren van arm-sjabloonparametersbestanden. Wanneer u in een specifieke omgeving implementeert, promoveert u het bijbehorende parameterbestand, meestal via een pijplijn voor DevOps.

Als u parametersbestanden dynamisch wilt vervangen met behulp van de Azure CLI, voert u de volgende opdracht uit:

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

Als u een op NuGet gebaseerd logische app-project hebt, moet u het projectbestand (<logic-app-name.csproj>) bijwerken om het parameterbestand op te nemen in de build-uitvoer, bijvoorbeeld:

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

Zie de volgende artikelen voor meer informatie over het instellen van uw logische apps voor DevOps-implementaties:

• Overzicht van DevOps-implementatie voor logische apps met één tenant
• DevOps-implementatie instellen voor logische apps met één tenant

App-instellingen beheren

In Standaard logische apps bevatten app-instellingen globale configuratieopties voor alle werkstromen in dezelfde logische app. Wanneer u werkstromen lokaal uitvoert in Visual Studio Code, hebt u toegang tot deze app-instellingen als lokale omgevingsvariabelen in het local.settings.json-bestand . U kunt vervolgens verwijzen naar deze app-instellingen in uw parameters.

In de volgende secties wordt beschreven hoe u app-instellingen voor Visual Studio Code, Azure Portal, Azure CLI en ARM-sjabloon (Bicep) toevoegt, bijwerkt of verwijdert.

App-instellingen controleren met behulp van Azure Portal

Voer de volgende stappen uit om de app-instellingen voor uw logische app-resource in Azure Portal te controleren:

1. Open uw logische app-resource in Azure Portal.

2. Selecteer in het zijbalkmenu van de resource onder Instellingende optie Omgevingsvariabelen.

3. Controleer op de pagina Omgevingsvariabelen op het tabblad App-instellingen de app-instellingen voor uw logische app.

4. Als u alle waarden wilt weergeven, selecteert u Waarden weergeven. Als u één waarde wilt weergeven, selecteert u die waarde.

Voer de volgende stappen uit om een nieuwe instelling toe te voegen:

1. Selecteer + Toevoegen onder Toepassingsinstellingen.

2. Voer bij Naam de sleutel of naam voor de nieuwe instelling in.

3. Voer voor Waarde de waarde in voor uw nieuwe instelling.

4. Selecteer indien nodig instelling voor implementatieslots.

5. Wanneer u klaar bent om uw nieuwe sleutel-waardepaar te maken, selecteert u Toepassen.

App-instellingen controleren met behulp van Azure CLI

Als u de huidige app-instellingen wilt controleren met behulp van de Azure CLI, voert u de opdracht uit. az logicapp config appsettings list Zorg ervoor dat uw opdracht de --name -n en --resource-group -g parameters bevat, bijvoorbeeld:

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

Voer de opdracht az logicapp config appsettings setuit om een app-instelling toe te voegen of bij te werken met behulp van de Azure CLI. Zorg ervoor dat de opdracht de --name n en --resource-group -g parameters bevat. Met de volgende opdracht maakt u bijvoorbeeld een instelling met een sleutel met de naam CUSTOM_LOGIC_APP_SETTING met de waarde :12345

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

App-instellingen controleren en definiëren in een Resource Manager- of Bicep-bestand

Als u uw app-instellingen in een ARM-sjabloon of Bicep-bestand wilt controleren en definiëren, zoekt u de resourcedefinitie van uw logische app en werkt u het appSettings JSON-object bij. Zie de arm-sjabloonreferentie voor de volledige resourcedefinitie.

In dit voorbeeld ziet u bestandsinstellingen voor ARM-sjablonen of Bicep-bestanden:

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

Gerelateerde inhoud

• Eén tenant versus multitenant in Azure Logic Apps