Sun Worklist Manager Service Engine User's Guide

Defining Automatic Task Notifications

Creating notifications is a three–step process. First you define the notification, and specify who will receive the notification and how the email is presented. Then you specify a task action, such as Claimed or Completed, and associate the action with the notification, or you associate the notification with a defined escalation. Finally you configure the Email Binding Component by modifying the automatically generated WSDL file, EmailNotificationHanlder.wsdl, that defines the email binding.

Perform these tasks in the following order to define automatic notifications:

ProcedureTo Define Automatic Notifications

  1. Complete the steps under Assigning Users and User Groups to a Task.

  2. If the task definition is not opened, open the file in the Task Definition Editor.

  3. Click the Notification tab.

    Figure shows the Notification page of the Task
Definition Editor.
  4. Enter a name for the notification.

  5. In the Operation field, select an operation to handle the email notification from the email notification handler WSDL file.

    Note –

    Both the port type and operation are defined in EmailNotificationHandler.wsdl. You only need to modify the operation if you customize the WSDL file. The port type cannot be modified.

  6. In the E-Mail Addresses section, click New and then enter an email address for the notification in the new line.

  7. In the Subject field, enter a subject for the email that goes out.

  8. Under the Subject field, enter the text that should appears in the email that goes out.

    You can specify this in literal text, as a variable that takes the text from the incoming message, or a combination of both. For more information about XPath expressions, see Using XPath Expressions and Functions in Task Definitions.

    Figure shows a notification configured in the
Task Definition Editor.
  9. Continue to To Associate a Notification With a Task Status Change or Escalation.

ProcedureTo Associate a Notification With a Task Status Change or Escalation

  1. Complete the steps under To Define Automatic Notifications.

  2. To associate a task status with the notification, do the following:

    1. Click the Actions tab.

    2. Click Add Action.

    3. Enter a name for the action, and then select a task Status from the Type list.

    4. In the Notifications section click Add, and then select the name of the notification to associate.

      Figure shows a defined trigger action.
  3. To associate an escalation with the notification, do the following:

    1. Click the Escalations tab.

    2. Click Add in the Notifications section for the escalation you are assigning the notification to.

    3. Click in the new line that appears, and then select the name of the notification to add.

      Figure shows an escalation definition for a Worklist
Manager task.
  4. On the NetBeans toolbar, click Save All.

ProcedureTo Configure the Email BC for Task Notification

The Email BC WSDL file need to be configured for your email server.

  1. Open EmailNotificationHandler.wsdl in the WSDL Editor.

  2. Expand Services > EmailNotificationHandlerService > NotificationHandlerPortTypeBindingPort.

  3. Select email:SMTPaddress.

    The SMTP address properties appear in the Properties panel.

  4. Configure the following properties for your email server:

    • emailServer: The email server host that is used for sending emails.

    • port: The port number for the email server.

    • userName: The user login name used for authentication on the email server.

    • password: The user password used for authentication.

    • useSSL: An indicator of whether to use SSL for connecting to the server.

      Figure shows the email handler WSDL file.

    This is how the properties look in the WSDL code view:

    <service name="EmailNotificationhandlerService">
          <email:SMTPaddress location="" 
    				 emailServer=yourServer userSSL="false" port="465"
               userName="yourUserName" password="yourPassword"/>