列小插件
概述
列小插件是 Labii 数据管理的基础，用于定义 ELN 和 LIMS 表格中信息的采集、验证、显示和交互方式。Labii 表格中的每一列都由一个列小插件提供支持；小插件决定数据类型、输入方法、验证规则和视觉呈现方式。列小插件涵盖基本的文本与数字输入、外部 API 集成、计算字段以及专业科学数据类型，为构建完整的数据管理方案提供所需结构和功能。无论是追踪样品、记录实验、管理库存还是构建自定义工作流程，列小插件都能帮助用户准确、高效地采集数据。
了解列小插件
什么是列小插件？
列小插件是一种可复用组件，用于定义表格列的行为。管理员创建或配置表格列时，所选列小插件会决定：
- 数据类型：可以存储的信息类型，例如文本、数字、日期或文件
- 输入方法：用户输入数据的方式，例如文本输入、下拉选择或文件上传
- 验证规则：数据必须满足的约束，例如必填字段、格式要求或数值范围
- 显示格式：数据在列表视图、详情页和表单等不同视图中的显示方式
- 交互操作：用户可以执行的操作，例如编辑、计算或链接其他记录
列小插件视图
列小插件会根据使用场景调整外观和功能。每个小插件通常支持三种视图：
- 表单视图：创建新记录时显示，提供适合初次录入数据的输入控件、占位文本和提示
- 编辑视图：修改现有数据时显示，可能提供与初次录入不同的选项或限制
- 只读视图：列表视图和详情页中的默认显示模式，以便于查看的格式呈现数据，并可能包含可视化、格式设置或相关信息链接
配置和自定义
许多列小插件都提供配置选项，可根据具体需求调整其行为：
- 字段设置：定义标签、默认值、帮助文本以及字段是否必填
- 数据验证：设置允许的值、范围、格式或模式
- 显示选项：控制格式、精度、单位或视觉呈现方式
- 集成设置：配置与外部数据源或计算功能的连接
- 权限：控制哪些用户可以查看或编辑该列
列的配置通过表格设置中的 Columns 界面进行管理。有关创建和配置列的详细说明，请参阅列管理。
操作按钮和控件
列小插件可能根据自身功能和用户权限显示不同的操作按钮：
- Edit：修改列值；对只读用户隐藏
- Configure：调整小插件设置；仅限管理员
- Calculate/Refresh：重新计算派生值或从外部数据源刷新数据
- Clear：移除当前值
- 自定义操作：打开编辑器、扫描代码或触发集成等小插件专属操作
数据导入和导出
许多列小插件支持数据导入和导出：
- 默认值：可配置为在创建记录时自动填充字段
- 导入格式：定义导入文件（CSV 或 Excel）中的数据格式
- 导出格式：决定数据在导出文件中的表示方式
小插件类别
列小插件根据主要用途分为以下功能类别。
表单小插件
用于在表单和表格中采集常见数据类型的标准输入控件。
- 文本输入 - 文本、多行文本、数字、电子邮件、电话号码、地址、URL、富文本和密码字段
- 布尔值 - 用于真/假值的复选框和开关
- 日期和时间 - 日期、时间、日期时间、时间戳、时区和预约字段
- 下拉菜单 - 单选、多选、记录引用（ForeignKey）和成员分配字段
- 文件 - 文件上传、图像、文件路径引用、文件大小显示和防病毒状态
计算小插件
根据公式、序列或其他列的数据执行计算并生成派生值。
- 计算 - 公式计算、自动编号、行数统计、样品消耗追踪、列加法和列计算
列数据小插件
显示并处理相关记录和列中的数据。
- 列 - 记录引用、列引用、列数据显示和跨记录计算
条形码和标识
为记录生成并显示条形码和二维码。
- 条形码 - 生成和显示条形码与二维码
数据分析小插件
以视觉方式呈现记录中的分析结果和进度数据。
- 数据分析 - 使用进度条等视觉元素显示数值和状态
高级小插件
用于复杂数据结构和特殊需求的专业小插件。
- 高级 - 副标题、评分、嵌套字段、存储坐标和存储位置追踪
集成小插件
连接外部系统和 API，以便交换数据和实现自动化。
- 集成 - API 集成小插件和 API 驱动的下拉字段
- Integration-1 - 通过第三方 API 集成自动填充数据
科学和专业小插件
适用于科研和专业工作流程的领域专用小插件。
监管
支持监管要求和数据完整性的小插件。
- 监管 - 电子签名和签名工作流程
入门指南
用户指南
- 创建记录：创建新记录时，每列的小插件决定显示的输入控件。填写标有星号的必填字段，并使用提供的控件输入数据。
- 编辑数据：单击任意列的 Edit 按钮修改其值。编辑视图可能提供与表单视图不同的选项。
- 了解视图：注意同一数据在列表视图中的紧凑显示与详情视图中的完整格式之间有何差异。
- 使用操作：根据小插件类型使用 Calculate、Refresh 或其他专属操作按钮。
管理员指南
- 添加列：依次进入 Settings → Tables → 选择表格 → Columns → Add Column，然后选择符合数据需求的小插件类型。
- 配置小插件：创建列后，单击 Configure 设置验证规则、显示格式或集成选项等小插件专属配置。
- 设置默认值：定义默认值以简化数据录入，并确保不同记录之间保持一致。
- 测试小插件：正式提供给用户之前，创建测试记录，确认小插件在三种视图中均按预期工作。
- 管理权限：配置列级权限，控制哪些用户可以查看或编辑敏感数据。
最佳实践
- 选择合适的小插件：选择与数据类型和验证需求匹配的小插件，减少数据质量问题。
- 配置验证规则：通过小插件配置在录入时强制执行数据完整性规则。
- 提供上下文：使用帮助文本和字段标签说明需要输入的数据及其格式。
- 充分测试：部署新列之前，在所有视图中使用不同输入测试其行为。
- 规划导入：如需导入数据，请检查每个小插件的导入格式要求，并相应准备数据。
- 考虑权限：识别包含敏感数据的列，并配置适当的访问控制。
- 记录自定义配置：记录复杂的小插件配置，尤其是公式和 API 集成设置，以供日后参考。