Parameters voor meerdere omgevingen maken voor werkstroominvoer in Azure Logic Apps

Van toepassing op: Azure Logic Apps (verbruik + standaard)

In Azure Logic Apps kunt u waarden die kunnen veranderen in werkstromen in ontwikkel-, test- en productieomgevingen abstraheren door parameters te definiëren. Wanneer u parameters gebruikt in plaats van omgevingsspecifieke variabelen, kunt u zich in eerste instantie meer richten op het ontwerpen van uw werkstromen en uw omgevingsspecifieke variabelen later invoegen.

In dit artikel wordt uitgelegd hoe u parameters kunt maken, gebruiken en bewerken voor werkstromen voor logische app-apps met meerdere tenants verbruik en voor werkstromen voor standaard logische apps met één tenant. U leert ook hoe u omgevingsvariabelen beheert.

Voor meer informatie over Azure Logic Apps met meerdere tenants en één tenant raadpleegt u Omgeving met één tenant versus meerdere tenants en integratieservice voor 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 logische apps voor verbruik of standaard

  Als u nog geen werkstroom voor een logische app hebt, raadpleegt u Een voorbeeld van een logische app-werkstroom voor verbruik maken met behulp van de Azure Portal of Een voorbeeld van een standaardwerkstroom voor logische apps maken met behulp van de Azure Portal.

  Notitie

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

Parameters voor verbruik versus standaardwerkstromen voor logische apps

Voor zowel de logische app-werkstromen verbruik als de standaardwerkstroom kunt u parameters definiëren met behulp van de ontwerpfunctie. Nadat u de parameter hebt gedefinieerd, kunt u naar die parameter verwijzen vanuit elke werkstroom of verbinding die zich in dezelfde logische app-resource bevindt.

Nadat u parameters in de ontwerpfunctie hebt gemaakt en gebruikt in werkstromen voor verbruik met meerdere tenants, definieert en stelt u de omgevingsvariabelen in uw Azure Resource Manager sjabloon (ARM-sjabloon) en sjabloonparametersbestanden in. In dit scenario moet u de parameters bij de implementatie definiëren en instellen. Dit betekent dat u, zelfs als u slechts één variabele hoeft te wijzigen, de ARM-sjabloon van uw logische app opnieuw moet implementeren.

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

Notitie

In standaardwerkstromen voor logische apps worden beveiligde gegevenstypen, zoals securestring en secureobject, niet ondersteund. Als alternatieve optie kunt u echter app-instellingen gebruiken met Azure Key Vault. U kunt vervolgens rechtstreeks verwijzen naar beveiligde tekenreeksen, zoals verbindingsreeksen en sleutels. Net als bij ARM-sjablonen, waar u omgevingsvariabelen tijdens de implementatie kunt definiëren, kunt u app-instellingen definiëren binnen de definitie van de werkstroom van uw logische app. Vervolgens kunt u dynamisch gegenereerde infrastructuurwaarden vastleggen, zoals verbindingseindpunten, opslagtekenreeksen en meer.

App-instellingen hebben echter groottelimieten en kunnen niet worden verwezen vanuit bepaalde gebieden in Azure Logic Apps. Parameters bieden een breder scala aan gebruiksvoorbeelden dan app-instellingen, zoals ondersteuning voor grote waardegrootten en complexe objecten.

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

• Een testparametersbestand hebben dat alle waarden bevat die u tijdens het testen gebruikt. Bij de implementatie kunt u het bestand met testparameters vervangen door het bestand met productieparameters.

• Parameteriseer verschillende onderdelen van het bestand connections.json . Vervolgens kunt u het bestand connections.json controleren in broncodebeheer en vervolgens eventuele verbindingen beheren via het bestand parameters.json .

• 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 bestand local.settings.json van uw project. U kunt vervolgens naar deze app-instellingen verwijzen in uw parameters.

Notitie

Als algemene aanbeveling kunt u overwegen om parameters te gebruiken als de standaard manier om waarden te parameteriseren, niet app-instellingen. Op die manier kunt u, wanneer u beveiligde sleutels of tekenreeksen moet opslaan, de aanbeveling volgen om vanuit uw parameters te verwijzen naar app-instellingen. Als u wilt, kunt u beide opties in uw oplossing gebruiken door parameters te gebruiken om te verwijzen naar app-instellingen.

Parameters definiëren, gebruiken en bewerken

Verbruik

Azure Portal

