Create/Modify/Delete Semantic Groups

Create Semantic Group

You can create semantic group in five different ways:

1. Create new template while creating semantic group

  • Click on Create group button in Data Semantics tab
  • Click on Create template link

  • You will immediately get all the prompts necessary to make a template
  • Enter name for your template
  • Continue by adding Attribute - provides additional information about the semantic group
  • Choose Attribute type
  • If you check Attribute required box, value text box will be mandatory for all Attribute types

  • If numeric - enter number as value
  • If string - enter text as value
  • If boolean - check value box
  • If location - enter coordinates as value
  • You can add multiple number of Attributes

  • Continue by adding placeholder for Sensor’s feed
  • Go to Sensors tab
  • Click on Add sensor link

  • In new text field enter Sensor name, Reading type and Unit
  • Now that you created a placeholder, click Map data button to map sensor’s feed to the placeholder

  • New dialog with search option will pop up
  • Search by entering device/sensor name

  • Choose sensor
  • Click Save
  • You can add multiple number of sensors
  • Continue by adding placeholder for Actuator
  • Go to Actuators tab
  • Click on Add actuator link

  • In new text field enter Actuator name and Reading type
  • Now that you created a placeholder, click Map data button to map actuator to the placeholder

  • New dialog with search option will pop up
  • Search by entering device/actuator name

  • Choose actuator
  • Click Save
  • You can add multiple number of actuators
  • Continue by adding placeholder for Alarm
  • Go to Alarms tab
  • Click on Add alarm link

  • In new text field enter Alarm name

  • Now that you created a placeholder, click Map data button to map alarm to the placeholder
  • New dialog with search option will pop up
  • Search by entering device/alarm name

  • Choose alarm
  • Click Save
  • You can add multiple number of alarms
  • Now that you have created the template and the semantic group, click Save to finalise the process
  • Semantic group will appear in Data Semantics tab in Semantic groups field
  • Template you created will appear in Templates tab
  • Now you can continue with making your semantic group

2. Create template and then create semantic group

  • Go to Templates tab
  • Click on button to create new semantic group template

  • You will jump to Create templates screen
  • Create template as described in 1. Create new template while creating semantic group

3. Choose template from those already created

  • This will automatically generate all the placeholders for Attributes/Sensors’ feeds/Actuators/Alarms you have created with a template
  • To continue the process, check Update template [name] box
  • Click Save and finalise the process of creating a semantic group
  • Semantic group will appear in Data Semantics tab in Semantic groups field

4. Create semantic group without creating template

  • Go to button and start creating semantic group as described in the beginning of this section
  • Skip choosing template or creating new template steps

  • Create your semantic group by adding any Attribute/Sensor/Actuator/Alarm as described in 1. Create new template while creating semantic group
  • Click Create to complete the process
  • Your semantic group will be created and listed in the Semantic groups tab

5. Create semantic group in Device Management module

You can create semantic group in Device Management module while creating your device. At the final step of creating device, you can check Create semantic group from this device box. The semantic group with the same name as the created device will appear in the Semantic groups list in the Data Semantics module.

For more information on how to create semantic group in Device Management module, go to User Guides/Device Management/Create/Delete Devices section.

Note: Each feed/actuator/alarm displayed in a semantic group is presented in form of a tile with its name, graphic representation of sensor’s feed/actuator/alarm in question and the info if the source (the device sensor’s feed/actuator/alarm comes from) is active, inative or removed.

Modify Semantic Group

You can modify semantic group in various ways:

  • Edit
  • Move to
  • Move to first level
  • Delete

Edit Semantic Group

To edit semantic group:

  • Click on a semantic group tile
  • You will jump to the box that contains tiles of feeds/actuators/semantic subgroups
  • Click on Edit group button above the box
  • New window will pop up with Info and Access tab

Info tab contains text file in which you can modify the name of the (sub)group.

  • You can also Add attribute, Cancel and Update the changes you made
  • Access tab enables you to modify the access to your semantic (sub)groups and the data it contains
  • Click on Edit group button
  • New window will pop up with Info and Access tabs

Note: The Access tab in Edit semantic group pop-up may/may not be displayed depending on your business context!

In Info tab you can edit group’s attribute or even add some new ones.

In Access tab you can edit the access to the semantic group you have created, or the one you have the permission to modify.

  • The pop-up window will display (sub)group access permission list and the name of the user who has created it (Creator)

  • You can edit the name and the access permission (private/public) of the semantic group
  • To change the access permission from Public (default) to Private, choose Private from a drop-down list

  • New window Are you sure you want to change this device asset access to private? will pop up

  • Click CONFIRM
  • In new text field Add member add one or more users with whom you would like to share the (sub)group you have created or have the access to

  • You can add an infinite number of members
  • To expand the access to other subgroups, check Propagate access list to all semantic subgroups check box
  • Click Update to confirm all the modifications you have made

Move To

Move to option in semantic group screen enables you to move the semantic GROUP in question to another semantic group and make it a SUBGROUP.

To do so:

  • Click on Move to button
  • New widow will pop up with the list of all the semantic groups you created/have the access to

  • Choose the semantic group
  • Click Save
  • Your semantic group is now a subgroup of the group you have chosen

Move to First Level

Move to First Level option allows you to move semantic SUBGROUP to the first level and make it a first level semantic GROUP.

To do so:

  • Click on Move to first level button
  • You will jump to the screen with first level semantic groups

  • Your semantic subgroup is now displayed in the screen

Delete Semantic Group

To delete semantic (sub)group:

  • Go to Delete group button

  • New confirmation dialog will pop up
  • Click Delete

Please note that if you delete semantic group, all of its data, including subgroups will be deleted from the Semantic groups list, but will remain in the Data tab.