Table of Contents

Search

  1. Preface
  2. Workflows
  3. Workflow Variables
  4. Workflow Parameters
  5. Cluster Tasks
  6. Command Task
  7. Human Task
  8. Mapping Task
  9. Notification Task
  10. Gateways
  11. Workflow Recovery
  12. Workflow Administration

Developer Workflow Guide

Developer Workflow Guide

Notifications Options

Notifications Options

Set the Notifications options to notify users or groups when a task instance that a step defines changes status. The Human task sends an email notice to the users or groups that you identify.
Before you can configure a Human task to send emails, an administrator must enable and configure the Email Service in the Administrator tool.
The following table describes the notification options of a step:
Property
Description
Task Events
Lists the types of status change for which a user can be notified. You can choose one of the following values:
  • Create. A Human task creates a task instance associated with the step.
  • Complete. A user completes a task instance.
  • Escalated. A user or group does not complete a task instance on time.
  • Reassign. A business administrator reassigns a task instance to another user.
You can configure the Notifications options to send a different notification for each task event. For example, you can notify a user when a Human task creates the task instance, and you can notify another user when the task instance is complete. You can also enter a different email subject and message for each task event.
Recipients
Lists one or more users to notify for the status change that you select.
You can select or clear the option to notify the task owner in addition to any recipient that you select when the task instance changes status. The option applies when a single user owns the task instance. When you select the option to notify the task owner, you can optionally leave the Recipients field empty.
Subject
Lists the contents of the subject line for the email notifications. You can edit the subject line.
Mime Type
Specifies the content type for the email. Select one of the following values:
  • Plain. Send a message in plain text.
  • HTML. Send HTML content. You can include lists and hyperlinks in HTML content.
The HTML view provides basic a HTML structure by default. If you edit the HTML, you cannot restore the default structure.
Message
Displays the email content as you type.
Preview
Displays the email content as it will appear to the recipients.

Workflow Variables in Task Instance Notifications

You can use workflow variables to write information about a Human task instance to an email notification. The variables store information about the task instance when a user completes, escalates, or reassigns a task instance. To display the list of variables, click in the subject line or the notification message body and press the $+CTRL+SPACE keys.
The notification can display the following variables:
$taskEvent.eventTime
The time that the workflow engine performs the user instruction to escalate, reassign, or complete the task instance.
$taskEvent.owner
The owner of the task instance at the time that the workflow engine escalates or completes the task. Or, the owner of the task instance after the engine reassigns the task instance.
$taskEvent.status
The task instance status after the engine performs the user instruction to escalate, reassign, or complete the task instance. The status names are READY and IN_PROGRESS.
$taskEvent.taskEventType
The type of instruction that the engine performs. The variable values are escalate, reassign, and complete.
$taskEvent.taskId
The task instance identifier that the Analyst tool displays.

0 COMMENTS

We’d like to hear from you!