Storage

Associate storage information with specific records, enabling precise physical location tracking with visual coordinate-based storage maps

Specs

Label	Value
Version	0.2.0 (updated on 2025-06-23)
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 Storage widget enables precise physical location tracking by associating storage information with specific records. This widget empowers users to select predefined storage units—such as freezers, cabinets, or shelves—and visually displays the storage layout with an interactive coordinate-based map. Users can easily choose the exact location (e.g., row and column) within the storage unit, making it simple to manage and retrieve stored items efficiently. The intuitive interface seamlessly combines hierarchical storage paths with visual grid selection, allowing for clear visualization and precise storage coordination that streamlines sample and inventory tracking across laboratory environments.

Use case

1. Use this widget to track physical storage locations for inventory items in freezers, refrigerators, or cabinets.

2. Use this widget to manage sample placement in multi-compartment storage units with coordinate-based retrieval.

3. Use this widget when you need to document exact storage positions for regulatory compliance and audit trails.

Configuration

The widget will function with default settings, but you can use configuration options to customize the behavior and data connections.

• Table (Storage) - Choose the Storage table from the drop-down menu that contains your storage units.

• Column (Number of rows) - Select the column that defines the number of rows in each storage unit.

• Column (Number of columns) - Select the column that defines the number of columns in each storage unit.

• Column (Should transpose header) - Choose the column that determines whether row/column headers should be transposed.

• Column (Parent) - Select the column that defines the parent-child relationship for nested storage units.

• Should hide storage map - Toggle to hide the visual storage map and show only the storage path and coordinates.

Configuration 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.

The readonly view displays the storage location with specific coordinates. By default, only the immediate storage unit name is shown. Click the Show full path button to display the complete hierarchical chain of parent storage units leading to the current location. The Update button allows users to refresh the storage path if changes have been made to the storage hierarchy.

Edit view

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

Click the Storage dropdown to select a storage unit from your available storage options. Once selected, the storage grid automatically updates to reflect the actual layout configuration of that storage unit. You can click on any cell in the visual grid to set the coordinates, or manually enter the coordinate values in the input field if you prefer direct entry. Additionally, you can select a color to visually identify the item's location when displayed in the Storage Map widget.

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 same as 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 is stored in JSON format with the following keys:

• storage - Object containing the storage unit's SID and name

• coordinates - String value representing the grid position (e.g., "A1", "B3")

• color - Optional color value for visual identification in storage maps

Example:

{
    "storage": {"sid": "xxx", "name": "xxx"},
    "coordinates": "A1",
    "color": "#FF5733"
}

Default value

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

Default value should follow the same JSON format as shown above, with valid storage SID and coordinate values.

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 a colon and the storage coordinates. For example: SG1: A1