---
sourceDocument: Xanadu Employee Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/employee-service-management

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Employee Service Management

ft:clusterId :

    - emplsm

bundleId :

    - emplsm

workflow :

    - Employee


---

# Setup Workplace Connectors for occupancy data

# Setup Workplace Connectors for occupancy data {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Configure workplace connectors to provide workplace occupancy data.  
Workplace Occupancy data provides real-time insights on workplace space and resource optimization. It uses the occupancy data from the occupancy connectors or sensors installed at a workplace location. The occupancy data is provided by third-party occupancy sensor data providers. For example, Metrikus Spoke is integrated with Flow Designer Integration Hub. The external Ids from Metrikus Spoke are mapped with Workplace Connectors locations to fetch the occupancy data.  
Note:  
Customers who aren't using the Metrikus Spoke must build their own integration to get Occupancy data insights for locations provided in Workplace Connectors locations.  
Workplace occupancy connector data provides the following benefits;

* Automatically checks in a reservation based on the space occupancy data and reservation status. For example, Occupied, unoccupied, reservation is in progress, reservation is canceled, and so on. For more information, see [Configure automatic check-in for reserved spaces](https://www.servicenow.com/docs/QnnAEtrLZhL5pBVmIq~qWw "Configure automatic reservation check-in using the Occupancy state of a location or space. If a location is using occupancy data sensors, it checks for Occupancy state of each space in the Space Occupancy data table").
* Provides near-real time occupancy data on floor maps, Employees can reserve spaces based on Occupancy data and reservation data. For more information, see [Manage workplace activities and services with Location directory](https://www.servicenow.com/docs/meh9JEt9sIxzu8D1H3swKg "Explore workplace campuses, sites, buildings, and neighborhoods using the Location directory. Get directions using map routes to a meeting room, building, or co-workers to collaborate effectively. Search for employees, locations, and neighborhood spaces. Reserve a space, request, or report a workplace service issue. Filter spaces by reservation states, occupancy states to get insights on space availability.").
{#setup-occupancy-connectors__ul_mkx_b1n_s1c}
1. [Activate Metrikus Spoke](https://www.servicenow.com/docs/JEKEPKV4~5p1S5HxqMAnfA)  
   Activate the Metrikus Spoke plugin from the ServiceNow Store.
2. [Integrate Metrikus spoke](https://www.servicenow.com/docs/9w3cKZx0GjJxMXTejOJqrw)  
   Integrate Metrikus Spoke with Flow Designer Integration Hub to retrieve occupancy data for workplace locations.
3. [Connector Configurations](https://www.servicenow.com/docs/IREgeZ0A7f_yZ7BS9IYpEA)  
   Configure the Connector Configurations table for loading the occupancy data in the target Space Occupancy Data table (sn-wsd_wc_space_occupancy). Connector configuration table retrieves the sensor data from different occupancy data providers.
4. [Provider Connector Configuration](https://www.servicenow.com/docs/D3rTa5CyV4fxisrAU5I5dA)  
   Register details for the occupancy data provider, the data source type, and connector configuration (sensor) details. Filter spaces using a condition builder, and retrieve occupancy data for a workplace location.
5. [Provider Space Type Mappings](https://www.servicenow.com/docs/1YF4FoyGKXuEsKO2TvnJVg)  
   This table maps workplace space types or locations with external ids provided by the space occupancy data providers.
6. [Configure Provider Space Mapping for occupancy data](https://www.servicenow.com/docs/nud50X~Q66jMk9BG~sclMA)  
   The Provider Space Mapping data table stores the workplace locations and external Ids provided by the occupancy data provider.
7. [Retrieving Action Configurations data](https://www.servicenow.com/docs/aRAZyQRNu6FOGMtv7EuVFQ)  
   Retrieve Actions from occupancy data provider using Flow Designer Integration Hub. Specify the transform definitions and invoke the Sub flow to retrieve Occupancy data. For example, Metrikus Spoke integration. The occupancy sensor data from the Occupancy data provider is transformed to derive space occupancy data in Workplace Connectors.
8. [Retrieving Space Occupancy Data](https://www.servicenow.com/docs/sZoVejQJJxKtu_ogiiVItw)  
   Retrieve the Space Occupancy Data table for loading workplace occupancy data and space occupancy data insights for a selected workplace location.

**Previous topic:** [Extension point for badging data](https://www.servicenow.com/docs/SJjzTpSjH4nv_MTNR~~Obw "Create a scripted extension point to process badging data from the provider and convert it into a standard format. Confirm that each provider implements this extension.")  
**Next topic:** [Activate Metrikus Spoke](https://www.servicenow.com/docs/JEKEPKV4~5p1S5HxqMAnfA "Activate the Metrikus Spoke plugin from the ServiceNow Store.")