Changing the Texts of Notification E-Mails 

Use

The User Management Engine (UME) is shipped with default texts for notification e-mails. These texts are stored in a Java archive (JAR) file on the SAP Net Application Server (AS) Java. If you want to modify the default texts, you can 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. User management also provides a range of placeholders that you can use in the text.

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.      On the file server, navigate to:

 <installation-drive>:\usr\sap\<SID>\<Instance_ID>\SDM\root\origin
\sap.com\com.sap.security.core.sda\SAP AG\<version_number>

where <version_number>is the highest version number in the directory.

                            b.      From the file com.sap.security.core.offline.sda, extract the file com.sap.security.core.jar.

                            c.      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. If you wish to modify the e-mail message in several languages, you must modify all the corresponding files.

                            d.      Create a copy of the file and modify the copy as required.

For line breaks, use \n control 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.

                            e.      Save the file and name it com.sap.security.core.util.notification.notificationTexts_<language>.properties.

       2.      Upload the file to the AS Java as follows:

                            a.      Shut down all cluster elements.

                            b.      Start the Config Tool by executing <SAPJ2EEEngine_installation>\j2ee\configtool\configtool.bat.

                            c.      Choose the symbol for Switch to configuration editor mode.

                            d.      In the tree, navigate to cluster_data → server → persistent → com.sap.security.core.ume.service.

                            e.      To switch to edit mode, choose  with the quick info text Switch between view and edit mode.

                              f.      Click on 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 all cluster elements.

Result

The modified texts appear in the notification e-mails.