Enabling E-Mail Notifications for DTR Collisions

1. (One time only) Configure the user access

Note that you can review the configured e-mail notifications in the e-mail notification service even with a user that has no administrative roles. However, to be able to change the e-mail notifications, you have to be an Application Server Java (AS Java) or SAP NetWeaver Development Infrastructure (NWDI) administrator.

To enable the e-mail notification service, you have to configure a user to access the CBS. For that purpose, you create a dedicated user to use for this connectivity. A connectivity user must have permissions for read access to the CBS, and administrator's rights on the AS Java. Assign the user to the SAP_DI_DEVELOPER role and to the NWDI.Administrators group. The connectivity user must have the following characteristics:

To be able to read buildspace list from CBS. For this purpose the SAP_DI_ADMINISTRATOR role is required.
To be able to read folders below /ws in DTR. For this purpose the NWDI.Administrators group is required.
To be able to get information from the Application Server Java (AS Java), such as the host name and HTTP(S) ports that are required to put into the e-mails. For this purpose, the SAP_JAVA_NWADMIN_LOCAL_READONLY role is required.

For more information about configuring the user in the SAP NetWeaver Administrator, see Identity Management and Assigning Principals to Roles or Groups .

Once you have set up the user, you have to add it in the e-mail notification service. To do that:

In your browser, go to http://<host>:<port>/devinf and log on as an administrator. Choose the E-Mail Notification Service link.
Open the Global Notification Settings tab page. Choose the Edit pushbutton.
Enter the name of the connectivity user in the NWDI Access User field. Enter the user's password in the NWDI Access Password field. Repeat again the password in the Access Password Confirmation filed.
Save the changes.

2. (One time only) Enabling e-mail notifications for DTR collisions

To configure e-mail notifications for DTR collisions, DTR must be enabled for notification:

Open http://<host>:<port>/dtr/sysconfig/registered.properties .
Set the value of the property com.tssap.dtr.server.util.jms.enableJMS to true .
Set the value of the property com.tssap.dtr.server.util.jms.enableJMS.DTR.integrate to true .
In your browser, go to http://<host>:<port>/devinf . Choose the E-Mail Notification Service link. Log on and open the Global Notification Settings tab page. Choose the Edit pushbutton.
1. Set the value of the property enabled to true .
2. Set the value of the property simulation to false .
Save your settings.

To enable a certain track for collision notification e-mails, use the Web UI, select the track, plug-in, and template. Currently only one DTR plug-in is available.

3. (One time only) Define how often to check for notification events

With this step you define how often the e-mail notification service will check for events that could trigger e-mail notifications. This is a mandatory step.

Open the SAP NetWeaver Administrator tool.

In your browser, go to http://<host>:<port>/nwa .
Open the tab page Operations Jobs . Choose the Java Scheduler link.
In the Java Scheduler, open the Tasks tab page and choose the Add pushbutton.
In the wizard that appears find the NWDINotifyJob job. Choose Next .
Specify NWDINotifyTask as the display name for the task. Choose Next . In the Set Properties steps, choose Next again.
In the Set Execution Time step, on in the Reccuring tab page, specify the end date when the e-mail notifications will be automatically stopped. In the Period fields, we recommend that you define 60 seconds as the time interval for checking for new events.
Choose the Add pushbutton. Complete the wizard.

4. Create an e-mail template for the notification

You now have to create a template to be used for the sent e-mails. The template you want to use has to be created using HTML. Then you can upload this e-mail notification template to the e-mail notification service. Note that you can create and configure several different notification templates to be used when different events occur. However, you cannot change the list of participants of these e-mails - they are always sent to the same list of e-mail addresses.

You can create your own e-mail templates to be used when e-mail notification events occur. The file that you want to use as the template must be in HTML format:

Using HTML, create a file to be used as the template. Store it on your system.

For more information about creating such a template, see Configuring E-Mail Notification Templates .
In your browser, go to http://<host>:<port>/devinf . Choose the E-Mail Notification Service link.
On the HTML Templates tab page, browse to the location of the HTML file, then choose the Upload New Template pushbutton.

The HTML template is uploaded to the list of templates. You can now use it when creating a new e-mail notification configuration, or if you edit an existing one.

5. Configuring e-mail notifications for DTR collisions

In your browser, go to http://<host>:<port>/devinf . Choose the E-Mail Notification Service link. Open the DTR Notification Settings tab page.
Choose the Edit pushbutton.
In the dialog that appears, specify the e-mail addresses of the receivers of the e-mail. To add more than one e-mail address, use a semi-colon (;) as the separator.

Note that each address can be either a user ID from the identity management system (in which case, the e-mail address is retrieved from the identity management system), or a full e-mail address (identified by the at (@) sign).
Specify the event which should trigger an e-mail notification from the Plugin dropdown menu.
Specify which HTML template should be used for the e-mails from the Template dropdown menu.
Choose Add Selected Plugin .

Note
If you want to add more plug-ins, repeat the steps 4, 5 and 6.
Choose the Save Configuration pushbutton.