Customizing Message Properties

It is possible to customize a set of message properties in Cadenza by overriding them.

Configuration

Set a system property or an environment variable named CADENZA_CUSTOM_PROPERTIES (see Environment Variables, System Properties and Other Runtime Configuration Options) that points to the .properties files with your custom messages.

The path to .properties files has a special format, see Working With Message Bundles.

Customizable message keys used in Cadenza

See Working With Message Bundles for how to edit .properties files.

Key Explanation 
exception.error.referral

Message shown on the default error page in the details part

 
exception.errorReport.mail.body

Message used as body for the email which can be sent by the user by clicking the link on the default error page; You may use these placeholders in your message: {{productName}}, {{errorId}}, {{serverTime}}, {{serverUrl}}, {{currentUsername}}

 
exception.errorReport.mail.subject

Message used as subject for the email which can be sent by the user by clicking the link on the default error page; You may use the {{productName}} placeholder in your message.

 
login.sso

Label of "Login via SSO" button on the login page.

 
login.status.maxClientCountReached

Message shown on the login page when the maximum number of logged-in users was reached. This message can be marked up, see How to Use Simple Markup.

 
mailaddress.support

Mail-address configured during the installation of Cadenza. Used as "To"-part of the email which can be sent by the user by clicking the link on the default error page.

 
mainMenu.home
mainMenu.help

Messages shown as tooltips when hovering over elements in the Cadenza header.

 
page.title

Message shown as the default HTML title in the most cases, default is "{{pageTitle}} - {{productName}}", which resolves to [Where-You-Are] - productName, e.g. "Startseite - Cadenza"

 
page.title.detailed

Message shown as the default HTML title in some cases, default is "{{pageTitle}}: {{pageSubTitle}} - {{productName}}" which resolves to [Where-You-Are]:[Details]-productName, e.g. "Diagramm: Zeitverlauf pro Kenngröße - Cadenza"

 
welcome.page.title

Message that is used as the {{pageTitle}} in the page.title message of the welcome page

 
welcome.view.title

Message that is shown in the view header of the welcome page; You may use the {{productName}} placeholder in your message.

 
productLink

Link for the productName in the default contents of the footer template (see Writing Custom Page Content)

 
productName

Used in several places all over Cadenza Web, default is "disy Cadenza"

User specific message keys

You may also add your own messages to the .properties files (see Working With Message Bundles for how to edit .properties files) and use them in custom content (see Writing Custom Page Content).

Example:

  • You want to use a message with the key contactText in some custom content.

  • The value of this message should be different in German and English.

Add the following lines to your custom .properties files:

my-messages_de.properties
contactText=Kontaktieren Sie uns gerne auch unter der Telefonnummer +49 123/456789.
my-messages_en.properties
contactText=You are also welcome to contact us under the telephone number +49 123/456789.