1. Open in de Azure Portal de werkstroom van uw logische app. Selecteer en open uw werkstroom onder Werkstromen in de ontwerpfunctie.

2. Selecteer Parameters in de werkbalk van de ontwerper.

   

3. Selecteer parameter toevoegen in het deelvenster Parameters.

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

   Eigenschap	Vereist	Beschrijving
   Naam	Ja	De naam voor de parameter die moet worden gemaakt.
   Type	Ja	Het gegevenstype voor de parameter, zoals Matrix, Bool, Float, Int, Object, Beveiligd object, Beveiligde tekenreeks en Tekenreeks.
   Standaardwaarde	Yes	De standaardwaarde voor de parameter. U moet de standaardparameterwaarde opgeven, omdat de werkstroomlogica, verbindingsgegevens en parameterwaarden niet op één locatie bestaan. De ontwerper moet de parameterwaarden kunnen oplossen voordat deze worden 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	No	De werkelijke waarde voor de parameter.

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

   

5. Als u meer parameters wilt toevoegen, selecteert u Parameter toevoegen. Sluit anders het deelvenster parameters, maar zorg ervoor dat u de werkstroom opslaat om de nieuwe parameterdefinitie op te slaan.

6. Als u wilt verwijzen naar de parameter vanuit een trigger of actie die zich in dezelfde werkstroom bevindt, voert u de volgende stappen uit:

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

   2. Klik in de eigenschap waarin u de parameter wilt gebruiken in het invoervak van die eigenschap.

   3. Selecteer in de lijst met dynamische inhoud die wordt geopend onder Parameters de eerder gemaakte parameter, bijvoorbeeld:

      

7. Voer de volgende stappen uit om de parameters in een werkstroom voor een logische app weer te geven of te bewerken:

   1. Open de werkstroom van de logische app in de ontwerpfunctie. Selecteer Parameters op de werkbalk van de ontwerper.

      Het deelvenster Parameters wordt geopend en alle parameters die u voor die werkstroom hebt gedefinieerd, worden weergegeven.

   2. Breng uw wijzigingen aan, sluit het deelvenster Parameters en sla de werkstroom van de logische app op.

Standard

Azure Portal

1. Open in de Azure Portal de resource van uw logische app. Open uw werkstroom onder Werkstromen in de ontwerpfunctie.

2. Selecteer Parameters in de werkbalk van de ontwerper.

   

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

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

   Eigenschap	Vereist	Beschrijving
   Naam	Ja	De naam voor de parameter die moet worden gemaakt.
   Type	Ja	Het gegevenstype voor de parameter, zoals Matrix, Bool, Float, Int, Object en Tekenreeks. Opmerking: in standaardwerkstromen voor logische apps worden beveiligde gegevenstypen, zoals securestring en secureobject, niet ondersteund.
   Waarde	Yes	De waarde voor de parameter. In standaardwerkstromen voor logische apps moet u de parameterwaarde opgeven omdat de werkstroomlogica, verbindingsgegevens en parameterwaarden niet op één locatie bestaan. De ontwerper moet de parameterwaarden kunnen oplossen voordat deze worden geladen.

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

   

5. Wanneer u klaar bent, sluit u het deelvenster Parameters , maar slaat u de werkstroom op om de nieuwe parameterdefinitie op te slaan.

6. Als u wilt verwijzen naar de parameter vanuit een trigger of actie die zich in een werkstroom in dezelfde logische app bevindt, voert u de volgende stappen uit:

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

   2. Klik in de eigenschap waarin u de parameter wilt gebruiken in het invoervak van die eigenschap.

   3. Selecteer in de lijst met dynamische inhoud die wordt geopend onder Parameters de eerder gemaakte parameter, bijvoorbeeld:

      

7. Voer een van de volgende stappen uit om parameters in dezelfde logische app weer te geven of te bewerken:

   • Open een werkstroom in die logische app. Selecteer Designer in het werkstroommenu. Selecteer Parameters op de werkbalk van de ontwerper.

     Het deelvenster Parameters wordt geopend en alle parameters worden weergegeven die u hebt gedefinieerd vanuit werkstromen in die logische app.

   • Als u JSON bulksgewijs wilt weergeven of bewerken, selecteert u Parameters in het hoofdmenu van uw logische app.

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

Visual Studio Code

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

   Belangrijk

   Het parameters.json-bestand moet alle parameters en hun waarden definiëren en bevatten waarnaar u verwijst of elders in uw project gebruikt, bijvoorbeeld in werkstroomdefinities of 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 @appsettingparameters.json is het enige geldige expressietype.

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

