Skip to content

数据节点

数据节点是处理表单数据记录的相关节点,可以实现向表单写入记录,更新记录,查询记录,删除记录等操作

1.新增记录

节点功能:向目标表单写入单条或多条记录


选择表单

选择新增记录保存的目标表单


选择数量

选择新增单条或多条记录


发生错误时

默认当新增记录节点发生错误时,将中断所在分支执行。如果需要忽略错误并继续执行,则可以启用选项忽略错误并继续执行后续节点

提示

新增记录最常见的错误是唯一字段重复,即:新创建的记录与表单内已有的记录重复


新增字段

设置目标表单中新增记录的字段值,字段值的来源如下

  • 自定义:由用户手动设置字段值
  • 流程数据:选择流程中其他节点的数据作为字段值
  • 数据字典:使用数据字典中已定义的字典项作为字段值
  • 空值:字段值为空,等价于不设置字段值

注意

当选择了保存多条,并且字段值的来源为流程数据,并且选择的其他节点的数据包含多条记录,则将自动创建并保存多条记录


节点数据

新增记录节点上存放新增记录的数据


注意事项

  1. 暂不支持自动执行表单控件的计算公式,最终的记录数据就是新增字段包含的字段数据
  2. 设置子表字段值时,若数据来源是 流程数据 ,则子表字段的来源必须完全一致。例如:都是客户表成交记录

2.更新记录

节点功能:更新目标表单中筛选范围内记录的数据


选择表单

选择更新记录所在的目标表单


更新配置

  • 更新单条/多条:选择更新目标表单中单条或多条记录
  • 当没有匹配的记录时,在表单中创建新的记录

提示

默认情况下,如果筛选条件没有匹配到记录则不会执行任何操作。如果需要当没有匹配记录时,自动创建记录,则启用此选项(仅更新单条时有效)

自动创建的记录,将包含更新字段所有的字段值,以及筛选条件中的筛选字段

  • 不刷新记录更新时间

提示

默认情况下,更新记录节点会刷新记录的更新时间为当前时间。如果不希望刷新更新时间则启用此选项

注意

系统以更新时间保护记录在多人同时操作下的数据安全。如果更新时间被刷新为最新时间,则所有正在编辑此记录的操作都会失败

例如:张三正在修改客户表某位客户的基础信息,在他的修改过程中,李四也修改了相同客户的基础信息并保存,这时张三点击保存时就会提示当前记录已被他人或工作流修改,请重新打开记录后编辑(原因:李四修改后记录的更新时间被刷新为当前时间,张三保存时系统检测到更新时间不一致则会提示错误)

  • 不生成数据更新日志

提示

默认情况下,任何字段的更新操作都会保存于记录的数据日志中。如果不希望保存此次更新的日志,则启用此选项

某些情况下,如果某个字段被频繁变更,那么会生成大量数据日志,当这个更新信息不重要时,可以启用此选项

  • 筛选条件:筛选出满足条件的记录,用于执行后续更新操作

使用触发节点的记录ID

当,仅使用匹配条件 记录ID 等于 流程数据 触发节点/记录ID 更新时,弹窗中左下方会出现下图提示:

默认是自动更新来自 触发节点 的数据,后续工作流节点便能从 触发节点 获取到更新后的数据。
若勾选 不同步更新触发节点数据 ,则后续工作流节点只能从 触发节点 获取更新前的数据


发生错误时

默认当更新记录节点发生错误时,将中断所在分支执行。如果需要忽略错误并继续执行,则可以启用选项忽略错误并继续执行后续节点

提示

更新记录最常见的错误是唯一字段重复,即:更新后的记录数据与其他记录重复


合并子表

默认情况下,子表数据会被拆分为多个记录,若希望将子表所有记录整合为一个值填充至控件中,则设置此项

注意:生效范围

目前仅对 图片附件 控件生效!!!


更新字段

更新目标表单指定范围内记录的字段值,字段值的来源如下

  • 自定义:由用户手动设置字段值
  • 流程数据:选择流程中其他节点的数据作为字段值
  • 数据字典:使用数据字典中已定义的字典项作为字段值
  • 空值:字段值为空,等价于不设置字段值

注意

某些更新字段存在特殊的更新方式,以下详细介绍

  • 数值
数值字段可以选择额外的更新方式:增加数值、减少数值

增加数值:增加指定的数值
减少数值:减少指定的数值
  • 关联记录

关联记录字段中保存的是多个记录ID点击查看系统字段说明

关联记录字段可以选择额外的更新方式:增加关联记录、删除关联记录

增加关联记录:增加指定的关联记录
删除关联记录:删除指定的关联记录
  • 子表
子表字段可以选择额外的更新方式:增加子表记录、删除子表记录、更新子表记录

