Oracle Workflow Guide Release 2.6.2 Part Number A95265-02 |
Previous | Next | Contents | Index | Glossary |
When an event is raised locally, the Event Manager checks each subscription before executing it to determine whether the subscription requires the event data. If the event data is required but is not already provided, the Event Manager calls the Generate function for the event to produce the event data. The Generate function returns the event data in character large object (CLOB) format.
Note: If the event data is required but no Generate function is defined for the event, Oracle Workflow creates a default set of event data using the event name and event key.
Note: If the Generate function is costly, and you want to return control to the calling application more quickly after raising the event, you can defer all the subscriptions that require the complete event data. Then the Event Manager will not run the Generate function until those subscriptions are executed at a later time. See: Deferred Subscription Processing.
The PL/SQL function that generates the event data must have the following standard API:
function <function_name> (p_event_name in varchar2, p_event_key in varchar2 p_parameter_list in wf_parameter_list_t default null) return clob;
The arguments for the function are as follows:
p_event_name | The internal name of the event. |
p_event_key | A string generated when the event occurs within a program or application. The event key uniquely identifies a specific instance of the event. |
p_parameter_list | An optional list of additional parameter name and value pairs for the event. |
To Define an Event Subscription
Previous | Next | Contents | Index | Glossary |