To View and Maintain Events: To View and Maintain Events:Use a Web browser to navigate to the Event Manager, using a responsibility and navigation path specified by your system administrator. Then choose the Events tab. See: Oracle Workflow Developer Navigation Paths.
Search for the events you want to display. The main search option is:
Name - Enter the internal name of the event you want to display. You can enter a partial value to search for events whose internal names contain that value.
You can also enter the following additional search criteria:
Display Name - Enter the display name of the event you want to display.
Type - Select Event or Group as the type of the events you want to display.
Status - Select Enabled or Disabled as the status of the events you want to display.
Owner Name - Enter the name of the program or application that owns the event you want to display.
Owner Tag - Enter the application short name of the application that owns the event you want to display.
To view the subscriptions to an event, select the subscription icon for that event.
Note: For events that do not have any subscriptions, a blank subscription icon appears in the Subscription column. For events that do have subscriptions to them, a full subscription icon appears.
If you have workflow administrator privileges, you can define a new subscription to the event by selecting the Create Subscription button. The Create Event Subscription page appears with the event name automatically entered in the Event Filter field. See: To Create or Update a Subscription.
If you have workflow administrator privileges, you can update an existing subscription by selecting the update icon for that subscription. See: To Create or Update a Subscription.
Note: For seeded subscriptions with a customization level of Limit, you can only update the subscription status. For seeded subscriptions with a customization level of Core, you cannot update any properties; you can only view the subscription definition.
If you have workflow administrator privileges, you can use the administration icons and buttons in the Events page to perform administrative operations.
To update an event, choose the update icon for that event. See: To Create or Update an Event and To Create or Update an Event Group.
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.
To manually raise a test event, select the test icon for the event you want. See: To Raise a Test Event.
Note: You cannot raise an event group. You must raise each event individually.
To delete an event, select the event and select the Delete button.
Note: You can only delete events that do not have any subscriptions referencing them and that do not belong to any event groups.
Additionally, you cannot delete any event seeded by Oracle E-Business Suite that has a customization level of Core or Limit.
To create a new individual event, select the Create Event button. See: To Create or Update an Event.
To create a new event group, select the Create Event Group button. See: To Create or Update an Event Group.
To Create or Update an Event:Navigate to the Create Event page or to the Update Event page. The Create Event page and the Update Event page are identical, except that the fields in the Update Event page are populated with previously defined information for the selected event.
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.
Note: Your Oracle E-Business Suite installation may include seeded events owned by Oracle E-Business Suite products that you have not licensed. For such events, the Update Event page displays a notice that the event is not licensed. Oracle Workflow will not execute any subscriptions to these events.
Enter the internal name of the event in the Name field. 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>
Enter a display name for the event.
Enter an optional description for the event.
Select Enabled or Disabled as the event status. If you disable an event, its definition remains in the Event Manager for reference, but you cannot use the event in active subscriptions.
If you are defining an event that occurs on your local system, enter a generate function for the event. A generate function is a PL/SQL procedure or Java API that can produce the complete event data from the event name, event key, and an optional parameter list. Define only one generate function for an event, either PL/SQL or Java. See: Standard API for an Event Data Generate Function.
To assign the event a PL/SQL generate function, enter the PL/SQL procedure in the Generate Function field in the following format:
<package_name>.<function_name>
To assign the event a Java generate function, enter the Java API in the Java Generate Function field in the following format:
<customPackage>.<customClass>
Alternatively, if you want to use the XML metadata corresponding to a service data object (SDO) as the event data, you can define the Java generate function in a special format to retrieve the SDO metadata. See: Generating Service Data Object Metadata.
Identify the program or application that owns the event by selecting the application short name in the Owner Tag field. By default, Oracle Workflow sets the Owner Name field to the application name associated with that application short name. However, you can optionally enter a different name in the Owner Name field, such as a particular program or component within the application.
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 E-Business Suite.
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 E-Business Suite.
User - Any property in the event definition can be updated. This level is automatically set for events that you define.
To Create or Update an Event Group:Navigate to the Create Group page or to the Update Group page. The Create Group page and the Update Group page are identical, except that the fields in the Update Group page are populated with previously defined information for the selected event group.
Note: For seeded event groups with a customization level of Limit, you can only update the event group status. For seeded event groups with a customization level of Core, you cannot update any properties; you can only view the event group definition.
Note: Your Oracle E-Business Suite installation may include seeded event groups owned by Oracle E-Business Suite products that you have not licensed. For such events, the Update Group page displays a notice that the event group is not licensed. Oracle Workflow will not execute any subscriptions to these event groups.
Enter the internal name of the event group in the Name field. 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>
Enter a display name for the event group.
Enter an optional description for the event group.
Select Enabled or Disabled as the event group status. If you disable an event group, its definition remains in the Event Manager for reference, but you cannot use the event group in active subscriptions.
Identify the program or application that owns the event group by selecting the application short name in the Owner Tag field. By default, Oracle Workflow sets the Owner Name field to the application name associated with that application short name. However, you can optionally enter a different name in the Owner Name field, such as a particular program or component within the application.
Review the customization level for the event group.
Core - No changes can be made to the event group definition. This level is used only for event groups seeded by Oracle E-Business Suite.
Limit - The event group status can be updated to Enabled or Disabled, but no other changes can be made to the event group definition. This level is used only for event groups seeded by Oracle E-Business Suite.
User - Any property in the event group definition can be updated. This level is automatically set for event groups that you define.
Select the Apply button to save the event group definition.
To add a member event to the group, select the Add Events to Group button.
Note: An event group can contain only individual events as its members. It cannot contain another group.
In the Add Events to Group page, search for the events you want to add. The main search option is:
Name - Enter the internal name of the event you want to add. You can enter a partial value to search for events whose internal names contain that value.
You can also enter the following additional search criteria.
Display Name - Enter the display name of the event you want to add.
Type - You can only add individual events as members of the group.
Status - Select Enabled or Disabled as the status of the events you want to add.
Owner Name - Enter the name of the program or application that owns the event you want to add.
Owner Tag - Enter the program ID of the program or application that owns the event you want to add.
Select the event or events that you want to add to your event group, and select the Add to Group button.
You can optionally enter new search criteria to search for other events to add to the event group.
After you finish adding events to the event group, select the Apply button to save the event group members.
To delete a member event from the group, select the event in the Update Group page and select the Delete button.
Note: Deleting a member event from an event group does not delete the event definition for the individual event. The individual event remains in the Event Manager.
To Raise a Test Event:In the Event Identifier region, specify the event you want to raise.
Event Name - Select the internal name of the event.
Note: You cannot raise an event group. You must raise each event individually.
Event Key - Enter an event key that uniquely identifies this instance of the event.
Send Date - Optionally specify the date when the event message is available for dequeuing. If you set the send date to a future date when you raise the event, the event message is placed on the WF_DEFERRED queue, and subscription processing does not begin until the specified date.
In the Event Parameters region, optionally enter any additional parameter name and value pairs to be stored in the parameter list within the event message. You can enter up to 100 parameters.
In the Event Data region, you can optionally enter an XML document to describe what occurred in the event.
To enter the event data manually, select Write XML in the Upload Option field and enter the XML document in the XML Content field. You can enter up to 4000 characters.
To upload an XML file from your file system, select Upload XML in the Upload Option field. Enter the full path and file name of the XML file containing your event data in the XML File Name field, and select the Upload XML File button.
Note: You can also assign generate functions in the event definition to generate the event data, or raise the event using the WF_EVENT.Raise() API instead of using the Test Business Event page. These methods let you provide the event data as a CLOB storing up to four gigabytes of data. See: To Create or Update an Event and Raise.
Choose the tier where you want to raise the event and begin event processing.
To raise the event in the database, select the Raise in PLSQL button.
To raise the event in the middle tier, select the Raise in Java button.
The Test Business Event page displays a confirmation message together with the values you submitted for you to review. If the event triggers a Web service subscription that is executed synchronously and returns an XML response, the page also displays that response.
To clear all fields except the Event Name field, select the Clear button. You can then optionally raise another event.