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.