What are Shared Dashboards?

Open

Creating a Shared Dashboard

1. While editing your dashboard, click Add gadget

2. In the gadget search bar, search for Shared Dashboard. Click to Add the “Custom Charts Shared Dashboard” gadget

3. Configure the way you’d like your Shared Dashboard to appear:

In the Live Preview	In the Additional Settings and Link Access Permissions

In the Live Preview	In the Additional Settings and Link Access Permissions
Open	Open
All Custom Charts gadgets that you’ve already added to your Jira dashboard will be visible here. Drag and drop the various gadgets to reposition them on your Shared Dashboard You can use the Trashcan icon to the right of the name of each gadget to remove the ones you do not want to include in your Shared Dashboard	Title (Required): This will be populated by default with the Jira dashboard name, and can be edited Layout: adjust the column layout for your Shared Dashboard Theme: choose light mode or dark mode Link Access Permissions: this setting controls who can access the link to your Shared Dashboard. See below for more details on Link Access Permissions

JSM Portal and Shared Dashboards

When JSM Portal users is selected under Link Access permissions, Shared Dashboards in the portal are available from the Account dropdown, under My Dashboards. Customers will be able to see any dashboards that have been made available to them.

This sharing setting is disabled by default, and must be enabled by a Jira Admin before users can display Shared Dashboards in the portal.

Step 1: Enable Shared Dashboards for the JSM Portal

1. Navigate to the Custom Charts - Shared Dashboard Admin Settings. You can do this by either :

   1. Editing your Shared Dashboard gadget and clicking Admin settings in the bottom right corner of the gadget

   2. In the Jira navigation, clicking Apps → Manage your Apps → Custom Charts - Shared Dashboard - Settings

2. In the Shared Dashboard Settings, on the Link Options tab, navigate to the JSM Portal - Access restrictions section. Click the toggle on the right to enable the link option. You will know it’s enabled once the toggle turns green with a checkmark

3. Open

   

   You have successfully enabled the JSM Portal link option!

   1. You can use the Users and Groups selectors to add specific Jira users and/or Jira groups you want to give access to creating Shared Dashboard links for the JSM Portal. Users listed here are the only ones who can set the Link Access Permissions to Shared Dashboards.

Step 2: Configure Shared Dashboard gadgets for the portal

Open

When JSM Portal users is selected under Link Access permissions, Shared Dashboards in the portal are available from the Account dropdown, under My Dashboards. Customers will be able to see any dashboards that have been made available to them.

To grant specific permissions to the link in the Portal, while editing your Shared Dashboard gadget:

1. On the right side of the gadget editor, under Link Access Permissions, select the radio button next to JSM Portal - Access restrictions.

   1. JSM Project (required) - In the dropdown, select the particular JSM project(s) where the Shared Dashboard link should appear in the portal. This makes the Shared Dashboard link available to all Customers of that service desk

   2. Organization (optional) - If you’d like to give a subset of customers access to the Shared Dashboard link, in the dropdown, select the particular Organization(s) that house those customers

   3. Portal user (optional) - If you’d like to give specific portal user(s) access to the Shared Dashboard link only, select them from this dropdown

2. Open

   

1. Save the Shared Dashboard gadget.

Viewing Shared Dashboards

Link Access Permission setting - “Only users with access to this Jira dashboard”

In the Link Access Permission settings, if Only users with access to this Jira dashboard is selected, the Shared Dashboard link will not appear in the JSM Portal. It can instead be accessed directly from the Jira Dashboard appear as a wallboard. Users can access this following these steps:

1. Navigate to the Jira Dashboard where the Shared Dashboard gadget lives

2. Navigate to the specific Shared Dashboard gadget

3. On the default tab, click the title of the Shared Dashboard - it will appear as a link. The Shared Dashboard will open as a wallboard in a new tab

   1. You can also provide a direct link to the Shared Dashboard by clicking “Copy link” on the default tab

Link Access Permissions setting - “JSM Portal - Access Restrictions”

In the Link Access Permission settings, if JSM Portal - Access Restrictions is selected, the Shared Dashboard link will appear in the JSM Portal. Users can access this by following these steps:

1. Navigate to the JSM Portal

2. Click their user profile icon in the top right corner of the Portal

3. Click My Dashboards. It will open up as a pop-up in the Portal

Shared Dashboards Data Restrictions

Shared Dashboard Owner

When a Shared Dashboard is created, all of the issues in the charts are loaded with the permissions of the Shared Dashboard owner. This user is the last person to save the Shared Dashboard gadget.

This user is also the only one who can edit Custom Charts that are part of the Shared Dashboard. For additional details on changing the Shared Dashboard owner, navigate here.

Open

Viewing the Shared Dashboards Gadget on a Dashboard

When users come to the Dashboard, they can view the Shared Dashboard gadget and see the details of some of its settings, as depicted in the screenshot below.

Open