工作流节点--获取多条数据
节点功能: 通过此节点可以获取多行数据(表中的多行记录/或数组中的多行数据),然后可以对这些记录进行批量修改,或者将这些多行数据批量新增到其他表中,也可以传递给子流程依次处理;查询数据时支持仅获取前N行数据或随机获取N行数据。
获取多条数据的7种方式
1、查询并批量更新
从工作表查询多条记录,查询到数据后进行批量更新,最多支持更新1000行。若查询结果超过1000行,按排序只更新前1000行。
更新后,这些数据还可以被后面的节点使用,后面节点使用的内容是查询时的记录以及这些记录更新后的数据。 如果被后面节点使用,这个节点最多支持100行。
2、查询并批量删除
从工作表查询多条记录,查询到数据后批量删除,最多支持删除1000行。若查询结果超过1000行,按排序只删除前1000行。
删除记录时,支持直接彻底删除,不进入回收站。(无法恢复)
3、查询工作表
从工作表中获取多条记录,获取后,可以被后面的节点使用。
如果被新增节点、更新节点、删除节点、代码块节点使用,最多处理100行数据,超过100行将中止流程。
如果传递给子流程,则可处理10000行。
4、获取关联记录
从一条记录中获取他所关联的多条记录,此方式最多获取1000条关联记录,如果需要获取超过1000条的关联记录,请使用“查询工作表”的方式。
5、获取批量新增结果
- 新增记录节点支持批量新增,因此可以再次从批量新增的多条记录中再获取一次多行数据。
6、获取操作明细
- 可以获取某个审批/填写节点的操作数据。 操作人员、时间、意见、签名等。这个方式获取的不是表记录,而是JSON数组,类似的多行数据。
7、获取数组对象
代码块、发送API请求和封装业务流程等节点可以输出一个对象数组,通过此节点可以接收转化为内部多行数据结构。
封装业务流程的输入参数也可能是对象数组,在PBP中通过此节点可以接收转化为内部多行数据结构。
随机获取多条数据
查询数据时可以通过设定排序规则,按顺序返回数据。也可以忽略排序方式,随机排序返回数据。
限制获取的数量
根据排序规则和查询条件,支持仅获取前XX行的记录。
- 被“新增节点”、“更新节点”、“删除节点” 批量操作使用时,最多处理100条(建议设置最多获取100条);超过100条时,请使用子流程处理。
当超过处理上限时,流程将中止,并提示“批数据源数量超过节点处理上限”, 如下图:
获取结果是否保存
在使用此节点的获取结果时,有两种类型:
类型1、直接获取
流程到达此节点时,直接计算,保留计算结果,供后续节点使用。后续所有节点使用的获取结果时一样的。
类型2、每次使用时动态获取
流程到达获取节点时先不执行获取操作,等到执行到后续使用获取结果的节点时重新计算, 不同节点使用的获取结果可能不同。
举例: 如下图的流程配置
如果采用的是类型1,那么流程是正常的,删除后,还可以继续将备份表写入数据。因为获取作废任务数据已经保存了。
如果采用的是类型2,那么删除后,新增节点又重新获取了作废记录,但是已经被删除了,就没有获取到,导致最终不会写入到备份表。
场景举例
《项目》和《任务》是有关联关系的两张表,一个项目可以关联多个任务。当完成项目并将状态标记为“已完成”,批量获取到关联的任务,然后将这些任务也修改为“已完成”。
1、创建工作表事件触发的工作流
工作表选择《项目》表
触发方式选择 “仅更新记录”时触发,指定项目状态为触发字段
筛选条件设置项目状态 =已结束。
- 这样筛选的效果是,仅仅更新项目状态时,且更新的状态为 已结束,才会触发流程,避免浪费资源。
2、添加“获取多条数据”节点
并选择第二个方式:从记录获取关联记录
3、配置“获取多条数据”节点
A:选择节点对象
- 即从哪条记录中获得它关联的记录,这里我们选择的是触发流程的那条记录。
B:选择关联类型的字段
- 选择一个关联表字段,这个关联必须是多条类型的。因为一个表可能关联多个他表字段,所以要选择一个关联字段,我们选择 “任务”这个关联字段
C:筛选条件
- 对所关联的记录进行筛选,只获取需要的记录。例如,项目中关联了3条,但是呢,有的记录已经完成了,那就不需要再获取到了,直接排除即可。
D:排序规则
- 设定一个排序规则,按此规则排序后返回记录列表。
E:限制数量
可以设定最多获取N行数据,N可以是手动写入的固定值,也可以选择一个数值字段。例如查询时,满足条件的记录有200条,但是我们只需删除60条,就可以设定最多获取60条。如果不设定数量,获取批量数据节点最多只能获取到100行,如果传给子流程用,最多获取1万行。
如果被新增记录、更新记录、删除记录、代码块等4个节点使用时,建议设定最多获取100条,避免报错。
如果需要传给子流程,建议设置最多1万条,避免报错。
多条传给封装业务流程
保存节点设置
4、批量更新数据
更新的对象: 选择第2个节点获得的多条记录
更新字段: 选择状态=已完成。
4、发布流程
5、测试
文档问题反馈
文档中是否有错别字、内容过期、难以理解等问题? 点此给我们反馈吧