Azure 逻辑应用中工作流定义语言的架构参考指南

在 Azure 逻辑应用中创建逻辑应用时，逻辑应用具有一个基础工作流定义，用于描述逻辑应用中运行的实际逻辑。 该工作流定义使用 JSON ，并遵循工作流定义语言架构验证的结构。 此参考概述了此结构，以及架构如何在工作流定义中定义属性。

工作流定义始终包括用于实例化逻辑应用的触发器，以及触发触发器后运行的一个或多个作。

下面是工作流定义的高级结构：

"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>" }
}

在工作流定义中， triggers 和 actions 部分定义工作流执行期间发生的调用。 有关这些部分的语法和详细信息，请参阅 工作流触发器和作。

部署生命周期通常具有不同的开发、测试、过渡和生产环境。 将逻辑应用部署到各种环境时，可能需要根据部署需求使用不同的值，例如连接字符串。 或者，你可能希望在整个逻辑应用中重复使用的值，而无需进行硬编码或经常更改。 在工作流定义的 parameters 部分中，可以为逻辑应用在运行时使用的值定义或编辑参数。 必须先定义这些参数，然后才能在工作流定义中的其他位置引用这些参数。

下面是参数定义的常规结构：

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

接下来，为工作流定义创建 Azure 资源管理器模板 ，定义接受部署时所需的值的模板参数，根据需要将硬编码的值替换为对模板或工作流定义参数的引用，并将要在部署时使用的值存储在单独的 参数文件中。 这样，便可以更轻松地通过参数文件更改这些值，而无需更新和重新部署逻辑应用。 对于敏感或必须保护的信息（例如用户名、密码和机密），可以将这些值存储在 Azure Key Vault 中，并让参数文件从密钥保管库中检索这些值。 有关在模板和工作流定义级别定义参数的详细信息和示例，请参阅 概述：使用 Azure 资源管理器模板自动部署逻辑应用。

在 staticResults 属性中，定义作的模拟 outputs ，并在 status 打开作的静态结果设置时返回该作。 在作的定义中，属性 runtimeConfiguration.staticResult.name 引用内部 staticResults静态结果定义的名称。 了解如何 通过设置静态结果通过模拟数据测试逻辑应用工作流。

"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": { "<...>" }
}

例如，在此 HTTP作定义中，属性runtimeConfiguration.staticResult.name在定义作的模拟输出的属性内staticResults引用HTTP0。 该 runtimeConfiguration.staticResult.staticResultOptions 属性指定静态结果设置位于 Enabled HTTP作上。

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

HTTP作返回定义staticResults中的HTTP0输出。 在此示例中，对于状态代码，模拟输出为 OK。 对于标头值，模拟输出为 "Content-Type": "application/JSON". 对于作的状态，模拟输出为 Succeeded。

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

使用 JSON 时，可以具有设计时存在的文本值，例如：

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

还可以具有在运行时之前不存在的值。 若要表示这些值，可以使用在运行时计算的 表达式。 表达式是一个序列，可以包含一个或多个 函数、 运算符、 变量、显式值或常量。 在工作流定义中，可以通过在 JSON 字符串值中的任何位置使用表达式，方法是使用 at-sign （@） 作为表达式前缀。 在计算表示 JSON 值的表达式时，通过删除 @ 字符来提取表达式正文，并且始终生成另一个 JSON 值。

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

通过字符串内插 ，还可以在由 @ 字符和大括号 （{}） 包装的字符串内使用多个表达式。 下面是语法：

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

结果始终是一个字符串，使此功能类似于 concat() 函数，例如：

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

如果有以 @ 字符开头的文本字符串，请使用另一个 @ 字符作为转义字符前缀 @ 字符：@@

这些示例演示如何计算表达式：

对于这些示例，假设你定义“myBirthMonth”等于“January”和“myAge”等于数字 42：

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

这些示例演示如何计算以下表达式：

在工作流设计器中以可视方式工作时，可以使用表达式编辑器创建表达式，例如：

完成后，表达式会显示在工作流定义中的相应属性，例如， searchQuery 此处的属性：

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

在本 outputs 部分中，定义工作流在运行完成后可以返回的数据。 例如，若要跟踪每个运行中的特定状态或值，请指定工作流输出返回该数据。

下面是输出定义的常规结构：

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

若要从工作流运行中获取输出，请查看 Azure 门户中逻辑应用的运行历史记录和详细信息，或使用 工作流 REST API。 还可以将输出传递给外部系统，例如 Power BI，以便创建仪表板。

在 表达式 和 函数中，运算符执行特定任务，例如引用数组中的属性或值。

• 工作流定义语言作和触发器
• 工作流 REST API