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ättaauthentication
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
Azure Portal
Öppna logikappens arbetsflöde i Azure Portal. Under Arbetsflöden väljer du och öppnar arbetsflödet i designern.
Välj Parametrar i designerverktygsfältet.
I fönstret Parametrar väljer du Lägg till parameter.
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:
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.
Följ dessa steg om du vill referera till parametern från en utlösare eller åtgärd som finns i samma arbetsflöde:
Öppna önskat arbetsflöde i designern och expandera utlösaren eller åtgärden.
I egenskapen där du vill använda parametern klickar du i den egenskapens redigeringsruta.
I listan med dynamiskt innehåll som öppnas, under Parametrar, väljer du den tidigare skapade parametern, till exempel:
Följ dessa steg om du vill visa eller redigera parametrarna i ett logikappsarbetsflöde:
Ö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.
Gör dina ändringar, stäng parameterfönstret och spara logikappens arbetsflöde.