关联记录控件介绍
概述
在应用里，每张业务表都用来记录一种业务对象的数据（例如客户、联系人、项目、任务等）。在实际业务中，这些对象往往存在“归属 / 对应 / 包含”等关系：一条记录需要关联到另一张表中的某条记录。如果不建立这种关系，就容易出现同一份信息在多处重复填写、维护困难、修改容易漏改等问题。
关联记录控件 就像表与表之间的“连接器”，让当前记录可以选择并关联目标表中的记录。它建立的是引用关系（而不是把信息复制一份到当 前表）：因此既能减少重复录入、保持数据一致，也能在查看数据时快速定位并跳转到关联对象，实现更高效的查询与展示。
以《客户》和《联系人》为例：一个客户通常对应多个联系人，联系人一般归属某个客户公司。使用关联记录后，创建联系人时只需选择对应的客户记录，无需重复录入客户信息；查看联系人时，也可以一键跳转查看所属客户的详细资料。
其他场景:
-
人事管理：在【请假单】中关联【员工】
-
进销存：在【入库单】中关联【供应商】
-
项目管理：在【任务】中关联【项目】
关联效果
-
关联一条他表记录效果（一个联系人只能有一个客户公司）
-
关联多条他表记录效果（一个客户有多个联系人）
快速配置（场景示例：客户表关联联系人表）
1.添加关联控件
2.建立关联关系
选择要关联的目标工作表（示例：联系人表）。若关联其他应用下的表，需要具备目标应用管理员或开发者权限。
重要说明
- 建立关系后，系统赋予“客户记录可关联联系人记录”的能力；
- 两表现有记录不会自动关联（系统无法判断对应关系），需要人工选择或通过工作流规则自动建立关联；
双向关联
两张表各自建立关联字段，关联一方后另一方自动同步显示。适用于两边都需要查看和维护对方关系的场景。
以客户和联系人为例：在客户记录中关联联系人后，该联系人记录里也会自动显示所属客户。
在关联字段配置中，图标 ⇌ 表示双向关联。
如果在两张表中分别新建关联字段，而不是配对为同一段关联，就会形成两段互不相知的独立关系。
典型场景：
- 在客户表新建"关联联系人"字段，选择联系人表，新建关联 → 关联A 建立
- 在联系人表新建"所属客户"字段，选择客户表，又选了新建关联 → 关联B 建立
此时系统里存在两段完全独立的关联：关联A 只属于客户表，关联B 只属于联系人表，两者互不感知。
结果： 在客户"明道科技"里通过关联A 关联了联系人"张三"后：
- 客户"明道科技"的关联字段：显示张三 ✓
- 联系人"张三"的关联字段：空 ✗（关联B 对关联A 的操作一无所知）
正确做法： 第二张表配置关联时，选择已有关联，与第一张表的字段配对，才能形成真正的双向同步。
单向关联
只有一张表建立关联字段，另一张表不感知这段关系。适用于基础数据表被引用、但自身无需反查来源的场景。
例如：库存记录关联产品，但产品记录不需要显示”哪些库存关联了我”。
在关联字段配置中，图标 → 表示单向关联。
如何选择
问自己一个问题：对方表的人需要从对方那边看到这段关系吗？
- 需要 → 双向关联
- 不需要 → 单向关联
能用单向就用单向。双向关联需要在两表之间同步数据，关联量大时会影响写入性能。
配置关联字段属性
基础设置
字段名称
设置关联记录在本表中的显示名称。
关联记录数量
多条： 可关联数量不定（例：一个客户可能有多个联系人）。 在本表（客户表）选择多条。
单条： 最多只关联 1 条（例：一个联系人只能所属一个客户公司）。
一定要选择正确的关联关系，这个对数据加载性能，数据显示方式都有影响。请记住一个准则：能选择单条的，就尽量选择单条处理。
选择和显示方式
-
多条关联：四种方式
- 卡片形式：弹窗选择；已关联记录以卡片逐一展示。
- 下拉框选择：下拉选择并显示，适用于关联项较少且需要快速选择的场景。
- 表格：表格展示多条记录详细信息，便于对比与分析。
- 标签页表格：位于标签页中，适用于需要详细展示与切换场景。
重要提示（性能限制）
- 下拉框方式：最多关联 50 条
- 卡片方式：最多关联 200 条
- 表格 / 标签页表格：不限制关联条数
-
单条关联：两种方式
- 下拉框
- 弹窗 （弹窗方式选择后，以卡片形式显示）
卡片悬浮预览
在视图中查看数据时，若单条为卡片模式或下拉框模式，鼠标悬停支持显示卡片预览。
标题字段
在下拉框和卡片方式下，可指定关联记录显示标题字段（默认使用关联表标题字段）。
效果：
显示字段
选择与呈现记录时，除标题外可展示更多字段，并支持拖拽排序。
-
卡片方式：标题下展示更多字段
-
下拉框方式： 已关联记录下方卡片中显示更多字段
-
下拉列表附加信息： 如果需要在选择记录时下拉菜单中显示更多字段，可以勾选“在下拉列表中显示附加信息和封面”,并设置显示的字段。
-
表格方式
关联选择设置
在“关联选择设置”中配置用户在关联时待选记录的界面。如筛选范围、弹层设置(下拉框设置)、查询方式、显示字段、统计与排序。
若不勾选“允许选择已有记录”，“关联选择设置”按钮隐藏。
过滤选择范围
通过添加筛选条件，缩小可选择记录范围。
筛选方式说明：
-
1.且的方式
条件组合：{条件1：字段A=字段B} 且 {条件2：字段C=字段D}
含义：只有当条件1和条件2同时满足时，记录才会筛选到。
-
2.或的方式：
条件组合：{条件1：字段A=字段B} 或 {条件2：字段C=字段D}
含义：只要条件1或条件2满足其中之一，记录就会筛选到。
动态值为空时的处理方式
当筛选条件使用动态值（例如：条件1为字段A=字段B,条件2 为 字段C = 字段D，而字段D可能为空）时，可选择以下策略：
| 处理策略 | 条件2 在 D 为空时如何处理 | 且/或组合下的直观结果 |
|---|---|---|
| 当前条件无筛选结果 | 视为条件2不成立 | 且：结果为空；或：忽略条件2，仅按其他条件筛选 |
| 忽略此条件（当全部忽略时，返回所有记录） | 丢弃条件2 | 若最终没有任何有效条件（例如其它动态值也为空），则返回所有记录 |
| 忽略此条件（当全部忽略时，返回无结果） | 丢弃条件2 | 若最终没有任何有效条件，则返回无结果 |
| 查询空值 | 将 D 的空值作为条件值 | 等价于筛选 字段C = 空值 |
弹层设置
-
关联样式为【卡片】、【表格形式】时，通过弹层方式选择关联记录。
-
记录显示方式为【表格】时，可设置弹层中的显示字段。
-
记录显示方式为【列表】时，列表仅显示标题字段。
该显示方式下一次性加载记录1000条。
-
-
当关联样式为【下拉框】时，可以配置下拉框中选择记录时显示的字段和封面。
- 允许弹层选择关联记录：在下拉框中点击弹层按钮后可打开表格弹层选择记录。
查询设置
查询设置用于在选择关联记录时快速定位目标记录：
- 搜索字段：默认可搜索所有文本字段；也可指定搜索字段，并配置精确/模糊搜索
- 在搜索后显示可选记录：勾选后，默认不显示列表，只有搜索后才展示可选记录
- 筛选字段：支持配置多个字段进一步缩小范围
用户在操作时的效果
统计
对已经勾选的记录进行数据统计，仅支持显示的字段。
选择记录时的排序
可设置“选择记录时”的查看顺序：
- 与关联记录排序保持一致
- 自定义（最多支持 5 个排序字段）
已关联记录排序
多条关联支持三种排序方式：
- 按添加时间排序（默认）
- 卡片/下拉框：新添加在后；支持拖拽调整顺序
- 表格/标签页表格：不支持按添加时间排序
- 按设置的排序：选择关联表字段升/降序
- 按关联视图的排序：采用关联表视图当前排序规则
卡片/下拉框的排序生效条件
| 排序方式 | 生效条件 | 额外说明 |
|---|---|---|
| 按添加时间排序（可拖拽） | 关联记录 ≤ 50 条 | 超出后仍保留顺序，但不可拖拽调整 |
| 按设置的排序 | 关联记录 ≤ 5 条 | 超过5条后，仅保证前5条的顺序准确。 |
| 按关联视图的排序 | 关联记录 ≤ 5 条 | 超过5条后，仅保证前5条的顺序准确。 |
关联默认值
新建记录时，可以默认关联1条或多条记录，支持三种方式：
-
固定默认值： 每次新增记录时都是关联这几个
-
其他字段值： 自动引用其他关联记录字段所关联的记录（表格样式不支持此赋值方式）
-
查询工作表： （最多500行）
默认值的详情配置方式，请参考
用户操作设置
允许选择已有记录
- 勾选后，可已选择已有记录进行关联，并可点击上方的“关联选择设置”按钮配置待关联记录的样式。
- 不勾选“允许选择已有记录”，关联时“关联已有记录”按钮隐藏。关联字段配置中的“关联选择设置”也会隐藏。
关联记录时的权限范围
选择已有记录时，可选范围：
-
全部记录
-
仅可选择“有查询权限的记录”
并可叠加筛选条件进一步限定范围。
是否允许新建记录
如果不勾选"是否允许新建记录"，新建记录按钮不可见，只能关联已有记录。
是否允许取消现有关联
对于已经关联的记录，可以配置是否允许操作人取消关联。如果不勾选，则操作按钮会隐藏。
是否允许打开记录
默认勾选：点击记录行或记录卡片可打开关联记录详情；取消勾选后无法打开详情，仅可在关联列表 中查看。
打开详情的视图选择优先级:
-
若此处选择了视图，则使用该视图打开（受操作人权限影响）
-
若此处未选，但高级设置中的“关联视图”选择了视图，则按关联视图打开
-
若两处都未选择视图，则可打开详情页，仅显示操作人可见字段
权限提示
若操作人不可见所选视图，或在该视图下不可见该记录，则无法打开记录详情页。
允许导出
勾选后在关联记录字段中显示导出按钮，可将关联记录导出到 Excel（仅导出显示字段）。
允许批量操作
对于已关联的记录，可以进行批量，点击勾选框右侧设置按钮，可以选择允许哪种批量操作。
支持的批量操作有：导出、取消关联、删除、编辑、打印和自定义动作。
勾选允许批量操作后，关联表格上方会显示批量操作按钮，点击后，选择要批量操作的记录，然后选择批量动作即可。
显示记录快捷方式
关闭后，关联记录表格左侧快捷按钮不可见（复制/删除/取消关联/自定义按钮等）
样式设置
表格类型
表格类型的关联记录，有"常规"和"行列转置"两种显示类型。
"常规"样式和“行列转置”效果对比：
选择为“行列转置”样式后，在关联字段中会显示“行列转置”,点击切换样式。
交互方式
-
经典模式（默认模式）
打开记录详情： 单击每个单元格的空白打开记录详情页面
快捷编辑： 鼠标放在单元格时点击显示的编辑按钮进行编辑。
-
电子表格模式
打开记录详情： 点击单元格然后按空格键打开记录详情页。
快捷编辑： 单击单元格时为选中状态，可以类似excel操作，如通过键盘的上下左右键切换单元格、或直接复制内容。回车或再点击一次激活单元格，可以编辑字段内容。编辑字段内容时，可通过键盘输入，如数字字段、单选字段等激活后可通过上下键选择内容。
行高和列宽
关联记录的表格方式可以设置行高和列宽。
-
调整行高
在字段配置中，选择合适的高度
-
调整列宽
打开一条记录，直接拖拽表头调整列宽，然后点击左边的保存按钮即可。 管理员操作对所有人有效。
树形表格
对于关联的多条记录，支持选择一个本表关联的关联记录字段显示为树形表格，也就是说可以通过折叠/展开操作，直观地展示数据之间的层级关系，满足更多场景需要。 支持设置默认展开层级。
使用场景：
-
在项目管理中，查看项目下关联的任务。任务之间也父任务和子任务的关系
-
在生产管理中，对产品的BOM清单一目了然
如项目表中关联的任务为例：如果任务表中有配置好本表关联的父任务-子任务，则树形表格可以选择“父任务”字段作为依据字段。
效果：
显示序号
勾选后，在查看数据是第一列将显示行序号。取消勾选“显示序号”,直接显示数据列。
允许行内编辑
勾选后，在关联表格的单元格中，可以直接编辑字段。
如果不勾选，则必须点击行行记录打开记 录详情才能编辑字段。
显示交替行颜色
关联记录列表中，显示交替行颜色可以提升可读性。如下图为两种方式的对比。
高级设置
关联视图
选择一个关联表的视图后，该视图的筛选范围、排序会自动应用到"选择关联记录"的弹层中，打开关联记录时也默认用此视图展示。适合已有视图配置、希望直接复用的场景，避免在关联字段中重复设置。
- 关联字段内单独配置的排序和打开记录视图，优先级高于此处配置
- 过滤选择范围与此处叠加生效
- 已关联的记录即使后续数据变更、不再出现在该视图下，关联关系依然保留
过滤显示结果
此处过滤的是已关联记录的展示，而非选择范围。关联关系本身不受影响——符合条件的记录正常显示，不符合条件的隐藏。
-
按条件过滤
配置一个固定条件，只显示符合条件的关联记录。
-
按用户权限过滤
勾选后，按照操作者对关联的工作表/视图的权限查看，隐藏无权限的数据或字段。
无权限而隐藏的记录会显示"X条记录已隐藏"。
显示计数
当设置了[过滤结果]、[按用户权限查看]后，可见数量可能会少于计数，为了避免疑惑，建议关闭此配置。
显示统计行
开启后，表格底部会显示统计行，用于查看当前数据的汇总结果，也可按需隐藏。
统计行支持对以下字段进行求和统计：
- 数值
- 金额
- 汇总（数值类型）
- 公式（数值类型）
当勾选多条数据时，统计行会实时计算已选数据的合计值。
移动APP输入
-
扫码内容
扫码添加关联记录，实际就是根据扫出的内容识别到一条记录，除了记录链接的二维码可以定位一条记录外，可以通过指定识别哪个字段内容来查询需要关联的记录。 例如，选择姓名字段，那么扫码识别出内容后，按姓名去查询关联。
-
禁止手动输入
勾选后，只能通过APP扫码添加，PC端和移动端不能手动添加关联记录，
-
禁用相册
禁用后，只能拍照,不能从相册选择已有图片。
-
在显示表单前先获取输入
勾选后，在移动端App创建记录时会首先调取拍摄输入，此功能在自定义按钮填写时也会生效。
-
获取后直接提交表单
在移动端App获得拍摄结果后会自动提交表单。配合上个功能，用户在拍摄录入的特定场景下可以无需中间步骤，一次完成操作。此功能在自定义按钮填写时也会生效。
关联记录操作
添加关联记录
新建XXX： 向关联表中创建一条记录，并自动关联当前记录
选择XXX： 从关联表中选择一条已有的记录进行关联
取消关联记录
取消关联时不会删除记录。
分栏显示关联记录
分栏可以将本记录字段和关联记录分为两个固定区域，分开显示。无需其他配置，关联 记录字段只需是标签页表格方式即可使用。
这篇文档对你有帮助吗？