Show TOC

Procedure documentationConfiguring Notification Messages Service Locate this document in the navigation structure

 

With the notification messages service you can inform actual and potential processors of tasks via e-mail about new tasks in their inbox. The notification message has as subject the task title including dynamically created titles based on process context. The static body text is automatically translated. The message also includes a direct link to the task execution UI and a link to the universal worklist (UWL).

More information: Completing Tasks

To enable the notification messages service, you have to configure the mail server connectivity. In addition you can configure who gets a notification message, only the new actual processor or all potential processors.

Caution Caution

You can configure only one mail server to retrieve the sent notification e-mails. If this server is down or not reachable notifications will be lost. This can result in not meeting the deadline for a task and therefore cause a delay in execution of the business process. If you rely on e-mail notifications you need to ensure the provision of a reliable e-mail infrastructure.

End of the caution.

You can configure the notification messages service using the configuration wizard (see Wizard-Based Configuration for Business Process Management) or using the offline Config Tool as described below.

Procedure

Looking up the Default Settings in the SAP NetWeaver Administrator (Optional)

If you are not sure whether the notification messages service is already configured or what are the settings for the notification messages service, you can check the settings in the SAP NetWeaver Administrator.

  1. Open the SAP NetWeaver Administrator in a browser using the path http://<host>:<httpport>/nwa, and log on with administrator rights.

  2. Choose   Configuration Management   Infrastructure   Java System Properties  .

    Note Note

    You cannot edit the Java system properties online in the SAP NetWeaver Administrator.

    End of the note.

  3. Choose Applications tab, and select tc~bpem~base~ear.

  4. Look up the defaults for localization of the process context parameters of data type Date and Time:

    • Default.locale: For example, en.

    • Default.timezone: For example, CET.

  5. Look up the mail server properties:

    • Mail.from: E-mail address of the sender.

    • Mail.smtp.password: Password of the sender.

    • Mail.smtp.user: Name of the sender.

  6. Look up the following properties for the notification messages service:

    • Notification.assigned: If a notification message should be sent in case of delegation or nomination, this property needs to be set to true.

    • Notification.newtasks: If a notification message should be sent when a new task is in the inbox and also when a task is again displayed in the inbox because it was revoked, this property should be set to true.

    • http.baseurl: URL, including host name and port number, which is used to generate the links to the UWL and the task execution UI in the notification e-mail.

Configuring the Notification Messages Service with the Config Tool

The Config Tool provides offline configuration of the AS Java instances. To edit the AS Java settings, you can use the GUI Config tool or the command line Config Tool. For more information about the Config Tools, see Config Tool. In the following step-by-step description, we use the GUI Config Tool.

  1. To start the GUI Config Tool, double-click the configtool script file in <SAP_install_dir>/<system_name>/<instance_name>/j2ee/configtool directory.

  2. Select your instance and choose Applications.

  3. Select the tc~bpem~base~ear application.

  4. Enter defaults for localization of the process context parameters of data type Date and Time. Mark the property and enter the value in the Custom Value field.

    • Default.locale: Enter a locale, for example, en.

    • Default.timezone: Enter a time zone in the standard notation, for example, CET.

  5. Enter the following mail server properties:

    • Mail.from: Enter the e-mail address of the sender.

    • Mail.smtp.password: Enter the password of the sender.

    • Mail.smtp.user: Enter the user name of the sender.

  6. Set the following properties for the notification messages service:

    • Notification.assigned: To send a notification message in case of delegation or nomination, set this property to true. Otherwise set it to false.

    • Notification.newtasks: To send a notification message to all potential owners when a new task is in the inbox and also when a task is again displayed in the inbox because it was revoked, set this property to true. Otherwise set it to false.

    • http.baseurl: Enter the URL, which is used to generate the links to the UWL and the task execution UI in the notification e-mail. As host name, enter the fully qualified domain name, for example, http://<host.xyz.company.corp>:<httpport>.

  7. To save the settings, click Save (Save).

  8. To apply the new settings, restart the instance

    .

Configuring the JavaMail Client Service

In addition you need to configure the JavaMail Client Service properties:

  1. Open the SAP NetWeaver Administrator in a browser using the path http://<host>:<httpport>/nwa, and log on with administrator rights.

  2. Choose   Configuration Management   Infrastructure   Java System Properties  .

  3. Choose Services tab, and select Java Mail Client.

  4. Enter the host of the mail server like this, for example <mail.company.corp>. The default value is localhost.

  5. Specifies the SSL certificate to be used for authentication if the connection is secure.

  6. Save the JavaMail Client Service Properties.