| 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.

> 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.

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.

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 an event key. 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. 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