Create/Edit/Delete Semantic Group Data

Semantic group data includes all the data you can have within one semantic group:

• semantic subgroups
• feeds
• actuators
• alarms
• attributes

Create Semantic Subgroups

Data Semantics subgroup represents a semantic group (child) in an already existing semantic group (parent). You can add a multiple number of (child) semantic subgroups in one parent group and/or multiple levels of (child) semantic subgroups.

To create a semantic subgroup:

• On the Data Management screen, double-click on the semantic (sub)group you want to create a subgroup for
• Select the Subgroups tab, and then click on the Add button

• This will open the Create Group sidebar
• Enter subgroup name
• Optionally, choose to create a subgroup using an existing template
• Click Save

Create Feeds

To create a feed for a semantic (sub)group:

• On the Data Management screen, double-click on the semantic (sub)group you want to create a feed for
• Select the Feeds tab, and then click on the Add button

You will be prompted to the Create Feed screen. Here you will need to enter:

• Feed Name - at least three characters long
• Feed parent field will be prepopulated with the name of semantic (sub)group for which you are creating the feed
• Stale after value - number of minutes after which a reading coming from a feed will be considered stale due to lack of updates (e.g. malfunctioning or non-responsive device). Set to 30 by default
• Unit - enter at least one character to be able to select a unit of measurement from the drop-down list
• Data Source - device/sensor which will provide data for the feed. Enter at least three characters to be able to select a device/sensor from the drop-down list
• Click Save

Create Feed Threshold

You can also set thresholds for the feed you are creating. Feed threshold functionality allows you to set multiple, gradable thresholds on a feed, apart from its minimum and maximum values.

To create feed threshold:

• Click on next to the feed for which you want to create a threshold
• Click on DS

• This will open the Set thresholds sidebar
• Enable thresholds by click on the toggle switch
• The range is defined by minimum and maximum values.
• To create new threshold click the Split button

After performing a splitting action, the interval splits into two and a new interval row field appears.

In a new interval field define the State (Normal, Warning or Alarm), the end value to which that interval will last (To field) and the message that will be displayed in the Messages module and in the Notifications drop-down.

• To, State and Message fields are directly copied to the threshold that is currently being set
• To, defined in the previous field, is set as From in the next active field
• All To fields are in the right order - from lower to higher value

Split action can be performed on all intervals.

Click on Save to finish the process.

Change Feed Source

If device’s data (feed/actuator/alarm) is deleted/removed, it will be displayed as No Source inside the grid.

If device’s data you have put in a semantic group is put offline, it will be displayed as Source Not Active inside the grid.

You can remap feed/actuator/alarm with another one, but it needs to have the same reading type (e.g. temperature to temperature only), and needs to be expressed in the same unit (e.g. temperature in ⁰C, not F) as a previously removed feed/actuator/alarm. This way, removed device history will be remapped to a new device.

To change feed source/remap feed:

• Click on next to the feed for which you want to change source/remap

• This will open the Change feed source sidebar
• Choose new source
• Click Save

Download Raw Data from Feeds

To download raw from feed(s):

• Check the checkbox next to the feed for which you want to download raw data
• Click on More at the top of the grid
• Click on Download raw data

• This will open the Download raw data sidebar
• Enter time interval for which you want to download raw data using date picker
• Click on Download

Create Actuators

To create an actuator for a semantic (sub)group:

• On the Data Management screen, double-click on the semantic (sub)group you want to create an actuator for
• Select the Actuators tab, and then click on the Add button

This will open the Create Actuator sidebar. Here you will need to enter:

• Actuator Name
• Actuator Type - you can choose between three different types actuation values: Boolean (actuators with only two values/states, such as on/off switches), Count (actuators with a range of values/states, such as dimmer switches or thermostats), and Text (actuators which can display text, such as screens on devices ).
• Select which actuator you will actuate from the Source drop-down list
• Click Save

To actuate actuators:

• Click on the actuator to open the focus drawer
• Go to the Actuate section

In case of Count actuator type, you actuate it by dragging the slider or entering the value inside the field:

In case of Text actuator type, you actuate it by entering text inside the field:

In case of Boolean actuator type, you actuate it by clicking on the toggle switch:

To confirm the changes you have made, click on (OK) or (Cancel) to discard them.

Create Alarms

To create an actuator for a semantic (sub)group:

• On the Data Management screen, double-click on the semantic (sub)group you want to create an alarm for
• Select the Alarms tab, and then click on the Add button

This will open the Create Alarm sidebar. Here you will need to enter:

• Alarm Name
• Specify a device alarm (type in at least three characters)
• Click Save

Create Attributes

To create an attribute for a semantic (sub)group:

• On the Data Management screen, double-click on the semantic (sub)group you want to create an attribute for
• Select the Attributes tab, and then click on the Add button

This will open the Create Attribute sidebar. Here you will need to enter:

• Attribute Name
• Select attribute type from the drop-down list:
  • If numeric - enter number as value
  • If string - enter text as value
  • If boolean - check value box
  • If location - enter coordinates as value
• Click on Save

Edit Semantic Group Data

To edit a feed/actuator/alarm/attribute within one semantic group:

• Select a feed/actuator/alarm/attribute you want to edit by checking the checkbox next to it
• Click on to open the options menu
• Click on Edit inside the menu

• Change the name of the feed/actuator/alarm/attribute in the sidebar
• Click Save

Delete Semantic Group Data

To delete a feed/actuator/alarm/attribute:

• Select a feed/actuator/alarm/attribute you want to delete by clicking on next to it
• Click on Delete inside the menu
• Also, you can select the checkbox next to the feed/actuator/alarm/attribute you want to delete and then click on Delete at the top of the grid

• A new dialog will appear asking you to confirm the action

• Click Delete

Note: You can delete typed attributes only if they are optional