Display the dashboard list

After a successful login to Performance Dashboard, the list of dashboards available to the logged in user is created by browsing the client-specific configuration directory <installation directory>\ppmmashzone\server\bin\work\data_ppm\webapp\WEB-INF\config\<client>\performancedashboards for valid dashboard configurations. The client name is taken from the value of the client property in the login module used.

A dashboard configuration is made up of the following XML files:

The name of an XML file is made up of the base name (dashboard identifier) and an extension describing the type of configuration the file contains.

Extension

Configuration type

Description

_conf.xml

Dashboard configuration

Specifies the source system connections for measure queries, the list of available global filters and the user list for the dashboard.

_def.xml

Structure definition

Defines the process environment and measure queries for your dashboard

_properties.xml

Layout options

Configures the layout options for all interface items in your dashboard (process groups, processes, queries) - managed automatically

_resources.xml
(optional)

Display options

Configures descriptive texts for certain interface items

_styles.xml
(optional)

Display options

Defines templates for displaying process groups, processes and queries

Example

The dashboard configuration for the demo scenario supplied with PPM consists of the following files:

To create the list of the dashboards available to the logged in user, all dashboard configuration files in the client-specific configuration directory are first checked. If the user appears in the user list (userlist XML element) in a _conf.xml file, the _def.xml file corresponding to the base name is read. The dashboard definition text specified in the language-specific description element (pcdefinition XML element) is listed as the name of the dashboard, according to the selected login language.

To copy an existing dashboard, copy all configuration files for that dashboard and adapt the base names of the configuration files. Note that in the copied _def.xml file, in the description XML elements for the pcdefinition XML element you need to change all language-specific names for the new dashboard to differentiate the original and copied dashboards in the dashboard list.