Notification messages are based on a message template that determines the format and contents of an e-mail notification message, including the message subject and body. A template is an HTML-formatted document that you can view or change as required to customize notification messages. The template text may include dynamic content that is generated at run time by retrieving information from the running instance of the workflow process. Notification messages are created, and normally sent, in HTML format. You can optionally configure the activity to format and send notification messages as plain text.
The Web Interface address setting specifies the address (URL) of the Active Roles Web Interface. The activity uses this setting to construct hyperlinks in the notification messages.
The email server setting determines the name and other parameters of the email server that is used for delivery of notification messages.
A Notification activity in a workflow is used to subscribe recipients to the notifications of the following events:
-
Executing this activity: This event occurs upon running the Notification activity. When configured to notify of this event, the activity creates and instantly sends an email message about initiating the Notification activity. Notification of this event is normally intended to inform that the workflow initiation process has reached the Notification activity.
-
Workflow completed successfully: When configured to notify of this event, the activity creates a message to be sent upon workflow completion. When the workflow is completed, Active Roles will send that message if no considerable errors occurred during the running of the workflow.
-
Workflow encountered an error: When configured to notify of this event, the activity creates a message to be sent upon workflow completion. When the workflow is completed, Active Roles will send that message if some errors occurred during the running of the workflow.
-
Operation performed: When configured to notify of this event, the activity creates a message to be sent upon workflow completion. When the workflow is completed, Active Roles will send that message if the operation that started the workflow is successfully performed.
The configuration of a Notification activity specifies the notification event and recipients. When run by the workflow, the Notification activity prepares a notification message appropriate to the specified event. Active Roles retains the message prepared by the activity, and sends the message to the specified recipients once that event occurs. The configurable settings of a Notification activity are similar to the notification settings of an Approval activity.