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 |
Display options |
Configures descriptive texts for certain interface items |
_styles.xml |
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.