The Oracle Workflow Event Manager lets you register interesting business events that may occur in your applications, the systems among which events will be communicated, named communication agents within those systems, and subscriptions indicating that an event is significant to a particular system. The Event Manager also performs subscribtion processing when events occur.
You must have workflow administrator privileges to maintain Business Event System objects in the Event Manager pages. If you have workflow administrator privileges, you can create, update, and delete events, subscriptions, systems, and agents. You can also test business events by manually raising a test event. If you do not have administrator privileges, you can view Business Event System objects in the Event Manager, but you cannot modify them. Workflow administrator privileges are assigned in the Workflow Configuration page. See: Setting Global User Preferences.
Note: When defining internal names for Business Event System objects in the Event Manager, use only characters from the ASCII character set.
You can use the Workflow XML Loader to upload and download XML definitions for Business Event System objects between a database and a flat file. See: Using the Workflow XML Loader.
Note: To ensure that your customizations are handled appropriately in conjunction with the Online Patching feature introduced in Release 12.2, follow the instructions in Deploying Customizations in Oracle E-Business Suite Release 12.2, My Oracle Support Document 1577661.1.
When an event occurs in an application on your local system, an event key must be assigned to uniquely identify that particular instance of the event. Then the event must be raised to the Event Manager.
You can raise an event by any of the following methods:
Raise the event from the application where the event occurs using the WF_EVENT.Raise() PL/SQL API or the raise method in the BusinessEvent Java class. See: Raise.
Raise the event from a workflow process using a Raise event activity. See: Event Activity.
Raise the event manually using the Test Business Event page. See: To Raise a Test Event.
Additionally, the Event Manager can receive events sent from the local system or remote systems.
When an event is raised by a local application or received from a local or external system, the Event Manager executes any subscriptions to that event. Depending on the action defined in the subscription, the Event Manager may send the event information to a workflow process, send the event information to an agent, send a notification, send or receive an Oracle XML Gateway message, execute custom code, or invoke a Web service.
To communicate event messages between systems, you must schedule propagation for outbound messages and run agent listeners for inbound messages. You can use Oracle Enterprise Manager to schedule propagation and the Workflow Manager component of Oracle Applications Manager to run agent listeners. You can also view the distribution of event messages on different agents in Workflow Manager, drill down to view details about individual event messages, and review queue details for the agents. For more information, please refer to the Oracle Enterprise Manager online help, Oracle Enterprise Manager Support, Oracle Streams Advanced Queuing User's Guide and Reference, Oracle Workflow Manager Overview, and Setting Up the Business Event System.
To test your Business Event System setup, you can run the Workflow Agent Ping/Acknowledge workflow. See: Workflow Agent Ping/Acknowledge.