更新日期
1. 简介
1.1 功能概述
获取单条数据节点用于从目标表单中 获取单条指定的数据 ,获取到的记录可供当前工作流对该条数据进行更新、删除,或将其内容 填写至其他表单 等后续操作。实现 跨表单 数据的精准引用与 自动化处理。
1.2 应用场景
- 自动更新处理状态 :通过“工单编号”获取当前工单详情,自动将处理状态更新为“已接收”。
- 更新物料库存 :通过“物料编码”获取当前库存数量,将出库后的新库存数量更新至“物料台账”。
- 生成员工考勤记录 :通过获取“员工工号”获取排班信息,将考勤状态记录至“月度考勤表”。
1.3 前提条件
使用获取单条数据节点前,需在应用后台的工作流管理页面中,点击 已有工作流 或点击右上方 「+ 工作流」 按钮 新建工作流,进入编辑页面。

2. 设置入口
操作路径:进入工作流编辑页面 >> 点击 「+」 按钮 >> 选择 「获取单条数据」 节点。

3. 操作指南
3.1 节点说明
进入工作流编辑页面,点击 「获取单条数据」 节点,可唤起节点配置窗口。窗口主要包含 节点名称 与 获取方式 两部分。

3.2 节点配置
3.2.1 设置获取方式
获取方式决定了数据的来源。节点支持以下四种方式:
- 从普通表单中获取 :可浏览 当前应用 及 跨应用 的表单,并支持在文本框中输入关键词搜索表单。

注意: 跨应用获取表单数据时,需当前应用具备相应读取权限,否则获取失败。详情可参考 跨应用 相关文档。
- 从数据节点中获取 :可在下拉框中选择上游节点的数据。该方式仅支持引用 「获取多条数据」 节点,用于从先前获取的多条记录中筛选出所需的单条数据。

注意: 该方式不支持获取 循环容器 内“获取多条数据”节点的数据。
- 从关联表单中获取:依靠表单中的 「选择数据」 字段,获取其指向的表单记录。
配置路径如下:选择 「获取方式 >> 从关联表单中获取」 >> 选择 上游节点 作为被关联表单(含 「选择数据」 字段) >> 选择 「选择数据」 字段作为关联表单。

注意:
1)所选流程节点必须包含「选择数据」字段,否则无法选择。
2)可选上游节点包括「当前发起的表单」、「新增数据」节点(仅限新增单条数据)以及「获取单条数据」节点。
- 从子表中获取数据 :支持获取 子表 中的记录。
配置路径如下:选择 「获取方式 >> 从子表中获取」 >> 选择 上游节点 作为主表单(含「子表单」字段)>> 选择对应的「子表单」字段。

注意:
1)所选流程节点必须包含「子表单」字段,否则无法选择。
2)可选上游节点包括「当前发起的表单」以及「获取单条数据」节点。
3.2.2 设置筛选条件
在节点配置窗口中设置筛选条件,符合条件的记录方能被获取。
1)确定 逻辑关系 :选择同时满足 所有 条件或 任一 条件。
2)添加 筛选字段 :
- 点击 「添加过滤条件」 ,选择表单字段并设置筛选条件。
- 点击 「添加条件组」 ,可添加自定义条件组,实现更灵活的条件判断。
3)设置 匹配规则 :根据业务需求选择匹配规则,例如 等于、不等于、包含、不包含、为空、不为空,或针对集合类的 等于任意一个、不等于任意一个。
4)填充 条件判断值 ,支持以下五种填充方式:
- 值 :填写自定义值,填写方式取决于字段类型。
- 字段 :从上游节点字段中选取。支持包括「表单触发」、「新增数据」、「获取单条数据」、「获取多条数据」等节点,且所选 字段类型 需与当前字段类型一致。
- 公式 :通过公式对工作流中的字段值进行计算。
- 参数 :使用子流程触发节点中配置的参数(仅子流程场景支持)。
- 空值 :直接填充空值。
5)根据填充方式输入 字段值。

注意:
1)日期时间类型的字段在选择匹配规则时,除基础规则外,还可对时间进行动态筛选。
2) 若从上游节点字段中选择的值与当前字段类型不一致,会导致无法赋值。
3) 若未设置筛选条件,系统将按排序规则获取第一条数据,结果可能不符合预期。
3.2.3 设置排序规则
若筛选后仍有多条满足条件的记录,节点将按设置的排序规则获取排序后的 第一条数据 。
配置排序规则的步骤如下:
点击「添加排序规则」按钮 >> 选择「升序」或「降序」>> 拖拽 「排序」字段(靠上者优先级更高) >> 点击「删除」按钮(移除该规则)。

注意: 多条符合条件记录时若未设置排序,获取的第一条数据不可控,建议明确排序字段及顺序。
4. 效果演示
以下是通过「获取单条数据节点」获取员工工作状态的实际效果:
工作人员输入员工基础信息与事项安排后,工作流 自动获取 该表单中员工“工作状态”,并发送通知。

5. 注意事项
- 数据快照不同步 :获取单条数据节点执行后生成数据快照。若源数据后续变更,快照不会自动更新,需重新获取。
- 子表获取注意 :若所选流程节点不包含子表单字段,则无法选择子表获取方式,请确保主表单节点配置正确。