Technologies / Innovative Solutions / Integrations - IoT

Integrating with Vergesense IoT Occupancy Sensors

Overview

Occupancy-monitoring hardware sensors detect human occupancy in places such as desks, conference rooms, offices, hospital patient rooms, and warehouses. By integrating Vergesense occupancy sensor data with Archibus, space managers can accurately measure actual utilization of space. With this data, they can gain a true understanding of how space is actually used.

For example, space managers can answer such questions as:

How many people access each building, floor, and office each day?

What days of the week have peak occupancy?
How many hours a week are people in this conference room?
How often are our "phone booth" offices used?
When staff book rooms for their in-office days, do they use the booked room?

Knowing the peak hours and patterns of space usage enables space managers to calibrate space availability, capacity, and allocation. With the most accurate measurements of actual space utilization, they can find opportunities to optimize space.

Other potential benefits of adapting space usage according to patterns are better energy consumption, better collaborations between employees, and overall increased efficiency.

To review their utilization data, space managers run the IoT Utilization report.

Set Up

The IoT Integration solution has its own license: the Integrations - IoT (AbIntegrationIoT) license.

The Technologies / Innovative Solutions / Integrations - IoT / IoT Utilization report (ab-iot-sp-analysis.axvw) checks for this license.

Sample Vergesense data has already been added to the IoT Space Utilization (iot_space_util table) in the sample HQ database. The sample HQ database has sensor data covering the period 6/19/2023 through 6/22/2023.

Procedure

In Vergesense, map buildings, floors and spaces to Archibus buildings, floors and rooms, by populating the Vergsense fields as follows:

Vergsense Field	Archibus Field
Building Ref. ID	Building Code
Floor Ref. ID	Building Code, Floor Code (ex. NC05,05)
Space Ref. ID	Building Code, Archibus Floor Code, Archibus Room Code (ex. NC05,05,5-100A). Map only the spaces for which you have setup sensors and want to import utilization data into Archibus

Vergsense Field

Archibus Field

Building Ref. ID

Building Code

Floor Ref. ID

Building Code, Floor Code (ex. NC05,05)

Space Ref. ID

Building Code, Archibus Floor Code, Archibus Room Code (ex. NC05,05,5-100A).

Map only the spaces for which you have setup sensors and want to import utilization data into Archibus

In Archibus, configure for which Vergesense floors to import data. This is required in order to avoid querying the entire set of buildings and floors that exist in Vergesense; it focuses the data query to only those floors for which you need to import utilization data.
- Run the System / System / Archibus Administrator - Application Configuration / Configure Application Parameters task.
- Locate the AbIntegrationIoT application and the IoTUtilization-FloorsToImport parameter.
- For the parameter value, list the Vergesense Building Ref IDs and Floor Ref IDs for which to import utilization data.
  - List the Building Ref ID and then the Floor Ref ID, separated by commas, such as: HQ,18,NC05,01,NC05,05,NB,03
Configure the space.vergesense.apiKey property in %archibusfolder%/WEB-INF/config/context/applications/space.properties with your Vergesense API Key so that the Archibus workflow rule can connect to the Vergsense API and import your utilization data. You can obtain your Vergesense API Key from the Vergesense platform.

Notes