Vytvoření parametrů mezi prostředími pro vstupy pracovního postupu v Azure Logic Apps

portál Azure

1. Na webu Azure Portal otevřete pracovní postup aplikace logiky. V části Pracovní postupy vyberte a otevřete pracovní postup v návrháři.

2. Na panelu nástrojů návrháře vyberte Parametry.

   

3. V podokně Parametry vyberte Přidat parametr.

4. Zadejte následující informace o parametru, který chcete vytvořit:

   Vlastnost	Požadováno	Popis
   Jméno	Ano	Název parametru, který se má vytvořit.
   Typ	Ano	Datový typ pro parametr, například Array, Bool, Float, Int, Object, Secure Object, Secure String a String.
   Výchozí hodnota	Ano	Výchozí hodnota parametru. Je nutné zadat výchozí hodnotu parametru, protože logika pracovního postupu, informace o připojení a hodnoty parametrů neexistují v jednom umístění. Návrhář musí být schopen před načtením přeložit hodnoty parametrů. Důležité: Pro datové typy Secure Object a Secure String nepoužívejte nastavení výchozí hodnoty, protože hodnota je uložena jako prostý text.
   Skutečná hodnota	No	Skutečná hodnota parametru.

   Následující příklad ukazuje definici parametru řetězce:

   

5. Pokud máte další parametry, které chcete přidat, vyberte Přidat parametr. V opačném případě zavřete podokno parametrů, ale nezapomeňte uložit pracovní postup a uložit novou definici parametru.

6. Pokud chcete odkazovat na parametr z triggeru nebo akce, která je ve stejném pracovním postupu, postupujte takto:

   1. V návrháři otevřete požadovaný pracovní postup a rozbalte trigger nebo akci.

   2. Ve vlastnosti, ve které chcete použít parametr, klikněte do textového pole této vlastnosti.

   3. V seznamu dynamického obsahu, který se otevře v části Parametry, vyberte dříve vytvořený parametr, například:

      

7. Pokud chcete zobrazit nebo upravit parametry v pracovním postupu aplikace logiky, postupujte takto:

   1. Otevřete pracovní postup aplikace logiky v návrháři. Na panelu nástrojů návrháře vyberte Parametry.

      Otevře se podokno Parametry a zobrazí se všechny parametry, které jste definovali pro tento pracovní postup.

   2. Proveďte úpravy, zavřete podokno parametrů a uložte pracovní postup aplikace logiky.

portál Azure

1. Na webu Azure Portal otevřete prostředek aplikace logiky. V části Pracovní postupy otevřete pracovní postup v návrháři.

2. Na panelu nástrojů návrháře vyberte Parametry.

   

3. V podokně Parametry vyberte Vytvořit parametr.

4. Zadejte následující informace o parametru, který chcete vytvořit:

   Vlastnost	Požadováno	Popis
   Jméno	Ano	Název parametru, který se má vytvořit.
   Typ	Ano	Datový typ pro parametr, například Array, Bool, Float, Int, Object a String. Poznámka: V pracovních postupech standardní aplikace logiky nejsou podporované zabezpečené datové typy, například securestring a secureobject.
   Hodnota	Ano	Hodnota parametru. V pracovních postupech standardní aplikace logiky musíte zadat hodnotu parametru, protože logika pracovního postupu, informace o připojení a hodnoty parametrů neexistují v jednom umístění. Návrhář musí být schopen před načtením přeložit hodnoty parametrů.

   Následující příklad ukazuje definici parametru řetězce:

   

5. Až budete hotovi, zavřete podokno Parametry , ale nezapomeňte uložit pracovní postup a uložit novou definici parametru.

6. Pokud chcete odkazovat na parametr z triggeru nebo akce, která je v jakémkoli pracovním postupu ve stejné aplikaci logiky, postupujte takto:

   1. V návrháři otevřete požadovaný pracovní postup a rozbalte trigger nebo akci.

   2. Ve vlastnosti, ve které chcete použít parametr, klikněte do textového pole této vlastnosti.

   3. V seznamu dynamického obsahu, který se otevře v části Parametry, vyberte dříve vytvořený parametr, například:

      

7. Pokud chcete zobrazit nebo upravit parametry ve stejné aplikaci logiky, postupujte následovně:

   • Otevřete libovolný pracovní postup v této aplikaci logiky. V nabídce pracovního postupu vyberte Návrhář. Na panelu nástrojů návrháře vyberte Parametry.

     Otevře se podokno Parametry a zobrazí se všechny parametry, které jste definovali z pracovních postupů v této aplikaci logiky.

   • Pokud chcete zobrazit nebo upravit hromadně JSON, vyberte v hlavní nabídce aplikace logiky parametry.

     Otevře se zobrazení JSON parametrů a zobrazí se všechny parametry, které jste definovali z pracovních postupů v této aplikaci logiky.

Visual Studio Code

1. V souboru JSON kořenové úrovně projektu s názvem parameters.json definujte všechny parametry a jejich hodnoty. Tento soubor obsahuje objekt, který obsahuje páry klíč-hodnota . Každý klíč je název každého parametru, zatímco každá hodnota je struktura každého parametru. Každá struktura musí obsahovat jak definici type value , tak i deklaraci.

   Důležité

   Soubor parameters.json musí definovat a obsahovat všechny parametry a jejich hodnoty, na které odkazujete nebo používáte jinde v projektu, například v definicích pracovního postupu nebo připojení.

   Následující příklad ukazuje základní soubor parametrů:

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

   Poznámka:

   V souboru @appsetting parameters.json je jediným platným typem výrazu.

