Changing the Texts of Notification
E-Mails
Use
The user management engine (UME) ships with default texts for notification e-mails. These texts are stored in a Java archive (JAR) file on the SAP NetWeaver Application Server (AS) Java. To modify the default texts, you store the modified texts in the configuration store of the AS Java. The modified texts stored in the configuration store have priority over the texts in the JAR file and are not overwritten during an upgrade.
The notification texts are defined in packaged files where there is a different file for each language. The UME also provides a range of placeholders that you can use in the text.
Prerequisites
This procedure requires you to stop the AS Java, so you should plan for the required downtime while the AS Java restarts.
Procedure
...
1. Create a file for the language you require, and enter the texts that you want to use for notification e-mails.
We recommend that you copy an existing file and modify it as required.
To modify an existing file, proceed as follows:
a. In the file system, navigate to:
<ASJava_installation>\j2ee\cluster\bin\ext\com.sap.security.core.sda\
b. From the file sap.com~tc~sec~ume~core~impl.jar, extract the file notificationTexts_<language>.properties where <language> is the language that you want to change.
There is a separate file for each language. For example German texts are defined in notificationTexts_de.properties, Spanish texts are defined in notificationTexts_es.properties. To modify the e-mail message in several languages, you must modify all the corresponding files.
c. Create a copy of the file and modify the text as required.
For line breaks, use \ncontrol sequence.
The following placeholders are defined and can be used to personalize the texts.
Placeholder |
Description |
{0} |
DisplayName of the sending user |
{1} |
Salutation of the sending user |
{2} |
First name of the sending user |
{3} |
Last name of the sending user |
{4} |
DisplayName of the receiving user |
{5} |
Salutation of the receiving user |
{6} |
First name of the receiving user |
{7} |
Last name of the receiving user |
{8} |
Password of the receiving user
The system replaces the placeholder with the password: ● When users register themselves and the system generates the user passwords automatically ● When users reset their own passwords with the logon help ● When the user administrator changes or resets the user’s password ● When the user administrator creates a new user
The system sends the password in plain text. Users must change their passwords at the first opportunity. |
{9} |
Free text. This is the text that the administrator or user can add in a text box, for example when locking user. Do not remove the free text placeholder. |
d. Name and save the file com.sap.security.core.util.notification.notificationTexts_<language>.properties.
2. Upload the file to the AS Java as follows:
a. Stop the AS Java.
b. Start the Config Tool.
c.
Choose 
with the
quick info text Switch to configuration editor
mode.
d. In the Display Configuration tab, choose cluster_config → system → custom_global → cfg → services → com.sap.security.core.ume.service.
e.
Choose 
with the
quick info text Switch between view and edit
mode.
f. Click com.sap.security.core.ume.service with the secondary mouse button and choose Create sub-node.
The Create dialog box appears
g. Choose File-entry as the type of entry.
h. Choose Upload, browse to the file you created, and choose Open.
The text of your file is displayed in the text field.
i. Choose Create.
j. Choose Close window.
In the Config Tool there is a new entry under com.sap.security.core.ume.service with the name com.sap.security.core.util.notification.notificationTexts_<language>.properties.
k. Restart the AS Java.
Result
The modified texts appear in the notification e-mails.