Install the Safe Workplace Dashboard

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 8 Minuten Lesedauer

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

    Vorbereitungen

    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.
    Hinweis:
    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

    Tabelle : 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 Safe Workplace 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 Now Support 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 Safe Workplace 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 Safe Workplace 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.

    If you've subscribed to the Safe Workplace suite and you already have some of the apps installed, refer to the following order of installation for the remaining apps.
    • Emergency Outreach (sn_imt_checkin)
    • Employee Health Screening (sn_imt_monitoring)
    • Workplace PPE Inventory Management (sn_imt_ppe)
    • Employee Readiness Surveys (sn_imt_readiness)
    • COVID-19 Global Health Data Set (sn_imt_c19datafeed)
    • Contact Tracing (sn_imt_tracing)
    • Emergency Self Report (sn_imt_quarantine)
    • Workplace Core (sn_wsd_core)
    • Safe Workplace Dashboard (sn_imt_dashboard)
    • Emergency Response Management for Now Mobile (sn_imt_mobile)
    • Employee Travel Safety (sn_imt_travel)
    • Health and Safety Testing (sn_imt_health_test)
    • Vaccination Status (sn_imt_vaccine)

    Prozedur

    1. Navigate to System Applications > All Available Applications > All.
    2. 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.
    3. Click Install.
    4. 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.

    5. Wahlweise: 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.
      Hinweis:
      If you don't load the demo data for a store application during installation, it's not available to load later.
    6. Click Install.
    7. 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.

    Hinweis:
    The Application Files table lists the components that are installed with this application. For instructions on how to access this table, 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
    Hinweis:
    Assign Safe Workplace Dashboard users the pa_viewer role. This role is required to see the dashboard content.
    Safe Workplace Dashboard administrator

    [sn_imt_dashboard.admin]

    		 Manage alert types and set system properties. sn_imt_dashboard.user

    Scheduled Safe Workplace Dashboard data collector jobs installed

    The data collector jobs installed with the Safe Workplace Dashboard are set to run daily and collect data for use in the dashboard and its widgets.

    Scheduled job Description
    [PA Workplace Service Delivery] Daily Data Collection Collects metrics from Safe Workplace suite Safe Workplace apps starting from the previous day to the current day. A user with the pa_data_collector role can change the parameters.
    [PA Workplace Service Covid19] Daily Data Collection Collects metrics from the COVID-19 Global Health Data Set starting from the previous day to the current day. A user with the pa_data_collector role can change the parameters.
    Aggregate campus status data Collects data from check-ins and campus statuses to populate the Reopening Check-In Count [sn_imt_dashboard_reopening_checkin_count] table. Runs daily at 23:00 instance time.

    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 Safe Workplace apps starting from 1 day ago to today.
    [PA Workplace Service Covid19] Daily Data Collection Collects metrics from the COVID-19 Global Health Data Set 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.
    Phase Definitions

    [sn_sw_planner_phase]

    		 Definitions of phases and their assigned locations. Used to categorize what phase of reopening a location is in. A location can be in only one phase at a time. A phase has a name, location, description, and allowed maximum occupancy percentage that is allowed during the phase. Phase definitions are required for information to populate widgets in the Safe Workplace Dashboard Reopening page.
    Campus Statuses

    [sn_sw_planner_campus_status]

    		 Primary table containing data that determines the current status of each location in the reopening page and widgets of the Safe Workplace Dashboard.
    Reopening Check-In Audience

    [sn_imt_dashboard_reopening_checkin_audience]

    		 Table containing check-in audiences and their criteria based on the organization's configurations. Administrators can create Check-In Audiences using the condition builder to create users. Users are uniquely counted across tables even if they have the same user ID. Check-In Audiences are required to provide information to populate widgets in the Safe Workplace Dashboard Reopening page.
    Reopening Check-In Count

    [sn_imt_dashboard_reopening_checkin_count]

    		 The Aggregate campus status data scheduled job automatically populates the table with the dates and locations of all check-ins.
    Campus Status Log

    [sn_imt_dashboard_reopening_campus_status_log]

    		 Tracks campus statuses and how a location's status changes through each phase.

    Safe Workplace Dashboard properties

    Set up Safe Workplace Dashboard properties to add your Mapbox API token and configure how indicators are displayed across timezones.

    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 properties , navigate to Safe Workplace Dashboard > Properties.
    Tabelle : 2. Safe Workplace Dashboard properties
    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.
    Use Indicator PA job timezone

    [sn_imt_dashboard.Use Indicator Job Timezone]

    		 When enabled, the Performance Analytics (PA) indicators shown on the Safe Workplace Dashboard are displayed using the time zone of the indicator's data collection job. If the indicator job time zone is not set, the instance time zone is used instead. The indicators are displayed identically for all users viewing the dashboard, regardless of the user's time zone.

    When not enabled, the PA indicators are displayed based on the user's time zone. The indicators may show different daily data to users in different time zones. For example, an event occurs in the evening in Seattle, which is the next day's morning in Berlin. A user in Seattle sees the event in the data for October 5, while a user in Berlin sees the event in the data for October 6.

    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 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
    • Safe Workplace Dashboard Covid PA
    • Safe Workplace Dashboard Vaccination Widget

    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
    • CDC New
    • 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
    • CDC Totals
    • 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.