Nested Fields

Provide signature and timestamp of specific activities.

Specs

Label	Value
Version	1.1.0 (updated on 2024-12-19)
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	Yes

Overview

This Signature widget is the replacement of previous TimeSeal widget.

The Labii Signature widget is a powerful tool that serves as an unofficial digital signature, allowing users to record specific actions, along with their user details and timestamp information. This widget offers a secure and tamper-proof way to document important interactions, providing a digital fingerprint for each action taken. It's particularly valuable for maintaining a transparent and reliable record of user activities, making it an ideal choice for activities like document approvals, data changes, or any situation where a digital paper trail is needed. The Labii Signature widget enhances data integrity and accountability by affixing an indisputable timestamp to each action, ensuring trust and authenticity in digital processes.

Use case

1. Use this widget to approve the purchase of lab supply.

2. Use this widget to checkout the aliquots.

Configuration

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

• Text - The text of the button. Default to 'Sign'

• Icon - The icon of the button. See a list of supported icons at https://fonts.google.com/icons?icon.set=Material+Icons. Default to 'draw'.
• Text to deny - Text to disapprove the data. If provided, a 'Disapprove' button with the text will appear, and users will have the option to disapprove the data.

• Icon to deny - The icon of the disapprove button. See a list of supported icons at https://fonts.google.com/icons?icon.set=Material+Icons. Default to 'cancel'.
• Team - Select a team to limit the permission to seal. If not selected, all active users with write permissions can seal.

• Should limit to oneself - If this box is ticked, individuals can only choose themselves.

• Format - Format the time to be displayed. Default to "YYYY_MM-DD HH:mm:ss". Learn more at https://momentjscom.readthedocs.io/en/latest/moment/04-displaying/01-format/
• Should enable cancel button - If selected, the cancel button will be displayed, allowing the user to abort the sealing action.

• Should archive on seal - If checked, the record will be archved on seal. For example, archive a aliquot after checkout.

Examples:

Use the widget to checkout the aliquots.

{
	"text": "Checkout"
	"format": "YYYY-MM-DD HH:mm:ss",
	"should_enable_cancel": false,
	"should_archive_on_seal": true
}

Display both approve and deny buttons.

{
	"text": "Approve"
	"text_deny": "Deny"
	...
}

Include cancel button after Approve or Deny.

{
	"text": "Approve"
	"text_deny": "Deny",
	"should_enable_cancel": true,
	...
}

Limit the user to only one team.

{
	"team": {"sid": "xxx", "name": "xxx"}
	...
}

Limit the user to select themselves only.

{
	"should_limit_to_oneself": true
	...
}

Views

See the interface of the widget in the following views.

Readonly view

Readonly view display the values of the column.

Before click:

After click:

Edit view

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

If a user is selected, only the selected user can provide the signature.

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 the 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

JSON

{
	"user": {
		"sid": "xxx",
		"name": "xxx"
	},
	"timestamp": "xxx"
}

Default value

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

Default value shall be the user name in the format of "[First name] [Last name]". For example: John Goodway

Import value

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

Import value shall be the user name in the format of "[First name] [Last name]". For example: John Goodway