Search results

Configuring Custom Attribute

Custom attribute is a piece of code that acts like a parameter, which is replaced anywhere in the query varied by the users. The attribute name is replaced by the code, which is saved for each user that makes the dashboard to get rendered based on it.

Custom attribute hierarchy

Custom attribute can be defined in three levels:

  1. User level
  2. Group level
  3. Site level

The user level attribute has high priority than the other levels. The group and site level attribute can be override in the user level. Also, the site level attribute can be override by the group level attribute.

User level attribute

This attribute can be set by the site admin for a user in the user management profile page. You can view the attributes inherited from the group and site level in the user’s attribute listing.

User Level Add Custom Attribute Button

Group level attribute

This attribute can be set by the site admin for a group in the group profile page. You can view the attributes inherited from the site level in the group’s attribute listing.

Group Level Add Custom Attribute Button

Site level attribute

This attribute can be set by the UMS admin for a site in the site details page.

Site Level Add Custom Attribute Button

Adding custom attribute

Attributes are name-value pairs that are associated with users, groups, and the sites (tenants).

Custom Attribute Window

Name – Name of the attribute.

Value – Value of the attribute.

Description – Explaining the purpose for this attribute.

Encrypt – Store it as encrypted one in database and the value will be shown as dots in the grid.

Applying custom attribute for different users

Let us consider for the user James has the custom attribute value is configured as Sectors IN (‘Industrial’, ‘Traffic’) with the attribute name as Sector.

Use custom attribute for user James

For the user Christ , has the custom attribute value is configured as Sectors IN (‘Residential’, ‘Commercial’) with the attribute name as Sector.

Use custom attribute for user Christ

Uses of custom attribute

The custom attribute can be used only in the custom query. It can be used in the query by manually providing the required custom attribute name in code view using the syntax.

Syntax: ${{:AttributeName}}

Use custom attribute in code view

Here, created a simple dashboard for James, the data is retrieved based on the condition for the column Sectors as given in the custom attribute Sectors.

Sample Dashboard for user James

For Christ, the data is retrieved based on the condition for the column Sectors as given in the custom attribute Sectors.

Sample Dashboard for user Christ