Changing the Texts of Notification E-Mails

Use

The User Management Engine is shipped with default texts for notification e-mails and these are stored in a JAR file on the file server. However, if you wish to modify the default texts, you can store the modified texts in the configuration store of the J2EE Engine. The modified texts stored in the configuration store have priority over the texts in the JAR file and will not be 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 wish 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 \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
{9}	Free text. This is the text that the administrator or user can add in a text box, for example when creating a new user. In general, the free text placeholder should never be removed.

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

       2.      Upload the file into the J2EE Engine 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  (Switch between view and edit mode).

                              f.      Click on com.sap.security.core.ume.service with the alternate 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.