Input Form Widget

The Input form allows users to submit values to variables through a form.

Editing the form

The Input form is a very dynamic widget. You can customize its colors, layout, text, and icons.

To edit a specific section or element of this widget, hover over the desired element and click it. A panel will appear on the right side with all editable options for the selected element.

Sections

Sections are the main structure of the form, and each section has its own fields.
You can show a divider between sections, duplicate sections, remove captions, and more.

Fields

Fields are associated with a variable and device using the Data From. Once the form is submitted, the data can be sent through the device’s storage.

Input form has many field types, such as Address, Barcode, Calendar, Checkbox, Device, Dropdown, Text, and more.
Learn more about Input Form fields type.

It is also possible to change a field’s visibility based on other fields’ values: see the article on Form fields visibility.

Data From Field

This field allows you to set the device and variable that will be used in this widget. This field is dependent on the type of dashboard you are using; the difference is explained below.

Normal Dashboards

From the option Data From on the right menu, select the source of the data, which can be either a Device or an Entity. After that you can select the specific Device or Entity and its field or variable.

Blueprint Dashboards

From the option Data From on the right menu, select the source of the data, which can be either a Device or an Entity. Add the Blueprint device and input the name of the variable or field that contains the information.

When using a Blueprint dashboard, the inputs Variable or Field will not list the contents to be picked because it doesn't know the entities or devices linked to your Blueprint Associations.

When using Entities, certain fields might be marked as required. If these essential fields are not included in your form, an error will occur. To resolve this issue, you can either add the missing fields to your input form or modify the field settings in your Entity so that it is no longer mandatory. See the article on Entities.

Buttons

It is also possible to create and customize buttons that can perform actions such as running analysis, clearing fields, and sending data to the device.

After the button has been clicked, you can show a confirmation dialog message that needs to be accepted so that the actions of the button can be performed.

When the button triggers an analysis, it sends the field data and the button identifier through the analysis’s scope.