Skip Headers

Oracle Workflow Developer's Guide
Release 2.6.3

Part Number B10284-02
Previous Next       Contents Index Glossary
         Previous  Next          Contents  Index  Glossary

Default Event Error Process

DEFAULT_EVENT_ERROR is the internal name of the Default Event Error Process for the Business Event System. The purpose of this error handling process is to:

'Receive Errored Queue Message' Event Activity

The Receive Errored Queue Message activity receives an event message that has encountered an error or warning condition during subscription processing. For instance, if a subscription rule function returns an ERROR or WARNING status code, or if an unexpected event is received, the Event Manager executes default subscriptions that send the event message to the Default Event Error process. See: Predefined Workflow Events.

The Receive Errored Queue Message activity stores the event name, event key, and the complete event message in item type attributes.

'Initialize Event Error' Function Activity

The Initialize Error activity calls a PL/SQL procedure named WF_STANDARD.INITIALIZEEVENTERROR. This procedure determines the error type.

'Event Warning Notification' Activity

The Workflow Engine initiates the Event Warning Notification activity when the errored event has an error type of Event Warning. The activity sends the Default Event Warning message to the system administrator to indicate that a warning condition has occurred during subscription processing. This message is an FYI message and does not require a response.

The subject and body of the Default Event Warning message are as follows:

Subject: Event WARNING : &EVENT_NAME / &EVENT_KEY
Body: A Warning occurred in the following Event
Subscription: &EVENT_SUBSCRIPTION

Event Error Name: &ERROR_NAME
Event Error Message: &ERROR_MESSAGE
Event Error Stack: &ERROR_STACK

Event Data: &EVENT_DATA_URL

Other Event Details: &EVENT_DETAILS

'External Event Error Notification' Activity

The Workflow Engine initiates the External Event Error Notification activity when the errored event has an error type of External Event Error. The activity sends the Default External Event Error message to the system administrator. This message indicates that an error has occurred during subscription processing for an event received from an external source, and that a response is needed. The response options and their resulting actions are:

The system administrator can attempt to correct the error before re-enqueuing the event. For example, the system administrator can create a subscription to handle an unexpected event and then re-enqueue the event message to trigger the new subscription.

The subject and body of the Default External Event Error message are as follows:

Subject: External Event &ERROR_TYPE : &EVENT_NAME / &EVENT_KEY
Body: An Error occurred in the following Event
Subscription: &EVENT_SUBSCRIPTION

Event Error Name: &ERROR_NAME
Event Error Message: &ERROR_MESSAGE
Event Error Stack: &ERROR_STACK

Event Data: &EVENT_DATA_URL

Other Event Details: &EVENT_DETAILS

'Local Event Error Notification' Activity

The Workflow Engine initiates the Local Event Error Notification activity when the errored event has an error type of Local Event Error. The activity sends the Default Local Event Error message to the system administrator. This message indicates that an error has occurred during subscription processing for an event raised on the local system, and that a response is needed. The response options and their resulting actions are:

The system administrator can choose the level of information to provide to the Event Manager when reraising the event. For example, if an error exists in the event data that was originally provided, the event can be reraised with only the event name and the event key, forcing the Event Manager to regenerate the event data using the event's Generate function.

The system administrator can also attempt to correct the error before reraising the event.

The subject and body of the Default Local Event Error message are as follows:

Subject: Local Event &ERROR_TYPE : &EVENT_NAME / &EVENT_KEY
Body: An Error occurred in the following Event
Subscription: &EVENT_SUBSCRIPTION

Event Error Name: &ERROR_NAME
Event Error Message: &ERROR_MESSAGE
Event Error Stack: &ERROR_STACK

Event Data: &EVENT_DATA_URL

Other Event Details: &EVENT_DETAILS

'Retry Process Event' Function Activity

The Retry Process Event activity executes the PL/SQL procedure WF_STANDARD.RETRYRAISE. Depending on the notification response selected by the system administrator, this procedure either re-enqueues or reraises an errored event. The responses that can initiate the Retry Process Event activity and their resulting actions are:

See Also

Workflow Core APIs, Oracle Workflow API Reference

Managing Business Events


         Previous  Next          Contents  Index  Glossary


Oracle Logo
Copyright © 2003 Oracle Corporation.

All rights reserved.