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

3. 字段属性
本文主要介绍子表单字段的特有属性,通用属性设置可查看:字段属性。
3.1 管理子字段
子字段是指在子表单中添加的字段,一个子表单支持添加多个子字段以构成完整的明细条目。
支持的字段类型:
单行文本、多行文本、数字输入框、日期时间、时间、单选框、复选框、下拉框、下拉复选框、地址、图片、附件、选择数据、关联查询、按钮、手写签名、定位成员单选、成员多选、部门单选、部门多选。
3.1.1 添加子字段
- 属性区添加:选中子表单,在右侧属性区点击「添加子字段」,从下拉菜单中选择目标类型。
- 直接拖拽添加:从左侧字段区将目标字段直接拖入设计区的子表单区域内。


3.1.2 子字段排序、复制与删除
- 排序:在属性区通过拖动子字段后的「排序(⁝ ⁝)」图标,或在设计区选中子字段直接左右拖拽调整顺序。
- 复制:点击子字段后的「复制」图标,系统将复制一个配置相同的字段,并默认添加在原字段之后。
- 删除:点击子字段后的「删除」图标即可移除该字段。

3.1.3 子字段属性配置
点击子字段名称即可进入其字段属性配置页,配置完成后点击上方「完成」返回。
- 必填:填写子表单数据时,该子字段的值在每一行数据中均不能为空。
- 重复值校验:
- 不允许重复值:全局校验,即在全表所有数据中,该子字段的值不允许重复。
- 单条数据内不允许重复值:局部校验,仅在当前子单的多个数据行内校验唯一性(如:一张采购单内严禁出现重复的物料编码)。
配置注意:
- 字段支持范围:目前仅以下子字段支持设置「单条数据内不允许重复值」:单行文本、下拉框、选择数据、成员单选、部门单选。
- 勾选联动逻辑:「单条数据内不允许重复」支持单独勾选;「不允许重复」不可单独勾选;一旦勾选该项,系统将自动同步勾选「单条数据内不允许重复值」。
- 提示文字定制:支持自定义重复值校验的报错提示内容。此提示内容「不允许重复」和「单条数据内不允许重复」通用。

3.1.4 子字段宽度
子字段宽度支持 1/2、标准、2倍、自定义 四种模式,默认宽度为标准(200px),可根据内容长度(如备注类设为2倍,数字设为1/2)灵活调整布局。

3.2 默认值
- 子字段联动:支持针对单个子字段设置独立的数据联动或公式。
- 整体联动:支持根据主表条件,设置子表单整体数据联动,一次性联动填充子表单的多行数据。
- 自定义默认值:点击「设置」,可预设多条子表单数据,成员填写时打开表单即可见。

3.3 子字段显隐规则
子表单支持独立的显隐逻辑,规则仅在子表内部生效。具体设置参考:子表单显隐规则。

3.4 字段权限
字段权限决定了填报时该字段的可见与可编辑性。子表单特有的可编辑权限包括:
- 可新增记录:允许增加新的明细行。
- 可编辑已有记录:允许编辑通过默认值、联动或公式自动填充的已有数据。
- 可删除已有记录:允许删除已存在的明细行。
说明:勾选对应权限后,成员在填写时方可执行复制单条数据、插入行、删除行等操作。

3.5 子表单展示样式
支持通过「子表单展示样式」属性,分别优化电脑端与移动端的视觉体验。
3.5.1 电脑端
支持固定列设置。勾选「固定前」并设置列数,可在横向滚动时锁定核心信息(首列默认为序号)。

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

4. 子表单填写提交
- 新增与粘贴新增:支持单条「新增」或通过「+ 粘贴新增」从 Excel 快捷导入(单次上限 100 行)。
- 复制与插入:点击序号列的「更多(⁝)」图标,可执行复制当前行或在当前行上/下方插入空白行。
- 删除:点击序号列的「删除」按钮即可执行单条删除操作。
- 快速切换:支持通过 Enter(回车键)切换到下一行,Tab 键切换至当前行的下一字段。


5. 注意事项
- 数量限制:单个子表最多添加 200 行子数据。
- 复制规则:复制子表单字段时,将会同步复制子表单内所有子字段的属性配置。
- 冻结说明:关联查询列无法被冻结;选择数据列可被冻结,但其关联的填充字段列不会随之冻结。
6. 效果演示
