更新日期
1. 简介
1.1 功能概述
新增数据节点用于在工作流运行过程中向指定表单 新增单条或多条数据 。该节点支持向 主表 新增记录,也支持向 子表 中新增记录,实现业务流程中的数据自动写入。
1.2 应用场景
- 生成采购订单 :当库存低于安全库存时,系统自动创建补货申请单。
- 记录学员签到 :学员扫码签到时,系统自动在考勤表中添加一条签到记录。
- 创建生产工单 :生产计划确认后,系统自动为每个工序生成对应的工单。
1.3 名词解释
| 名称 | 功能说明 |
|---|---|
| 主表 | 表单中的 主要数据表,用于存储业务记录的核心信息。每个表单对应一个主表,支持新增、更新、删除等操作。 |
| 子表 | 嵌套在主表中的数据表,用于存储与主表记录关联的信息。详见:子表单。 |
| 上游节点 | 在工作流中位于 当前节点之前的节点。上游节点输出的数据(如获取到的记录、表单提交的数据)可作为当前节点的输入来源。 |
| 数据源 | 新增数据时,用于提供待新增数据的 来源。可选择上游节点的输出字段作为数据源。 |
| 必填字段 | 表单中设置为“必填”的字段。在新增记录时,必须为这些字段赋值,否则工作流节点配置无法保存。 |
| 字段填充方式 | 为字段赋值时选择的具体方式。支持值(固定值)、字段(上游节点输出)、公式(计算)、参数(子流程参数)、空值五种方式。 |
1.4 前提条件
使用新增数据节点前,需在应用后台的工作流管理页面中,点击 已有工作流 或点击右上方 「+ 工作流」 按钮 新建工作流,进入编辑页面。
![[触发节点创建图片]](https://oss.yingxiongyun.com/admin-web/help-docs/b9e0a8bf6d73dc6f1f95c4ff3c7041cca2c4347237020258.png)
2. 设置入口
操作路径:进入工作流编辑页面 >> 点击 「+」 按钮 >> 选择 「新增数据」 节点。
![[新增数据节点创建图片]](https://oss.yingxiongyun.com/admin-web/help-docs/b9e0a8bf6d73dc6ffec0fe80e571461f9e23ad9813c9dc46.png)
3. 操作指南
3.1 节点说明
进入工作流编辑页面,点击 「新增数据」 节点,可唤起右侧配置窗口。窗口中包含 节点名称 与 新增方式 两部分。

3.2 节点配置
配置新增数据节点的主要步骤如下:
点击 「在表单中新增数据 >> 选择目标表单(支持搜索)」 >> 选择新增数据条数(单条或多条)>> 点击 「添加字段」 >> 选择字段并配置字段值。

3.2.1 设置新增方式
- 新增主表数据 :选择 「在表单中新增数据」 >> 点击「下拉框」选择目标表单(支持搜索 当前应用 及 跨应用 表单)。
![[选择新增数据表单图片]](https://oss.yingxiongyun.com/admin-web/help-docs/b9e0a8bf6d73dc6fbcfe91b1112f4460a2a0fd7e94f4d1d8.png)
- 新增子表数据 :选择 「在子表单中新增数据」 >> 选择主表记录来源 >> 选择目标子表(在该子表中新增记录)。
![[选择主表和子表图片]](https://oss.yingxiongyun.com/admin-web/help-docs/b9e0a8bf6d73dc6fa068813456484ce7ba6f2717e64e1624.png)
注意: 进行子表新增操作时,需选择一个流程上游节点作为主表记录的来源,用于定位子表所属的主表记录。上游节点中,「获取多条数据」和「新增多条数据」节点不可用。
3.2.2 设置新增数据条数
确定目标表单后,需选择新增 单条数据 或 多条数据 。
![[选择新增数据条数图片]](https://oss.yingxiongyun.com/admin-web/help-docs/b9e0a8bf6d73dc6f9a3c0ddb2d7f4c13bf6ea583cc852805.png)
注意:
1)选择新增多条记录时,数据来源必须是工作流中上游节点的数据。
2) 支持选择的数据源节点包括:「当前发起的表单」、「新增数据」、「获取单条数据」、「获取多条数据」。
3.2.3 设置字段值
字段赋值用于指定新增记录中各字段的具体内容。配置步骤如下:
1)处理必填字段:系统自动列出目标表单中的必填字段 , 为每个必填字段设置值(否则工作流保存时会报错)。
2)添加可选字段:点击 「添加字段」, 从下拉列表中选择需要赋值的字段。
3)选择填充方式:字段值支持以下 五种 填充方式:
4)根据填充方式,为目标字段逐个赋值。
![[字段设置图片]](https://oss.yingxiongyun.com/admin-web/help-docs/b9e0a8bf6d73dc6fe8b09ea9dd564817b5029919c8ff68e4.png)
注意:
1) 选择新增单条数据时,上游节点字段支持来自「当前发起的表单」、「新增数据」、「获取单条数据」、「获取多条数据」等节点。
2) 选择新增多条数据时,只能选择3.2.2数据源节点中选择的同类型表单字段
4. 效果演示
以下示例演示了通过“新增数据”节点自动新增课程表的实际效果:
当“教师开班”表单中新增开班数据后,系统 自动 将该课程信息同步至“开班教室课程信息”表单中。在记录的数据日志中可以看到,该记录是通过 工作流新增 的。

5. 注意事项
- 数据来源限制 :选择新增多条数据时,必须指定上游节点数据作为数据源。
- 必填字段校验 :所有必填字段均需设置赋值,否则节点配置无法保存。
- 子表新增前置条件 :子表新增需确保上游节点提供了正确的主表,否则新增可能会失败。