修改数据节点

1. 简介

1.1 功能简介

修改数据是指，当「智能助手Pro」执行到该节点时，修改节点所指向的数据或目标表单中满足条件的已有数据；若找不到对应数据，还可直接新增数据。

1.2 应用场景

1.3 预期效果

以学生管理为例，通过「智能助手Pro」实现当「迎新表」中学生的状态被标记为已报到后，同步修改「学籍表」中的学生状态；如果「学籍表」中没有该学生的信息，则新增一条数据。效果如下：

1）「学籍表」中存在对应学生信息，进行修改操作。

2）「学籍表」中无对应学生信息，进行新增操作。

2. 操作步骤

新建 智能助手Pro 后，将自动进入设计画布，配置好 触发节点 后，即可进行后续执行节点的配置。

2.1 添加节点

根据业务需求，在已有节点后添加一个修改数据节点：

2.2 选择修改对象

修改数据节点支持如下 2 种修改对象，且各自适用场景不同：

2.2.1 选择表单修改数据

选择表单修改数据是指，修改目标表单中满足条件的数据，支持选择当前应用以及 跨应用 表单：

2.2.2 选择节点修改数据

选择节点修改数据是指，对节点所指向的数据进行修改操作。支持选择触发节点、查询单条/多条数据节点、新增数据节点。具体实现效果如下：

2.3 筛选出要修改的数据

当修改对象为「选择表单修改数据」时，可以添加过滤条件，仅从目标表单中筛选出符合条件的主数据，用于后续修改（下文会将此处筛选出的待修改数据统称为目标数据）。

过滤条件需要设置的内容及说明如下：

2.4 选择修改方式

通过以下选项，可以确定数据的修改方式：

2.5 设置字段值

2.5.1 修改数据字段值

1）添加修改字段

点击「添加字段」，从目标数据中选取需要修改值的字段并设置其新值（支持修改为：节点字段值、自定义值或空值）。

2）设置匹配关系/修改条件（选做，仅需要在特定场景下进行配置）

当目标数据为多条数据/子表单数据时，「修改数据」节点在执行修改的过程中会遇到一个问题：取到赋值数据源中的一条数据后，它不知道应该去修改哪一条或几条数据。

因此，需设置目标数据和赋值数据源间的 匹配关系/修改条件，确保节点能够找到对应的目标数据并进行修改。

2.5.2 新增数据字段值

若修改方式为「修改或新增数据」，相应地，在字段值设置处将会出现「新增数据」区域，用于设置新增数据时每个字段的值：

3. 注意事项

3.1 通用说明

1）通过修改数据节点修改表单数据时，可以触发数据推送（仅在修改单条数据时触发），不会触发推送提醒。

2）目标表单中的定位、图片、附件字段，只能设置为触发表单字段值或空值，不支持自定义。

3）对子表单字段进行修改赋值时，需要遵循 子表单赋值规则。在赋值过程中，为防止即将选择的字段与已选字段冲突，导致赋值失效，字段选择面板中会自动隐藏冲突字段，仅提供当前配置下不产生冲突的字段供选用。

如需查看所有字段，可将鼠标移动至字段选择面板底部的 上方，并点击「显示所有字段」即可。如下所示：

4）在调用前置节点上的数据，对目标数据进行过滤和赋值时，若所调用的数据不存在，则修改数据节点的执行效果会受到影响，详情参见：执行节点详解。

3.2 修改数量限制

1）修改数据节点每次最多支持修改 200 条数据。在一次修改过程中，若满足修改条件的数据或前置节点指向的数据超过 200 条，则不会执行该次修改操作，并进行报错提示。

2）如下类型的字段值设置，可对多条子表单数据进行修改。当匹配数据时的计算量SUM(目标数据.子表单数据量 * 赋值数据源的数据量 * 匹配条件数) 小于等于 100 万时，可继续进行修改操作，否则会修改失败。

以同步变更入库数据为例，若发起了采购变更申请，对同一商品在多个仓库的采购数量进行变更，则需要同步修改入库单中的多条入库数据，计算量为：sum(1*2*2,2*2*2) = 12：

若因为计算量超出限制而导致修改失败，可以减少匹配条件或修改数据条数。

3.3 字段值说明

字段值可以设置为以下三种：节点字段值、自定义以及空值。

3.3.1 节点字段值

1）支持将「目标表单的字段值」修改为「前置节点字段值」，即将「智能助手Pro」中前置节点上存储的数据应用到目标表单的相应字段上。

2）修改为节点字段值时，支持引用触发节点、新增数据节点、查询单条数据节点、查询多条数据节点、计算节点、插件节点中存储的数据。其中：

3）对于不同类型的目标表单字段，可以设置的前置节点字段类型如下：

4）当目标表单字段与前置节点字段的设置存在以下区别时，将作为特殊情况处理：

3.3.2 自定义

1）支持自定义目标表单的字段值。如下图所示：

2）对于不同类型的目标表单字段，自定义值的设置方法如下：

3.3.3 空值

支持将「目标表单的字段值」修改为「空值」。如下图所示：