请参阅 Application Integration 支持的连接器。

使用“For Every Loop”任务调用子集成

本快速入门介绍如何创建使用 For Every Loop 任务来调用子集成的集成。子集成会从主集成中获取输入，并使用“发送电子邮件”任务向收件人发送电子邮件。

创建子集成

在 Google Cloud 控制台中，前往 Application Integration 页面。
转到 Application Integration
在导航菜单中，点击 Integrations（集成）。随即会出现集成列表页面。
点击创建集成。
输入集成名称和说明。
在本快速入门中，输入名称 ForEachSendEmailSubIntegration 和说明 Quickstart sub-integration。
选择集成的区域。
注意：区域下拉列表仅列出您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
点击创建以打开集成编辑器。

在子集成中添加 API 触发器

必须使用触发器来启动构成集成的任务序列。在本快速入门中，您可以使用 API 触发器开始集成。

如需添加和配置 API 触发器，请执行以下步骤：

在集成编辑器中，点击触发器查看可用触发器的列表。
点击 API 触发器元素，并将其放入集成编辑器中。

在子集成中创建输入变量

子集成使用变量来存储从主集成接收的 JSON 格式的详细信息。如需创建新的输入变量，请执行以下步骤：

点击设计器导航栏中的（切换面板）以打开变量窗格。
点击 +创建以创建变量。

在创建变量窗格中，执行以下操作：

a. 名称：输入 order_details。

b. 数据类型：选择 JSON。

c. 点击根据默认值推断。

d. 在默认值中，输入以下 JSON。

  {
    "orderId": "1",
    "customerName": "Harry Ford",
    "emailId": "YOUR_EMAIL_ID",
    "shippingAddress": {
      "city": "New York",
      "country": "USA",
      "zipcode": "103487"
      },
    "items": [{
      "itemid": "111-222-333",
      "itemName": "Smartphone",
      "itemPrice": 999.0,
      "quantity": 1.0
      }, {
      "itemid": "444-555-666",
      "itemName": "Mobile Cover",
      "itemPrice": 49.0,
      "quantity": ""
      }],
    "paymentDetails": {
      "mode": "COD",
      "status": ""
      },
    "expectedDelivery": "15 March 2023"
  }

在此示例 JSON 对象中，将 YOUR_EMAIL_ID 替换为要用于测试集成的电子邮件 ID。

e。点击用作集成的输入。

f. 点击创建。

添加和配置“数据映射”任务

通过数据映射任务，您可以在集成中执行变量赋值，获取和设置 JSON 对象的属性，以及将嵌套的转换函数应用于值。数据映射任务使用的变量可以是集成变量或任务变量。

如需添加和配置“数据映射”任务，请执行以下步骤：

在集成编辑器中，点击 Tasks 以查看可用任务列表。
点击数据映射元素，并将其放入集成编辑器中。
点击集成编辑器中的 Data Mapping 元素，打开任务配置窗格。
点击打开数据映射编辑器。
按如下方式配置“输入”：
1. 在“输入”部分，点击变量或值。
2. 在“变量”中，输入 item，然后选择 order_details.items。
3. 点击保存。
4. 向 order_details.items 添加映射函数。点击 order_details.items 旁边的 + 符号。在函数列表中，向下滚动并选择 FOR_EACH(Any) -> JSON。
5. 输入 FOR_EACH 函数输入参数。点击变量或值，然后选择 ~obj1。
6. 点击保存。
7. 向 obj1 添加映射函数。点击您刚刚添加的 obj1 元素后方括号内的“对于”行中的 +。在函数列表中，向下滚动并选择 GET PROPERTY(String) -> JSON。
8. 点击变量或值，然后在值中输入 itemName。
9. 点击保存。
10. 在“获取媒体资源”后的行中点击 + 添加函数，然后选择 TO_STRING() -> 字符串。
11. 点击最后一行中的 + 添加函数，然后选择 TO_STRING() -> 字符串。
按如下方式配置输出：
1. 创建新的输出变量。在输出部分中，点击创建新文件。
2. 在创建变量窗格中，输入名称 items，保留所有其他字段的默认值，然后点击创建。
验证您的数据映射配置是否与下图类似。
关闭数据映射编辑器以返回到集成编辑器。

添加和配置“发送电子邮件”任务

要添加和配置发送电子邮件任务，以便向各个收件人发送电子邮件，请执行以下步骤。

在集成编辑器中，点击添加任务/触发器。
前往 Tasks，然后点击 Send Email 元素并将其放置在集成编辑器中。
点击集成编辑器中的 Send Email 任务元素，打开任务配置窗格。
设置以下任务输入字段：
1. 收件人：点击变量，然后选择 order_details.emailId。
2. 主题：输入电子邮件的主题。在本快速入门中，请输入 Order delivery notification。
3. 纯文本正文：输入以下文本：
```
Hi $order_details.customerName$! Your order with Order Id: $order_details.orderId$ with items: $items$ has been successfully placed. Expected delivery by: $order_details.expectedDelivery$.
```

