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