Grouping devices

The Device Inventory allows you to organize devices in statically or dynamically defined custom groups. They help you navigate through your device fleet and can be used as a basis for defining the scope of mass management operations such as tasks and rules.

Тhe Device Inventory provides three group types - static directory groups and tag groups, and dynamic filter groups.

Directory groups

Directory groups organize devices hierarchically in a tree-like structure and can contain an arbitrary number of devices and/or other groups of the same type. A device can belong to only one directory group at a time, but can be moved between directory groups at any time.

Directory groups, as well as devices added to directory groups, are automatically assigned a groupPath attribute, as part of their Info attribute.

The specific format of the groupPath attribute:

  • for directory groups is "groupPath": "/parent_path/group_name"

  • for devices, included in a directory group is "groupPath": "/parent_path/my.namespace:device_id"

The following example illustrates the format that you will have for a device added to a directory subgroup:

group1 ("groupPath": "/group1"*)
\___ subgroup ("groupPath": "/group1/subgroup")
\___ my.namespace:device_id("groupPath": "/group1/subgroup/my.namespace:device_id")

Tag groups

Tags are also treated as groups and facilitate the search for devices according to flexible criteria. You can add multiple tags to a device, therefore such a device will be included in multiple tag groups.

Filter groups

The members of filter groups vary on the basis of the current state of the devices being filtered. A filter group is created by saving a search filter for future use. Thus every time you apply this saved filter, it will involve different members. An example of such a filter is all devices that are currently online, or perhaps all devices with a particular software version installed.

You can add custom attributes to each of these group types . These attributes can be used for marking valuable service information like notes on the executed management actions on the group. For example, they can be used to see what updates have been sent to all devices in the group. Find out some examples in Working with attributes and the related pages in the Developer guide.