Skip to main content
Planview Customer Success Center

Publishing Dashboards

This video demonstrates how to publish a dashboard. Duration 7 min.

 

 

You use the Publish Options modal (or the Update Options for Published Dashboards) to configure and manage published dashboards. Note that you must first run the dashboard and then select Actions > Publish from the dashboard viewer, as shown below:

dash_run_publish.png

The Publish Options modal is shown below, and its features described throughout the rest of the help page:


dash_pub_modal_simple.png

Who Can Manage Published Dashboards

  • To publish dashboards you must be a full user and a member of the Publishing standard group.
  • To unpublish dashboards from the Admin/Publishing page, you must be a full or team user with administrative permissions. Note that these administrators cannot see/edit publish options, but can unpublish only.
  • To unpublish the dashboard from the Dashboard list you must be the user who published the dashboard.
  • To delete published dashboards you must be the owner or a user with administrative privileges. An informational message will explain that the system will first unpublish the dashboard and then delete it.

Users with administrative privileges can view the schedules for all dashboards in your organization at Admin/Scheduled Jobs. This page displays a list of all dashboards with a publishing schedule, showing the title, the last run date, the next run date, the expiration date, and who scheduled the dashboard.

Exporting Published Dashboard Data to Excel

You can allow dashboard viewers to download data to Excel by enabling the checkbox next to Allow viewers to export dashboard data to Excel. This gives users access to the data without having to be logged into PPM Pro.


dashboard_export_excel.png

Important Information about Published Dashboards 

  • Dashboards must be run before they can be published.
  • Any drilldowns on reports that are included in published dashboards will be visible to all users, and active for users who are logged in. If not logged in, the user will be prompted to do so upon clicking a drilldown link. (Note: drilldown links available only to full, team, and support users.)
  • The URL for the published dashboard remains the same - you do not have to redistribute the URL after each update.
  • You must set an expiration date to one year or less from the current date.
  • Dashboards can only be scheduled to run outside of normal business hours (5pm - 7:30am in the current user's timezone).
  • A dashboard might not run at the exact time specified. The specified time defines the earliest start time. Dashboards are queued, and those configured to run around that time will get picked up, depending number of jobs ahead in the queue. A dashboard will never be run before the specified time.
  • If you configure an Access code, it can be any combination of up to 20 characters
  • Use the Copy URL button or right-click menu option to copy the published dashboard URL without opening the dashboard.

Configuring Published Dashboard Authentication

By default, no authentication is required to view a published dashboard - users can just click the URL.

You can require authentication two ways:

a)      Require users to be logged into PPM Pro to view the dashboard

b)      Require users to specify an access code to view the dashboard. The access code can be any combination of up to 20 characters. You can reset the access code whenever you want.

Each of these options is configured by selecting the appropriate radio button. If you choose to require an access code, enter the code in the field that becomes editable after you select the access code option:

dashboard_authentication.png

You can additionally require the user to log in from an IP address that falls within a range specified by your PPM Pro administrator. Note that your organization must be using the IP Address feature (enter a support case at customercare@planview.com if you are interested in enabling this feature). See IP Restrictions.

Setting URL Expiration Date and Notifying Publisher

You must set an expiration date for the dashboard URL that is no more than one year out from today's date. In addition, you can configure PPM Pro to send a notification in advance of the URL expiration date by checking the setting Notify dashboard publisher N days before expiration date. When this setting is checked, a notification email will be sent to the dashboard owner at the specified number of days prior to the dashboard expiring. You can update the expiration date at any time.

The email message body will be:

The dashboard <Dashboard Title> will expire in <n> days
Click the link to view publish details: <link>

dashboard_expiration.png

Setting a Dashboard Publishing Schedule

You can optionally set up a publishing schedule along with optional alerts.

You can configure a publishing schedule for any dashboard. The schedule determines how often to rerun and republish the dashboard automatically, helping dashboard owners streamline their end of day, week, or month reporting. Remember that dashboards are a snapshot of data in time. If a dashboard is set to be published weekly, say, on Sunday at 7am, the data you're looking at on the following Wednesday was last updated then. To see current data, rerun the selected dashboard (provided you're a user with visibility rights to the dashboard).

Click the checkbox next to Configure publishing schedule (see screenshot below). Use the scheduling settings that appear to configure the publishing schedule.

dashboard_publish_schedule.png

Dashboard Publication Alerts

After you configure the publishing schedule, you can notify up to 15 individual users each time the dashboard is re-published by entering their email addresses in the Notification Email Address(es) section; you can use a distribution list to notify a larger number of users. You can create a custom subject/message using the Email Subject and Email Message fields, respectively; a link to the published dashboard will be included below the message. The message fields are disabled until at least one email address is entered. If either the Email Subject or the Email Message fields are left empty, the standard notification will be used.

The recipient(s) will receive an email notification each time the dashboard is automatically republished (alerts are not sent if the dashboard is manually republished). The sender should always be alert_innotas@innotas.com. You can whitelist this sender or the innotas.com domain.
 

publish_alerts.png

To publish a dashboard

View the dashboard you want to publish by selecting it in the Dashboard List and clicking Actions > View.

  1. In the Dashboard viewer, choose Actions > Publish.
  2. (Optional) Authentication - the default is "Do not require any authentication." If you want to provide dashboard security, you can:

a)      Require users to be logged into PPM Pro to view the dashboard

b)      Require users to specify an access code to view the dashboard.

  1. Set the date you want the URL to expire in the Expires on field. The date must be within one year of the current date.
  2. (Optional) Configure the system to notify the dashboard publisher prior to the expiration date.
  3. (Optional) Configure the dashboard to republish on a regular schedule enabling the Configure publishing schedule check box and setting a schedule for repeated publishing (see above).
  4. (Optional) Enter custom alert text in the Email Subject and Email Message fields.
  5. Click Save.

To unpublish a dashboard

Note: Can be done only by user who published the dashboard. Admins can unpublish from Admin/Publishing.

  1. Navigate to the Dashboard List page.
  2. Select the dashboard you wish to unpublish and choose Actions > Unpublish.
  3. Click OK to dismiss the confirmation dialog.

Note: Users with administrative privileges can view a list of all published dashboards under Admin/Publishing. Any dashboard can be unpublished from that screen.

Resetting the access code or expiration date

Note: Can be done only by the user who published the dashboard.

  1. Navigate to the Dashboard List page.
  2. Select the dashboard you wish to modify and click the Published published_icon.png icon .
  3. In the Publish Options dialog that appears, enter a new access code and/or expiration date.
  4. Click Save.