Verbindingenbestand parameteriseren

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

Belangrijk

Als u het bestand connections.json tijdens de ontwikkeling parameteriseert, wordt de ontwerpervaring beperkt, zowel lokaal als in de Azure Portal. Als u de ontwerpfunctie moet gebruiken voor ontwikkeling, gebruikt u in plaats daarvan een niet-geparameteriseerd connections.json-bestand . Vervang vervolgens in uw implementatiepijplijnen door het geparameteriseerde bestand. De runtime werkt nog steeds met parameterisatie. Ontwerpverbeteringen zijn in ontwikkeling.

In het volgende voorbeeld ziet u een geparameteriseerd connections.json-bestand dat zowel app-instellingen als parameters gebruikt. Hoewel u waar mogelijk parameters wilt gebruiken, is dit scenario een uitzondering of edge-geval waarbij u app-instellingen zou gebruiken in plaats van parameters, omdat app-instellingen tijdens de implementatie worden gegenereerd en gemakkelijker dynamisch kunnen worden ingevuld in een ontwikkelingspijplijn. Dit voorbeeldbestand gebruikt een parameter voor het complexe blob_auth verificatieobject en app-instellingen voor de andere waarden. In dit geval kunt u een parameter voor het verificatieobject gebruiken, omdat het onwaarschijnlijk is dat u 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')"
      }
   }
}

Notitie

Wanneer u een expressie hebt die inline is met tekst zonder opmaak, moet u ervoor zorgen dat u de geïnterpoleerde indeling voor die expressie gebruikt door die expressie tussen accolades ({}) te plaatsen. Deze indeling helpt bij het voorkomen van parseerproblemen.

Als u bijvoorbeeld hebt "<text>/@<function-name>('<parameter-name>')/<text>", gebruikt u in plaats daarvan de volgende versie: "<text>/@{<function-name>('<parameter-name>')}/<text>".

Raadpleeg Overwegingen voor het gebruik van functies voor meer informatie.

Parametersbestanden beheren

Normaal gesproken moet u meerdere versies van parametersbestanden beheren. Mogelijk hebt u gerichte waarden voor verschillende implementatieomgevingen, zoals ontwikkeling, testen en productie. Het beheren van deze parametersbestanden werkt vaak net als het beheren van arm-sjabloonparametersbestanden. Wanneer u implementeert in een specifieke omgeving, promoot 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>

Notitie

Op dit moment is de mogelijkheid om parametersbestanden dynamisch te vervangen nog niet beschikbaar in de Azure Portal of de werkstroomontwerper.

Raadpleeg de volgende documentatie 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 Azure Logic Apps met één tenant 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 bestand local.settings.json . U kunt vervolgens naar deze app-instellingen verwijzen in uw parameters.

Als u app-instellingen wilt toevoegen, bijwerken of verwijderen, selecteert en bekijkt u de volgende secties voor de sjabloon Visual Studio Code, Azure Portal, Azure CLI of ARM (Bicep).

Azure Portal

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

1. Open in de Azure Portal de resource van uw logische app.

2. Selecteer in het menu van de logische app onder Instellingende optie Configuratie.

3. Controleer op de pagina Configuratie op het tabblad Toepassingsinstellingen 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 op het tabblad Toepassingsinstellingen onder Toepassingsinstellingen de optie Nieuwe toepassingsinstelling.

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

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

4. Wanneer u klaar bent om uw nieuwe sleutel-waardepaar te maken, selecteert u OK.

   

5. Wanneer u klaar bent, selecteert u Opslaan op de werkbalk Configuratie.

Azure CLI

Voer de opdracht az logicapp config appsettings listuit om uw huidige app-instellingen te controleren met behulp van de Azure CLI. Zorg ervoor dat de opdracht de --name -n parameters en --resource-group -g bevat, bijvoorbeeld:

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

Als u een app-instelling wilt toevoegen of bijwerken met behulp van de Azure CLI, voert u de opdracht az logicapp config appsettings setuit. Zorg ervoor dat de opdracht de --name n parameters en --resource-group -g 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 

Resource Manager- of Bicep-sjabloon

Als u uw app-instellingen in een ARM-sjabloon of Bicep-sjabloon 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-sjablonen:

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

Volgende stappen

• Omgeving met één tenant versus multitenant en integratieservice voor Azure Logic Apps