2. Pokud chcete odkazovat na parametry ve vstupech triggeru nebo akce, použijte výraz @parameters('<parameter-name>').

Parametrizace souboru připojení

Chcete-li parametrizovat connections.json soubor, nahraďte hodnoty literálů, například ConnectionRuntimeUrl, jedním parameters() výrazem, @parameters('api-runtimeUrl')například . V souboru connections.json jsou jediné platné typy výrazů a @parameters @appsetting.

Následující příklad ukazuje parametrizovaný soubor connections.json , který používá nastavení aplikace i parametry. I když chcete použít parametry tam, kde je to možné, je tento scénář výjimkou nebo hraničním případem, kdy byste použili nastavení aplikace pro parametry, protože nastavení aplikace se generují během nasazování a dají se dynamicky naplnit ve vývojovém kanálu. Tento ukázkový soubor používá parametr pro komplexní blob_auth objekt ověřování a nastavení aplikace pro ostatní hodnoty. V tomto případě můžete pro objekt ověřování použít parametr, protože pravděpodobně nebudete odkazovat na parametr v pracovním postupu:

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

Správa souborů parametrů

Obvykle potřebujete spravovat více verzí souborů parametrů. Můžete mít cílové hodnoty pro různá prostředí nasazení, jako je vývoj, testování a produkční prostředí. Správa těchto souborů parametrů často funguje jako správa souborů parametrů šablony ARM. Když nasadíte do konkrétního prostředí, zvýšíte úroveň odpovídajícího souboru parametrů, obvykle prostřednictvím kanálu pro DevOps.

Pokud chcete soubory parametrů dynamicky nahradit pomocí Azure CLI, spusťte následující příkaz:

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

Pokud máte projekt aplikace logiky založený na NuGetu, musíte aktualizovat soubor projektu (<logic-app-name.csproj>) tak, aby zahrnoval soubor parametrů ve výstupu sestavení, například:

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

Další informace o nastavení aplikací logiky pro nasazení DevOps najdete v následující dokumentaci:

• Přehled nasazení DevOps pro aplikace logiky založené na jednom tenantovi
• Nastavení nasazení DevOps pro aplikace logiky založené na jednom tenantovi

Správa nastavení aplikace

V Azure Logic Apps s jedním tenantem obsahují nastavení aplikace globální možnosti konfigurace pro všechny pracovní postupy ve stejné aplikaci logiky . Při místním spouštění pracovních postupů v editoru Visual Studio Code můžete k těmto nastavením aplikace přistupovat jako k místním proměnným prostředí v souboru local.settings.json . Na tato nastavení aplikace pak můžete odkazovat ve svých parametrech.

Pokud chcete přidat, aktualizovat nebo odstranit nastavení aplikace, vyberte a projděte si následující části šablony editoru Visual Studio Code, webu Azure Portal, Azure CLI nebo ARM (Bicep).

portál Azure

Pokud chcete zkontrolovat nastavení aplikace pro prostředek aplikace logiky na webu Azure Portal, postupujte takto:

1. Na webu Azure Portal otevřete prostředek aplikace logiky.

2. V nabídce aplikace logiky v části Nastavení vyberte Konfigurace.

3. Na stránce Konfigurace na kartě Nastavení aplikace zkontrolujte nastavení aplikace pro vaši aplikaci logiky.

4. Pokud chcete zobrazit všechny hodnoty, vyberte Zobrazit hodnoty. Pokud chcete zobrazit jednu hodnotu, vyberte tuto hodnotu.

Pokud chcete přidat nové nastavení, postupujte takto:

1. Na kartě Nastavení aplikace v části Nastavení aplikace vyberte Nové nastavení aplikace.

2. Do pole Název zadejte klíč nebo název nového nastavení.

3. Do pole Hodnota zadejte hodnotu nového nastavení.

4. Až budete připraveni vytvořit nový pár klíč-hodnota , vyberte OK.

   

5. Až budete hotovi, na panelu nástrojů Konfigurace vyberte Uložit.

Azure CLI

Pokud chcete zkontrolovat aktuální nastavení aplikace pomocí Azure CLI, spusťte příkaz az logicapp config appsettings list. Ujistěte se, že váš příkaz obsahuje parametry --name -n , --resource-group -g například:

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

Pokud chcete přidat nebo aktualizovat nastavení aplikace pomocí Azure CLI, spusťte příkaz az logicapp config appsettings set. Ujistěte se, že váš příkaz obsahuje parametry --name n a --resource-group -g parametry. Například následující příkaz vytvoří nastavení s klíčem pojmenovaným CUSTOM_LOGIC_APP_SETTING s hodnotou 12345:

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

Šablona Resource Manageru nebo Bicep

Pokud chcete zkontrolovat a definovat nastavení aplikace v šabloně ARM nebo v šabloně Bicep, vyhledejte definici prostředku aplikace logiky a aktualizujte appSettings objekt JSON. Úplnou definici prostředku najdete v referenčních informacích k šabloně ARM.

Tento příklad ukazuje nastavení souborů pro šablony ARM nebo šablony Bicep:

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