While 循环任务

公告：Application Integration 现在可供您的 Google Cloud 项目使用。现在，您可以在同一 Google Cloud 项目中同时使用 Apigee Integration 和 Application Integration 了。了解详情

借助 While 循环任务，您可以从当前（主）集成重复调用子集成，直到满足指定条件为止。

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

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

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

注意：

• While 循环任务最多可运行 8000 次迭代。即使配置的条件导致无限循环，该限制条件仍适用。
• 从每个子集成运行收集的数据的累计大小不能超过 50 MB。如果大小超过 50 MB，则集成将失败，并且下游任务不会运行。

准备工作

• 确保您已将用户管理的服务账号关联到您的集成。如果您的集成未配置用户管理的服务账号，则默认情况下使用默认服务账号 ([e-mail]) 进行身份验证。
• 确保您的服务账号具有 Application Integration Invoker IAM 角色。如需了解如何向服务账号授予角色，请参阅管理对服务账号的访问权限。

配置属性

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

属性	数据类型	说明
API Trigger ID	字符串	要运行的子集成的触发器 ID。 此值可在子集成中的 API 触发器的触发器 ID 字段中找到。
Integration name	字符串	要运行的子集成的名称。
While loop condition	不适用	终止循环的条件。子集成会运行，直到满足条件为止。
Map to sub-integration input(s)	不适用	从当前集成传递到子集成的值。 此属性的值采用键值对的形式，其中键为当前集成中的变量，值为子集成中的相应输入变量。例如，假设您的主集成具有 productID 变量，并要将此变量映射到 subIntProductID 子集成变量；您可以从要从中映射的集成变量 (Integration variable to map from) 下拉列表中选择 productID，然后在要映射到的子集成输入 (Sub-Integration input to map to) 字段中输入 subIntProductID。
Collect values from sub-integration output(s)	不适用	整理子集成运行的结果。 每次子集成运行时，您都可以将子集成的输出存储在当前集成的数组变量中。 将子集成的输出变量输入要从中收集的子集成输出字段，然后从要收集到的集成变量下拉列表中选择当前集成中的数组变量。数组的每个元素都有一次特定子集成运行的响应。例如，如果数组变量为 resultsArray，则 resultsArray[0] 具有第一次运行的响应，而 resultsArray[1] 具有第二次运行的响应。
Override values from sub-integration output(s)	不适用	读取子集成运行的输出变量，并将其存储在当前集成的变量中。 从要从中映射的子集成输出 (Sub-integration output to map from) 下拉列表中选择子集成的输出变量，然后从要替换的集成变量 (Integration variable to override) 下拉列表中选择当前集成中的相应变量。您可以通过在映射到其他子集成输入 (Map to additional sub-integration input(s)) 属性中映射当前集成中已替换的变量，将其发送到下一次子集成运行。因此，您可以聚合子集成运行的响应。
Loop metadata	JSON 数组	包含子集成运行的执行详情（例如执行期间传递的子集成执行 ID、错误消息和变量值）的输出变量。

最佳做法

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

错误处理策略

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