Integrating an URVE Room Booking Adapter

Scenario: You want to configure Desigo CC to operate on the URVE Room Booking system.

 

Reference: For background information, see the reference section.

 

Workflow diagram:

 

 

Prerequisites:

  • The URVE Room Booking extension is installed and included in the active project. The following extensions are also selected automatically:
    • Scripts
    • SORIS Driver
  • The URVE Adapter is running and connected to the URVE Room Booking system. For instructions, see Installing and Configuring the URVE Adapter.
  • System Manager is in Engineering mode.
  • System Browser is in Management View.

 

Steps:

1 – Create the SORIS Driver
  1. Depending on where the driver will run, select one of the following:
  • Project > Management System > Servers > Main Server > Drivers
  • Project > Management System > FEPs > [FEP station] > [drivers folder]
    NOTE:     If the drivers folder is not available, to create it select the FEP station and click New .
  1. In the Object Configurator tab, click New and select New SORIS Driver.
  1. In the New object dialog box, enter a description and click OK.
  • The newly created SORIS driver is added to System Browser, but not started.

NOTE: In the SORIS tab, in the Polling threads field, you can specify the value for the polling volume. It is recommended to use the default value 75.

SORIS Driver Polling Threads

 

2 – Create the SORIS Network
  1. Select Project > Field Networks.
  1. In the Object Configurator tab, click New and select New SORIS Network.
  1. In the New Object dialog box, enter a name and description, and click OK.
  • The newly created SORIS network is added to System Browser.

 

3 – Associate a Driver to the SORIS Network
  1. Select Project > Field Networks > [SORIS network].
  1. In the SORIS tab, open the Network Settings expander.
  1. From the Monitored by driver drop-down list, select the driver.
  1. Click Save .
Linking the Network to the Driver

 

4 – Start the SORIS Driver

The status of a newly created driver is Stopped. To be able to connect, the driver must be started.

  1. Depending on where the driver runs, select one of the following:
  • Project > Management System > Servers > Main Server > Drivers > [SORIS driver]
  • Project > Management System > FEPs > [FEP station] > [drivers folder] > [SORIS driver]
  1. In the Extended Operation tab, click Start.

 

5 – Create a URVE Room Booking Adapter Under the Network
  1. Select Project > Field Networks > [SORIS network].
  1. In the Object Configurator tab, click New.
  1. In the New Object dialog box, enter a name and description, and click OK.
  • The newly created adapter is added to System Browser. The adapter starts automatically as a Windows service.
  1. Select the newly created adapter and click the SORIS tab.
  1. In the ULR field, enter the IP address of the computer from which the network adapter is run using the following format: https://<IP address>:<port number>, for example: https://192.169.7.200:8080.
  • In the Operation tab, the Online property indicates Connected and the property URL displays the IP address configured.
URVE Room Booking Adapter Configuration

 

6 – Discover URVE Room Booking Adapter Basic Objects
  1. Select Project > Field Networks > [SORIS network] > [URVE Room Booking adapter].
  • In the Extended Operation tab, the Online property indicates Connected while the Discovery Status property indicates Idle.
  1. Next to the URL property, click Discover.
  • Under the URVE Room Booking adapter node, System Browser displays the rooms in a flat list.
    NOTE: The discovery process creates the rooms in System Browser if at least one room has one or more programmed events.

 

7 – Check the Room Status

You can now check the room pages.

  1. Set System Manager to Operating mode.
  1. Select Project > Field Networks > [SORIS network] > [URVE Room Booking adapter] > [Room]
  • The room page displays with the active and planned events. The page layout is based on the URVE Graphic Template.
Example of Room Status