Runtime Messages

The Cúram CDEJ runtime messages can be localized or customized by creating a RuntimeMessages.properties file within the component folder, i.e. the <client-dir>/components/<component_name> folder. The default content for this file can be found in the <cdej-dir>/doc/defaultproperties/ folder. Any messages present in this file will override the corresponding messages from the RuntimeMessages.properties shipped with the Cúram CDEJ. The standard file naming convention for Java properties files can be used to add locale-specific messages. For example, to create a Spanish version, a file RuntimeMessages_es.properties would be created.

It is not necessary to copy all of the messages into the custom message catalog when customizing only some of them. Only the messages that are customized need to be defined in the custom message catalog; the other messages will be loaded from the default message catalog.

When resolving error messages, the custom message catalog is checked first and all the locale fall-backs are applied. If a message is not found, then the default message catalog (from the Cúram CDEJ) is checked. Therefore, a message in a custom message catalog will take precedence over one in a default catalog even if the locale of the default catalog is more specific.

When customizing a message, the message argument placeholders cannot be changed. The message argument placeholders have the form %ns where n is the argument number. The message arguments can be moved around and their order changed, but no new arguments may be added and none may be removed.