连接子集成中的元素

现在，您已在子集成中添加和配置了所需的任务和触发器，请在元素之间添加连接（边缘）。边缘表示从一个元素到下一个元素的控制流。

将 API 触发器元素添加到数据映射元素的边缘。将鼠标悬停在 API 触发器元素上的某个控制点上，然后点击线条并将其拖动到数据映射元素的控制点上。
同样，添加从 Data Mapping 元素到 Send Email 元素的边缘。

测试和发布子集成

如需测试此子集成，请点击集成编辑器工具栏中的 Test，然后点击 Test Integration 对话框中的 Test integration。子集成使用默认值作为输入运行，并向“发送电子邮件”任务中指定的电子邮件地址发送电子邮件。测试完成后，您应该会看到一条成功消息。
如需发布此子集成，请点击集成编辑器工具栏中的发布。

创建主集成

在导航菜单中，点击 Integrations（集成）以返回到 Integrations（集成）页面。
点击创建集成。
输入集成名称和（可选）说明。在本快速入门中，输入名称 ForEachSendEmail 和说明 Quickstart main integration。
从支持的区域列表中选择集成的区域。请确保在子集成所在的区域中创建主集成。
点击创建。

在主集成中添加 API 触发器

在集成编辑器中，点击触发器查看可用任务和触发器的列表。
点击 API 触发器元素，并将其放入集成编辑器中。

在主集成中创建输入变量

在主集成中，输入变量用于存储通过 For Every Loop 传递给子集成的数据。您可以立即创建此变量，也可以在下一步添加和配置“For Every Loop”任务时创建此变量。在本快速入门中，请立即创建变量。

点击设计器导航栏中的（切换面板）以打开变量窗格。

在创建变量窗格中，执行以下操作：

a. 名称：输入 order_requests。

b. 数据类型：选择 JSON。

c. 点击根据默认值推断。

d. 在默认值中，输入以下 JSON：

  [{
    "orderId": "1",
    "customerName": "Harry Ford",
    "emailId": "YOUR_EMAIL_ID",
    "shippingAddress": {
      "city": "New York",
      "country": "USA",
      "zipcode": "103487"
    },
    "items": [{
      "itemid": "111-222-333",
      "itemName": "Smartphone",
      "itemPrice": 999.0,
      "quantity": 1.0
    }, {
      "itemid": "444-555-666",
      "itemName": "Mobile Cover",
      "itemPrice": 49.0,
      "quantity": ""
    }],
    "paymentDetails": {
      "mode": "COD",
      "status": ""
    },
   "expectedDelivery": "15 March 2023"
  }, {
    "orderId": "2",
    "customerName": "Tim Harvey",
    "emailId": "YOUR_EMAIL_ID",
    "shippingAddress": {
      "city": "Los Angeles",
      "country": "USA",
      "zipcode": "210738"
    },
    "items": [{
      "itemid": "222-333-444",
      "itemName": "Laptop",
      "itemPrice": 5999.0,
      "quantity": 1.0
   }],
    "paymentDetails": {
      "mode": "Online Payment",
      "status": "Success"
    },
    "expectedDelivery": "21 Feb 2023"
  }]

在此示例 JSON 对象中，将两个出现的 YOUR_EMAIL_ID 替换为要用于测试集成的电子邮件 ID。

e。点击用作集成的输入。

f. 点击创建。

添加并配置“For Every Loop”任务

在集成编辑器中，点击 Tasks。
点击 For Every Loop 元素并将其放置在集成编辑器中。
点击集成编辑器中的 For Every Loop 任务元素，打开任务配置窗格。
在配置窗格中，执行以下操作：
1. 要迭代的列表：选择您创建的输入变量 order_requests。
2. API 触发器 ID：在子集成中选择 API 触发器。在本快速入门中，请选择 api_trigger/ForEachSendEmailSubIntegration_API_1。
3. Integration name（集成名称）：选择要调用的子集成的名称。在本快速入门中，请选择 ForEachSendEmailSubIntegration。
4. 迭代元素子集成映射：选择 order_details。

连接主集成中的元素

添加从 API 触发器元素到 For Every Loop 元素的边缘。将鼠标悬停在 API 触发器元素上的某个控制点上，然后点击线条并将其拖动到 For 各个循环元素上的控制点上。

测试并发布主集成

最后一个任务是测试并发布主集成。

点击集成编辑器工具栏中的 Test，然后在 Test Integration 对话框中点击 Test integration。测试完成后，您应该会看到一条成功消息。
如需发布此集成，请点击集成编辑器工具栏中的发布。

成功完成后，集成会向“发送电子邮件”任务中指定的电子邮件地址发送电子邮件。在电子邮件客户端中确认收到电子邮件。