Device List Widget

Device List Widget

The Device List widget is a table that dynamically populates with information about your devices, such as names, tags, configuration parameters, and IDs. It can't access devices' data, however.

1. Editing the device list

It works as a dynamic table, as you can customize its colors, columns, and filter which devices will be shown in the list.

Setting up device filtering

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

2. Device filtering

This option is required to be filled up in order to show your devices. You can either filter the devices that will show up in your list by the devices' tag key and tag value, or by tag match for one of the blueprint devices on your dashboard.
You can also have multiple filters working at the same time. It works as an AND operator, and the device must match all the filters.

You can easily set up tags on your devices by accessing the Device's page.

a) Filter by Tag Key and Tag Value
All devices for the list must have the same tag key and tag value specified by you in this filter.

b) Match with Blueprint Devices tag
You must select a blueprint device from the dashboard and one tag key.
The devices for the list must match the same value of that tag key in the selected blueprint device of the dashboard.

3. Setting parameters on Columns

Every column created will require you to select a parameter from the device to show up for the column.

Setting up column information


a) Device Information
Shows a piece of specific information from the Device, such as the device name, ID, Connector, or Network.

b) Tag Key
Shows a value of a specified tag key. It will be an empty row if the tag key doesn't exist in the device settings.

c) Configuration parameter
Shows a value of a specified configuration parameter. It will be an empty row if the configuration parameter key doesn't exist in the device settings.

Configuration Parameter values in ISO-8061 date format will be displayed as Date.

4. Editing device parameters

You can allow users to modify a tag or configuration parameter value inside of the list by enabling the edit option located inside the column's configuration. 

Device Information such as ID, Connector, and Network can't be edited.

The device list offers a bunch of field types to indicate what kind of value can be submitted in the input once the user modifies it. These types are Text, Password, Number, Dropdown, Dropdown Multiple, and Address.

These field types have the same behavior as the Input Form's fields.

5. Blueprint Device List for TagoRUN

When sharing a blueprint dashboard to Run Users, you're required the additional step of creating an Access Rule in order for the devices to show up in the list. Without the Access Rule, users doesn't have access to the devices the Device List expects to show, even with your filtering from the Step 2.

Make sure you have an Access Rule for giving Blueprint access of the devices to the RUN Users. The rules must match in some way the devices you are applying on the Device List filter.

    • Related Articles

    • User List Widget

      The User List widget is a table that dynamically populates with information about your users, such as names, tags, email, and IDs.  1. Editing the user list It works as a dynamic table, as you can customize its colors, columns, and filter which user ...
    • Device Token

      The secret key used between TagoIO and your device is called Device Token. An access from a device will only be granted with a valid device token. This token should be kept in secret and only be shared with those you trust. Each time a device is ...
    • 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 ...
    • Device Emulator

      The device emulator is a powerful tool for developers to send data to buckets as if it was sent by a real device. The emulator is intuitive and requires just a few clicks to validate and send your data package. To access the device emulator, go 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 ...

    Webinar Announcement - Image Only

        Take a look at our updated roadmap here!
          What would you like to see on TagoIO?

            Future and past Webinars