A Resource data event publication rule defines the devices for which a specified condition is monitored. When that condition is entered or exited a resource data event will be published. For each resource data event publication rule Hagleitner senseManagement creates the necessary infrastructure that can be used by 3rd party software systems to subscribe to the published events.
Resource data event publication rules defined on the Client Service and are translated to directives for the Resource Data Observation Service.
Managing resource data event publication rules rules is bound to the capability RESOURCE_DATA_EVENT_PUBLICATION. Only users with permission EDIT_RESOURCE_DATA_EVENT_PUBLICATION_RULES can create and modify event publication rules. Only users with permission VIEW_RESOURCE_DATA_EVENT_PUBLICATION_RULES can view event publication rules rules, this includes viewing connection strings for the SignalR Hub Group and the Azure Service Bus queue for the publication rules.
Resource data event publication rules are created for customers and stored with those customers. A event publication rule can therefore only monitor devices of one customer - however, the set of monitored devices can be further limited with a device filter, see below for more details.
Table 56 describes the general attributes stored with resource data event publication rules.
Attribute |
Description |
|---|---|
ID |
UUID. Mandatory. ID of the rule set by HsM |
Name |
Mandatory. Name of the device monitoring rule. |
Description |
Optional. Description of the device monitoring rule |
Is Active |
If true the device monitoring rule is considered active, i.e. it will be used by the Resource Data Observation Service. If false the rule is inactive and not be used by the Resource Data Observation Service i.e. will not raise events. This setting can be used to temporarily disable a rule without loosing all of the rule's settings. Even if set to False, the infrastructure (SignalR Hub Group, Azure Service Bus Queue) will not be deleted. |
Table 56: General attributes of resource data event publication rules
Devices to be monitored
Basically a device monitoring rule will monitor all devices of the customer for which the monitoring rule was created. However a device filter can be used to limit the set o devices that shall be monitored.
Monitoring condition
The monitoring condition is the condition that is checked on each incoming resource value. If that condition is met a notification will be triggered.
Property |
Description |
|---|---|
Common resource |
The common resource that is filtered for. |
Comparison operator |
One of: less than, equal, greater than, in-list |
Comparison value |
A single value (for comparison operators less than, equal, greater than) Multiple values for the in-list operator Note User interfaces may present the comparison based on Catalog Service information. |
Table 57: Properties of the monitoring condition stored with each resource data event publication rule
