更新日期
1. 简介
1.1 功能概念
循环容器用于对多条数据批量执行相同操作。用户可以在循环容器内设置需要重复执行的步骤(循环体),系统会自动为每一条数据执行这些操作。
1.2 主要应用场景
- 电商订单批量发货:通过循环容器遍历“待发货”订单,为每个订单执行获取发货状态、自动回填发货信息等;
- 生产质量批次抽检:批次生产完成后,自动按抽检规则生成抽检样本清单,通过循环容器为每个样本创建检验任务;
- 多级BOM物料计算:在处理复杂产品的物料需求时,通过循环容器逐层展开物料清单,对每个子件自动执行库存查询与需求计算。
2. 设置步骤
2.1 设置入口
进入应用的管理后台,创建工作流后,可添加「循环容器」节点。
2.2 设置循环容器节点
2.2.1 添加节点
在工作流设计页面可添加「循环容器」节点。
注意: 一个工作流只可添加一个「循环容器」节点。

2.2.2 设置循环方式
方式一:数组循环,对节点内数据逐条执行循环
- 何时使用:已有明确的数据列表需要处理时
- 数据来源:循环容器节点前有输出多条数据的节点,如新增数据(多条)、获取多条数据
- 循环形式:新增/获取多条数据,然后对每条数据逐一执行循环操作
- 结束条件:执行完所有数据后,自动结束循环

方案二:不指定循环数据,在循环容器中设置“结束循环”条件
- 何时使用:循环次数不确定或需要动态控制时
- 具体设置:不指定循环数据,使用「条件分支」+「结束循环」节点,按需设置什么情况结束循环,需设置“最大循环次数”(上限200次)
- 循环形式:先进入循环,然后获取数据并对其执行操作
- 结束循环:满足「结束循环」条件或达到最大循环次数,结束循环

2.2.3 循环过程执行失败时
循环过程执行失败时,循环容器节点会根据设定好的规则执行:
1)中止流程:立即停止整个工作流;
2)结束循环,执行循环体的节点:结束当前循环,继续执行后续节点;
3)跳过失败的轮次,进入下一次循环:仅跳过当前出错的数据,继续执行下一条数据,直至循环结束。

2.3 设置循环体
在循环容器内添加需要重复执行的节点,比如数据节点、分支节点、消息通知、流程/插件节点。

注意:使用“条件循环”时,必须包含「结束循环」节点。

3. 重要说明
- 容量控制:单个循环容器最多可添加30个节点;
- 节点限制:循环容器内不可添加审批节点、抄送节点,以及另一个循环容器(不支持嵌套);
- 数据使用规则:循环体内可使用「本次循环数据」及容器前的节点数据,容器后的节点无法使用「本次循环数据」。