使用 Azure 逻辑应用的工作流内联添加和运行 JavaScript 代码

适用于：Azure 逻辑应用（消耗 + 标准）

要在 Azure 逻辑应用中使用工作流内联执行自定义集成任务，可以直接在 Azure 门户中从工作流添加和运行简单的 JavaScript 代码片段。 对于此任务，请使用名为执行 JavaScript 代码的内联代码操作。 此操作返回代码片段返回中的结果，以便可以在工作流的后续操作中使用该输出。 此操作还具有不同的限制，具体取决于你拥有的是消耗型工作流还是标准工作流，并且最适合具有以下属性的代码片段：

要运行不适合这些属性的代码，可以使用 Azure Functions 创建和调用函数。

本指南展示了该操作在以 Office 365 Outlook 触发器开头的示例工作流中的工作原理。 当新电子邮件到达关联的 Outlook 电子邮件帐户时，工作流将开始运行。 示例代码片段将提取电子邮件正文中存在的任何电子邮件地址，并将这些地址作为输出返回，以供你在后续操作中使用。

下图显示了示例工作流中的亮点：

Prerequisites

• Azure 帐户和订阅。 如果没有订阅，可以注册免费的 Azure 帐户。

• 想要添加代码片段的工作流所在的逻辑应用资源。 工作流须以触发器开头。

  本文的示例使用名为“新电子邮件到达时”的 Office 365 Outlook 触发器。

  如果没有逻辑应用资源和工作流，请立即按照所需的逻辑应用的步骤创建它们：

  • 消耗：创建示例消耗逻辑应用工作流
  • 标准：创建示例标准逻辑应用工作流

• 根据你拥有的是消耗型还是标准逻辑应用工作流，查看以下要求：

  • 消耗型工作流：

    • Node.js 版本 8.11.10

    • 从逻辑应用资源指向集成帐户的链接（空或其他）

      重要说明

      请确保使用适合你的用例或方案的集成帐户。

      例如，免费层集成帐户仅适用于探索方案和工作负载，而不适用于生产方案，另外，其使用量和吞吐量有限制，且不附带服务级别协议 (SLA) 的支持。

      其他集成帐户层会产生费用，但附带 SLA 支持，并且提供更高的吞吐量和限制。 详细了解集成帐户层、限制和定价。

  • 标准工作流：

    • Node.js 版本 16.x.x
    • 不需要集成帐户

添加“执行 JavaScript 代码”操作

使用 workflowContext 对象引用触发器和操作输出

从设计器上的代码片段内部，可以使用动态内容列表选择可引用触发器或任何上述操作的输出的令牌。 选择令牌时，“执行 JavaScript 代码”操作会将该令牌解析为只读的 workflowContext JSON 对象。 此对象使代码能够访问触发器、前面任何操作和工作流的输出。 该对象使用以下结构并包括 actions、trigger 和 workflow 属性，这些属性也是对象：

{
   "workflowContext": {
      "actions": {
         "<action-name-1>": @actions('<action-name-1>'),
         "<action-name-2>": @actions('<action-name-2>')
      },
      "trigger": {
         @trigger()
      },
      "workflow": {
         @workflow()
      }
   }
}

下表包含有关这些属性的详细信息：

在本文的示例中，workflowContext JSON 对象可能具有来自 Outlook 触发器的以下示例属性和值：

