Edit on Github

Substeps Schema

A schema that is used to validate a part of Laboperator workflow templates.

Schema

A substep is a single instruction of a step and can both content and actions attached to it.

Substeps Schema
primaryrequired
string (Primary Instruction) <= 200 characters

The primary line of instructions. Field values can be embedded by enclosing a field identifier in double curly braces.

Example 1:
Place {{sample}} on {{balance}}.
secondary
string (Secondary Instruction) <= 100 characters
The secondary line of instructions.
Example 1:
Caution! {{sample}} is super expensive...
description
reference (Description)
Markdown Formatted Content

The description fields can be used to add details to the substep. As it supports markdown, you can use basic formatting, links, tables and even images.

expandDescription
boolean (Initially expand the description?)

A flag to indicate whether or not to show the entire description for this substep right away.

The default is false, which will cause only the first line of the description to be visible. Of course the user can always decide to expand the description when required.

Not expanding the description by default keeps your workflow interface clean and the user can get a good overview of the substeps, while an expanded descriptoin will make sure an important notes or images you might have put in the description will be shown.

confirm
boolean (Show manual confirmation button?)
Display a manual confirmation button to complete the substep.
inputs
Array of reference (Substep Inputs)
Member Name

A list of fields to show inputs for on the substep. For each field the substep will display an appropriate input component.

Use the title and description properties of the field schema to control the label and help text of an input.

buttons
Array of reference (Substep Buttons) <= 4 items
Button
A list of buttons on the substep.
devices
Array of reference or reference (Substep Devices)

A list of fields to display as devices on the substep. For each device the substep will display general information, status and activities such as invoked commands.

Array
One of
  • Member Name
  • Device Object
reference
Member Name

The identifier of a field that is a device or channel relation.

elements
Array of reference (Substep Data Elements)
Step Element Schema

Data elements allow to render data from device channels on the substep.

timer
reference or reference (Substep Timer)

A timer to display on the substep. The timer can be started using displayed buttons or using actions. With no default_duration given or duration set to 00:00 it can be used as a stop watch.

For full flexibility the timer can either implicitly define a field and behaviors to handle the manual buttons or you can a define timer field in the /fields section of the step or the workflow manually and reference it here.

Behaviors to handle the buttons on the timer are automatically created for you. To skip creation of these behaviors, pass the skipBehavior flag to the timer definition.

Example 1:
myTimer
Example 2:
type: timer
defaultDuration: 2000
One of
  • Member Name
  • Timer
reference
Member Name
behaviors
selector

Where is this used?

Other schemas that have a reference ($ref) to this schema.