...
The NETx BMS Server provides the opportunity to integrate event information from Kaba online door locks. an interface which can be used to integrate information from the hotel management system MICROS Fidelio/Opera. Using this interface, information about the check-in/check-out procedure, the hotel guests and the hotel room states can be retrieved. In addition, it is also possible to send dedicated information from the NETx BMS Server to the MICROS Fidelio/Opera system. This interface for the NETx BMS Server is certified by MICROS. The offical certificate can be found here.
The following figure shows how the integration has to be done.
In order to connect to MICROS Fidelio/Opera system, the so called IFC interface from MICROS Fidelio/Opera has to be activated at the MICROS Fidelio/Opera side. This has to be done by the MICROS Fidelio/Opera integrator.
Kaba door locks are using a wireless communication protocol which is based on ZigBee. In order to retrieve information like door events, ZigBee/IP hubs are required. These hubs are provided by Kaba and have the aim to translate ZigBee packets into IP packets for the local area network (LAN). Depending on the project multiple ZigBee hubs are needed.
The events are centrally collected by the Kaba server software. This software package provides an interface called Messenger LENS web service interface. This interface provides the opportunity to send events via push notifications to third-party software. In detail, the Kaba software acts as a web service client that sends web service requests to our NETx BMS Server which in turn acts as web service server. The communication protocol itself is based on SOAP web services.
Integration steps
| Info |
|---|
The Kaba MICROS Fidelio/Opera interface is currently not already included in the setup of the NETx BMS Server. In order to use the Kaba interface, please contact the team of NETxAutomation. |
First, the Messenger LENS web service interface has to be configured. Open a web browser and open the login screen of the Messenger LENS web interface. Within the http URL, use the IP address of the PC where the Kaba software is running.
Afterwards, select the "Configuration" tab, select "Group Permissions" and add a new group permission. Within the wizard, go through step 1 - 3 and select the events and locks that you want to receive within the NETx BMS Server. Within step 4, select "Allow User's Web Service" and enter the following URL (replace <IP BMS Server> with the IP address of the PC where the NETx BMS Server is running and choose a free port (e.g. 6005):
| No Format |
|---|
http://<IP BMS Server>:<Port>/ |
The following screenshot shows an example.
Finish the configuration by going through the remaining steps 5 - 7.
Afterwards, change to the tab "Operations", select "Subscription" and add a new subscription. Select the events, the user and the locks. Within the last step (step 4) of the wizard, "Notify me on my Web server" should be selected and the web service URL should be shown.
...
it, an extra license is needed – for testing purposes, the "Demo" license includes the MICROS Fidelio/Opera interface. Please contact the team of NETxAutomation for more information. |
To start, open the BMS Studio. First, configure the communication IP address and port number that you have enter within the web service URL. This can be done by selecting "Driver Configuration" within the menu "Modules" -> "Kaba".
...