模板说明
在审批、详情或自定义页面内查看同一业务对象的明细、附件登记或处理记录。
使用场景
采购申请中列出同一申请 ID 的报价记录,显示「记录名称」和「业务状态」两列。
运行结果
用目标列表的关联字段匹配当前值后显示卡片或表格。用字段显示名 JSON 指定中文标题,查询继续使用真实字段标识。仅展示摘要,无写回。
来源列表需授予使用者读取权限。控件读取查询返回的首批记录,再按配置筛选、排序或截取。数据量较大时,按目标租户的 SDK 筛选格式缩小查询范围。
验收步骤
验证两种布局、中文列名、错误关联值的空状态,以及不同申请之间的记录隔离。
查看完整控件源码(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 | 变量或表达式 | 按需 | 查询筛选条件。可选的列表查询条件。 | 按需留空 |