Referenční příručka schématu pro jazyk definice pracovního postupu v Azure Logic Apps

Když vytvoříte aplikaci logiky v Azure Logic Apps, vaše aplikace logiky obsahuje základní definici pracovního postupu, která popisuje vlastní logiku, která se spouští ve vaší aplikaci logiky. Tato definice pracovního postupu používá JSON a dodržuje strukturu, kterou ověřuje schéma jazyka definice pracovního postupu. Tento odkaz poskytuje přehled této struktury a způsob, jakým schéma definuje atributy v definici pracovního postupu.

Struktura definice pracovního postupu

Definice pracovního postupu vždy zahrnuje Trigger pro vytvoření instance aplikace logiky a jednu nebo více akcí, které se spustí po aktivaci triggeru.

Tady je struktura vysoké úrovně pro definici pracovního postupu:

"definition": {
  "$schema": "<workflow-definition-language-schema-version>",
  "actions": { "<workflow-action-definitions>" },
  "contentVersion": "<workflow-definition-version-number>",
  "outputs": { "<workflow-output-definitions>" },
  "parameters": { "<workflow-parameter-definitions>" },
  "staticResults": { "<static-results-definitions>" },
  "triggers": { "<workflow-trigger-definitions>" }
}

Aktivační události a akce

V definici pracovního postupu triggers actions definují oddíly a volání, ke kterým dochází během provádění pracovního postupu. Syntaxi a další informace o těchto oddílech najdete v tématu triggery a akce pracovních postupů.

Parametry

Životní cyklus nasazení má obvykle různá prostředí pro vývoj, testování, přípravu a produkci. Při nasazování Logic Apps do různých prostředí pravděpodobně budete chtít v závislosti na potřebách nasazení použít jiné hodnoty, například připojovací řetězce. Nebo můžete mít hodnoty, které chcete znovu použít v rámci aplikace logiky bez zakódujeme nebo změny často. V části definice pracovního postupu parameters můžete definovat nebo upravit parametry pro hodnoty, které vaše aplikace logiky používá za běhu. Než budete moci odkazovat na tyto parametry jinde v definici pracovního postupu, musíte tyto parametry definovat jako první.

Tady je obecná struktura definice parametru:

"parameters": {
   "<parameter-name>": {
      "type": "<parameter-type>",
      "defaultValue": <default-parameter-value>,
      "allowedValues": [ <array-with-permitted-parameter-values> ],
      "metadata": {
         "description": "<parameter-description>"
      }
   }
},

Dále vytvořte šablonu Azure Resource Manager pro definici pracovního postupu, definujte parametry šablony, které přijmou hodnoty, které chcete v nasazení, nahraďte hodnoty pevně zakódované odkazy na šablonu nebo parametry definice pracovního postupu podle potřeby a uložte hodnoty, které chcete použít při nasazení v samostatném souboru parametrů. Tímto způsobem můžete tyto hodnoty snadno měnit pomocí souboru parametrů, aniž byste museli aktualizovat a znovu nasazovat aplikaci logiky. Pro informace, které jsou citlivé nebo musí být zabezpečené, jako jsou uživatelská jména, hesla a tajné klíče, můžete tyto hodnoty uložit v Azure Key Vault a nechat si soubory parametrů načíst tyto hodnoty z vašeho trezoru klíčů. Další informace a příklady definování parametrů na úrovních definice šablony a pracovního postupu najdete v tématu Přehled: Automatizace nasazení pro Logic Apps pomocí šablon Azure Resource Manager.

Statické výsledky

V staticResults atributu definujte prvek akce outputs a status , který akce vrátí, pokud je zapnuto nastavení statického výsledku akce. V definici akce runtimeConfiguration.staticResult.name atribut odkazuje na název statického výsledku definice v rámci staticResults . Pomocí nastavení statických výsledků se dozvíte, jak testovat aplikace logiky pomocínapodobných dat.

"definition": {
   "$schema": "<...>",
   "actions": { "<...>" },
   "contentVersion": "<...>",
   "outputs": { "<...>" },
   "parameters": { "<...>" },
   "staticResults": {
      "<static-result-definition-name>": {
         "outputs": {
            <output-attributes-and-values-returned>,
            "headers": { <header-values> },
            "statusCode": "<status-code-returned>"
         },
         "status": "<action-status>"
      }
   },
   "triggers": { "<...>" }
}

Například v této definici akce HTTP runtimeConfiguration.staticResult.name jsou atributy odkazy v atributu, HTTP0 staticResults kde jsou definovány výstupní výstupy pro akci. runtimeConfiguration.staticResult.staticResultOptionsAtribut určuje, zda je nastavení statického výsledku Enabled v akci HTTP.

"actions": {
   "HTTP": {
      "inputs": {
         "method": "GET",
         "uri": "https://www.microsoft.com"
      },
      "runAfter": {},
      "runtimeConfiguration": {
         "staticResult": {
            "name": "HTTP0",
            "staticResultOptions": "Enabled"
         }
      },
      "type": "Http"
   }
},

