Metrikus spoke
Summarize
Summary of Metrikus spoke
The Metrikus spoke, designed for the Zurich release, integrates with ServiceNow’s Flow Designer and Integration Hub to retrieve real-time data from workplace sensors such as occupancy, air quality, and temperature sensors. This enables ServiceNow customers to automate and enhance workplace management through sensor data collected by Metrikus.
Show less
This spoke requires an Integration Hub subscription and is compatible with Metrikus Beta v1.0. Proper authentication via Metrikus login credentials, including a Client ID and Client Secret key, is necessary to use the spoke.
Key Features
- Fetches sensor event data like employee presence in meeting rooms or desk occupancy.
- Provides occupancy data for Workplace Connectors space records, supporting automatic reservation check-in configuration.
- Displays occupancy state for selected locations or spaces within the Workplace Service Delivery Location Directory.
- Offers multiple actions to look up space and desk occupancy in batches for efficient data retrieval and mapping.
- Includes sample subflows that demonstrate automation workflows to retrieve occupancy data by IDs for spaces and desks, which can be customized within a new application scope.
Spoke Requirements and Dependencies
- Metrikus login credentials with Client ID and Secret key.
- Installation of dependent plugins: IntegrationHub Runtime, IntegrationHub Action Step - OpenAPI, and Metrikus Spoke plugin.
- Licenses may be required for some plugins if used outside the spoke implementation.
Spoke Actions and Automation
The spoke provides several actions to automate workplace tasks triggered by sensor events, including:
- Look up Space Tree: Retrieves the location hierarchy and spaces from Metrikus.
- Look up Space Occupancy Batches and Desks Occupancy Batches: Retrieves occupancy data in batches for scalability.
- Look up Latest Desk and Space Occupancy: Provides the most recent occupancy data for desks and spaces.
User Roles and Security
Access to the Metrikus spoke data and configurations is controlled via the System Administrator role, ensuring secure management of sensor data integrations.
Connection and Credential Management
The spoke utilizes Integration Hub’s alias system to manage connection and credential information, including OAuth credentials. This approach simplifies credential management across multiple environments by centralizing updates without needing to modify individual actions.
Metrikus spoke provides actions to retrieve data from various sensors (such as occupancy sensor, air quality sensor, temperature sensor etc.) that are found at a workplace.
Request apps on the Store
Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.
Integration Hub subscription
This spoke requires an Integration Hub subscription. For more information, see Metrikus spoke - IntegrationHub overview.
Supported versions
This spoke was built for Metrikus Beta v1.0.
Key features
- Get event data. For example, when an employee enters a meeting room,when an employee occupies a desk).Get occupancy data for Workplace Connectors space records from Metrikus.
- Get occupancy data.
- The occupancy data is used for configuring automatic reservation check in.
- Workplace Service Delivery Location Directory shows Occupancy state for a selected location or space.
Spoke requirements
- Ensure that you have Metrikus login credentials.
- Metrikus provided Client ID and Client Secret key.
Spoke dependencies
- ServiceNow IntegrationHub Runtime [com.glide.hub.integration.runtime]
- ServiceNow IntegrationHub Action Step - OpenAPI [com.glide.hub.action_step.openapi]
- Metrikus Spoke [com.sn.wsd.metrikus.spoke]
Spoke actions
The Metrikus Spoke provides actions to automate tasks when events occurs in your ServiceNow instance. Available actions include:
| Actions | Description |
|---|---|
| Look up Space Tree | Get all the spaces along with the location hierarchy from Metrikus. |
| Look up Space Occupancy Batches | Gets batches of spaces (for example, 2000) and get occupancy data from Metrikus for all batches to combine and map it. |
| Look up Latest Desk Occupancy | Gets occupancy data for desks in a batch ( for example, 2000.) |
| Look up Latest Space Occupancy | Gets occupancy data for spaces in a batch (for example, 2000) |
| Look up Desks Occupancy Batches | Gets batches of desks (for example, 2000) and get occupancy data to combine and map it with Metrikus Spoke. |
Spoke subflows
The Metrikus Spoke provides sample subflows to demonstrate automating Workplace Connectors tasks. To customize a sample subflow, copy it to a new application scope. Available sample subflows include:
| Subflow | Description |
|---|---|
| Get All occupancy by Ids | Retrieves occupancy data of both Workplace Connectors spaces and desks. |
| Get Occupancy by desks by Ids | Retrieves occupancy data of all desks. Invoked by Get All Occupancy by Idssub flow. |
| Get Occupancy by spaces | Retrieves occupancy of all spaces. Invoked by the Get All Occupancy by Ids sub flow. |
Spoke user roles
The Metrikus spoke provides the System Administrator user role to control access to data:
Connection and credential alias requirements
Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.