跳到主要内容

Formulation

规格​

标签值
版本1.1.0（更新于 2026-08-05）
开发者Labii Inc.
类型章节
支持配置是

概述​

Formulation 小插件让研究人员能够定义来源物料、指定用量，并根据可配置比例自动计算目标用量，从而简化实验室试剂混合物的制备。它特别适合制备 PCR 反应体系、缓冲液、培养基，以及其他对试剂比例精度要求较高的配方。该小插件通过自动创建消耗记录与 Labii 库存管理系统无缝集成，确保准确跟踪物料使用情况和库存水平。

使用场景​

  • PCR 反应制备：定义预混液组分及其浓度，并自动计算目标反应体积所需的用量
  • 缓冲液配制：指定储备液浓度，并计算达到所需终浓度所需的体积
  • 培养基制备：创建包含多种组分的培养基配方，并跟踪试剂消耗以管理库存
  • 药物配方：跟踪 API、辅料、来源容器和计算所得目标用量，以受控方式制备药品混合物
  • 标准溶液制备：通过精确的浓度计算为分析程序配制标准溶液
  • 批量配制：以一致的试剂比例同时制备多个反应体系或溶液
  • 库存集成：自动为配方中使用的所有来源物料生成消耗记录，保持库存水平准确

界面​

只读视图​

只读视图以简洁的表格形式呈现配方数据，完整概览所有配方组分。每一行代表一种来源物料及其相关信息。

Formulation 章节小插件

只读视图的主要功能：

  • Formulation Table：显示所有已添加的来源物料及其配置字段
  • Container Table：显示来源资源容器及其配置字段
  • Base Amount Display：显示每种来源物料的基础用量和单位
  • Target Amount Display：显示根据配方设置计算的目标用量
  • Notes Column：显示每个配方项目的其他备注或说明
  • Consumption Status：指明是否已为各来源创建消耗记录

结构化表格让研究人员能够快速检查所有配方组分、核对用量，并确认计算结果符合实验要求。

编辑视图​

编辑视图提供用于构建和管理配方的交互式界面。用户只需点击按钮，即可添加新的来源物料、配置用量并生成消耗记录。

编辑视图的主要功能：

  • Add Formulation Button：打开用于向配方添加新来源物料的模态表单
  • Formulation Table：显示所有配方组分和操作按钮的交互式表格
  • Target Amount Calculation：根据配置设置自动计算并显示目标用量
  • Individual Consumption：每个配方项目旁的 Add Consumption 按钮用于创建单独的消耗记录
  • Bulk Consumption：Add Consumption for All 按钮可一键为所有配方项目创建消耗记录
  • Edit/Delete Actions：根据需要修改或移除配方项目
  • Real-time Calculation：配方设置更改后自动更新目标用量

用于添加配方的模态表单包含来源选择、显示字段配置、基础用量、单位选择和备注字段。

配置​

初始设置​

点击 Edit 按钮，前往 Widget Settings。

配置 Consumption Settings，以关联库存管理系统：

  • Container Table：选择包含来源容器的表
  • Container Source Column：选择容器表中保存来源引用的列
  • Consumption Table：选择用于存储消耗记录的表
  • Experiment Column：选择引用实验的列
  • Source Column：选择存储来源物料引用的列
  • Amount Column：选择记录消耗量的列
  • Unit Column：选择存储用量单位的列

配置 Formulation Settings，定义计算参数：

  • Target Amount：指定配方的目标用量值
  • Base Amount：输入作为计算目标用量基准的来源用量值
  • Unit：选择配方的计量单位

点击 Save 应用配置。

信息

该小插件使用基础用量与目标用量的比例，自动计算配方中每种来源物料的所需用量。

必需设置​

Consumption Settings​

  • Container Table：包含配方所用资源来源容器的表。
  • Container Source Column：容器表中存储来源引用的列，用于将每个容器关联回其来源物料。
  • Consumption Table：指向消耗表的 ForeignKey 字段，用于跟踪物料使用情况。这项集成可确保所有配方活动都反映在库存系统中。
  • Experiment Column：将消耗记录关联到特定实验或程序的列，是保持实验可追溯性的必要设置。
  • Source Column：引用被消耗来源物料的列，用于将配方项目关联到库存记录。
  • Amount Column：记录消耗量的列，对准确计算库存扣减至关重要。
  • Unit Column：存储计量单位的列，用于确保用量报告和库存跟踪保持一致。

Formulation Settings​

  • Target Amount：配方的目标用量值（例如，20 µL PCR 反应中的 20），决定配方规模。
  • Base Amount：作为计算基准的来源用量值。小插件使用以下公式计算目标用量：(Target Amount / Base Amount) × Source Base Amount。
  • Unit：配方使用的计量单位（例如 µL、mL、mg），必须与来源物料单位兼容。
  • Decimals：计算所得目标用量保留的小数位数。
