循环节点
循环节点提供了循环执行节点的能力,可在循环体内配置需要循环的节点,用户可以通过在循环体内编排节点多次执行处理任务。
循环是一种常见的控制机制,用于重复执行一系列任务,直到满足某个条件为止。工作流提供循环节点,当需要重复执行一些操作,或循环处理一组数据时,可以使用循环节点实现。
循环节点为可选节点,若无需配置,可跳过该步骤。
循环节点配置步骤如下:
- 拖动左侧“循环”节点至画布中,拖动其他需要循环执行的节点到循环体画布内部并编排(循环内执行需从循环输入节点开始,输出连接到循环输出节点,暂不支持交互式节点)。
- 参照表1,完成循环节点的配置。
表1 循环节点配置说明 配置类型
参数名称
参数说明
循环类型配置
使用数组循环
使用数组循环类似编程语言中的 for 语法结构。遍历循环用于遍历一个已知的序列,对序列中的每个元素执行一系列相同的步骤。
使用数组循环时,需要指定 arr_loop_var 的值,此参数仅支持引用上游节点的输出,且必须为数组格式。使用数组循环模式下执行循环节点时,循环的次数取决于循环数组引用的数组长度。
使用数组循环时,循环节点会遍历数组中的每个元素,每次循环都会将当前循环到的元素赋值给内置变量。内置变量仅限循环节点内部使用。目前支持的内置变量如下:
- item:数组元素,即当前循环到的数组元素。
- index:数组索引,index+1 为当前循环的轮次。
指定循环次数
指定循环次数模式通常用于批量、顺序处理数据的场景,需要同时设置循环次数。
循环次数默认为 5 次,支持设置为 1~1000 次。
使用参考:
回合制游戏,3局2胜可将循环次数设置为3。
网络爬虫爬取前1000个商品信息,循环次数设置为1000。
变量配置
循环数组
此参数只有在使用数组循环时支持配置,名称固定为 arr_loop_var,仅支持引用上游节点输出。
中间变量
循环节点支持设置中间变量,此变量可作用于每一次循环。中间变量通常和循环体中的设置变量节点搭配使用,在每次循环结束后为中间变量设置一个新的值,并在下次循环中使用新值。
输出参数
循环节点的输出参数可设置为循环体的执行结果集合,表示当数组中所有元素运行完毕之后,将所有循环的运行结果打包输出给下游。也支持设置为中间变量的取值。
终止条件
表达式
分支由[判断参数 比较条件 比较参数]组成一个条件表达式。
- 判断参数:条件表达式上半部分,需要选择来自前序节点的输出参数。
- 比较条件:条件表达式左侧,当前支持的比较条件有:长度大于、长度大于等于、长度小于、长度小于等于、等于、不等于、包含、不包含、为空、不为空。针对不同的判断参数类型,前端将展示不同的比较条件。
- 比较参数:条件表达式下半部分,支持“引用”和“输入”两种类型。
- 引用:支持用户选择工作流中已包含的前置节点输出变量值及全局配置中的记忆变量。
- 输入:支持用户自定义取值。
- 添加条件:单击“+”,在当前条件分支中添加多个条件表达式,多个条件表达式之间通过“且”或“或”来连接。
- 单击“且”或“或”,可以切换该分支表达式的运算逻辑。
图1 循环节点配置示例 - 节点配置完成后,单击“确定”。
- 连接循环节点和其他节点。