Data Source Selector Configuration
Overview
The Data Source Selector is a dynamic filtering tool that allows users to interactively select and switch between different Devices or Entities within a dashboard. It enables dashboards to automatically update their content based on the selected item—for example, switching between sensors to display different temperature readings. This feature provides high scalability, allowing a single dashboard to display data from n sensors. Additionally, it supports the creation of hierarchical structures, such as Organization → Site → Device → Sensor.
Configuring the Data Source Selector
The Data Source Selector utilize a tag-based filtering system. Two main type of filters exists, the Filter by Tag or Filter By Data Source Selector (Tag Match). Below is explaining in detail how each works.
1. Filter by Tag
When applying a filter by tag, only the devices/entities with the specific tags assigned are displayed. See the example:
- Show only "Building Entities" (tag:
type:building). - Show only "Apartment Entities" (tag:
type:apartment). - Show only "Sensor Devices" (tag:
type:sensor).
| Selector ID | Label | Filters by Tag |
|---|---|---|
selector1 | Building | type:building |
selector2 | Apartment | type:apartment |
selector3 | Sensor | type:sensor |
You may need to establish relationships between them to ensure filtering works based on the selected item—for example, displaying only the apartments associated with a specific building. To achieve this, see item 2. Filter By Data Source Selector (Tag Match), which allows you to define the necessary relationships for context-based filtering.
2. Filter By Data Source Selector (Tag Match)
This feature enables cascading/dependent filtering between multiple Data Source Selectors. When you select an item in one selector (the "parent"), it automatically filters the options in another selector (the "child") by matching their tags. Example:
- Parent Selector makes a selection "Building A".
- The Child Selector then only shows items that belongs to "Building A". Such as: Apt 1a, Apt 1b, Apt 1c.
| Selector ID | Label | Filters by Tag | Filter By Data Source Selector (Tag Match) |
|---|---|---|---|
selector1 | Building | type:building | |
selector2 | Apartment | type:apartment | selector1 > tag key: building |
selector3 | Sensor | type:sensor | selector2 > tag key: apartment |
Note that to configure the Filter By Data Source Selector (Tag Match), you need to specify the selector you want to associate and the tag key. The tag value will be dynamically set based on the selected item.
In the example above, if selector1 is set to "Building A" and its tag is building:Building A, then selector2 will display only the items that have both type:apartment and building:Building A.