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.
A typical text input will appear, and the value will be anything that was typed into it.
It will display a text field integrated with Google Maps to look for an address, and the values for this field will be the complete address selected and it will also have the location coordinates within it.
For the Input Form Widget, it is possible to enable a map under the input.
It will display a calendar field that allows the user to enter a date, or a date range, as a value through a calendar popup. When receiving the user answer in your bucket, you will be able to get it in the value parameter and the metadata parameter. The latter one will be in date string format as
For example, the input above will produce the following payload:
"value": "Start: 2021-06-04T03:00:00Z, End: 2021-06-11-T02:59:59Z",
A traditional checkbox will appear and the value will be set as true (checked) or false (not checked)
5. Clock set
It will display a step button to select the hour range without the date.
It will display a dropdown field with all an account's devices. The value of the field will be the id of the selected device.
You can customize the devices shown by the list through tags. Configuring tags will show only the devices with a tag correspondence.
It displays a dropdown menu with options that you define. The value of the field will be the selected options, and these options can be defined as static or dynamic with the dropdown being filled up with data coming from a variable. Learn more about Creating Dynamic Dropdown selection using Forms.
8. Dropdown Multiple
It displays a dropdown menu with options that you define. The value of the field will be the multiple options selected, and these options can be defined as static or dynamic with the dropdown being filled up with data coming from a variable.
It displays a field to submit multiple emails, separated by a comma.
10. File Upload
It will display an option to upload files to TagoIO. These files will be stored in the files section under the folder
buckets/your_bucket_id/ by default. It is possible to restrict the number of files per upload, allow users to use their mobile camera, and more.
You can customize the path, however. For example, if you want to save the files in a folder called
images and a subfolder called
icons, you would need to type
The variable that receives this data keeps the file name in the value parameter, and in the metadata it keeps the file's parameter. So sending a file will produce variable data like this:
11. Filtered Variables
It will display a dropdown field, with options that change dynamically based on other fields. In the example below, the Food field changes based on the Food Type field. Learn more about Filtered Variables
12. Image / Video Select
Whenever you need to choose a value by using images instead of entering text, the image Field is the best option in form widgets. By entering media URLs into the options, the field will be filled with these images or videos and you will be able to select one or many of them. Learn more about Adding Image Selector field on Forms.
13. Incremental Step
It will display a step button to select a numerical value.
A traditional Radio input will appear. Once selected, you will be able to define its options with their labels and values. The value of the field will be one of the selected options.
This field is the only one that doesn’t represent a value to be sent with the form. The variable set to this field type expects to receive data (text) to show as a message above the form. Besides the text, you can also define the type of message that will appear. There are four types: warning, info, danger, and success. You can do this by sending a property
type in the metadata object of your data.
16. Other fields
- Barcode: It will display a field to type the barcode or scan it when using it through mobile or computer.
- Capture user: It will capture user information, such as e-mail or name, so that you can use it in the Analysis later.
- Hidden: For submitting data without user input, this variable will receive a static value, set by the field edit screen.
- Number: It will display a text input, but it validates if a number was typed.
- Password: It will display a password input.
- QR Code: It will display a field to scan a QR Code when using it through mobile or computer.