更新日期
1. 简介
1.1 功能概述
循环容器节点是一个具有 循环执行能力 的 自动化 节点,可针对不同的数据,重复多次执行 同一组操作(即循环体),循环体内可配置具体节点,实现数据的 批量处理。
1.2 应用场景
- 电商订单批量发货:通过循环容器遍历“待发货”订单,对每个订单执行获取发货状态、自动回填发货信息等操作。
- 生产质量批次抽检:批次生产完成后,自动按抽检规则生成抽检样本清单,通过循环容器为每个样本创建检验任务。
- 多级BOM物料计算:在处理复杂产品的物料需求时,通过循环容器逐层展开物料清单,对每个子件自动执行库存查询与需求计算。
1.3 使用说明
- 算力消耗:由于循环容器会不停地循环流程步骤,消耗系统算力,循环执行的次数将计入工作流的执行次数,与主流程的调用次数分开计算并计费,使用循环容器时会额外消耗流程使用次数。
- 循环体限制:单个循环容器内最多可添加 30个 节点。
- 循环次数限制:循环容器有最大循环限制,最多只能执行 200 次。
1.4 前提条件
在应用管理后台的 工作流管理页面 中,点击 已有工作流 或点击右上方「+工作流」按钮 新建工作流,进入工作流编辑界面。

2. 设置入口
操作路径:进入 工作流编辑页面 >> 点击画布中的「+」按钮 >> 选择「循环容器」节点。

3. 操作指南
3.1 节点说明
进入工作流编辑页面,点击「循环容器」节点,可唤起右侧配置窗口。窗口中可配置 循环方式、执行失败处理方式。

3.2 节点配置
3.2.1 设置循环方式
循环容器支持以下两种循环方式:
1)数组循环:对批量数据逐条执行循环操作,引用的数据来自流程 上游节点。

2)指定循环条件:不指定循环数据,在循环容器内使用「条件分支」+「结束循环」节点,按需设置结束循环的条件。当 未设置 循环条件或条件 始终不满足 时,流程将在达到 最大循环次数 后自动结束。

注意 :
1) 数组循环的数据来源为「获取多条数据」或「新增数据(新增多条)」节点,循环将对每条数据逐一执行操作,处理完所有数据后 自动结束循环。
2) 指定循环条件的模式需设置 最大循环次数(上限200次),循环按设定次数执行;若中途满足结束循环条件,可 提前终止。
3.2.2 设置执行失败处理
支持在循环过程执行失败时设置处理方式。可选方式有以下三种:
- 终止流程:立即停止整个工作流。
- 中止循环,执行循环后节点:结束当前循环过程,继续执行该循环容器后续的节点。
- 跳过失败的轮次,进入下一次循环:跳过当前出错的循环轮次,从下一次循环继续执行,直至循环结束。

3.3 循环体配置
3.3.1 在循环容器中添加节点
通过点击循环容器内的「+」号按钮,可以在循环容器内 添加 循环过程中需要执行的节点。循环体内可配置 数据节点、分支节点、消息通知、流程/插件节点等。单个循环容器内最多可添加 30个 节点。

3.3.2 引用本次循环数据
当使用 数组循环模式 时,在循环体中 配置字段或节点 时,可以选择「本次循环数据」来引用当前循环中的 具体数据。

3.3.3 设置结束循环条件
使用 指定循环条件模式 时,在循环体内使用「条件分支」+「结束循环」节点来设置结束循环的条件。操作步骤如下:点击循环体内的「+」按钮 >> 选择「条件分支」节点 >> 设置循环结束条件 >> 在满足条件的分支下添加「结束循环」节点。

注意 :若循环体内未配置条件分支而直接放置结束循环节点,循环将在第一次执行后立即终止,无法继续后续迭代。
4. 效果演示
以下以订单批量出货并自动更新订单状态为示例:
当订单所在批次发货后,通过循环容器遍历该批次的 所有订单,逐一将订单状态更新为“已发货”。当该批次订单全部处理完成后,自动发送消息通知相关人员。

5. 注意事项
- 节点限制:循环容器内不可添加审批节点、抄送节点以及另一个循环容器(不支持嵌套)。
- 节点引用规则:循环体内可使用「本次循环数据」及循环容器前的节点数据;循环容器后的节点无法使用「本次循环数据」以及循环容器内部的节点数据。
- 一个工作流限制:一个工作流中最多只能添加一个循环容器节点。