增加子表记录:向子表中添加新的记录。如果新增字段包含了多个值,则会添加多个子表记录
删除子表记录:删除筛选条件范围内的子表记录
更新子表记录:更新满足匹配条件的子表记录

增加子表记录示例

删除子表记录示例

更新子表记录示例

  • 成员多选
成员多选字段可以选择额外的更新方式:增减成员、减少成员

增加成员:增加指定的成员
删除成员:减少指定的成员
  • 部门多选
部门多选字段可以选择额外的更新方式:增减部门、减少部门

增加部门:增加指定的部门
删除部门:减少指定的部门

3.查询记录

节点功能:查询目标表单中筛选范围内的单条/多条记录


选择表单

选择查询记录所在的目标表单


查询条件

设置记录查询条件,返回条件范围的记录

注意

如果查询字段包含了子表字段,默认将返回子表字段所有的记录。如果需要仅返回查询条件范围内的子表记录,启用选项仅返回匹配的子表记录

示例

查询客户表成交金额大于一万的成交记录,启用选项后,将只返回成交金额大于一万的成交记录


查询数量

  • 查询单条:返回查询条件范围内的第一条记录
  • 查询多条:返回查询条件范围内的所有记录

查询多条说明

单次最大查询一万条记录,如果查询数量超过限制需要分页查询记录,则可以设置:查询开始位置查询记录数量

查询开始位置:查询的第一条记录在表单中的位置
查询记录数量:当前需要查询记录的数量

示例1:
客户表包含15000条记录
第1次查询:查询开始位置等于0,查询记录数量等于10000,将查询到前10000条记录
第2次查询:查询开始位置等于10000,查询记录数量等于5000,将查询到后5000条记录

示例2:
客户表包含100条记录,webhook每次需要分页获取10条记录
第1次查询:查询开始位置等于0,查询记录数量等于10,将查询到前10条记录
第2次查询:查询开始位置等于10,查询记录数量等于10,将查询到前10条记录后面10条记录
第3次查询:查询开始位置等于20,查询记录数量等于10,将查询到前20条记录后面10条记录
...
第10次查询:查询开始位置等于90,查询记录数量等于10,将查询到最后10条记录


查询字段

选择目标表单中需要查询的字段,这些字段数据将保存于节点上供后续节点使用


排序规则

设置查询记录的排序规则,记录将按指定规则排序后返回


未获取到数据时

默认情况下,如果没有查询到记录,会继续执行后续节点(当前节点数据为空)。如果需要中断流程,则启用选项终止当前所在分支或主流程执行

4.删除记录

节点功能:删除目标表单中筛选范围内的所有记录

特别说明

通过工作流删除的记录,不会进入回收站,一旦删除无法恢复!


选择表单

选择删除记录所在的目标表单


删除条件

设置记录删除条件,删除条件范围内的记录。默认删除单条,如果需要删除全部记录,则启用选项删除多条

5.数据统计

节点功能:统计指定表单中的数据

提示

数据统计的节点功能与页面图表汇总统计功能一致,均是统计指定维度下指定指标的数值


选择表单

选择统计记录所在的目标表单


过滤条件

设置过滤条件,统计条件范围内的记录

注意

如果筛选字段包含了子表中的字段,将仅返回查询条件范围内的子表记录

例如:查询客户表成交金额大于一万的成交记录,将只返回成交金额大于一万的成交记录


统计维度

当字段作为维度使用时,会将目标数据源中的记录划分为多组子记录。维度越多或者字段值越多,则划分的粒度越细

特别说明

当使用了单选多选级选字段作为维度时,会舍弃选项id,仅保留选项值。即:单选多选级选会被转为文本

以下为特定字段类型的维度配置项

  • 汇总方式:设置日期按指定精度进行汇总
  • 显示完整路径:默认级选仅显示最后一级路径,如果需要显示完整的路径则启用此选项

计算字段

计算字段用于将基础字段进行公式计算,然后将计算结果作为指标进行统计

提示

节点计算字段与图表计算字段配置完全一致


统计指标

当字段作为指标使用时,指标会在维度划分的多组子记录中分别计算对应指标的值。指标的计算结果为数值类型

注意

当使用数值字段作为指标时,可以设置指标的计算方式。以下为所有的计算方式

  • 求和:计算对应维度下,字段值之和
  • 平均值:计算对应维度下,字段值的平均值
  • 最小值:计算对应维度下,字段值的最小值
  • 最大值:计算对应维度下,字段值的最大值
  • 全部计数:计算对应维度下,全部字段值的数量
  • 去重计数:计算对应维度下,不重复的字段值的数量

当使用非数值字段作为指标时,仅可以设置为全部计数去重计数两种计算方式

注意

当选择包含多个值的字段作为指标时,会首先计算多个值的数量,然后再将这些数量相加

例如:当使用子表作为指标,并设置计算方式为全部计数,则会计算子表所有记录的数量