自定义按钮新增关联子表数据

1. 简介

1.1 功能简介

自定义按钮新增数据时，可以将「当前表单中关联子表的字段值」同步新增到「目标表单的关联子表字段」中，即同时新增数据至目标表单和关联子表字段对应的关联表中。能够有效避免重复录入，显著提升数据填报效率。

注：新增数据时，单次最多支持同步新增 500 条关联表数据。

1.2 应用场景

该功能常用于明细数据的跨表同步，能够实现类似于原先子表单整体联动的效果，例如：

订单管理中，业务员可在「订单表」内通过按钮快速发起出库操作，将订单明细（如商品名称、数量等）同步到出库明细中，仅需填写出库数量，即可完成出库申请，大大节省时间和精力；
生产管理中，生产人员可在「生产计划表」中通过按钮快速报工，将生产任务明细（如产品规格、计划数量等）同步到报工明细中，仅需填写实际完成数量和报工时间，即可完成报工流程。

1.3 预期效果

1）以订单出库为例，在订单详情中点击「出库」按钮后，系统将会提供「出库表」的数据填报页面。同时，当前订单明细也被自动同步到了出库明细中。

2）填写出库仓库、出库数量并点击「提交」，即可向「出库表」中新增一条出库数据。同时，出库明细数据也被新增到了相应关联表「出库明细表」中。效果如下所示：

2. 设置步骤

2.1 添加按钮

进入需要设置按钮的表单，点击「扩展功能 >> 自定义按钮 >> 新建自定义按钮」，进入自定义按钮设置页面：

2.2 基础设置

根据需求进行以下按钮设置：

按钮样式：设置按钮的名称、风格、颜色及图标；
显示位置：设置按钮在表单中的显示位置，包括：数据详情页、视图数据列表；
可用条件：设置按钮的可用条件，即满足特定条件时按钮才可见或可用。

2.3 执行动作设置

2.3.1 开启一同填报

执行动作设置为「新增数据」，并选择需要新增数据的目标表单。仅在当前表单与目标表单中均存在开启了「随主数据一同填报」的 关联子表 字段时，可见「为一同填报的关联表添加默认数据」选项。

2.3.2 设置字段默认值

勾选「为一同填报的关联表添加默认数据」选项后，按钮在新增数据时，便会将关联子表字段中所填写的内容一同入库到对应的关联表中。

因此，如需提升填报效率，想要把当前数据中的值传递到新增数据中，或是默认填写好新增数据中的部分字段值，可以分别设置新增数据时，主表和关联表字段的默认值。具体如下：

1）主表字段

在「主表字段」内，添加所需字段并设置其默认值，支持设置为字段值、自定义及空值，详情可参见本文第四节。

2）关联表字段

在「关联表字段」内，需进行如下设置：

数据传递规则：选择需要填报的关联子表字段 a（对应关联表为 A），并指定当前表单中的关联子表字段 b（对应关联表为 B）为数据源：

左侧：仅可选到目标表单中开启了「随主数据一同填报」的关联子表字段；
右侧：可选当前表单中的所有关联子表字段；

默认值设置：虽然新增数据时，看起来是数据从字段 b 传递到字段 a 中，但本质上是关联表 B 中的数据新增到了关联表 A 中，因此此处设置的为关联表 A 中字段的默认值，支持设置为字段值、自定义及空值，详情参见本文第四节。

全部设置完成后，点击「保存」。

2.4 保存按钮

保存按钮后，将自动进入使用范围设置，即设置在哪些权限组中可以使用该按钮。勾选需要使用按钮的权限组，点击「完成」即可。

3. 示例

本节示例：订单管理系统中，「订单表」已通过关联子表绑定「订单明细表」且支持一同填报；「出库表」和「出库明细表」同理，且「出库明细表」中还通过关联数据字段关联了「订单明细表」。此时，希望能够在订单表中快速发起出库操作。

注：在学习之前建议安装关联子表应用模板，本文将按照模板中的示例数据进行讲解。

3.1 添加按钮

进入「订单表」，点击「扩展功能 >> 自定义按钮 >> 新建自定义按钮」，进入自定义按钮设置页面：

3.2 基础设置

新建后，需进一步对按钮进行如下基础设置：

设置按钮名称为「订单出库」，并根据偏好设置按钮样式；
选择显示位置为「数据详情页、视图数据列表」；
添加可用条件为：「订单总金额」不为空。

3.3 执行动作设置

执行动作选择「新增数据」后，需进行如下设置：

选择目标表单为「出库表」；
勾选「为一同填报的关联表添加默认数据」；
设置主表字段默认值：「关联订单」设置为「当前数据」；
设置关联表字段默认值：

数据传递规则：设置为「出库明细」的数据来源于「订单明细」；
添加「关联订单明细」、「产品名称」、「产品规格」及「下单数量」字段并分别设置其默认值；

全部设置完成后，点击「保存」。

3.4 保存按钮

保存按钮后，勾选需要使用按钮的权限组，点击「完成」即可。

3.5 效果演示

效果参见【1.3 预期效果】。

4. 注意事项

1）设置默认值时，支持设置为字段值、自定义及空值：

字段值：

设置主表字段默认值时：可以选择当前表单中某个字段的值作为默认值；
设置关联表字段默认值时：可以选择关联表中某个字段的值作为默认值；

自定义值：手动输入一个固定值；
空值：不设置默认值，成员在新增时手动填写。

对于不同类型的字段，可以设置的默认值类型具体如下表所示：

目标表单字段	字段值	自定义	空值
单行文本、下拉框、单选按钮组	单行文本、单选按钮组、下拉框和流水号	✓	✓
多行文本	多行文本	✓	✓
日期时间	日期时间、提交时间、更新时间	✓	✓
地址	地址	✓	✓
定位	定位	x	✓
图片	图片	x	✓
附件	附件	x	✓
成员单选	成员单选、提交人	✓	✓
成员多选	成员多选	✓	✓
部门单选	部门单选	✓	✓
部门多选	部门多选	✓	✓
关联数据	当前数据	x	✓
选择数据	当前数据	x	✓

注：设置关联表字段默认值时，仅可设置「所选数据源背后的关联表」是其主表的关联数据字段。例如，数据源为关联子表 b（背后的关联表为 B），则设置默认值时，仅可从字段列表中选到主表为 B 的关联数据。