Overview
This article explains how to:
- Create a new UI Builder page for a dashboard
- Add a Dashboard L1 Navigation item in the Digital Product Release Workspace
- Create and configure a Platform Analytics Dashboard
- Configure Dashboard Visibility
- Wire the dashboard to the workspace navigation
Step 1: Create a Dashboard UI Builder Page
- Navigate to UI Builder from the Application Navigator.
- Open Digital Product Release Workspace.
- Under Pages and Variants, click the + (Plus) icon.
- Select Create New Page.
- Select option Create from scratch instead.
- Enter the required page details:
1. Page Name: Dashboard
2. Path: dashboard
Note: The page path configured here must match the route used later in the L1 navigation configuration.
- Select default URL options and click on Looks good.
- Complete the page creation process and save the page.
Step 2: Add an L1 Navigation Item for the Dashboard
- Create a new record in the sys_ux_page_property table with the following values:
Field
Value
Application
Digital Product Release Data Model
Page
Digital Product Release Workspace
Name
chrome_toolbar
Type
json
Suffix
chrome_toolbar
Value :
[
{
"id": "dashboard",
"label": {
"translatable": true,
"message": "Dashboard"
},
"icon": "grid-four-outline",
"viewportInfo": {},
"routeInfo": {
"route": "dashboard"
},
"group": "top",
"order": 900,
"badge": {},
"presence": {},
"availability": {
"roles": [
"sn_dpr_workspace.workspace_user"
]
}
}
] - After saving the record, a new Dashboard L1 navigation item will appear in the Digital Product Release Workspace.
Step 3: Create a Dashboard
- Navigate to Platform Analytics → Library → Dashboards.
- Create a new dashboard.
- Configure the required widgets and visualizations.
- Click on More actions icon and select share option to provide the Edit or View access to the user, group or role.
Step 4: Configure Dashboard Visibility
To make the dashboard accessible within the workspace:
- Open the dashboard record and click on the View dashboard details icon.
- Configure the dashboard visibility with Digital Product Release workspace.
- Ensure that the intended users and roles have access to view the dashboard.
Proper visibility configuration is required for the dashboard to be displayed within the Digital Product Release Workspace.
Step 5: Wire the Dashboard to the L1 Navigation Item
- Open the Dashboard page created in UI Builder.
- Under the Body section, click Add Content.
- Select the Dashboard component from Servicenow internal.
- In the Dashboard component properties, Set the Default Dashboard value to the name of the Platform Analytics Dashboard created in Step 3.
- Save and publish the page.
Verification :
- Open the Digital Product Release Workspace.
- Click the newly created Dashboard L1 navigation item.
- Verify that the configured Platform Analytics Dashboard is displayed successfully.
The dashboard is now integrated into the Digital Product Release Workspace and available to users with the appropriate roles and permissions.