"To Define an Event (Oracle Workflow Developer's Guide)

Oracle Workflow Developer's Guide
Release 2.6.3
Part Number B10284-02


	Previous	Next		Contents	Index	Glossary

To Define an Event

1. Use a web browser to connect to the following URL:

 <webagent>/wf_event_html.listevents

Replace <webagent> with the base URL of the web agent configured for Oracle Workflow in your Web server. See: Setting Global User Preferences, Oracle Workflow Administrator's Guide.

Attention: This URL accesses a secured page, so if you have not yet logged on as valid user in the current web session, you will be prompted to do so before the page appears. You must have workflow administrator privileges to access the Event Manager web pages.

Note: You can also access the Events web page from the Oracle Workflow home page. See: Accessing the Oracle Workflow Home Page, Oracle Workflow Administrator's Guide.

2. The Events page appears, displaying a list of existing events. The Events page summarizes the internal name, display name, type, and status of each event.

Choose the Add Event button to open the Edit Event page.

Note: For seeded events with a customization level of Limit, you can only update the event status. For seeded events with a customization level of Core, you cannot update any properties; you can only view the event definition.

3. Enter the internal name of the event in the Name field. All Oracle Workflow APIs, SQL scripts, and PL/SQL procedures refer to the internal name when identifying an event. The internal name is case-sensitive. The suggested format is a compound structure of identifiers separated by periods (.) as follows:

 <company>.<family>.<product>.<component>.<object>.<event>

4. Enter a Display Name for the event. This name appears in the Events list.

5. Enter an optional description for the event.

6. In the Status field, select Enabled or Disabled as the event status. If you disable an event, it still remains in the Events list for reference, but you cannot use the event in active subscriptions.

7. If you are defining an event that occurs on your local system, enter the Generate Function for the event. The Generate function is a PL/SQL procedure that can produce the complete event data from the event name, event key, and an optional parameter list. See: Standard API for an Event Data Generate Function.

8. You can optionally identify the program or application that owns the event by entering the program name in the Owner Name field and the program ID in the Owner Tag field. The Owner Name and Owner Tag are not required if you are defining an event manually in the Edit Event page. However, if you use a program to create event definitions automatically, the Event Manager displays the owner information set by that program in these fields. You can use the Edit Event page to update this information manually if necessary.

9. You can review the customization level for the event.

Core - No changes can be made to the event definition. This level is used only for events seeded by Oracle Applications.

Limit - The event status can be updated to Enabled or Disabled, but no other changes can be made to the event definition. This level is used only for events seeded by Oracle Applications.

User - Any property in the event definition can be updated. This level is automatically set for events that you define.

10. Choose the Submit button to save the event and return to the Events page. The Events page displays an updated list of events.

You can also choose the Cancel button to return to the Events page without saving the event.


	Previous	Next		Contents	Index	Glossary