{
   "workflowContext": {
      "trigger": {
         "name": "When_a_new_email_arrives",
         "inputs": {
            "host": {
               "connection": {
                  "name": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Web/connections/office365"
               }
            },
            "method": "get",
            "path": "/Mail/OnNewEmail",
            "queries": {
               "includeAttachments": "False"
            }
         },
         "outputs": {
            "headers": {
               "Pragma": "no-cache",
               "Content-Type": "application/json; charset=utf-8",
               "Expires": "-1",
               "Content-Length": "962095"
            },
            "body": {
               "Id": "AAMkADY0NGZhNjdhLTRmZTQtNGFhOC1iYjFlLTk0MjZlZjczMWRhNgBGAAAAAABmZwxUQtCGTqSPpjjMQeD",
               "DateTimeReceived": "2019-03-28T19:42:16+00:00",
               "HasAttachment": false,
               "Subject": "Hello World",
               "BodyPreview": "Hello World",
               "Importance": 1,
               "ConversationId": "AAQkADY0NGZhNjdhLTRmZTQtNGFhOC1iYjFlLTk0MjZlZjczMWRhNgAQ",
               "IsRead": false,
               "IsHtml": true,
               "Body": "Hello World",
               "From": "<sender>@<domain>.com",
               "To": "<recipient-2>@<domain>.com;<recipient-2>@<domain>.com",
               "Cc": null,
               "Bcc": null,
               "Attachments": []
            }
         },
         "startTime": "2019-05-03T14:30:45.971564Z",
         "endTime": "2019-05-03T14:30:50.1746874Z",
         "scheduledTime": "2019-05-03T14:30:45.8778117Z",
         "trackingId": "1cd5ffbd-f989-4df5-a96a-6e9ce31d03c5",
         "clientTrackingId": "08586447130394969981639729333CU06",
         "originHistoryName": "08586447130394969981639729333CU06",
         "code": "OK",
         "status": "Succeeded"
      },
      "workflow": {
         "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Logic/workflows/<logic-app-workflow-name>",
         "name": "<logic-app-workflow-name>",
         "type": "Microsoft.Logic/workflows",
         "location": "<Azure-region>",
         "run": {
            "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Logic/workflows/<logic-app-workflow-name>/runs/08586453954668694173655267965CU00",
            "name": "08586453954668694173655267965CU00",
            "type": "Microsoft.Logic/workflows/runs"
         }
      }
   }
}

将依赖项作为参数添加到“执行 JavaScript 代码”操作

在某些方案中，可能需要明确要求“执行 JavaScript 代码”操作包括来自触发器的输出或被代码引用为依赖项的操作。 例如，当代码引用工作流运行时不可用的输出时，必须执行此额外步骤。 在工作流创建期间，Azure 逻辑应用引擎会分析代码片段，以确定代码是否引用任何触发器或操作输出。 如果存在这些引用，引擎会自动包括这些输出。 在工作流运行时，如果在 workflowContext 对象中找不到引用的触发器或操作输出，引擎将生成错误。 若要解决此错误，需要将该触发器或操作添加为“执行 JavaScript 代码”操作的显式依赖项。 另一种需要执行此步骤的方案是 workflowContext 对象引用使用点运算符 (.) 的触发器或操作名称。

若要将触发器或操作添加为依赖项，可以添加适用于“执行 JavaScript 代码”操作的 Trigger 或 Actions 参数。 然后，添加触发器或操作名称，因为它们会显示在工作流的基础 JSON 定义中。

例如，假设 Office 365 Outlook 连接器的“发送审批电子邮件”操作位于示例工作流中的代码片段之前。 以下示例代码片段包含对此操作的 SelectedOption 输出的引用。

对于此示例，必须只添加 Actions 参数，然后将操作的 JSON 名称 Send_approval_email 添加到参数。 这样一来，你就指定了“执行 JavaScript 代码”操作显式包含“发送审批电子邮件”操作的输出。

查找触发器或操作的 JSON 名称

在开始之前，需要基础工作流定义中的触发器或操作的 JSON 名称。

• 工作流定义中的名称使用下划线（_），而不是空格。

• 如果动作名称使用点运算符（.），请包括该运算符，例如：

  My.Action.Name

1. 在工作流菜单上的 “工具”下，选择“ 代码 ”以查看工作流的 JSON 定义。 在 actions 对象中，查找操作的名称。

   例如，Send_approval_email 是“发送审批电子邮件”操作的 JSON 名称。

   

2. 若要返回到设计器视图，请在工作流菜单上的 “工具”下选择“ 设计器”。

3. 现在，将 JSON 名称添加到“执行 JavaScript 代码”操作。

将触发器或操作名称添加到“执行 JavaScript 代码”操作

1. 在 “执行 JavaScript 代码 ”作中，打开 “高级参数 ”列表。

2. 根据方案需求，从参数列表中选择以下参数。

   参数	说明
   操作	将上述操作的输出作为依赖项包含在内。 选择此参数时，系统会提示输入要添加的操作。
   触发器	将触发器的输出作为依赖项包含在内。 选择此参数时，系统会提示是否要包含触发器结果。 所以在“触发器”列表中选择“是”。

3. 在此示例中，选择 Actions 参数。

   

4. 在“操作项 - 1”框中，输入操作的 JSON 名称。

   

5. 若要添加另一个操作名，请选择“添加新项”。

6. 完成后，保存工作流。

操作参考

有关“执行 JavaScript 代码”操作在使用工作流定义语言的基础工作流定义中的结构和语法的详细信息，请参阅此操作的参考部分。

相关内容

• 适用于 Azure 逻辑应用的托管连接器
• Azure 逻辑应用的内置连接器