Devices can be grouped according to a particular use case. A device can be located in multiple groups and groups themselves can again be part of multiple groups.
Cumulocity IoT distinguishes between top-level groups and subgroups:
Top-level groups are shown in the Group menu in the navigator at top-level.
Subgroups can be used to further subdivide top-level groups.
Managing groups
To view groups
Click Groups in the navigator to see all groups in a list format.
For each group, various information is provided, for example the type and name. Click Configure columns at the right, to add or remove columns and customize the view to your preference. See also Configuring columns.
To filter the groups for certain criteria, hover over the column headers and click the respective filter icon .
Note that this function only creates a temporary filter. For permanent filters, you can use the smart groups function.
Click a group to view its details.
Subassets page
At the top of the Subassets page, the name and the description of the group is displayed (editable), followed by the information when the group was created and last updated.
Below, all assets assigned to the group are listed. For each asset, various information is displayed, for example the type and name. As with the top-level groups list, you can add or remove columns and customize the list to your preference, or you can apply filters to filter the list for certain criteria.
Hover over the respective entry you want to delete and click the delete icon at the right.
Managing devices in groups
To assign devices to a group
You can assign devices to groups in several ways.
From the group perspective
You can quickly assign devices to groups by using the drag and drop functionality in the navigator, see Restructuring groups and devices.
Moreover, you can assign devices performing the following steps:
In the navigator, select a group from the Group menu and then open the Subassets page.
Click Assign devices at the right of the top menu bar.
In the list, select the devices you want to add. You may apply filters to reduce the number of displayed devices.
Click Assign to assign the selected devices.
The devices will be assigned to the selected group and shown as subassets in the Subassets page.
From the device perspective
Select a device from the device list and open it.
In the Info tab, scroll down to the Groups assignment card. From the dropdown field, select the group you want to assign the device to. You can also directly enter a group name here or you can enter just parts of a name to filter the list for it and only show the matching group names.
Click Assign.
The device will be assigned to the selected group.
If you search for a group by its name which does not exist yet, a New button will appear so that you can create a new group with this name from here and assign the device to that group.
Info
In order to create a new group, the user must have the permissions ROLE_INVENTORY_CREATE and ROLE_INVENTORY_ADMIN.
To unassign a device
Hover over the respective device you want to unassign and click the unassign icon at the right.
Unassigning a device does not delete the device, subdevices or any associated data. The device is only removed from this group.
To delete a device
Hover over the respective device you want to delete and click the delete icon at the right.
The device will be permanently deleted.
To view the device details
To display the details of a particular device, click its name.
The device details for the device will be displayed.
Restructuring groups and devices
You can easily restructure groups, subgroups and devices by a drag & drop functionality.
To move a group
In the navigator, select a group which you want to move to another group.
Drag and drop it to the desired group.
In the resulting dialog box, confirm the operation.
To move or add a device
In the navigator, select the group or device which you want to move or add to another group.
Drag and drop it to the desired group.
In the resulting dialog box, select if you want to move or add the device.
Using smart groups
Smart groups are groups dynamically constructed based on filtering criteria. This type of group can be used, for example, for bulk upgrades of devices of a certain type to a new software or firmware version.
Info
Smart groups are only available in the Device management application and not visible in the Cockpit application.
Smart groups can be created from the device list.
To create a smart group
To open the device list, click All devices in the navigator.
Filter the devices in the list to select the desired devices. See To filter devices for details on filtering.
Click Create smart group at the right of the top menu bar.
Enter a name for the group and click Create.
The new group will appear as a top-level group in the Groups menu of the navigator. Smart groups can be distinguished by a small cogwheel in the folder icon .
Below the smart group name and description you can see the filter criteria which have been applied on building the smart group. You can edit the filter settings here and adjust your selection.
To delete a smart group
Hover over the respective entry you want to delete and click the delete icon at the right.