User List Widget

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 will be shown in the list.

Setting up user 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. User List filtering

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

You can easily set up tags on your devices by accessing the User`s page.

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

b) Match with Blueprint Device tags
You must select a blueprint device from the dashboard and one tag key.
The user 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 user to show up for the column.

Setting up column information

a) User Information
Shows a piece of specific information from the User, such as the user name, ID, email, time zone, company, and more.

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

Tags values in the ISO-8061 date format will be displayed as Date.

4. Editing user parameters

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

User Information such as ID, email, and password can't be edited.

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

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

5. Blueprint User 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 user to show up in the list. Without the Access Rule, users doesn't have access to viewing other users the User List expects to show, even with your filtering from the Step 2.

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

    • Related Articles

    • 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, ...
    • Custom Widget

      Custom widgets allow developers to incorporate powerful content in their own widget for their dashboards. Creating your own The sky's the limit when using this widget. You can build your widget using Angular, React, Vue.js, or even plain old ...
    • 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 ...
    • Tile Widget

      Tiles allow you to simplify how users interact with your dashboards by providing a more intuitive and beautiful set of options. Use Tile to display clickable images that will redirect user to another website, dashboard or tab.  Creating your own To ...
    • Card Widget

      Use Card to display the last value of a variable, its unit, and a mini-chart. Card accepts links so that when users click on it, it may redirect them to another website, dashboard, or tab.  This widget also accepts features like metadata, that can be ...
        Take a look at our updated roadmap here!
          What would you like to see on TagoIO?

            Future and past Webinars