跳到主要内容

按 ForeignKey 显示章节

规格​

标签值
版本1.1.0(更新于 2026-11-15)
开发者Labii Inc.
类型章节
支持配置是

概述​

按 ForeignKey 显示章节小插件可显示每条指向当前记录的记录内容。您需要选择一个数据表,以及该数据表中引用当前记录的列,例如 ForeignKey 或 ForeignKeys 列。小插件随后会查找匹配的记录,并依次显示它们的列组、章节或两者。您还可以通过查询条件筛选记录,并按名称隐藏指定的列组或章节。

此小插件的查找方向与按列显示章节相反。按列显示章节显示当前记录所指向的记录,而按 ForeignKey 显示章节显示指向当前记录的记录。

当前记录签名后,小插件仍会显示签名时的匹配记录内容。请参阅已签名和只读记录。

使用场景​

  • 实验结果:显示与实验关联的结果、观察或分析记录。
  • 衍生样品:显示引用父样品的所有分装或衍生样品。
  • 项目概览:显示引用项目记录的任务、报告或交付物。
  • 订单履行:显示引用采购订单的运输或收货记录。
  • 聚焦审查:使用查询条件和排除项,只显示相关的记录和内容。

界面​

只读视图​

小插件依次显示每条匹配的记录。每个区块以 Showing data from 链接开头,点击可在新标签页中打开源记录,随后显示所选内容。

  • 列:以紧凑布局显示每条匹配记录的列组。
  • 章节:显示每条匹配记录的章节。
  • 所有记录:加载并显示所有匹配的记录。
  • 空状态:没有记录引用当前记录时,小插件会显示相应提示。

按 ForeignKey 显示章节小插件的只读视图

只读视图显示引用当前记录的记录内容。

编辑视图​

在编辑视图中,您可以配置记录的来源、要显示的内容、要排除的内容,以及显示的内容是否可编辑。

  • 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 中拼错名称,因为只有名称完全一致(不区分大小写)的内容才会被隐藏。
  • 避免一次显示大量大型记录,因为每条匹配记录都会被完整加载和显示。