“针对每一个循环”任务

通过 For Each 循环任务，您可以从当前（主）集成反复调用子集成。该任务会遍历配置的数组变量，并针对数组中的每个元素调用子集成。子集成的调用次数等于数组变量的大小。

API 触发器 ID 和集成名称标识您要运行的子集成。

该任务还可让您从每个子集成运行中收集响应，并将值存储在当前集成中，以便在下游任务中使用。您可以使用以下任一方法收集响应：

  • 整理数组变量中每次运行的响应，其中数组的每个元素都有一次特定运行的响应。如需整理响应，请配置 Collect values from sub-integration output(s) 属性。
  • 将所有运行的响应汇总到一个变量中。如需汇总响应，请配置 Response parameter override mapping 属性。

准备工作

配置属性

下表介绍了 For Each 循环任务的配置属性。

属性 数据类型 说明
API Trigger ID 字符串 要运行的子集成的触发器 ID。

此值可在子集成中的 API 触发器的触发器 ID 字段中找到。

Integration name 字符串 要运行的子集成的名称。
List to iterate 类型为 Boolean、String、Integer、Double 或 JSON 的数组。 子集成应运行的值列表。为列表中的每个值逐一运行子集成。

您可以通过设置迭代元素子集成映射属性，将迭代值传递给子集成。在此属性中，指定必须将迭代值映射到子集成中的变量。
Iteration element sub-integration mapping 无 必须为其分配当前迭代元素的子集成中的变量。
Map to additional sub-integration input(s) 无 从当前集成传递到子集成的其他值。

此属性的值采用键值对的形式，其中键为当前集成中的变量，值为子集成中的相应输入变量。例如，假设您的主集成具有 productID 变量，并要将此变量映射到 subIntProductID 子集成变量；您可以从要从中映射的集成变量 (Integration variable to map from) 下拉列表中选择 productID，然后在要映射到的子集成输入 (Subintegration input to map to) 下拉列表中选择 subIntProductID。
Collect values from sub-integration output(s) 无 整理子集成运行的结果。

每次子集成运行时，您都可以将子集成的输出存储在当前集成的数组变量中。从要从中收集的子集成输出 (Sub-integration output to collect from) 下拉列表中选择子集成的输出变量，然后从要收集到的集成变量 (Integration variable to collect into) 下拉列表中选择当前集成中的数组变量。数组的每个元素都有一次特定子集成运行的响应。例如，如果数组变量为 resultsArray，则 resultsArray[0] 具有第一次运行的响应，而 resultsArray[1] 具有第二次运行的响应。
Response parameter override mapping 无 读取子集成运行的输出变量，并将其存储在当前集成的变量中。

从要从中映射的子集成输出 (Sub-integration output to map from) 下拉列表中选择子集成的输出变量，然后从要替换的集成变量 (Integration variable to override) 下拉列表中选择当前集成中的相应变量。您可以通过在映射到其他子集成输入 (Map to additional sub-integration input(s)) 属性中映射当前集成中已替换的变量，将其发送到下一次子集成运行。因此，您可以聚合子集成运行的响应。
Loop metadata JSON 数组 包含子集成的执行详情（例如执行期间传递的子集成执行 ID、错误消息和变量值）的输出变量。

最佳做法

如需了解适用于 For Each Loop 任务的用量限额，请参阅用量限额。

错误处理策略

任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略，以及了解不同类型的错误处理策略，请参阅错误处理策略。