注意

配置小插件前，请确保消耗表结构包含所有必需列。缺少列将导致无法创建消耗记录。

Add Formulation 表单​

添加配方项目时，模态表单提供以下配置选项：

  • Source：从库存中选择来源物料或样本。该字段通常提供自动完成搜索，便于查找物料。
  • Fields to Display：选择要在配方表中显示的来源记录字段，例如浓度、批号或有效期。
  • Base Amount：输入该来源用于计算目标用量的基础用量值，作为目标用量的计算基准。
  • Unit：选择 %，按配方目标用量的百分比计算目标用量；选择其他单位（例如 µL、mL、mg 或 mg/mL），则使用章节设置中配置的基础用量计算目标用量。
  • Notes：添加有关该配方项目的其他备注或说明，例如处理说明或特殊注意事项。

在小插件编辑视图中点击 Add Formulation 按钮。

在模态表单中搜索并选择 Source 物料。

选择 Fields to Display，在表中显示相关来源信息。

输入 Base Amount 并选择合适的 Unit。

在 Notes 中添加相关记录说明。

点击 Save，将配方项目添加到表中。

保存后，小插件会根据配方设置自动计算目标用量。

高级配置​

对于需要多种计算基准或混合单位的复杂配方：

为各来源物料配置不同的基础用量，以适应不同的储备液浓度。

使用 Notes 字段记录计算依据或特殊稀释倍数，以便追溯。

对于多步制备程序，在同一章节中设置多个 Formulation 小插件。

提示

对于多阶段配方（例如先制备预混液，再分装），建议每个阶段使用单独的 Formulation 小插件，以清楚记录各个步骤。

其他功能​

自动计算目标用量​

添加配方项目后，小插件会根据配置的配方设置自动计算目标用量。计算公式为：

Target Amount = (Formulation Target Amount ÷ Formulation Base Amount) × Source Base Amount

这可确保配方中的所有组分按一致比例缩放。

信息

修改配方设置后，目标用量会自动更新。因此，无需重新输入各来源用量，即可针对不同批量大小快速重新计算。

按基础用量或百分比计算​

Add Formulation 表单中选择的 Unit 决定小插件计算目标用量的方式：

  • Based on Base Amount：选择 % 以外的任意单位。小插件使用章节设置中配置的 Base Amount，按以下公式计算目标用量：(Formulation Target Amount ÷ Formulation Base Amount) × Source Base Amount。
  • Based on Percentage：选择 %。小插件忽略章节设置中配置的 Base Amount，按以下公式计算来源用量：Formulation Target Amount × Source Percentage ÷ 100。
信息

配方需要根据参考基础用量缩放时，请使用标准计量单位；每种来源需要按配方目标用量的一定比例计算时，请使用 %。

创建单项消耗记录​

表中每个配方项目都有一个 Add Consumption 按钮，用于单独创建消耗记录。

检查特定配方项目计算所得的目标用量。

点击配方行右侧的 Add Consumption 按钮。

小插件将在配置的消耗表中创建一条消耗记录，其中包含：

  • 配方项目中的来源引用
  • 当前记录中的实验引用
  • 等于计算所得目标用量的 Amount
  • 配方设置中的 Unit

系统显示确认指示，表明消耗记录已成功创建。

需要选择性创建消耗记录时，此功能非常有用，例如某些物料实际并未使用，或需要先核对用量再扣减库存。

批量创建消耗记录​

Add Consumption for All 按钮可同时为所有配方项目创建消耗记录，从而简化流程。

检查所有配方项目，确认计算所得目标用量正确。

点击小插件界面中的 Add Consumption for All 按钮。

小插件处理所有配方项目，并为每种来源物料创建单独的消耗记录。

确认消息将显示创建的消耗记录数量。

确认所有消耗记录均以正确用量显示在消耗表中。

提示

使用批量消耗创建功能，可确保单次配方事件的所有消耗记录具有一致的时间戳和元数据，从而提高审计追踪的清晰度。

编辑和删除配方项目​

根据需要修改或移除已有配方项目：

  • Edit：点击编辑图标，修改来源、基础用量、单位或备注
  • Delete：点击删除图标，从表中移除配方项目

配方项目发生更改后，目标用量会自动重新计算。

配方预规划​

在执行实验室程序前，可使用该小插件进行有效规划：

将所有必需试剂及其基础用量添加到配方中。

调整配方设置中的目标用量，使其与所需批量大小一致。

查看计算所得目标用量，确认现有库存能够满足需求。

打印或导出配方表，作为制备检查清单。

按照计算所得用量执行配制。

确认制备成功后创建消耗记录。

此工作流程让用户能够在开始实际实验室工作前，核实物料可用性和用量可行性。

与库存管理集成​

