Geutebrück VMS Integration Plugin
Introduction
Witness supports integration with many different types of external systems through the use of plugins. These are stand-alone software libraries which are dynamically loaded by the Management Server and have the ability to pass data and events to and from the external system. This page covers the process of setting up the Geutebrück plugin which enables integration with generic events, e.g. alarms and devices to provide the operator with comprehensive incident management.
Witness Requirements
The Witness installation needs to be licensed to use the Geutebrück Plugin and the required number of cameras
The Geutebrück Plugin needs to be installed
At least one camera must be configured to generate alarms or bookmarks
Overview
Geutebrück uses the G-Set application to configure their product and G-View for the operator to use.
Witness can send alarms and bookmarks to the Geutebrück system via their web API in the form of custom event messages which need to be configured within the Geutebrück G-Set application. Each camera in Witness requires mapping which would contain the unique custom event numbers for bookmark start/end and alarms (if required). These event number Ids would then be used to create events in the Geutebrück system to generate bookmarks, recordings and / or the raising of alarms.
Configuring the Geutebrück Plugin in Witness
To configure the Geutebrück plugin:
The Geutebrück Plugin will appear as a node under the Integration Configurations folder within the Configuration Tree.
Selecting the Geutebrück Plugin will display the following screen in the Configuration Control:
Enable the plugin and update the fields:
Enabled: Select to enable the Geutebrück Plugin.
Name: The unique name of the plugin.
Alarm Priority: Select the desired alarm priority.
Generate Alarms: Select to enable alarms in the Geutebrück Client.
Generate Bookmarks: Select to enable bookmarks to be created in the recorded video when an alarm is triggered in the Geutebrück Client.
Servers: Allows you to add or delete servers and displays the configured servers.
Camera Mapping: Allows you to add or delete cameras and displays the configured cameras.
Server Mapping within Witness
To do this:
Click the + icon to add a server to be mapped:
The Servers list becomes active:
Enter the Web Service URL, the Username and Password:
Camera Mapping within Witness
The next step is to map the cameras within Witness. The mapping configuration is required to map each of the devices configured in Witness to the corresponding devices in Geutebrück. This process ensures that Witness creates bookmarks for the correct camera in response to an alarm or bookmark in Witness. To do this:
Click the + icon to add a camera to be mapped:
Click the camera drop down list:
Select the appropriate camera and add the Web Service URL, Username and Password:
Select Save when complete. Next you need to configure the Bookmark Start Action Id, Bookmark End Action Id, and the Alarm Raised Action Id.
The camera will be configured. Repeat the process to add more cameras if required.
The Bookmark Start Action Id, Bookmark End Action Id, and the Alarm Raised Action Ids are used by the Geutebrück system and must be linked in their G-Set application as Parameters.
Geutebrück Configuration
Server Configuration within the Geutebrück
Use the Connection Wizard within the Geutebrück G-Set application to help you set up network connections (to match those configured in Witness) to servers in the Geutebrück system.
To do this:
To open the Connection Wizard menu, click on the Connection wizard button on the G-Set home page:
This will open the Connection Wizard. You can either edit an existing connection or create a new one by clicking the New icon:
When you have configured the server click the OK button:
If configured correctly the connection will show an enabled icon beside the connection as illustrated below:
For further information please see: https://www.geutebrueck.com/g-help/g-core/en/Content/G-Set/Wizards/Connection%20Wizard/Connection%20Wizard.htm?tocpath=G-Set%7CWizards%7C_____1.
Camera Mapping within the Geutebrück
You can also configure the cameras in the Geutebrück G-Set application. Please refer to: https://www.geutebrueck.com/g-help/g-core/en/Content/G-Set/Wizards/Media%20Channel%20Wizard/Media%20channel%20wizard.htm?tocpath=G-Set%7CWizards%7C_____2 for more information.
An example of a configured camera:
Geutebrück Event Configuration
Next you need to create events in the Geutebrück G-Set application to generate bookmarks, recordings and / or the raising of alarms.
Configuring Events is documented here: https://www.geutebrueck.com/g-help/g-core/en/Content/G-Set/Event-Behaviour%20Rules/Event%20Behavioural%20Rules/Event%20and%20Alarm.htm?tocpath=G-Set%7CEvent%252FBehavior%20Rules%7C_____1.
In the example below the Custom Actions have been configured with: -
INT parameter with a value of 3 which corresponds to the Alarm Raised Action Id configured in Witness.
INT parameter with a value of 2 which corresponds to the Bookmark End Action Id configured in Witness.
INT parameter with a value of 1 which corresponds to the Bookmark Start Action Id configured in Witness.
Configuring Behaviour Rules is covered here: https://www.geutebrueck.com/g-help/g-core/en/Content/G-Set/Event-Behaviour%20Rules/Behavior%20rules/Behavior%20Rules.htm?tocpath=G-Set%7CEvent%252FBehavior%20Rules%7C_____2. The example below shows a configured Custom Action:
Geutebrück Events & Alarms
Once you have configured the events and rules you can then use the Geutebrück G-View application to view the raised events and alarms.
In the example below you can see a configured camera:
Here is an example of an alarm:
The image below shows the bookmarks: