Home Madrid HR Service Delivery HR Service Delivery Safe Workplace suite Safe Workplace Dashboard Install the Safe Workplace Dashboard

Install the Safe Workplace Dashboard

Install the Safe Workplace Dashboard application. You can install this application If you have the admin role.

Before you begin

Ensure that the application and all of its associated ServiceNow® Store applications have valid ServiceNow entitlements. For more information, see Get entitlement for a ServiceNow product or application.

The Map existing campus with locations fix script creates the initial mapping entries between the Campus [sn_wsd_core_campus] table and the Location [cmn_location] table.

Note: Check that all existing campuses have sites and regions populated before running this script.

Use the default setting active=false to avoid incorrect mappings in the Campus [sn_wsd_core_campus] table.

Run this script after activating the Safe Workplace Dashboard (sn_imt_dashboard) plugin and ensuring that your existing campuses have sites and regions populated.

After running the Map existing campus with locations fix script, validate that all campuses and locations are accurate. For inaccurate data, remove entries and see Manually map a location and campus for more information.

Role required: admin

Table 1. Installation instructions for self-hosted and federal environments
Type	Instructions
Commercial on-premise	Visit the ServiceNow® Store to download and install the application.
Federal hosted	See the Federal downloads for the Emergency Response Management and Safe Workplace suite apps [KB0030260] article in the Store Help Center for more information.
Federal on-premise	If you are a federal on-premise customer and you would like to install this application, reach out to your sales representative or open a HI or HIWAVE ticket. In the ticket, request to be routed to the SHOT team. See the Federal downloads for the Emergency Response Management and Safe Workplace suite apps [KB0030260] article in the Store Help Center for more information.
On-premise	See the Commercial downloads for the Emergency Response Management and Safe Workplace suite apps [KB0030258] article in the Store Help Center for more information.

The Safe Workplace Dashboard application requires the ServiceNow®Performance Analytics - Premium application. If you're not already subscribed to Performance Analytics - Premium, you must install it before installing Safe Workplace Dashboard.

Procedure

Navigate to System Applications > All Available Applications > All.
Find the application using the filter criteria and search field.
You can search for the application by its name or ID. If you cannot find an application, you may have to request it from the ServiceNow Store. Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release note information for all released apps, see the ServiceNow Store version history release notes.
Click Install.
In the Application installation dialog box, review the application dependencies.

If your application requires other applications, install them first if they're not already installed.

Installing your application also automatically installs the dependent applications or plugins if they're not already installed.
(Optional) If demo data is available and you want to install it, click Load demo data.
Some applications include demo data, which are sample records that describe application features for common use cases. Load demo data when you first install the application on a development or test instance.
Note: If you don't load the demo data for a store application during installation, it's not available to load later.
Click Install.
When the installation is complete, click Close.

Components installed with the Safe Workplace Dashboard

Components are installed with the Safe Workplace Dashboard, including user roles, scheduled jobs, and tables.

Note: To view all other components installed with this plugin or application, see the Application Files table. For instructions, see Find components installed with an application.

Roles installed


Role title [name]	Description	Contains roles
Safe Workplace Dashboard user [sn_imt_dashboard.user]	View the dashboard information and drill into locations.	pa_viewer
Safe Workplace Dashboard administrator [sn_imt_dashboard.admin]	Manage alert types and set system properties.	sn_imt_dashboard.user

Scheduled ServiceNow®Performance Analytics (PA) data collector jobs installed

The data collector jobs for the Safe Workplace Dashboard are set to run daily and collect data from 1 day ago to today. A user with the pa_data_collector role can change the parameters if desired.


Scheduled job	Description
[PA Workplace Service Delivery] Daily Data Collection	Collects metrics from Safe Workplace suite apps starting from 1 day ago to today.

Tables installed


Table	Description
Alerts [sn_imt_dashboard_alerts]	Alerts by campus, generated from active alert types.
Alert Types [sn_imt_dashboard_alert_types]	Alert types are PA thresholds below which an alert is generated and displayed on the Safe Workplace Dashboard.
Breakdown All Time Values [sn_imt_dashboard_campus_all_time_values]	PA breakdown values, stored by campus.

Safe Workplace Dashboard property

You can obtain a token from Mapbox to add features to the Safe Workplace Dashboard map. The base system map is from OpenStreetMap, a collaborative, open source map application.

Mapbox requires a subscription, and their documentation site describes how to obtain an API token to add the extra features. For more information, open the Mapbox web site and select Documentation in the header.

To set your Mapbox token, navigate to Safe Workplace Dashboard > Properties.

Table 2. Property for the Safe Workplace Dashboard
Property	Description
Enter your Mapbox API Token to enable additional Mapbox features. Obtain an API token from https://www.mapbox.com/. sn_imt_dashboard.Mapbox Token	Obtain a Mapbox token to add display features to the Safe Workplace Dashboard. This setting is optional. Type: text Default value: none Location: Safe Workplace Dashboard > Properties Learn more: Read the documentation on the Mapbox website.

Safe Workplace Dashboard widgets

The Safe Workplace Dashboard comprises ServiceNow® Service Portal widgets that are populated by Performance Analytics widgets.

Service Portal widgets in the Safe Workplace Dashboard

Active Contact Tracing Cases
Safe Workplace Dashboard Announcement
Safe Workplace Dashboard Survey Sentiment
Safe Workplace Dashboard Favorite Location
Safe Workplace Dashboard Filter
Safe Workplace Dashboard Survey Sentiment
Safe Workplace Dashboard Employee Health
Safe Workplace Dashboard Main Summary
Safe Workplace Dashboard Site Details
Safe Workplace Dashboard Main
Safe Workplace Dashboard Overview Maps
Safe Workplace Dashboard Site Details Ba
Safe Workplace Dashboard PA
Safe Workplace Dashboard Survey Donut
Safe Workplace Dashboard Alerts
Safe Workplace Dashboard Menu

For information about customizing Service Portal widgets, see Service Portal widgets and the Widget developer guide.

Performance Analytics widgets

Active Cases
Number of Workplace Reservable Spaces
Employees Rejected % Change from Prior Day
Number of Employees Ready to Return
Number of Employees Not Ready to Return
Number of employees rejected
% of Employees That Want To Return To Work
Reserved Spaces
Number of employees surveyed for readiness return
PPE Inventory (time series)
PPE Inventory (score)
Number of Workplace Spaces
Reservable vs Reserved Spaces
Number of employees admitted Workplace Reservations
Reservable Spaces
Employees Admitted
Employee Entry Health Monitoring
Employees Rejected
Number of Workplace Reserved Spaces
PPE Inventory % Change from Prior Day

For information about using Performance Analytics, see Performance Analytics.

Previous topic

Next topic

Release version

Install the Safe Workplace Dashboard

Install the Safe Workplace Dashboard application. You can install this application If you have the admin role.

Before you begin

The Map existing campus with locations fix script creates the initial mapping entries between the Campus [sn_wsd_core_campus] table and the Location [cmn_location] table.

Note: Check that all existing campuses have sites and regions populated before running this script.

Use the default setting active=false to avoid incorrect mappings in the Campus [sn_wsd_core_campus] table.

Run this script after activating the Safe Workplace Dashboard (sn_imt_dashboard) plugin and ensuring that your existing campuses have sites and regions populated.

Role required: admin

Table 1. Installation instructions for self-hosted and federal environments
Type	Instructions
Commercial on-premise	Visit the ServiceNow® Store to download and install the application.
Federal hosted	See the Federal downloads for the Emergency Response Management and Safe Workplace suite apps [KB0030260] article in the Store Help Center for more information.
Federal on-premise	If you are a federal on-premise customer and you would like to install this application, reach out to your sales representative or open a HI or HIWAVE ticket. In the ticket, request to be routed to the SHOT team. See the Federal downloads for the Emergency Response Management and Safe Workplace suite apps [KB0030260] article in the Store Help Center for more information.
On-premise	See the Commercial downloads for the Emergency Response Management and Safe Workplace suite apps [KB0030258] article in the Store Help Center for more information.

Procedure

Navigate to System Applications > All Available Applications > All.
Find the application using the filter criteria and search field.
You can search for the application by its name or ID. If you cannot find an application, you may have to request it from the ServiceNow Store. Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release note information for all released apps, see the ServiceNow Store version history release notes.
Click Install.
In the Application installation dialog box, review the application dependencies.

If your application requires other applications, install them first if they're not already installed.

Installing your application also automatically installs the dependent applications or plugins if they're not already installed.
(Optional) If demo data is available and you want to install it, click Load demo data.
Some applications include demo data, which are sample records that describe application features for common use cases. Load demo data when you first install the application on a development or test instance.
Note: If you don't load the demo data for a store application during installation, it's not available to load later.
Click Install.
When the installation is complete, click Close.

Components installed with the Safe Workplace Dashboard

Components are installed with the Safe Workplace Dashboard, including user roles, scheduled jobs, and tables.

Note: To view all other components installed with this plugin or application, see the Application Files table. For instructions, see Find components installed with an application.

Roles installed


Role title [name]	Description	Contains roles
Safe Workplace Dashboard user [sn_imt_dashboard.user]	View the dashboard information and drill into locations.	pa_viewer
Safe Workplace Dashboard administrator [sn_imt_dashboard.admin]	Manage alert types and set system properties.	sn_imt_dashboard.user

Scheduled ServiceNow®Performance Analytics (PA) data collector jobs installed

The data collector jobs for the Safe Workplace Dashboard are set to run daily and collect data from 1 day ago to today. A user with the pa_data_collector role can change the parameters if desired.


Scheduled job	Description
[PA Workplace Service Delivery] Daily Data Collection	Collects metrics from Safe Workplace suite apps starting from 1 day ago to today.

Tables installed


Table	Description
Alerts [sn_imt_dashboard_alerts]	Alerts by campus, generated from active alert types.
Alert Types [sn_imt_dashboard_alert_types]	Alert types are PA thresholds below which an alert is generated and displayed on the Safe Workplace Dashboard.
Breakdown All Time Values [sn_imt_dashboard_campus_all_time_values]	PA breakdown values, stored by campus.

Safe Workplace Dashboard property

You can obtain a token from Mapbox to add features to the Safe Workplace Dashboard map. The base system map is from OpenStreetMap, a collaborative, open source map application.

To set your Mapbox token, navigate to Safe Workplace Dashboard > Properties.

Table 2. Property for the Safe Workplace Dashboard
Property	Description
Enter your Mapbox API Token to enable additional Mapbox features. Obtain an API token from https://www.mapbox.com/. sn_imt_dashboard.Mapbox Token	Obtain a Mapbox token to add display features to the Safe Workplace Dashboard. This setting is optional. Type: text Default value: none Location: Safe Workplace Dashboard > Properties Learn more: Read the documentation on the Mapbox website.

Safe Workplace Dashboard widgets

The Safe Workplace Dashboard comprises ServiceNow® Service Portal widgets that are populated by Performance Analytics widgets.

Service Portal widgets in the Safe Workplace Dashboard

Active Contact Tracing Cases
Safe Workplace Dashboard Announcement
Safe Workplace Dashboard Survey Sentiment
Safe Workplace Dashboard Favorite Location
Safe Workplace Dashboard Filter
Safe Workplace Dashboard Survey Sentiment
Safe Workplace Dashboard Employee Health
Safe Workplace Dashboard Main Summary
Safe Workplace Dashboard Site Details
Safe Workplace Dashboard Main
Safe Workplace Dashboard Overview Maps
Safe Workplace Dashboard Site Details Ba
Safe Workplace Dashboard PA
Safe Workplace Dashboard Survey Donut
Safe Workplace Dashboard Alerts
Safe Workplace Dashboard Menu

For information about customizing Service Portal widgets, see Service Portal widgets and the Widget developer guide.

Performance Analytics widgets

Active Cases
Number of Workplace Reservable Spaces
Employees Rejected % Change from Prior Day
Number of Employees Ready to Return
Number of Employees Not Ready to Return
Number of employees rejected
% of Employees That Want To Return To Work
Reserved Spaces
Number of employees surveyed for readiness return
PPE Inventory (time series)
PPE Inventory (score)
Number of Workplace Spaces
Reservable vs Reserved Spaces
Number of employees admitted Workplace Reservations
Reservable Spaces
Employees Admitted
Employee Entry Health Monitoring
Employees Rejected
Number of Workplace Reserved Spaces
PPE Inventory % Change from Prior Day

For information about using Performance Analytics, see Performance Analytics.

How search works:

Topics are ranked in search results by how closely they match your search terms

Install the Safe Workplace Dashboard

Install the Safe Workplace Dashboard

Components installed with the Safe Workplace Dashboard

Roles installed

Scheduled ServiceNow®Performance Analytics (PA) data collector jobs installed

Tables installed

Safe Workplace Dashboard property

Safe Workplace Dashboard widgets

Service Portal widgets in the Safe Workplace Dashboard

Performance Analytics widgets

On this page

Install the Safe Workplace Dashboard

Install the Safe Workplace Dashboard

Components installed with the Safe Workplace Dashboard

Roles installed

Scheduled ServiceNow®Performance Analytics (PA) data collector jobs installed

Tables installed

Safe Workplace Dashboard property

Safe Workplace Dashboard widgets

Service Portal widgets in the Safe Workplace Dashboard

Performance Analytics widgets

Log in to personalize your search results and subscribe to topics