Storage

Associate storage information with a specific record

Specs

Label	Value
Version	0.1.0 (updated on 2025-05-26)
Developer	Labii Inc.
Type	Column
Support Configuration	Yes
Support Readonly view	Yes
Support Edit view	Yes
Support Form view	Yes
Support Default value	Yes
Support Import	Yes
Allow multiple	No

Overview

The Labii Storage widget is designed to associate storage information with a specific record, enabling users to track where an item is physically stored. This widget allows users to select a predefined storage unit—such as a freezer, cabinet, or shelf—and visually displays the storage layout with a coordinate-based map. Users can easily choose the exact location (e.g., row and column) within the storage, making it simple to manage and retrieve stored items efficiently. The intuitive interface supports clear visualization and precise storage coordination, streamlining sample and inventory tracking across labs.

Use case

1. Use this widget to store the storage information for inventory.

Configuration

The widget will function without additional setup, but you have the option to utilize the configuration to customize the button.

• Table (Storage) - Choose the Storage table from the drop-down menu.

• Column (Number of rows) - Choose the column (Number of rows) of the storage table.

• Column (Number of columns) - Choose the column (Number of columns) of the storage table.

• Column (Should transpose header) - Choose the column (Should transpose header) of the storage table.

• Column (Parent) - Choose the parent of the storage item from the drop-down menu.

• Should display full path - Whether to display the full path of the storage item.

Examples:

{
    "table_storage": {
        "sid": "CFIL0a40x124e7EJOTY49d",
        "name": "storage"
    },
    "number_of_rows": {
        "sid": "GJMP0a40x55f41INSX38ch",
        "name": "number_of_rows"
    },
    "number_of_columns": {
        "sid": "HKNQ0a40x55f42JOTY49di",
        "name": "number_of_columns"
    },
    "should_transpose_header": {
        "sid": "ILOR0a40x55f43KPUZ50ej",
        "name": "should_transpose_header"
    }
}

Views

See the interface of the widget in the following views.

Readonly view

Readonly view display the values of the column.

It displays each storage location in a hierarchical chain along with the specific stored coordinates. If you prefer not to view the full path, you can disable it by setting “Should display full path” to false. The Update button allows users to refresh and update the storage path if any changes have been made.

Edit view

The Edit view is the interface that allows you to modify the value.

Click the Storage dropdown to select a storage unit. Once selected, the storage grid will update to reflect the actual layout of that storage. You can click on a cell in the grid to set the coordinates, or manually enter the coordinate values if preferred.

Form view

The Form view is the field integrated into the add form for collecting values when creating a new record.

The form view is identical to the edit view.

Data

Each widget in Labii stores data in a unique manner; refer below to understand how data from this widget is stored.

Data format

Data stored in JSON format with the following keys:

• storage

• coordinates

Example:

{
    "storage": {"sid": "xxx", "name": "xxx"},
    "coordinates": "A1",
}

Default value

The Default Value field within the column allows you to specify the default value when a record is created.

Same as the data specified above

Import value

The Import Value is the value you need to include in your Excel table for it to be imported into Labii.

The import value should consist of the Unique ID of the storage record followed by the storage coordinates. For example: SG1: A1