Akce HTTP vrátí výstupy v HTTP0 definici uvnitř staticResults . V tomto příkladu pro stavový kód je výstupní výstup OK . V případě hodnot hlaviček je výstup výstupu "Content-Type": "application/JSON" . Pro stav akce je výstup výstupu Succeeded .

"definition": {
   "$schema": "<...>",
   "actions": { "<...>" },
   "contentVersion": "<...>",
   "outputs": { "<...>" },
   "parameters": { "<...>" },
   "staticResults": {
      "HTTP0": {
         "outputs": {
            "headers": {
               "Content-Type": "application/JSON"
            },
            "statusCode": "OK"
         },
         "status": "Succeeded"
      }
   },
   "triggers": { "<...>" }
},

Výrazy

Pomocí formátu JSON můžete mít literálové hodnoty, které existují v době návrhu, například:

"customerName": "Sophia Owen",
"rainbowColors": ["red", "orange", "yellow", "green", "blue", "indigo", "violet"],
"rainbowColorsCount": 7

Můžete také mít hodnoty, které neexistují, až do doby běhu. Pro reprezentaci těchto hodnot můžete použít výrazy, které jsou vyhodnocovány v době běhu. Výraz je sekvence, která může obsahovat jednu nebo více funkcí, operátorů, proměnných, explicitních hodnot nebo konstant. V definici pracovního postupu můžete použít výraz kdekoli v hodnotě řetězce JSON tím, že se výraz nastaví na znaménko ( @ ). Při vyhodnocování výrazu, který představuje hodnotu JSON, je text výrazu extrahován odebráním @ znaku a vždy vede k jiné hodnotě JSON.

Například pro dříve definovanou customerName vlastnost můžete získat hodnotu vlastnosti pomocí funkce Parameters () ve výrazu a přiřadit tuto hodnotu k accountName vlastnosti:

"customerName": "Sophia Owen",
"accountName": "@parameters('customerName')"

Interpolace řetězců také umožňuje použít více výrazů v řetězcích, které jsou zabaleny @ znakem a složenou závorkou ( {} ). Tady je syntaxe:

@{ "<expression1>", "<expression2>" }

Výsledkem je vždy řetězec, což znamená, že tato funkce bude podobná concat() funkci, například:

"customerName": "First name: @{parameters('firstName')} Last name: @{parameters('lastName')}"

Pokud máte řetězcový literál, který začíná @ znakem, @ nahraďte znak jiným @ znakem jako řídicí znak: @@

Tyto příklady ukazují, jak jsou výrazy vyhodnocovány:

Pro tyto příklady Předpokládejme, že definujete "myBirthMonth" rovnající se "lednu" a "myAge" rovnající se číslu 42:

"myBirthMonth": "January",
"myAge": 42

Tyto příklady ukazují, jak jsou vyhodnocovány následující výrazy:

Při práci vizuálně v Návrháři Logic Apps můžete vytvářet výrazy prostřednictvím Tvůrce výrazů, například:

Až budete hotovi, výraz se zobrazí pro odpovídající vlastnost v definici pracovního postupu, například searchQuery vlastnost zde:

"Search_tweets": {
  "inputs": {
    "host": {
      "connection": {
        "name": "@parameters('$connections')['twitter']['connectionId']"
      }
    }
  },
  "method": "get",
  "path": "/searchtweets",
  "queries": {
    "maxResults": 20,
    "searchQuery": "Azure @{concat('firstName','', 'LastName')}"
  }
},

Výstupy

V outputs části definujte data, která může pracovní postup vracet po dokončení práce. Chcete-li například sledovat konkrétní stav nebo hodnotu z každého spuštění, určete, že výstup pracovního postupu vrací tato data.

Tady je obecná struktura definice výstupu:

"outputs": {
  "<key-name>": {
    "type": "<key-type>",
    "value": "<key-value>"
  }
}

Pokud chcete získat výstup z pracovního postupu, přečtěte si historii spuštění vaší aplikace logiky a podrobnosti v Azure Portal nebo použijte pracovní postup REST API. Výstup můžete také předat externím systémům, například Power BI, abyste mohli vytvářet řídicí panely.

Operátory

Ve výrazech a funkcíchoperátory provádějí konkrétní úkoly, jako je například odkaz na vlastnost nebo hodnotu v poli.

Functions

Některé výrazy získají jejich hodnoty z běhových akcí, které nemusí být k dispozici, když začne běžet definice pracovního postupu. Chcete-li odkazovat nebo pracovat s těmito hodnotami ve výrazech, můžete použít funkce , které poskytuje jazyk definice pracovního postupu.

Další kroky

• Další informace o akcích a triggerech jazyka definice pracovního postupu
• Přečtěte si, jak programově vytvářet a spravovat Logic Apps pomocí pracovního postupu REST API