To View and Maintain Event Subscriptions: To View and Maintain Event Subscriptions:Use a Web browser to navigate to the Event Manager, using a responsibility and navigation path specified by your system administrator. Then choose the Subscriptions tab. See: Oracle Workflow Developer Navigation Paths.
Search for the subscriptions you want to display. The main search option is:
System - Select the system for which you want to display subscriptions.
You can also enter the following additional search criteria.
Source Type - Select Local, External, or Error as the type of source system for which you want to display subscriptions.
Event - Select the event for which you want to display subscriptions.
Status - Select Enabled or Disabled as the status of the subscriptions you want to display.
If you have workflow administrator privileges, you can use the administration icons and buttons to perform administrative operations.
To update a subscription, choose the update icon for that subscription. See: To Create or Update an Event 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.
To delete a subscription, select the subscription and select the Delete button.
Note: You cannot delete any subscription seeded by Oracle E-Business Suite that has a customization level of Core or Limit.
To create a new subscription, select the Create Subscription button. See: To Create or Update an Event Subscription.
To Create or Update an Event Subscription:Navigate to the Create Event Subscription page or to the Update Event Subscriptions page. The Create Event Subscription page and the Update Event Subscriptions page are identical, except that the fields in the Update Event Subscriptions page are populated with previously defined information for the selected 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.
Note: Your Oracle E-Business Suite installation may include seeded subscriptions owned by Oracle E-Business Suite products that you have not licensed. For such subscriptions, the Update Subscription page displays a notice that the subscription is not licensed. Oracle Workflow will not execute any of these subscriptions.
In the Subscriber region, select the system where the subscription executes.
In the Triggering Event region, specify the event source to which the subscription applies in the Source Type field.
Local - The subscription applies only to events raised on the subscribing system.
External - The subscription applies only to events received by an inbound agent on the subscribing system.
Note: All event messages received by an inbound agent on the subscribing system are considered to have an External source, whether the sending agent is located on a remote system or on the local system.
Error - The subscription applies to only to errored events dequeued from the WF_ERROR queue or WF_JAVA_ERROR queue.
Select the event that triggers the subscription in the Event Filter field. You can specify an individual event or an event group.
Optionally select a source agent to which the subscription applies. If you specify a source agent, then the subscription is executed only when the triggering event is received from that agent.
Note: In most cases, the Source Agent field is left blank.
In the Execution Condition region, enter a phase number for the subscription to specify the order in which subscriptions triggered by the same event are executed. The phase number also controls whether a subscription is executed immediately or is deferred, unless processing for the event is deferred by another method.
Select Enabled or Disabled as the subscription status. If you disable a subscription, it still remains in the Event Manager for reference, but it can no longer be executed when events occur.
In the Rule Data field, specify the event information required by the subscription.
Key - The subscription requires only the event key.
Message - The subscription requires the complete event data.
In the Action Type region, select the subscription processing you want to perform when the triggering event occurs.
Launch Workflow - Send the event message to launch or continue a workflow process.
Send to Agent - Send the event message to a Business Event System agent.
Send Notification - Send a notification using a standard or custom message template.
Receive Trading Partner Message - Receive an Oracle XML Gateway message from your trading partner.
Send Trading Partner Message - Generate an Oracle XML Gateway message and send the message to your trading partner.
Invoke Web Service - Invoke a Web service.
Custom - Execute custom business logic defined as a PL/SQL rule function or as a Java rule function.
Specify the error handling to perform if Oracle Workflow encounters an error while processing this subscription.
Stop and Rollback - The Event Manager halts all subscription processing for the event and rolls back any subscriptions already executed for the event.
Skip to Next - The Event Manager rolls back only this subscription and then continues processing the next subscription for the event according to the subscription phase order.
Choose the Next button to define the details of the subscription action, depending on the action type you selected.
If you selected Launch Workflow as the action type, enter the following details.
Select the workflow item type and process name for the workflow process to which you want to send the event. Ensure that the process contains a receive event activity that will be able to accept the event. The event can either launch a new process instance or continue an existing process instance that is waiting to receive the event.
Note: The list of values for the Workflow Process field includes only the runnable processes within the item type you specify.
Select Normal, High, or Low as the priority for the subscription. Oracle Workflow uses the priority to help determine the order in which deferred subscriptions are processed. The default priority is Normal.
You can optionally select an additional option to control how the subscription is executed.
Add Subscription Parameters - Set the subscription parameters into the parameter list within the event message before sending the event to the specified workflow process. All the event parameters will be set as item attributes for the workflow process when the process receives the event.
Launch when Business Key Matches - Send the event to all existing workflow process instances that have eligible receive event activities waiting to receive it, marked by a business key attribute that matches the event key. This option lets you send the event to multiple processes. However, note that with this option the event is only sent to continue existing processes. If you want to launch a new process instance with the event, do not select this option.
Note: If you select this option, the Event Manager ignores the specified workflow item type and process name. Instead, it uses the business key attribute to identify the workflow processes that should receive the event.
Note: The rule function used for the Launch when Business Key Matches option, Instance_Default_Rule(), may take some time to complete, depending on how many existing workflow processes include receive event activities, how many of those processes are eligible to receive this event, and what activities in those processes the Workflow Engine must execute after the event has been received. Consequently, when you select this option, it is strongly recommended that you set the phase number for the subscription to 100 or higher to defer the subscription and allow the rule function processing to be completed in the background by an agent listener.
Launch when Parameters Match - Send the event to the specified workflow process only if the event message includes parameters whose names and values match all the parameters defined for the subscription. This option lets you specify additional conditions to control whether or not the subscription is executed. Ensure that you include the required parameters in the parameter list within the event message, either by providing them when the event is raised or by adding them during prior subscription processing.
If you selected the Add Subscription Parameters option or the Launch when Parameters Match option, specify the parameters for the subscription. Enter the name and value for each parameter with no spaces.
If you selected Send to Agent as the action type, enter the following details.
Enter either the Out Agent that you want to send the outbound message, or the To Agent that you want to receive the inbound message, or both.
If you specify both a To Agent and an Out Agent, Oracle Workflow places the event message on the Out Agent's queue for propagation, addressed to the To Agent.
If you specify a To Agent without an Out Agent, Oracle Workflow selects an outbound agent on the subscribing system whose queue type matches the queue type of the To Agent. The event message is then placed on this outbound agent's queue for propagation, addressed to the To Agent.
If you specify an Out Agent without a To Agent, Oracle Workflow places the event message on the Out Agent's queue without a specified recipient. The Out Agent must use either a multi-consumer queue with a subscriber list or a single-consumer queue.
Note: The Out Agent must be located on the subscribing system. The list of values for the Out Agent field includes only agents with a direction of Out.
The list of values for the To Agent field includes only agents with a direction of In.
Select Normal, High, or Low as the priority for the subscription. Oracle Workflow uses the priority to help determine the order in which deferred subscriptions are processed. The default priority is Normal.
You can optionally select an additional option to control how the subscription is executed.
Add Subscription Parameters - Set the subscription parameters into the parameter list within the event message before placing the event message on the outbound agent.
Launch when Parameters Match - Place the event message on the outbound agent only if the event message includes parameters whose names and values match all the parameters defined for the subscription. This option lets you specify additional conditions to control whether or not the subscription is executed. Ensure that you include the required parameters in the parameter list within the event message, either by providing them when the event is raised or by adding them during prior subscription processing.
If you selected the Add Subscription Parameters option or the Launch when Parameters Match option, specify the parameters for the subscription. Enter the name and value for each parameter with no spaces.
If you selected Send Notification as the action type, enter the following details.
Select the workflow item type and message name for the message you want to send.
Note: You do not need to define or run a workflow process to send a notification from a subscription with the Send Notification action type. However, you do need to define the message you want to send within a workflow item type. The list of values for the Message Name field includes only the messages within the item type you specify.
Select the role that should receive the notification.
Optionally enter a custom callback function you want the Notification System to use for communication of SEND and RESPOND source message attributes. See: Custom Callback Function.
Optionally enter context information for a workflow process instance that you want to pass to the callback function. With the standard Oracle Workflow callback function, the Notification System requires a context to obtain values for item type attributes. If you do not specify a context, do not reference any item type attributes in the message attributes. Otherwise the message body will not display correctly. The context information consists of the item type, item key, and activity ID in the following format:
<itemtype>:<itemkey>:<activityid>
If you specify a custom callback function, then enter the context information that is appropriate for your function.
Optionally enter a comment to send with the message.
Select Normal, High, or Low as the priority for the message. Oracle Workflow also uses the priority to help determine the order in which deferred subscriptions are processed. The default priority is Normal.
If you selected Receive Trading Partner Message or Send Trading Partner Message as the action type, select Normal, High, or Low as the priority for the subscription. Oracle Workflow uses the priority to help determine the order in which deferred subscriptions are processed. The default priority is Normal.
Note: You do not need to enter any additional subscription parameters for these action types.
If you selected Invoke Web Service as the action type, enter the Web service details in the Invoke Web Service wizard.
Enter the URL where the Web Services Description Language (WSDL) description for the Web service is located, and choose Next. For example:
http://www.example.com/myservice.wsdl
If the Web service is a BPEL process, you can specify a relative URL using the prefix bpel:// followed by a relative path to the WSDL description on the BPEL server. For example:
bpel://mybpelservice.wsdl
Note: You must specify the bpel:// prefix in lowercase letters.
At runtime, Oracle Workflow replaces the bpel:// prefix with the host name and port for the BPEL server specified in the WF: BPEL Server profile option. This profile option lets you quickly change the BPEL server setup for all subscriptions that invoke BPEL processes, such as if you move these subscription definitions from a test instance to a production instance. See: Specifying the BPEL Server.
Oracle Workflow displays the WSDL source and description that you specified. Select the name of the Web service from that description that you want to consume, and choose Next.
Oracle Workflow displays the WSDL source, WSDL description, and service name that you specified, and lists the name and endpoint of each available port. Select the port to use for the service and choose Next.
Oracle Workflow displays the WSDL source, WSDL description, service name, and port that you specified, and lists the name, port type, and operation type of each available service operation. Select the operation to invoke, and choose Next.
In the Web Service Security region, enter a user name and password if required to authenticate the user invoking the Web service.
Note: For a subscription seeded by Oracle E-Business Suite with a customization level of Core or Limit, if the seeded subscription definition includes a user name, then you cannot update that user name. However, if no user name was provided in the seeded subscription definition, then you can add or update the user name. If the Web service requires a password, you can update the password in the subscription definition, regardless of the customization level.
By default, Oracle Workflow uses oracle.apps.fnd.wf.bes.WebServiceInvokerSubscription as the Java rule function for a Web service subscription. If you have extended this class with a custom class, enter your custom class instead.
You can optionally specify additional parameters for the subscription to define further pre-invocation and post-invocation processing. Enter the name and value for each parameter with no spaces.
Oracle Workflow converts the list of subscription parameters into a text string of name and value pairs, separated by spaces, in the following format:
<name1>=<value1> <name2>=<value2> ... <nameN>=<valueN>
If you define a custom rule function, the function can reference the parameters from this format.
If you selected Custom as the action type, enter the following details.
Enter the rule function that contains the custom business logic you want to run on the event message. You can define the rule function either as a Java class or as a PL/SQL function. In either case, the rule function must be defined according to a standard API. See: Standard API for an Event Subscription Rule Function.
For a Java subscription, enter the Java rule function in the following format:
<customPackage>.<customClass>
In this case, you should leave the PL/SQL Rule Function field blank.
For a PL/SQL subscription, enter the PL/SQL rule function in the following format:
<package_name>.<function_name>
In this case, you should leave the Java Rule Function field blank.
Note: If you enter a rule function other than WF_RULE.Default_Rule, Oracle Workflow does not automatically send the event message to the specified workflow and agent. You must explicitly include the send processing in your custom rule function instead.
If your rule function will send the event to a workflow process, you can specify the workflow item type and process name for the function to reference. Ensure that the process contains a receive event activity that will be able to accept the event.
Note: The list of values for the Workflow Process field includes only the runnable processes within the item type you specify.
If your rule function will send the event to an agent, you can specify the outbound and inbound agents for the function to reference. Depending on the send processing in your function, you may need to specify either the Out Agent that you want to send the outbound message, or the To Agent that you want to receive the inbound message, or both.
Note: The Out Agent must be located on the subscribing system. The list of values for the Out Agent field includes only agents with a direction of Out.
The list of values for the To Agent field includes only agents with a direction of In.
Select Normal, High, or Low as the priority for the subscription. Oracle Workflow uses the priority to help determine the order in which deferred subscriptions are processed. The default priority is Normal.
You can optionally specify additional parameters for the subscription, to be referenced by the rule function. Enter the name and value for each parameter with no spaces.
Oracle Workflow converts this list of subscription parameters into a text string of name and value pairs, separated by spaces, in the following format:
<name1>=<value1> <name2>=<value2> ... <nameN>=<valueN>
The rule function can reference the parameters from this format.
For all action types, in the Documentation region, identify the program or application that owns the subscription 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 subscription.
Core - No changes can be made to the subscription definition. This level is used only for subscriptions seeded by Oracle E-Business Suite.
Limit - The subscription status can be updated to Enabled or Disabled, but no other changes can be made to the subscription definition. This level is used only for subscriptions seeded by Oracle E-Business Suite.
User - Any property in the subscription definition can be updated. This level is automatically set for subscriptions that you define.
Enter an optional description for the subscription.