按 ForeignKey 显示章节
规格
| 标签 | 值 |
|---|---|
| 版本 | 未记录（更新于 2026-06-14） |
| 开发者 | Labii Inc. |
| 类型 | 章节 |
| 支持配置 | 是 |
概述
按 ForeignKey 显示章节小插件可在当前 Labii 记录中显示相关记录的章节，无需用户每次手动选择源记录。该小插件不直接选择目标记录，而是读取 ForeignKey 或 ForeignKeys 列中的关系，并将关联记录用作内容源。因此，它适合跨多条记录复用 SOP 内容、共享项目文件、模板章节及其他受控参考资料，既能减少重复，又能让更新继续与原始来源保持关联。
使用场景
- 复用 SOP：在实验记录中显示 SOP 记录中的受控程序章节。
- 项目参考内容：显示关联项目或账户记录中的常用文件、说明或备注。
- 基于模板的文档记录：通过关系字段将标准记录章节引入下游工作记录。
- 跨记录上下文：无需将同一章节复制粘贴到多条记录中，即可让参考内容保持可见。
- 合规工作流程：当记录需要可追溯且特定于版本的参考内容时，将显示内容固定为所选版本。
界面
只读视图
在只读模式下，小插件直接在当前记录中呈现相关源记录的章节。启用 Is Readonly 或选择指定 Version 时会使用此模式，确保显示引用的内容但不允许就地编辑。
- 数据显示：在当前记录布局中显示相关记录的源章节。
- 解析关联关系：根据已配置的 ForeignKey 或 ForeignKeys 字段自动解析源记录。
- 识别版本：根据配置显示最新源内容或固定版本。
- 审查用途：适用于 SOP 审查、受控参考内容和已签署记录的工作流程。
只读视图在当前记录中显示关联源记录的章节。
编辑视图
在编辑模式下，小插件配置用于控制所使用的关系字段，以及所显示的源章节能否编辑。如果清除 Is Readonly 且未选择固定版本，显示的内容将采用与 Section Display By Record 相同的可编辑方式。
- 输入方式：选择指向源记录的关系列。
- 格式选项：选择使用最新内容，或将显示内容固定为指定版本。
- 验证：所选字段必须是可解析到至少一条相关记录的 ForeignKey 或 ForeignKeys 列。
- 协作：让团队能够跨记录展示共享内容，同时控制是否允许编辑。
当源字段为 ForeignKeys 列时，小插件使用该字段返回的第一条相关记录。
配置
初始设置
打开记录，将 Section Display By ForeignKey 小插件添加到章节。
将章节切换到 Edit 模式，或打开小插件设置。
选择包含源记录引用的关系列。
根据需要选择指定源版本或启用 Is Readonly，然后保存记录。
必填设置
- Column：选择指向源记录的 ForeignKey 或 ForeignKeys 列；该源记录的章节将被显示。
可选设置
- Version：如果显示内容需要保持固定，而不是跟随最新版本，请选择源记录的指定版本。
- Is Readonly：如果希望用户审查而不是编辑引用内容，请以只读模式显示关联章节。
如果未选择版本，小插件将使用关联源记录的最新可用版本。签署当前记录时，系统会自动分配一个最新版本。
高级配置
为了在多条记录之间更可靠地复用内容，请对用于存储源记录引用的关系字段进行标准化。
在相关数据表设计中创建一致的 ForeignKey 或 ForeignKeys 字段，用于引用 SOP、模板或共享源记录。
对于在批准、签名或审计期间需要稳定引用内容的工作流程，请固定版本。
如果所选关系字段为空或指向错误的记录，小插件将无法显示预期章节。在排查章节显示本身的问题之前，请先检查源字段。
其他功能
自动解析数据源
此小插件无需在每条目标记录中手动选择源记录。
- 由关系驱动的显示：自动从已配置字段中读取源记录。
- 减少重复：复用实时内容，而不是将同一章节复制到多条记录中。
- 加快设置：当数据源关系已经是数据表结构的一部分时，可支持可扩展的记录模板。
固定版本
当显示内容必须保持稳定以供审查或满足合规要求时，请选择版本。
打开小插件配置。
如果要固定显示内容，请选择所需的源 Version。
保存记录并确认显示的是预期的源版本。
集成功能
- 关系小插件集成：与 ForeignKey 和 ForeignKeys 列配合使用，以确定源记录。
- 记录复用集成：适合与集中管理 SOP、账户资源、模板或共享项目内容的数据表设计结合使用。
- 文档集成：让引用的章节与当前记录自身的备注和数据一起显示。
版本控制与审计跟踪
- 版本可追溯性：支持为受控文档记录工作流程固定源版本。
- 配置可追溯性：所选源列始终是小插件设置的一部分，确保记录行为可重复。
- 记录完整性：帮助共享章节保持唯一的权威来源，同时仍能在需要的位置展示内容。
最佳实践
数据整理
- 在专用 ForeignKey 或 ForeignKeys 字段中存储参考关系，不要依赖手动复制章节。
- 为源记录使用清晰的命名约定，便于核实关联内容。
- 将 SOP 或常用附件等可复用的受控内容存放在专为复用而设计的源记录中。
工作流程设计
- 对于显示内容不能发生变化的受监管或基于批准的工作流程，请固定 Version。
- 仅当用户应始终看到引用章节的最新版本时，才不固定小插件版本。
- 将此小插件与记录模板结合使用，使关联参考内容自动出现在下游记录中。
审查与合规
- 在签署依赖引用章节的目标记录之前，核实关联的源记录。
- 当显示的内容用作受控参考资料时，请优先使用只读模式。
- 记录源关系字段的用途，让协作者理解章节为何会自动显示。
当一条源记录作为受控参考资料，而所有目标记录都通过一致的关系字段指向该记录时，此小插件的效果最佳。
应避免的常见问题
- 不要使用自由文本字段代替 ForeignKey 字段，因为小插件需要结构化关系来解析源记录。
- 在受监管工作流程中，不要让版本行为含糊不清，因为当内容仍在跟随最新版本时，用户可能误以为内容已经固定。
- 不了解记录顺序时，不要使用 ForeignKeys 字段，因为小插件会使用该字段中的第一条相关记录。
相关小插件
- 按记录显示章节：如果用户应手动选择源记录，而不是通过关系字段确定，请使用此小插件。
- ForeignKey：使用此列小插件存储一条相关记录，供此章节小插件显示。
- ForeignKeys：需要存储多条相关记录时使用此列小插件；请注意，本章节小插件只使用第一条相关记录。