小插件创建的消耗记录会自动与 Labii 库存管理系统集成：

  • Real-time Stock Updates：消耗记录触发库存自动扣减
  • Batch Tracking：将消耗关联到特定来源批次，实现批号追溯
  • Usage Analytics：消耗数据用于使用情况报告和补货计算
  • Audit Compliance：创建完整的物料使用审计追踪，以满足监管合规要求

最佳实践​

数据组织​

  • Consistent Naming：对配方使用标准化名称，提高跨实验搜索效率
  • Detailed Notes：在 Notes 字段中记录偏离标准程序的情况、特殊处理要求或观察结果
  • Source Selection：始终选择具体批次或批号的来源物料，不要选择通用库存项目，以提高可追溯性
  • Field Display Configuration：选择在配方表中显示浓度、批号和有效期等关键信息

计算准确性​

  • Unit Consistency：确保来源物料与配方设置的单位一致（例如混合体积时始终使用 µL 或 mL）
  • Base Amount Verification：添加配方项目前仔细核对基础用量，因为它会直接影响目标用量计算
  • Concentration Considerations：使用储备液时，在 Notes 字段中记录浓度计算或稀释倍数
  • Rounding：注意计算所得目标用量的舍入；对于关键应用，请在操作前核对计算结果
提示

对于 PCR 反应和其他高精度应用，请根据移液能力配置合适的计算精度（例如以 0.5 µL 为增量）。

工作流程效率​

  • Template Formulations：为常用试剂混合物创建标准配方并保存为模板，以便快速复用
  • Batch Preparation：对常规配方使用批量消耗功能，减少数据录入时间
  • Sequential Planning：创建消耗记录前添加所有配方项目，以便进行最终检查和调整
  • Multi-stage Procedures：对于复杂制备流程，使用多个 Formulation 小插件分别记录各阶段

库存管理集成​

  • Timely Consumption Creation：使用物料后立即创建消耗记录，以保持实时库存准确
  • Pre-check Availability：开始制备前，对照当前库存检查配方需求，避免操作过程中物料短缺
  • Consumption Verification：定期将消耗记录与实际物料使用情况进行核对，以发现差异
  • Batch Traceability：始终将消耗关联到具体来源批次，以便在受监管环境中实现完整的批号追溯

合规与文档记录​

  • Complete Documentation：填写包括备注在内的所有相关字段，为监管审计创建完整记录
  • Review Before Execution：创建消耗记录前核对所有配方项目和计算所得用量，因为这些内容会成为永久审计追踪的一部分
  • Electronic Signatures：在 GLP/GMP 环境中，确保按照您的程序审查配方记录并进行电子签名
  • Archive Standards：根据公司的数据保留政策和监管要求保留配方记录
注意

消耗记录一旦创建，就会成为审计追踪的一部分，通常无法删除。点击 Add Consumption 按钮前请确保数据准确，以免引起审计追踪问题。

应避免的常见问题​

  • 避免：在确认计算所得用量正确且可行之前创建消耗记录
  • 正确做法：使用消耗创建功能前，始终检查配方表和计算所得目标用量
  • 避免：在没有明确记录的情况下混用不兼容单位（例如一种来源使用体积，另一种使用质量）
  • 正确做法：保持单位一致，或在 Notes 字段中清楚记录换算系数
  • 避免：使用未指明批次或批号信息的通用来源引用
  • 正确做法：选择具有完整批次/批号追溯信息的具体库存项目
  • 避免：配方完成后忘记创建消耗记录
  • 正确做法：将创建消耗记录作为配方工作流程的最后一步

性能优化​

  • Limit Display Fields：仅选择必要的来源物料显示字段，以提高表格加载性能
  • Batch Size Considerations：对于超大配方（超过 50 个项目），考虑拆分为多个较小的 Formulation 小插件
  • Data Management：定期归档旧配方记录，以保持最佳的小插件性能
  • Formulate：基于优化的配方替代方案。如果需要使用线性规划算法根据约束和目标优化原料组合，请选择此小插件。
  • Calculation：用于基本数学计算的简化选项。如果只需执行计算而不需要库存集成，请使用此小插件。

集成场景​

  • PCR Workflow：组合使用 Formulation、Rich Text 和 Image Gallery，完整记录 PCR 反应
  • Buffer Preparation：组合使用 Formulation、Table（缓冲液配方）和 Inventory Management，标准化制备和跟踪缓冲液
  • Media Preparation：集成 Formulation、Protocol 和 Consumption tracking，实现具有完整可追溯性的培养基批量制备
  • Quality Control：组合使用 Formulation、Calculation 和 Results 小插件，记录配方验证和质量控制测试
  • Batch Production：组合使用多个 Formulation 小插件、Inventory Management 和 Workflow automation，支持规模化生产工作流程
编辑此页
最后由 Yonggan Wu 于 更新