更新日期

1. 简介

1.1 功能概念

该节点支持根据已有多条数据或指定的循环次数来执行循环流程。用户可以在循环容器内设置需要重复执行的步骤(循环体),系统会自动执行循环操作。

1.2 应用场景

  • 电商订单批量发货:通过循环容器遍历“待发货”订单,为每个订单执行获取发货状态、自动回填发货信息等;
  • 生产质量批次抽检:批次生产完成后,自动按抽检规则生成抽检样本清单,通过循环容器为每个样本创建检验任务;
  • 多级BOM物料计算:在处理复杂产品的物料需求时,通过循环容器逐层展开物料清单,对每个子件自动执行库存查询与需求计算。

1.3 使用说明

  • 算力消耗:由于循环容器会不停地循环流程步骤,消耗系统算力,循环执行的次数将计入工作流的执行次数,与主流程的调用次数分开计算并计费,使用循环容器时会额外消耗流程使用次数。
  • 循环体限制:单个循环容器内最多可添加30个节点。
  • 循环次数限制:循环容器有最大循环限制,最多只能执行200次。

2. 功能说明

2.1 前置事件

在应用管理后台的「工作流」页面中,点击已有工作流或者点击右上方「+工作流」按钮新建工作流,进入工作流编辑界面。
更多操作,详见:工作流  和  触发节点 。

2.2 添加节点

点击节点之间的“+”号,在弹出的菜单中选择「循环容器」节点添加到当前工作流。
点击「循环容器」节点顶部唤起右侧节点配置窗口。

2.3 设置循环方式

2.3.1 数组循环
数组循环,是指对批量数据执行循环操作,引用的是流程历史节点数据。采用这种方式前,需要使用「获取多条数据」、「新增数据」(新增多条)节点获取需要处理的批量数据。特点如下:
  • 循环形式:对每条数据逐一执行循环操作。
  • 数据来源:「获取多条数据」、「新增数据」(新增多条)。
  • 结束条件:执行完所有数据后,自动结束循环。
2.3.2 指定结束循环条件
不指定循环数据,在循环容器中设置“结束循环”条件。在循环容器内使用「条件分支」+「结束循环」节点,按需设置什么情况结束循环。
在此情况下,需要设置“最大循环次数”(上限200次),当未设置或不满足结束循环条件时,流程将在达到‘最大循环次数’后结束。特点如下:
  • 循环形式:依照设定的最大次数执行循环,满足结束循环条件时跳出。
  • 结束循环:满足「结束循环」条件或达到最大循环次数,结束循环。
  • 注意问题:需设置“最大循环次数”(上限200次)。
2.3.3 设置执行失败处理
支持在循环过程执行失败时,设置处理方式。可选方式有三种:
1)中止流程:立即停止整个工作流;
2)中止循环,执行循环后的节点:结束循环过程,继续执行该循环容器后续节点;
3)跳过失败的轮次,进入下一次循环:跳过当前出错的循环轮次,从下一次循环继续执行,直至循环结束。

2.4 设置循环体

2.4.1 在循环容器中添加节点
通过点击循环容器内的「+」号按钮,可以在循环容器内添加循环过程中需要执行的节点。
2.4.2 引用本次循环数据
当使用“数组循环模式”时,在循环体中配置字段或节点时,可以通过选择“本次循环数据”来引用当前循环处理的数据。
2.4.3 设置结束循环条件
使用“指定结束循环条件”模式时,可以在循环体内使用「条件分支」+「结束循环」节点,设置什么情况结束循环。
操作步骤:
  1. 使用「条件分支」设置结束循环需要满足的条件;
  2. 在该条件分支下添加「结束循环」节点。

3. 注意事项

  • 节点限制:循环容器内不可添加审批节点、抄送节点,以及另一个循环容器(不支持嵌套);
  • 节点引用规则:循环体内可使用「本次循环数据」及容器前的节点数据,容器后的节点无法使用「本次循环数据」以及容器中的节点;
  • 数据使用限制:循环容器有最大循环限制,最多只能执行200次,且每次循环都会消耗企业工作流的使用次数。