General information about filtering messages and events

The ONVIF-Server module supports filtering of messages and events transmitted in the metadata stream according to the ONVIF standard: Topic Filter and Message Content Filter.

You can configure the correspondence of messages for Topic Filter and the Axxon PSIM events. These are the ONVIF-Server events that start with tns and tmk in the examples below on this page. Axxon PSIM transmits only those events for which the correspondence is configured. The remaining events and messages are sent automatically according to the specification (for example, when changing the settings of the server, profile, or MotionAlarm, and so on).

ONVIF standard events

Profile S and Profile T are implemented for event transmission. These profiles include standard events described in the ONVIF documentation. You can get a full list of supported events by a corresponding request to the server or using the Onvif Device Test Tool utility.

tns1:VideoSource/MotionAlarm (MD_START/MD_STOP in Axxon PSIM terms)

tns1:RecordingConfig/JobState (RECORDER_ON/RECORDER_OFF in Axxon PSIM terms)

tt:VideoAnalyticsStream (only BoundingBox for the tracker is transmitted inside the events, this is MD_INFO in Axxon PSIM terms)

tns1:Device/Trigger/Relay

tns1:Device/Trigger/DigitalInput

tns1:Configuration/Profile

tns1:Media/ProfileChanged

Configuring the correspondence of messages for Topic Filter and the Axxon PSIM events

The correspondence of messages for Topic Filter and the Axxon PSIM events is configured in the following order:

1. Go to the Event settings tab on the settings panel of the ONVIF-Server object.
   

2. From the drop-down list in the ONVIF-server event column (1), select the ONVIF server event. See the event description in the table at the bottom of the page.

   To add a row to the table, press the "down" button on the keyboard; to delete a row, use the Ctrl+Del key combination.

3. In the Computer, Type, and Number columns (2), specify the parameters of the object from which the corresponding event comes. The Name field is filled in automatically when you left-click it. If any column parameter is empty, it means that the message is sent for any value of the corresponding parameter.
4. From the Event drop-down list (3), select an event that comes from the selected object and corresponds to the specified ONVIF server message.
5. If the specification requires that the event contain certain parameters (see the table at the bottom of the page), it is necessary to specify their values or the correspondence to the Axxon PSIM event parameters in the Transfer parameters table:
   1. The ONVIF-event parameter name column (4) contains the required parameters of the ONVIF server event. They are set according to the specification.

   2. In the Event parameter name column (5), it is necessary to specify the parameter value or the parameter names of the Axxon PSIM event. Event parameters can be found in the Debug window, and some of them are described in Description of events and reactions of system objects (see Guide for creating scripts (programming)).

6. Repeat steps 2-5 for all required events.
7. Click the Apply button (6).

You can check the message and event filtering in the third-party software, for example, in the ONVIF Device Manager utility.

To do this, go to the Events or Metadata page, depending on what messages you want to see, set the filtering conditions (1) that are displayed in the list (2), and then click Apply (3). As a result, only the events that match the filter must be displayed.

Examples of filters used in the ONVIF Device Manager utility:

1. Topic Filter
   1. tns1:VideoSurveillanceSystem//.
      Events where the topic starts with tns1:VideoSurveillanceSystem/
   2. tns1:VideoSource/MotionDetectorTrigger
      MotionDetectorTrigger events only
   3. tns1:VideoSurveillanceSystem//.|tns1:FireAlarm/Alarm
      Events where the topic starts with tns1:VideoSurveillanceSystem/, as well as FireAlarm/Alarm events
   4. tns1:VideoSource/
      All events of the video system with a comment containing an Axxon PSIM event in its original form
2. Message Content Filter
   1. //tt:SimpleItem[@Name="Source" and @Value="{DFC2A44E-7CE4-E711-8A5F-54E6FC817BD7}{CAM.1}"]
      Events only from the source with the identifier {DFC2A44E-7CE4-E711-8A5F-54E6FC817BD7}{CAM.1}