Event Monitor Item

An item used to subscribe to events from the OPC UA server.

The Event Monitor Item has the following properties:

NameDescriptionIDFlags
SrcUaNodeIdThe UA Node ID in the source server which should be monitored for events.5031Persisted
EventType NodeIdThe UA Node ID of the base EventType this monitor should subscribe to.13000Persisted
UnmappedEventsourceActionThe action to perform when a received event has an unknown eventsource13001Persisted
LookupSourcePathTemplateTemplate string used to construct an eventsource path from the received event fields13002Persisted
UnmappedEventtypeActionThe action to perform when a received event has an unknown eventtype13003Persisted

The property UnmappedEventsourceAction can have one of the following values, which decide the action to take when an event with unknown eventsource nodeid is received:

  • DropEvent: the event is dropped
  • UseModuleAsEventsource: the module containing the Event Monitor Item is used as the eventsource
  • LookupSourcename: the sourcename field of the event is used to lookup a fully qualified itemname in Apis Hive. If such an item is found, it will be used as the event source, automatically creating the needed source in Apis Event Server if required.
  • LookupSourcepath: A sourcepath is created from the property LookupSourcePathTemplate, and if exactly one event source in Apis Event Server matches the path, this is used as the event source.

The property LookupSourcePathTemplate is a string with injected event field values. Any event field can be referenced in the template with the syntax $(BrowseName), e.g. "Server/Plant/*/ABC-$(SourceName)". The search is case-insensitive and supports the following operators:

  • *: matches zero or more characters
  • ?: matches one character
  • #: matches one digit
  • []: match any character between the '[' and ']', unless the first character after '[' is '^', in which case the logic is inverted.

The property UnmappedEventtypeAction can have one of the following values, which decide the action to take when an event with unknown eventtype is received:

  • DropEvent: the event is dropped
  • UseParentType: traverse the OPC UA eventtype hierarchy and use the first known parent-type