按 ForeignKey 显示章节
规格
| 标签 | 值 |
|---|---|
| 版本 | 1.1.0(更新于 2026-11-15) |
| 开发者 | Labii Inc. |
| 类型 | 章节 |
| 支持配置 | 是 |
概述
按 ForeignKey 显示章节小插件可显示每条指向当前记录的记录内容。您需要选择一个数据表,以及该数据表中引用当前记录的列,例如 ForeignKey 或 ForeignKeys 列。小插件随后会查找匹配的记录,并依次显示它们的列组、章节或两者。您还可以通过查询条件筛选记录,并按名称隐藏指定的列组或章节。
此小插件的查找方向与按列显示章节相反。按列显示章节显示当前记录所指向的记录,而按 ForeignKey 显示章节显示指向当前记录的记录。
当前记录签名后,小插件仍会显示签名时的匹配记录内容。请参阅已签名和只读记录。
使用场景
- 实验结果:显示与实验关联的结果、观察或分析记录。
- 衍生样品:显示引用父样品的所有分装或衍生样品。
- 项目概览:显示引用项目记录的任务、报告或交付物。
- 订单履行:显示引用采购订单的运输或收货记录。
- 聚焦审查:使用查询条件和排除项,只显示相关的记录和内容。
界面
只读视图
小插件依次显示每条匹配的记录。每个区块以 Showing data from 链接开头,点击可在新标签页中打开源记录,随后显示所选内容。
- 列:以紧凑布局显示每条匹配记录的列组。
- 章节:显示每条匹配记录的章节。
- 所有记录:加载并显示所有匹配的记录。
- 空状态:没有记录引用当前记录时,小插件会显示相应提示。

只读视图显示引用当前记录的记录内容。
编辑视图
在编辑视图中,您可以配置记录的来源、要显示的内容、要排除的内容,以及显示的内容是否可编辑。
- Table:选择包含引用记录的数据表。
- Column Referenced:选择该数据表中引用当前记录的列。
- Query:添加额外的查询条件来筛选记录。
- Display:选择 All columns、All sections 或两者。
- Exclude:输入要隐藏的列组或章节名称,以
,分隔。 - Is Readonly:选择显示的内容为只读还是可编辑。
配置
初始设置
打开记录,将 Section Display By ForeignKey 小插件添加到章节。
点击 Edit 打开小插件设置。
选择 Table 以及指向当前记录的 Column Referenced。
可选择更新 Query,在 Display 中选择要显示的内容,在 Exclude 中输入名称,然后点击 Submit。
必填设置
- Table:包含要显示记录的数据表。
- Column Referenced:所选数据表中引用当前记录的列。支持的小插件包括 ForeignKey、ForeignKeys、Files 和 Column Data。
- Display:每条匹配记录要显示的内容:
- All columns:记录的列组。
- All sections:记录的章节。
可选设置
- Query:添加到搜索中的额外查询条件。默认值为
is_archived=false。清空后将包括已归档的记录。 - Exclude:要隐藏的列组或章节名称,以
,分隔。例如,Account Information, Notes会隐藏 Account Information 列组和 Notes 章节。名称匹配不区分大小写。 - Is Readonly:默认勾选。取消勾选后,可直接在当前记录中编辑匹配记录的列和章节。
取消勾选 Is Readonly 后,在此小插件中所做的更改会保存到匹配的源记录,而不是当前记录。
升级早期配置
在 1.0.0 版本之前,此小插件显示当前记录中 ForeignKey 或 ForeignKeys 列所关联的第一条记录的指定章节,并可固定为某个版本。按此方式配置的章节会继续保持原有显示。编辑此类章节时会打开新的设置表单。选择 Table 和 Column Referenced 并提交后,小插件将使用新的行为。
其他功能
已签名和只读记录
为满足法规要求,已签名记录必须始终显示签名时的数据。
- 章节可编辑时,小插件显示当前的匹配记录,并保存每条记录的最新版本。
- 章节为只读时,小插件显示已保存的版本,而不再查找匹配的记录。当记录已签名或已完成、被打印或以版本方式打开,或者您没有编辑权限时,章节为只读。
这与 Is Readonly 设置不同,该设置仅控制在章节可编辑时,显示的内容能否被编辑。
尚未保存任何版本的章节会显示当前的匹配记录。
自动查找记录
章节可编辑时,每次打开记录,小插件都会自动查找匹配的记录。
- 始终保持最新:新增的引用当前记录的记录会自动出现,无需更改小插件设置。
- 查询筛选:使用任何支持的查询条件缩小记录范围。
- 防止引用自身:如果当前记录出现在搜索结果中,将被跳过。
防止递归
如果匹配记录中包含按记录显示章节、按 ForeignKey 显示章节或按列显示章节小插件,该章节将被跳过。这可以防止相互引用的记录无限地相互显示。
集成功能
- 关系小插件集成:与引用当前记录的 ForeignKey、ForeignKeys、Files 和 Column Data 列配合使用。
- 列组集成:使用每条匹配记录所在数据表中定义的列组。
- 章节集成:使用各自的小插件显示每条匹配记录的章节。
最佳实践
数据整理
- 将源数据表的列整理为清晰的列组,以便按名称排除。
- 在源数据表中使用一致的章节名称,使同一个 Exclude 值适用于所有记录。
工作流程设计
- 当显示的内容仅供参考时,请保持勾选 Is Readonly。
- 仅当用户需要在当前记录中更新匹配记录时,才取消勾选 Is Readonly。
- 当引用当前记录的记录较多时,使用 Query 限制记录数量。
- 签名前打开记录,使小插件保存匹配记录的最新版本。
将此小插件添加到数据表模板中,使每条新记录自动显示引用它的记录。
应避免的常见问题
- 避免选择未引用当前数据表的列,否则将没有匹配的记录。
- 避免在 Exclude 中拼错名称,因为只有名称完全一致(不区分大小写)的内容才会被隐藏。
- 避免一次显示大量大型记录,因为每条匹配记录都会被完整加载和显示。
相关小插件
- 按列显示章节:显示当前记录所指向的记录内容。
- 按记录显示章节:显示手动选择的源记录内容。
- 按 ForeignKey 显示记录列表:以列表形式显示引用当前记录的记录。
- ForeignKey:存储单条关联记录。
- ForeignKeys:存储多条关联记录。