更新日期
1. 简介
1.1 功能概述
子表单是嵌套在主表单中的“明细表”,用于处理 单条 主记录下一条或多条的关联数据。它能够实现数据间 1:1 或 1:N 的复杂结构,是构建 ERP、进销存等业务系统的核心组件。
1.2 应用场景
- 人事管理:一名员工关联多条“教育经历”或“工作背景”,通过子表单记录完整的履历信息。
- 采购入库:一张入库单包含多种“物资明细”(名称、规格、数量),通过子表单逐条录入物资信息。
- 财务报销:一份报销申请下涵盖多个不同类别的“费用科目”,通过子表单管理报销明细。
1.3 前提条件
当前用户需具备表单的 编辑权限 ,方可添加和配置子表单字段。
2. 设置入口
操作路径:进入目标表单的「 表单设计 」页面 >> 在左侧字段区找到「 子表单 」字段 >> 拖拽 或 点击 添加至表单设计区 >> 在 右侧属性区 进行配置。

3. 操作指南
3.1 添加子字段
- 属性区添加:选中子表单,在右侧属性区点击「 添加子字段 」,从下拉菜单中选择目标类型。
- 直接拖拽添加:从左侧字段区将目标字段直接 拖入 设计区的 子表单区域 内。

3.2 管理子字段
子字段是指在子表单中添加的字段,一个 子表单支持添加 多个 子字段以构成完整的明细条目。
3.2.1 支持的字段类型
子表单支持以下字段类型:
| 序号 | 字段类型 | 序号 | 字段类型 | 序号 | 字段类型 |
|---|---|---|---|---|---|
| 1 | 单行文本 | 8 | 下拉框 | 15 | 按钮 |
| 2 | 多行文本 | 9 | 下拉复选框 | 16 | 手写签名 |
| 3 | 数字输入框 | 10 | 地址 | 17 | 定位 |
| 4 | 日期时间 | 11 | 图片 | 18 | 成员单选 |
| 5 | 时间 | 12 | 附件 | 19 | 成员多选 |
| 6 | 单选框 | 13 | 选择数据 | 20 | 部门单选 |
| 7 | 复选框 | 14 | 关联查询 | 21 | 部门多选 |
3.2.2 子字段排序、复制与删除
- 排序:在属性区通过拖动子字段后的「 排序(⁝ ⁝) 」图标,或在设计区选中子字段直接 左右拖拽 调整顺序。
- 复制:点击子字段后的「 复制 」图标,系统将复制一个配置相同的字段,并默认添加在原字段之后。
- 删除:点击子字段后的「 删除 」图标即可移除该字段。

3.2.3 子字段属性配置
点击子字段名称即可进入其字段属性配置页,配置完成后点击上方「 完成 」返回。
1) 子字段校验
- 必填校验:在子字段属性中勾选「必填」后,填写子表单数据时,该子字段的值在 每一行数据中均不能为空 。
- 重复值校验:英雄云支持两种 重复值校验 方式:
| 校验方式 | 说明 |
|---|---|
| 不允许重复值 | 全局校验,即在全表所有数据中,该子字段的值不允许重复。 |
| 单条数据内不允许重复值 | 局部校验,仅在当前子表单的多个数据行内校验唯一性(如:一张采购单内严禁出现重复的物料编码)。 |

注意 :
1) 支持范围:目前仅以下子字段支持设置「单条数据内不允许重复值」:单行文本、下拉框、选择数据、成员单选、部门单选。
2) 联动逻辑:「单条数据内不允许重复」支持单独勾选;「不允许重复」不可单独勾选,一旦勾选该项,系统将自动同步勾选「单条数据内不允许重复值」。
3) 提示文字定制:支持自定义重复值校验的报错提示内容,此提示内容「不允许重复」和「单条数据内不允许重复」通用。
2) 子字段宽度
子字段宽度支持以下 四种 模式,默认宽度为标准(200px):
| 宽度模式 | 说明 |
|---|---|
| 1/2 | 宽度为默认的一半,适合数字、短文本等字段。 |
| 标准 | 默认宽度 200px。 |
| 2倍 | 宽度为默认的两倍,适合备注、地址等长文本字段。 |
| 自定义 | 手动输入具体宽度值。 |

3.3 默认值
子表单的默认值支持以下设置方式:
- 整体联动:支持根据主表条件,设置子表单整体数据联动,一次性联动填充子表单的多行数据。

- 自定义默认值:支持为子字段设置固定的默认值。点击「设置」,可预设多条子表单数据,成员填写时打开表单即可见。

注意 :针对子表单字段默认值的设置,除整体数据联动和自定义配置外,还可以为单个子字段 单独设置 数据联动或公式,实现更精细的字段级控制。
3.4 子字段显隐规则
子表单支持独立的 显隐 逻辑,规则仅在 子表内部 生效。具体设置参考:子表单显隐规则。

3.5 字段权限
字段权限决定了填报时该字段的可见与可编辑性。子表单 特有的可编辑权限 包括:
- 可新增记录:允许增加新的明细行。
- 可编辑已有记录:允许编辑通过默认值、联动或公式自动填充的已有数据。
- 可删除已有记录:允许删除已存在的明细行。

注意 :勾选对应权限后,成员在填写时方可执行复制单条数据、插入行、删除行等操作。
3.6 子表单展示样式
支持通过「 子表单展示样式 」属性,分别优化电脑端与移动端的视觉体验。
3.6.1 电脑端
支持 固定列 设置。勾选「 固定前 」并设置 列数,可在横向滚动时 锁定 核心信息(首列默认为序号)。

3.6.2 移动端
移动端支持两种显示形式:
- 纵向平铺显示:默认形式。字段垂直排列,适合移动端逐条录入。
- 横向表格显示:以表格形式呈现。支持「固定前」列数设置,适合多行数据对比。

3.7 子表单填写与提交
3.7.1 新增与粘贴新增
- 新增:点击子表单底部的「新增」按钮,可在当前行后新增一条空白明细行。
- 粘贴新增:点击「+ 粘贴新增」,可从 Excel 或其他表格中复制数据,一次性快速粘贴多行数据。单次上限为 100 行。操作详见:子表单批量新增。

3.7.2 复制与插入行
点击序号列的「 更多(⁝) 」图标,可执行以下操作:
- 复制到 下 x 行:复制当前行的数据,并在当前行的下面 新增 x 行 相同内容。
- 复制到 最后 x 行:复制当前行的数据,并从 最后一行 向上新增 x 行相同内容(包含最后一行)。
- 在 上方 插入 x 行:在当前行的上方插入 x 条 空白 明细行。
- 在 下方 插入 x 行:在当前行的下方插入 x 条 空白 明细行。

3.7.3 删除
点击序号列旁的「 删除 」按钮即可删除 单条 记录。该操作无确认提示,请谨慎执行。

3.7.4 快速切换
在填写子表单时,支持以下键盘快捷操作:
- Enter(回车键):切换到当前行的下一行。
- Tab 键:切换到当前行的下一字段。
4. 效果演示
完成子表单配置后,用户可在填写表单时可获得明细化的数据录入体验。

5. 注意事项
- 子表单字段的「 不允许重复值 」与「 单条数据内不允许重复值 」存在 联动 关系:「不允许重复值」不可单独勾选,勾选后将自动同步勾选「单条数据内不允许重复值」。
- 子表单内的 子字段 不支持作为数据联动的“触发字段”,仅支持作为“ 被联动字段 ”。
- 复制子表单字段时,将会 同步复制 子表单内所有子字段的属性配置。