The procedure for creating the PPM configuration files for your Performance Dashboard is as follows:
The following arguments are required to create the configuration files:
To display all available arguments for runcockpitcreator, run runcockpitcreator -h.
A list of arguments is available in the chapter on XML elements in the dashboard configuration file *_conf.xml.
-user <User name>
Name of the user in PPM, logged in with the Data import function privilege
-password <Password>
User password
[-client <Name>]
Name of the client (optional); here: umg_en
If no client is specified, the server of the default client is used.
-mode dashboard
-cockpitdefinition <File name>
Dashboard definition file (*_def.xml; including path), containing the dashboard hierarchy model, here DemoDashboard_def.xml
-cockpitconfiguration <file name>
Dashboard configuration file (_pcdefault_config.xml or *_conf.xml; including path) containing the technical specifications for the dashboard
-processtype <ptg\pt>
Process type group and process type for which user-defined aggregation measures are to be registered, e.g., Performance Dashboard
-source <Source name>
Name of the source system for which you are creating the configuration.
In PPM, the planned values for measures relate to specific process types or process type groups. You need to specify a process type group or process type to be able to define planned values for the aggregation measures registered there.
It is useful to specify a process type group Performance Dashboard and the relevant dashboard name as the process type. This procedure enables clear administration of the planned values for the aggregation measures in your Performance Dashboard as the relevant process type can be used directly for filtering in the planned value component.
When you install the PPM demo database, the Performance Dashboard process type group and the Performance Dashboard process type are created automatically.
Example
runcockpitcreator.bat -user system -password manager -client umg_en -mode dashboard -cockpitdefinition <installation directory>\ppmmashzone\server\bin\work\data_ppm\webapp\WEB-INF\config\umg_en\performancedashboards\umg_dashboard_def.xml -cockpitconfiguration <installation directory>\ppmmashzone\server\bin\work\data_ppm\webapp\WEB-INF\config\umg_en\performancedashboards\umg_dashboard_conf.xml -processtype "Performance Dashboard\Performance Dashboard" -source ppm -activate
If you are using the predefined demo dashboard definition (Demo_def.xml) and configuration (Demo_conf.xml) files, specify their names in the corresponding path.
The command line program runcockpitcreator.bat creates the following four configuration files and saves them to the same directory <PPM installation directory\server\bin\agentLocalRepo\.unpacked\ppm-client-run-prod-<version>-runnable.zip\ppm\bin by default. You can specify a different directory by indicating the additional argument -output <path>.
The value for <dashboard name> is defined by the value of the name attribute of the pcdefinition XML element in the specified _def file.
To automatically import the PPM configuration files to PPM, specify the additional argument -activate.
If you want to make changes to the created files, you can also import the configuration files manually as described in the chapter Import the dashboard definition files into PPM.