The Device List Block displays a list of devices for a given application. The list includes the device’s name, current connection status and number of defined attributes.
The block parameters are broken up into two sections …
You may choose to return all of your application’s devices or only devices that match any or all of a set of additional filters you provide. If choosing one of the latter two options, there are three types of filter you may provide:
Note: When building a device list using an Experience User context variable, it is extremely likely that you want to choose the “Match any of the filters below” option. Choosing the “Match all” option will, in most cases return no devices in your list.
Filtering by a device tag will return devices that match the key and value pair you provide. If choosing a tag that matches only against a key, any device with the key defined will be returned regardless of its value. The same holds true for choosing a tag that matches only against a value; if any key has a value matching your query, the device will be returned.
Filtering by an experience user context variable will return devices that are associated with that experience user through their membership in experience groups. Such a filter is useful when building experience dashboard pages that should display a list of all devices the associated with the current user.
Filtering by a search string will return devices whose name matches the provided string. This filter accepts an asterisk
* to search for any occurrence of the given characters in the device name. For example:
- Filtering with “dev” will display a device called “Device A” but hide one called “Second Device”
- Filtering with ”*dev” will show both the “Device A” and “Second Device” devices
You may override this behavior and link to a URL of your choosing. The custom URL supports Handlebars helpers, and information about the device (such as the name, ID and tags) is available within the template. For example, one could configure a device list block to behave as a table of contents for a dashboard built with context variables by linking to different contexts per device.
If a custom URL is provided, the link will always display, regardless of the user’s permission level or public status.