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:

  1. From the Workbench shortcut bar, select Configuration > Workflows.

  2. Open a workflow.

  3. In the Workflow window, click the Layout tab.

  4. Double-click a workflow step.

  5. In the Workflow Step window, click the Notifications tab.

  6. Click New.

    The Add Notification for Step window opens to the Setup tab.

  7. From the Event list, select Specific Error.

  8. From the Error list, select the error that you want to trigger the notification.

  9. 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.

  10. 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.

  11. For Enabled, leave Yes selected.

  12. To stop notification transmission after the step is no longer eligible, select the Don't send if obsolete checkbox.

  13. In the Recipients section, select the notification recipients (users, security groups, or tokens). For detailed instructions, see Configuring Notification Recipients.

  14. Click the Message tab, and the configure the body of the notification. For details on how to do this, see Configuring Message Content.

  15. Click OK.

  16. In the Workflow Step window, click OK.