Print      Open PDF Version of Online Help


Previous Topic

Next Topic

Workflow Monitor

You can use the Workflow Monitor to view instances of workflow Wait actions that are in a pending state, and instances of workflow actions that terminated unexpectedly after a wait period on a Wait action ended.

The Workflow Monitor page shows two lists:

  • A list of pending instances
  • A list of error instances

Pending Instances

From the Workflow Monitor, you can view details of pending instances and details of the workflow actions. For example, if an instance of a workflow Wait action is pending for longer than you expect, you can use the Workflow Monitor to investigate the instance and look at the configuration of the workflow action, and if necessary, you can delete the instance.

NOTE: When you delete a pending instance of a Wait action, none of the remaining actions on the workflow rule are performed.

For example, you might configure a workflow rule with the following intended sequence of actions:

  1. A Wait action with a duration of 24 hours
  2. A Send Email action
  3. A Wait action with a duration of 48 hours
  4. A Send Email action
  5. A Create Task action

If the actions are correctly configured, the first Wait action in the sequence, action 1, remains in the Pending state for 24 hours. When the wait period ends, the Send Email action (action 2) is performed. The second Wait action (action 3 on the workflow rule) is next in the sequence. It remains in the Pending state for 48 hours. When the wait period ends, the Send Email action (action 4) and the Create Task action (action 5) are performed.

However, if the wait period on action 3 was incorrectly specified as 48 days rather than 48 hours, the action remains in the pending state until 48 days have passed. You can see the action in the pending list on the Workflow Monitor, and you can view the action details to see if the wait period is incorrectly specified. You can then delete the Wait action instance.

When you delete the Wait action instance, the workflow rule instance is terminated, and the remaining actions on the rule instance are not performed. In the previous example:

  • If you delete action 1 while it is pending, actions 2, 3, 4, and 5 are not performed.
  • If you delete action 3 while it is pending, actions 4 and 5 are not performed.

NOTE: Wait actions are the only type of workflow actions that are held in the Pending state.

Error Instances

You can also use the Workflow Monitor to view details of some failed workflow instances. Failed instances of workflow actions are recorded on the Workflow Monitor only in the case where the action fails after the end of the wait period on a Wait action on the workflow rule.

In all other cases, when a workflow instance fails, the failure is reported immediately to the user whose actions triggered the workflow rule. The failure is reported in an onscreen error message or in the log file. Error messages for failed actions on workflow rules that are triggered by a Web service are reported in the response to the Web service.

As an example, you might configure a workflow rule with the following sequence of actions:

  1. A Send Email action
  2. A Create Task action
  3. A Wait action
  4. A Send Email action

If action 1 or action 2 terminates because of an error, the failure is reported in an error message on the screen or in the log file. If action 3 fails before the wait period starts, the failure is also reported in an error message on the screen or in the log file. If action 3 fails after the wait period ends, or if action 4 fails, the failure of the action is recorded in the Workflow Monitor. An error message is also written to the log file if the workflow rule was triggered by a Web service, but no message is displayed on the screen in the case where the workflow rule was triggered by a user action.

Details of workflow action instances that fail after the end of the wait period on a Wait action are retained in the error instances list of the Workflow Monitor for three months or until you delete them, whichever comes first. You can view details of the instances that terminated and details of the workflow actions.

For information about using the Workflow Monitor, see the following topics:

Related Topics

See the following topic for related information about workflow rules:


Published 5/4/2012 Copyright © 2005, 2012, Oracle. All rights reserved. Legal Notices.