枢搭云帮助中心

效果与作用

关联表单用于在当前表单中选择另一张表单的已有数据，并把两张表的数据建立引用关系。运行态会以下拉候选或选择弹窗的方式选择目标数据，选中后可以展示关联记录的主要信息，也可以按配置把关联表单中的字段回填到当前表单。它适合客户、供应商、项目、物料、合同等基础资料被业务单据引用的场景。

配置项

基础配置包括「标签」「字段说明」「占位提示」「默认值」「是否必填」「隐藏字段」「隐藏标签」。添加组件后，需要在「关联表单配置」中选择目标关联表单，否则运行态无法选择数据。

「显示设置」用于控制候选数据如何展示。下拉菜单显示字段中的主要信息会作为下拉选项和选中后的默认展示内容；数据表显示字段用于配置选择弹窗中的表格列，可以使用默认字段，也可以自定义字段。显示字段建议选择业务上能唯一识别记录的字段，例如客户名称、合同编号、物料编码。

「数据范围限定」用于限制可被选择的关联数据，可以添加条件组，条件中可使用关联表单字段、当前表单字段或固定值。开启“数据范围引用字段变化后自动选择数据范围内的第一条数据”后，当当前表单字段变化导致候选范围变化时，系统会尝试自动选中第一条符合条件的数据。

「数据填充规则」用于把关联表单字段写入当前表单字段。字段填充适合把客户电话、项目负责人、物料规格等信息带出到主表字段；子表单填充适合把关联表单中的明细行带入当前表单子表单。目标字段如果本身也是关联表单，可以通过匹配字段反查并写入对应关联记录。

应用场景

关联表单常用于订单关联客户、报销关联项目、入库单关联采购单、工单关联设备档案、合同关联供应商等场景。它可以减少重复录入，让业务单据引用同一份基础资料，并通过填充规则自动带出相关信息。

注意事项

关联表单保存的是目标数据的引用，不是简单文本。目标表单的显示字段、数据权限和数据状态都会影响候选列表和回显效果。切换目标关联表单后，旧的填充规则和数据范围通常需要重新配置，避免字段含义不一致造成误回填。不要把关联表单当作普通下拉选项使用；如果只是固定几个选项，使用下拉单选或下拉复选更轻量。