This article will cover:
Groups
Groups are essentially folders or containers used to house child groups, sensors and calculations. Groups allow users to build up an organized structure to store and monitor their assets.
Add Group
Groups can be added to a Project or to another group. This can be done in several ways from a few different buttons/menu options…
Right clicking on a Project (when not in Connectivity Mode)…
Right clicking on a group…
From the Project Details page…
From the Group Details page…
From the “Add new” option beneath the sensor management tree…
All options will trigger a dialog to appear…
Entering a name and clicking “Create” will place this group into the tree at the location specified.
Group Details
To browse to the group details page users can simply click on any group in the resource browser tree, this will present them with a detailed summary of that group including counts of child groups, sensors, calculations and observations – all in a graphical dashboard form.
From here users can create subgroups, add calculations, associate sensors into the group, rename or delete itself.
Delete Group
Deleting a group is possible in 2 ways – users can right click on a group in the tree and select “Delete”…
This will trigger a confirmation dialog…
If Delete is clicked the group will be removed from the tree along with all sub-groups and calculations it contains. Any sensors will have their group association removed and appear under the project group in the tree. This action cannot be reversed.
Deleting a group is also possible using the “Delete” button on the group details page…
The confirmation dialog and associated actions remain the same regardless of which delete action is chosen.
Rename Group
Renaming a group is possible in 2 ways – users can right click on a group in the tree and select “Rename”…
This will trigger a rename dialog as show below…
Clicking “Save” will rename the group with displays updated in both the tree and the group details page.
Renaming is also possible directly in the Group Details page…
Clicking “Save” will rename the group with displays updated in both the tree and the group details page.
Associate Sensor
This feature will give users the ability to associate or disassociate a sensor to and from a group.
A sensor can only be associated to one group at a time – a 1:1 relationship. If a sensor or calculation is not associated to a group it will appear beneath the Project in the tree.
To begin this process there are 2 possible routes – drag and drop or using the right click context menu.
Drag and Drop
To associate a sensor with a group simply select the sensor in the tree and begin to drag that sensor to the group of your choice. You will see a blue highlight appear similar to below…
Upon dropping you will be presented with a confirmation dialog detailing the move…
Clicking “Move” will confirm the move and update the tree, “Cancel” will undo the move and no changes will be made.
Context Menu
The alternative to drag and drop is to right click on any group and choose “Associate sensor”…
This will then open a dialog which may look familiar – the “Entity Picker” as shown below. This dialog is used in several features throughout iTwin IoT to select/identify sensors. Simply select the sensors you would like to associate or disassociate with your group – all associated sensors will display on the right hand in the “Selected Sensors” list. Clicking “Done” will confirm the sensor association.