更新日期

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个节点;
  • 节点限制:循环容器内不可添加审批节点、抄送节点,以及另一个循环容器(不支持嵌套);
  • 数据使用规则:循环体内可使用「本次循环数据」及容器前的节点数据,容器后的节点无法使用「本次循环数据」。