Input Form Widget

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 even icons.

To edit a specific section of this widget, you must hover over the desired element and click it. Promptly, a new page will appear on the right side with all the editable options for the selected element

Info
This widget works for both dashboards, Normal and Blueprint.

1. Sections

Sections are the main structure of the form, and each section has its own fields.

It is possible to show a divider between sections, duplicate sections, remove the captions, and more.


2. 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 data storage.

Input form has many field types, like Address, Barcode, Calendar, Checkbox, Device, Dropdown, Text, and more.

Learn more about Input Form fields type.

As well, it is possible to change the field's visibility based on other fields' values.

2.1. '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.
2.1.1 'Data From' for 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.

2.1.2 'Data From' for 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 or Blueprint Entity and input the name of the variable or field that contains the information.

InfoWhen 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.
Notes
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. Read more here.

3. Buttons

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

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

Info
When the button triggers an analysis, it sends the field data and the button identifier through analysis's scope.
    • Related Articles

    • Field Types for Input Form

      The field is the structure that contains the relation between the inputted data and the Device data in some widgets. Fields can have a bunch of types, depending on the widget that it is dealing with. 1. Text A typical text input will appear, and the ...
    • Input Control Widget

      The Input control allows users to submit values to variables through a form. Editing the form The Input control is a very dynamic widget, as you can customize its colors, layout, text, and even icons. To edit a specific section of this widget, you ...
    • Form Fields Visibility

      Fields Visibility offers the possibility to control the visibility of certain fields in your Input Form widget. By using this feature, you are able to define conditions to hide some fields based on the values of other fields. For example, the field ...
    • Pie Widget

      Using data from multiples variables, the Pie widget automatically produces a Pie Chart, where each slice represents variable data. This widget also accepts features like metadata, that can be set in your variable data. Creating your own To add it to ...
    • Icons Widget

      With icons, the user can create very personalized widgets for their applications, and the result can look like the ones shown below, but the possibilities are endless. Users can add up to 9 variables in this widget, and each variable will show its ...