Sending Notifications When Workflow Steps Result in Specific Errors

You can configure the notification to be sent when a workflow step has a specific error. Table 3-2. Specific errors for workflow steps lists the possible workflow step errors.

Table 3-2. Specific errors for workflow steps
Specific Error	Meaning
No consensus	All users of all security groups, or users linked to the workflow step need to vote, and there is no consensus.
No recipients	None of the security groups linked to the workflow step have users linked to it. No user can act on the workflow step.
Timeout	The workflow step timed out. (Used for execution steps and decision steps.)
Invalid token	Invalid token used in the execution.
ORACLE error	Failed PL/SQL execution.
NULL result	No result is returned from the execution.
Invalid integer	Validation includes an invalid value in the Integer field.
Invalid date	Validation includes an invalid value in the Date field.
Command execution error	Execution engine has failed or has a problem.
Invalid Result	Execution or subworkflow has returned a result not included in the validation.
Parent closed	For wf_receive or wf_jump steps, a request expects a message from a package line that is cancelled or closed.
Child closed	For wf_receive or wf_jump steps, a package line expects a message from a request that is cancelled or closed.
No parent	For wf_receive or wf_jump steps, a request expects a message from a package line that has been deleted.
No child	For wf_receive or wf_jump steps, a package line expects a message from a request that has been deleted.
Multiple jump results	For wf_jump steps in a package Line, different result values were used to transition to the step.
Multiple Return Results	The package-level subworkflow received multiple results from package lines that traversed it.

To send a notification when a workflow step has a specific error:

From the Workbench shortcut bar, select Configuration > Workflows.
Open a workflow.
In the Workflow window, click the Layout tab.
Double-click a workflow step.
In the Workflow Step window, click the Notifications tab.
Click New.

The Add Notification for Step window opens to the Setup tab.
From the Event list, select Specific Error.
From the Error list, select the error that you want to trigger the notification.
To determine the time at which the notification is sent, from the Interval list, select a value.

Note: If you select 8:00 AM Daily M-F, the notification will go out every morning at 8:00 AM from Monday through Friday after the step becomes eligible.

If you select 8:00 AM Daily M-F or Hourly M-F, you can send multiple notifications to a single recipient in a batch.
To send recipients a reminder if the event is still in effect after a given number of days:
1. For the Send Reminder? option, select Yes.
2. In the Reminder Days field, type the number of days after which, if the event is still in effect, a reminder is to be sent.
For Enabled, leave Yes selected.
To stop notification transmission after the step is no longer eligible, select the Don't send if obsolete checkbox.
In the Recipients section, select the notification recipients (users, security groups, or tokens). For detailed instructions, see Configuring Notification Recipients.
Click the Message tab, and the configure the body of the notification. For details on how to do this, see Configuring Message Content.
Click OK.
In the Workflow Step window, click OK.