查看 Application Integration 支持的连接器。
While 循环任务
借助 While 循环任务,您可以从当前(主)集成重复调用子集成,直到满足指定条件为止。
API 触发器 ID 和集成名称标识您要运行的子集成。
该任务还可让您从每个子集成运行中收集响应,并将值存储在当前集成中,以便在下游任务中使用。您可以使用以下任一方法收集响应:
- 整理数组变量中每次运行的响应,其中数组的每个元素都有一次特定运行的响应。如需整理响应,请配置
Collect values from sub-integration output(s)
属性。 - 将所有运行的响应汇总到一个变量中。如需汇总响应,请配置
Override values from sub-integration output(s)
属性。
准备工作
- 确保您已将用户管理的服务账号关联到您的集成。如果您的集成未配置用户管理的服务账号,则默认情况下使用默认服务账号 (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com
) 进行身份验证。 - 确保您的服务账号具有 Application Integration Invoker IAM 角色。如需了解如何向服务账号授予角色,请参阅管理对服务账号的访问权限。
配置属性
下表介绍了 While 循环任务的配置属性。
属性 | 数据类型 | 说明 |
API Trigger ID
|
字符串 | 要运行的子集成的触发器 ID。
此值可在子集成中的 API 触发器的触发器 ID 字段中找到。 |
Integration name |
字符串 | 要运行的子集成的名称。 |
While loop condition
|
不适用 | 终止循环的条件。子集成会运行,直到满足条件为止。 例如 $loopMetadata.current_iteration_count$< 10 。 |
Map to sub-integration input(s)
|
无 | 从当前集成传递到子集成的值。
此属性的值采用键值对的形式,其中键为当前集成中的变量,值为子集成中的相应输入变量。例如,假设您的主集成具有 |
Collect values from sub-integration output(s)
|
无 | 整理子集成运行的结果。
每次子集成运行时,您都可以将子集成的输出存储在当前集成的数组变量中。 将子集成的输出变量输入要从中收集的子集成输出字段,然后从要收集到的集成变量下拉列表中选择当前集成中的数组变量。数组的每个元素都有一次特定子集成运行的响应。例如,如果数组变量为 |
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、错误消息和变量值)的输出变量。 循环元数据包含变量,其中包括以下输出变量:current_iteration_count 、sub_integration_execution_ids 、failure_location 、current_element 、iteration_element 和 failure_message 。
|
最佳做法
如需了解适用于 While Loop 任务的用量限额,请参阅用量限额。
错误处理策略
任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略,以及了解不同类型的错误处理策略,请参阅错误处理策略。
配额和限制
如需了解配额和限制,请参阅配额和限制。