Adapt the login page

You can adapt the Performance Dashboard start page to meet your requirements. You can adjust the interface texts displayed and the display properties.

Interface texts

You can adapt the texts displayed on the Performance Dashboard login page to meet your requirements by editing the file loginAppResources.xml in the directory <PPM installation directory>\bin\agentLocalRepo\.unpacked\ppm-web-run-prod-<version>-runnable.zip\ppm\PerformanceDashboard\webapp\assets. The texts displayed in the user interface are specified by key/value pairs depending on the selected language. The language is selected using the URL argument language=<Locale ID>.

Structure of the file loginAppResources.xml

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE dashboardresources SYSTEM "dashboardresources.dtd">

<dashboardresources>

<resourceslist language="...">

<resource key="..." value="..."/>

</resourceslist>

<resourceslist language="...">

<resource key="..." value="..."/>

</resourceslist>

</dashboardresources>

The file contains a list of possible login languages with the assigned display texts. If the URL argument language is not specified for the URL, the default language is used.

The screen below shows the possible keys and their position on the login page.

Linked Picture File Template_support_manuals_APD

Example

You want to display supplementary information on the login page and use the following file.

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE dashboardresources SYSTEM "dashboardresources.dtd">

<dashboardresources>

<resourceslist language="de">

<resource key="loginApp.applicationTitle.DBT"
value="ARIS Performance Dashboard (deutsch)"/>

<resource key="loginApp.title.DBT"
value="Anmeldung&#10;Bitte geben Sie Benutzername und Kennwort an, &#10;um mit ARIS Performance Dashboard arbeiten zu können."/>

<resource key="loginApp.username.DBI"
value="Benutzername:"/>

<resource key="loginApp.password.DBI"
value="Kennwort:"/>

<resource key="loginApp.login.BTN"
value="Anmelden"/>

</resourceslist>

<resourceslist language="en">

<resource key="loginApp.applicationTitle.DBT"
value="ARIS Performance Dashboard"/>

<resource key="loginApp.title.DBT"
value="Login&#10;Please enter user name and password&#10; to access ARIS Performance Dashboard."/>

<resource key="loginApp.username.DBI"
value="User name:"/>

<resource key="loginApp.password.DBI"
value="Password:"/>

<resource key="loginApp.login.BTN"
value="Login"/>

</resourceslist>

</dashboardresources>

The string &#10; is interpreted as a line break.

The screen below shows the corresponding login page in English.

Linked Picture File Template_support_manuals_APD

Display properties

You can define certain display features of the login page, e.g., character set and colors, by editing templates (styles). These templates are defined in the XML file loginAppStyles.xml in the directory <PPM installation directory>\bin\agentLocalRepo\.unpacked\ppm-web-run-prod-<version>-runnable.zip\ppm\PerformanceDashboard\webapp\assets. The file contains a list of template definitions (styletemplates XML element). Each template definition is identified by a unique name and contains a list of attributes with the corresponding values. The attributes that are useful for a particular template definition depend on the type of interface item for which the template is being used.

Structure of the file loginAppStyles.xml

<?xml version="1.0" encoding="UTF-8"?>

<styletemplates>

<styledeclaration name="..."

<Attribute>=<Value>

/>

</styletemplates>

The screen below shows the assignment of interface items to the template names specified in the name XML attribute.

Linked Picture File Template_support_manuals_APD