# 关联记录摘要网格

在审批、详情或自定义页面内查看同一业务对象的明细、附件登记或处理记录。

## 放置与配置

在易企办测试应用中打开审批表单或支持自定义代码控件的页面，添加自定义代码控件，将同目录 TSX 完整粘贴到编辑器。先核对位置、字段类型与读写权限，再配置下表。

| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `targetListId` | 变量或表达式 | 需要 | 关联列表 ID。保存关联记录的数据列表 ID。 | `203...` |
| `relationField` | 变量或表达式 | 需要 | 关联字段。用于匹配关系的目标列表字段标识。 | `RequestId` |
| `relationValue` | 变量或表达式 | 需要 | 当前关联值。用于匹配关联记录的当前值。 | `{{ListDataID}}` |
| `displayedFieldsJson` | 变量或表达式 | 需要 | 展示字段。以 JSON 数组或逗号分隔文本指定要展示的字段。 | `["Title","Status"]` |
| `fieldLabelsJson` | 文本 | 按需 | 字段显示名 JSON。用 JSON 对象为字段标识配置中文列名。 | `{"Title":"记录名称","Status":"业务状态"}` |
| `displayType` | 文本 | 按需 | 展示方式。使用 card 显示卡片，使用 table 显示表格。 | `table` |
| `titleField` | 变量或表达式 | 按需 | 标题字段。作为首个摘要值的字段标识。 | `Title` |
| `statusField` | 变量或表达式 | 按需 | 状态字段。保存状态的字段标识。 | `Status` |
| `titleText` | 文本 | 按需 | 标题。显示在控件顶部的主标题。 | `关联记录` |
| `subtitleText` | 文本 | 按需 | 副标题。显示在主标题下方的说明。 | `已关联的业务记录` |
| `maxItems` | 文本 | 按需 | 最大条数。最多显示的关联记录数。 | `6` |
| `emptyText` | 文本 | 按需 | 空状态提示。没有可展示数据时的提示文案。 | `暂无关联记录` |
| `filterExpression` | 变量或表达式 | 按需 | 查询筛选条件。可选的列表查询条件。 | 按需留空 |

示例字段和列表 ID 请替换为目标应用的实际值。表达式请在编辑器中绑定。保存目标使用可写文本字段或环境支持的可写变量。

1. 绑定关联列表与匹配字段。
2. 选择展示字段并配置中文列名。
3. 切换卡片与表格查看。

## 业务示例与结果

采购申请中列出同一申请 ID 的报价记录，显示「记录名称」和「业务状态」两列。

用目标列表的关联字段匹配当前值后显示卡片或表格。用字段显示名 JSON 指定中文标题，查询继续使用真实字段标识。仅展示摘要，无写回。

来源列表需授予使用者读取权限。控件读取查询返回的首批记录，再按配置筛选、排序或截取。数据量较大时，按目标租户的 SDK 筛选格式缩小查询范围。

## 预览验收

验证两种布局、中文列名、错误关联值的空状态，以及不同申请之间的记录隔离。

出现空结果时，先核对参数值、来源数据、字段标识和使用者权限。涉及写回时，再检查可写目标类型、当前页面权限及保存后的实际值。

模板已做本地源码与交互检查。发布到业务环境前，请在目标易企办租户验证当前版本的控件编辑器、数据权限和实际读写。

源模板 CCT87111。 [Yeeflow 原站控件](https://www.yeeflow.com/templates/custom-code/related-record-summary-grid)