跳到主要内容

消耗量

规格​

标签值
版本4.5.0（更新于 2025-04-14）
开发者Labii Inc.
类型列
支持配置是
支持只读视图是
支持编辑视图否
支持表单视图否
支持默认值否
支持导入否
允许多个是

概述​

Consumption 小插件用于简化实验室操作，为计算和追踪样品或试剂的剩余量提供便捷方案。研究人员可以通过直观的界面轻松输入初始量、记录消耗数据，并立即查看实时剩余量。Labii 的 Consumption 小插件不仅能提高准确性，还能节省宝贵时间，帮助实验室维持适当的库存水平并避免意外短缺，从而提高研究工作的效率和生产力。借助此小插件，用户无需手动计算，即可获得准确、便捷的结果。

Consumption 小插件还免除了手动换算不同单位数值的麻烦。只需在小插件设置中配置换算系数，即可自动进行单位换算。

使用场景​

  • 使用此小插件显示样品或试剂的剩余量。
  • 使用此小插件显示入库或出库数量的总和。
  • 使用此小插件根据发票项目计算发票总金额。

配置​

Consumption 小插件使用以下公式计算样品或试剂的剩余量：

$$ Remaining Volume (v) = Total Volume (V) - Sum(Consumption) $$

因此，需要预先在消耗表中配置总量列。

  • Column (Quantity) - 选择总数量列。如果此列留空，返回值将是所有消耗值的总和。
  • Column (Unit) - 选择数量单位列。
  • Table (Consumption) - 选择用于记录消耗数据的表。
  • Column (Source) of the Consumption table - 选择消耗表中与当前记录关联的列。
  • Column (Amount) of the Consumption table - 选择消耗表中记录已使用数量或体积的列。
  • Column (Unit) of the Consumption table - 选择消耗表中记录数量单位的列。
  • Conversions - 为使用的每个单位指定换算系数，并确保包含数量单位中的所有单位。未提供的单位将使用系数 1。
  • Threshold - 将阈值配置为特定数值或百分比；剩余量等于或低于该值时触发警告。例如，设为“10”时，剩余量达到或低于 10 会触发警告；设为“10%”时，剩余量等于或低于总量的 10% 会触发警告。
  • Query - 添加补充查询条件，进一步筛选显示的记录。
  • Stop condition - 条件满足时，公式停止计算。条件必须返回 true 或 false。此字段不支持其他列数据，只能使用变量 data 引用当前记录数据。
  • Should auto update when readonly - 选中后，此小插件会在只读状态下执行实时计算。

示例​

以下是使用消耗表数据执行计算的小插件配置。

{
    "unit": {
        "sid": "xxx",
        "name": "unit"
    },
    "amount": {
        "sid": "xxx",
        "name": "amount"
    },
    "format": {
        "decimals": "2",
        "thousand": ","
    },
    "source": {
        "sid": "xxx",
        "name": "source"
    },
    "quantity": {
        "sid": "xxx",
        "name": "quantity"
    },
    "threshold": "10%",
    "consumption": {
        "sid": "xxx",
        "name": "consumption"
    },
    "conversions": [
        {
            "unit": "µL",
            "factor": 1
        },
        {
            "unit": "mL",
            "factor": 1000
        },
        {
            "unit": "L",
            "factor": 1000000
        },
        {
            "unit": "µg",
            "factor": 1
        },
        {
            "unit": "mg",
            "factor": 1000
        },
        {
            "unit": "g",
            "factor": 1000000
        },
        {
            "unit": "kg",
            "factor": 1000000000
        },
        {
            "unit": "Each (EA)",
            "factor": 1
        },
        {
            "unit": "Dozen (DZ)",
            "factor": 1
        },
        {
            "unit": "Gross (GR or GRO)",
            "factor": 1
        },
        {
            "unit": "Pair (PR)",
            "factor": 1
        },
        {
            "unit": "Case (CS or CA)",
            "factor": 1
        },
        {
            "unit": "Pack (PK)",
            "factor": 1
        },
        {
            "unit": "Bundle (BDL)",
            "factor": 1
        },
        {
            "unit": "Carton (CTN)",
            "factor": 1
        },
        {
            "unit": "Set (SET)",
            "factor": 1
        },
        {
            "unit": "Roll (RL)",
            "factor": 1
        }
    ],
    "quantity_unit": {
        "sid": "xxx",
        "name": "unit"
    }
}

以下小插件配置用于计算库存入库总量。

{
    "unit": {
        "sid": "xxx",
        "name": "unit"
    },
    "amount": {
        "sid": "xxx",
        "name": "quantity"
    },
    "format": {
        "decimals": "2",
        "thousand": ","
    },
    "source": {
        "sid": "xxx",
        "name": "stock"
    },
    "consumption": {
        "sid": "xxx",
        "name": "checkin"
    },
    "conversions": [
        {
            "unit": "µL",
            "factor": 1
        },
        {
            "unit": "mL",
            "factor": 1000
        },
        {
            "unit": "L",
            "factor": 1000000
        },
        {
            "unit": "µg",
            "factor": 1
        },
        {
            "unit": "mg",
            "factor": 1000
        },
        {
            "unit": "g",
            "factor": 1000000
        },
        {
            "unit": "kg",
            "factor": 1000000000
        },
        {
            "unit": "Each (EA)",
            "factor": 1
        },
        {
            "unit": "Dozen (DZ)",
            "factor": 1
        },
        {
            "unit": "Gross (GR or GRO)",
            "factor": 1
        },
        {
            "unit": "Pair (PR)",
            "factor": 1
        },
        {
            "unit": "Case (CS or CA)",
            "factor": 1
        },
        {
            "unit": "Pack (PK)",
            "factor": 1
        },
        {
            "unit": "Bundle (BDL)",
            "factor": 1
        },
        {
            "unit": "Carton (CTN)",
            "factor": 1
        },
        {
            "unit": "Set (SET)",
            "factor": 1
        },
        {
            "unit": "Roll (RL)",
            "factor": 1
        }
    ],
    "quantity_unit": {
        "sid": "xxx",
        "name": "unit"
    }
}

视图​

在以下视图中查看此小插件的界面。

只读视图​

只读视图显示列的值。

在只读视图中，当剩余量小于或等于指定阈值时，系统会显示警告消息。

编辑视图​

编辑视图是用于修改值的界面。

此小插件不支持编辑视图。

表单视图​

表单视图是集成到添加表单中的字段，用于在创建新记录时收集值。

此小插件不支持表单视图。

数据​

Labii 中的每个小插件都以独特的方式存储数据；请参阅以下内容，了解此小插件的数据存储方式。

数据格式​

{
    "value": number,
    "is_low": bool
}

默认值​

列中的 Default Value 字段允许您指定创建记录时使用的默认值。

此小插件不支持默认值。

导入值​

Import Value 是需要包含在 Excel 表格中的值，以便将其导入 Labii。

此小插件不支持导入值。

备注​

信息

您可以使用小插件生成的“is_low”键筛选即将耗尽、需要补货的样品列表。

注意

此小插件仅在前端运行。这意味着，如果样品是通过导入生成的，而您从未打开过这些样品的详细视图，则使用 Consumption 小插件创建的列将保持为空。因此，筛选结果可能并不完全准确。要纠正这些错误，可以在列表视图中启用“Edit View”选项，以批量更新消耗量计算。

编辑此页
最后由 Yonggan Wu 于 更新