表单元素的四层分类：主表、从表、附件与扩展控件

表单元素怎么分，决定了设计器面板怎么摆、元数据怎么存、运行时怎么渲染。按数据载体切，一共四层。

表单元素的四层分类：主表、从表、附件与扩展控件

一、概述

表单的本质是两件事：展示数据与采集数据。 这两件事决定底层逻辑；元素怎么分类，则决定设计器面板怎么摆、元数据怎么存、运行时怎么渲染。

该平台把一张低代码表单上的「可设计元素」按数据载体分成四层：

与《表单三要素》的关系：三要素讲控件 · 数据 · 逻辑；本文讲主表 · 从表 · 附件 · 扩展——同一车厢的两种切片。逻辑类（级联、Pop、AutoFull）不另开一章，它们挂在字段上的 Sys_MapExt 里，见三要素文档。

运行时主链（经典表单）：FrmGener → FrmFool* → MapAttrForm → OneMapAttr；从表走 DtlComponent / DtlCard；附件块走 Ath.vue。

二、主表数据

主表数据 = 主表物理行上的一列列字段。 每列是 Sys_MapAttr 一行，由三个维度共同描述（详见三要素文档）：

2.1 分类（对应设计器「基础字段」）

大纲里的「文本框、下拉框、单选、选择框」，在代码里展开为：

创建实现：CreateFieldFunctions.ts 中 createBasicTextField / createBasicDateField / createBasicBooleanField 等 → INSERT Sys_MapAttr。 渲染：FrmEnd.useKeyOfEnType() 综合 MyDataType + UIContralType + mapExts 决定模板分支，再由 OneMapAttr.vue 画出具体控件。

2.2 实现要点

1. 同一个 TB，配不同 MyDataType，就是不同输入体验（日期控件 ≠ 另起一种 UIContralType）。
2. 下拉 / 单选 / 多选的数据来源不在控件枚举里，而在 LGType + UIBindKey（枚举进 Sys_Enum*，外键进 Sys_SFTable）。
3. 组合字段 / Pop / 文本补全会出现在「实体单据引用」面板，但落库仍是主表文本字段 + Sys_MapExt——属于主表字段的行为增强，不是第四种主表数据类型。

2.3 主表小结

三、从表数据

从表 = 挂在主表下的多行明细。 元数据：Sys_MapDtl（FK_MapData→主表，PTable→明细物理表）；列定义仍是 Sys_MapAttr，只是 FK_MapData 等于从表 No。 布局上通过 Sys_GroupField.CtrlType='Dtl' 占一块区域。 行键：OID + RefPK → 主表主键（流程里常为 WorkID）。

设计器：「附件/从表」→ 从表(子表) → createSlavaTable。

3.1 展示模式：ListShowModel（GPE_ListShowModel）

从表不只是「一张普通表格」。产品按 MapDtl.ListShowModel 分成三组：

（1）常规模式

另有 EditModel：0 表格内编辑 / 1 经典表单卡片编辑——管的是「怎么改行」，与「怎么列出来」正交。

（2）报表模式（交叉采集 / 展现）

适用：按「年级 × 政治面貌」、多维指标矩阵等做采集或展示；存储仍是扁平从表行（维度字段 + 数值），交叉是展现算法。

（3）固定行表格

3.2 实现要点

1. 从表是容器，不是 UIContralType；容器里的每一列才是控件。
2. 运行时：DtlComponent.vue → 表格 Dtl.vue 或卡片 DtlCard.vue；卡片/单元格内字段仍走 OneMapAttr。
3. 复杂计算装不下时用 自定义 URL，但不要另起一套存储——继续写当前 MapDtl.PTable。
4. VSTO 场景另有 VSTOEditModel（Excel 侧编辑从表），与 Web ListShowModel 并列，不互相替代。

3.3 从表小结

四、附件

附件解决的是：非结构化文件如何挂到表单实例上。 配置在 Sys_FrmAttachment；文件行在 Sys_FrmAttachmentDB（RefPKVal 挂主表/从表主键）。

4.1 上传类型：AttachmentUploadType（EnumAth.cs）

文案对照：FrmAttachmentExt.UploadTypeT —— Multi→「多附件」，Single→「单附件」。设计器面板用「字段附件 / 表格附件」更贴实现。

4.2 图片附件

• 设计器：「图片」→ createImgAth
• 控件：UIContralType=FrmImgAth(12)，可配 PicUploadType（相册或仅拍照等）
• 与普通 Ath 分流：偏图片预览与移动端拍照，仍落附件库体系

另有 写字板（HandWriting=8）在附录分组里，本质是手写图像类附件扩展，见下一节。

4.3 实现要点

API 侧：CCFormAPI.CreateOrSaveAthMulti / 单附件创建路径分别写 UploadType=Multi/Single。

4.4 附件小结

五、字段扩展控件

扩展控件 = 仍是主表（或从表）上的 MapAttr 字段，但 UIContralType 不再是普通 TB/DDL，而是专用组件。 设计器创建函数集中在 CreateFieldFunctions / EditPageMap；运行时由 OneMapAttr 的 isScore / isSignCheck / isGovDocFile 等分支接管。

5.1 常见扩展清单（按代码补全）

评分、签批等在 EditPageMap 里各自打开专用属性页（如 ExtScore、SignCheck），不要用普通文本框属性页硬改。

5.2 与「逻辑扩展」的边界

Pop、文本自动完成在设计器「实体单据引用」里，实现上仍是文本字段 + MapExt，归入逻辑，不归入本节「换控件」。

5.3 扩展小结

先问：是换一种录入/展示组件，还是给现有组件加联动？ 前者 → 扩展控件；后者 → MapExt（见《表单三要素》业务逻辑章）。

六、四层如何拼成一张单

以「请假 + 行程 + 证明」为例：

换检验检测、合同申报，只是从表改成二维矩阵、附件改成报告 PDF、扩展改成评分——四层骨架不变。

七、小结

1. 主表数据：基础字段面板；UIContralType × MyDataType × LGType。
2. 从表数据：MapDtl + ListShowModel（通用表 / 卡片 / 2 维 / 3 维 / 损益…）。
3. 附件：字段附件（Single）vs 表格附件（Multi）vs 图片附件；文件在 FrmAttachmentDB。
4. 字段扩展控件：高编号 UIContralType 专用组件；与 MapExt 逻辑扩展分工明确。
5. 设计器换车间（经典/章节/VSTO），元素分类与 Sys_ 落点共用*。

延伸阅读

• 《表单三要素：控件、数据与业务逻辑》：级联 / AutoFull / Pop 等逻辑类怎么挂。
• 《表单引擎在应用系统中的位置与作用》：流程 / 实体 / 单据 / 活动四种宿主角色。
• 《五类表单设计器》：请假 / 公文 / 合同 / 检验检测选哪种车间。

本文依据当前仓库傻瓜设计器与 数据引擎 静态整理；面板文案以你部署的版本为准。