元数据
规格
| 标签 | 值 |
|---|---|
| 版本 | 2.0.0（更新于 2021-11-25） |
| 开发者 | Labii Inc. |
| 类型 | 章节 |
| 支持配置 | 否 |
概述
元数据小插件以简单的键值格式显示和管理与记录关联的元数据。实验室团队无需重新设计底层数据表结构，即可用它记录描述性上下文、操作属性和系统级注释。当记录需要轻量、灵活的元数据用于跟踪、筛选、报告或下游集成时，此小插件非常实用。
使用场景
- 记录注释：添加存储条件、供应商标识符、仪器设置或外部参考 ID 等描述性元数据。
- 数据标准化：存储规范化的键值属性，使相关记录更容易在不同实验或批次之间比较。
- 操作可追溯性：记录有助于审计、调查和可重复性工作的上下文详情。
- 报告支持：展示元数据值，帮助用户在仪表板、导出文件或审查流程中理解记录。
- 集成工作流程：维护连接器字段，将 Labii 记录映射到外部系统、文件或服务。
界面
只读视图
在只读模式下，小插件以键值对列表呈现与当前记录关联的元数据。用户无需打开更大的编辑器或切换到其他标签页，即可轻松浏览标签和值。
- 数据显示：每个元数据条目均以标签和值配对显示。
- 可见性：用户可以快速查看已附加到记录的元数据。
- 易于理解：这种格式非常适合简短的技术属性和系统注释。
- 记录上下文：显示的元数据始终与当前记录关联，帮助用户在编辑或签署前确认上下文。
编辑视图
在编辑模式下，小插件提供表单式界面，用于添加、更新和删除元数据条目。用户可以直接在小插件中输入元数据标签及其对应值。
- 输入方式：使用可编辑的键和值字段添加或修改元数据。
- 条目管理：不再需要时可删除过时的元数据条目。
- 灵活结构：无需预定义列即可支持操作性和描述性元数据。
- 快速更新：无需重构记录的其他部分即可进行针对性修改。
配置
元数据小插件不提供专用配置选项。将其添加到章节后，用户可以立即开始查看和编辑元数据。
初始设置
将 Metadata 小插件添加到数据表或应用布局中的目标章节。
打开需要显示或记录元数据的记录。
在只读模式下查看现有元数据，或切换到编辑模式以创建和维护键值条目。
必填设置
- 无。该小插件无需其他设置字段即可工作。
可选设置
- 无。小插件的行为由记录的元数据内容决定，而非小插件级选项。
信息
由于该小插件没有配置面板，因此在不同数据表和应用中的实施方式简单且一致。
其他功能
元数据维护
- 添加条目：当记录需要额外的描述性上下文时，创建新的元数据键值对。
- 更新条目：随着实验、样品或操作条件的变化修改元数据值。
- 删除条目：删除过时的键，使记录保持简洁和相关。
工作流程支持
- 灵活记录：使用元数据保存不值得专门更改架构的详情。
- 保留上下文：让记录专属注释与记录的其余内容一起显示。
- 便于审查：以紧凑格式向审查者和协作者提供辅助详情。
合规与审计用途
- 支持追溯：维护有助于说明记录创建、处理或审查方式的上下文属性。
- 受控更新：如果元数据更改需要审查，请将此小插件与 Labii 的版本控制和签署流程结合使用。
最佳实践
数据整理
- 在不同记录中使用一致的元数据键名，使审查、报告和自动化更容易。
- 值应简洁具体，确保元数据在详情和摘要工作流程中都易于阅读。
- 优先使用批次 ID、仪器 ID、源系统或存储条件等稳定标签，而不是含义模糊的自由文本键。
性能与易用性
- 元数据仅用于有意义的属性，不要在键值对中存储大段叙述性内容。
- 将重复的长篇说明移至面向文本的小插件，并让此小插件专注于紧凑的元数据。
- 定期检查记录中重复或过时的元数据键。
安全与合规
- 如果记录用于受监管工作流程或正式审查流程，请使用标准化的元数据标签。
- 确认元数据编辑符合公司的审计、批准和数据治理流程。
- 避免在元数据字段中存储机密或敏感凭据。
提示
将元数据键视为实验室数据标准的一部分。一致的标签可以提高可搜索性、可理解性和下游复用能力。
应避免的常见问题
- 避免：为同一概念创建多个标签，例如
Batch、Batch ID和batch_id。 - 避免：用元数据记录冗长的程序说明；这类内容更适合文本或文档小插件。
- 建议：为每个工作流程定义一组数量较少且经过批准的键名，并始终重复使用这些名称。
维护与故障排除
- 在数据表治理或模板审查期间检查元数据键。
- 如果元数据不一致，请标准化标签，并以受控批处理方式更新受影响的记录。
- 如果用户需要结构化验证，请考虑使用专用列，而不是不受限制的元数据条目。