Business Event Subscription JCA Connectivity Using OAPPS Adapter

21-18 Developers Guide for Oracle Application Integration Architecture Foundation Pack 5. Choose the right connectivity based on the E-Business Suite capability to communicate the required ABM to AIA based on the business requirements: Select Concurrent Program Executable or Business Event Subscription. 6. Finalize the format of the message E-Business Suite ABM. 7. Finalize the contract between E-Business Suite and AIA, that is, define the WSDL of the AIA requester ABCS. 8. Define and finalize the error or fault handling message format between E-Business Suite and AIA. 9. Define the error handling mechanism and the style of AIA errors to be displayed and logged for the E-Business Suite application user. 10. Finalize on the MEP between E-Business Suite and AIA. Follow Best Practices and Design Asynchronous Patterns to Avoid Long Running Transactions 1. Finalize on the type of acknowledgment for asynchronous operations. 2. Ensure the metadata of the service is captured in the Oracle Enterprise Repository. 3. Add the service to the deployment plan of the AIA project definition. Tasks for Developers in Service Design and Construction phase: 1. Analyze the E-Business Suite requester ABS definition provided by solution architect. 2. Work with E-Business Suite development and discuss the possible design. 3. Finalize the content of the message from E-Business Suite. 4. Get the schema of the message from E-Business Suite and ensure the following: TargetNameSpace - If higher than version 0, must have suffix VN where V is abbreviation for version and N is the version number. If there is no version number, it is considered to be version 0. Example 21–7 provides an example of version 0. Example 21–7 Example of a Version 0 TargetNameSpace xsd:schema xmlns:xsd=http:www.w3.org2001XMLSchema targetNamespace=http:xmlns.oracle.comebizCurrencyExchange xmlns:db=http:xmlns.oracle.comebizCurrencyExchange elementFormDefault=qualified xsd:schema xmlns:xsd=http:www.w3.org2001XMLSchema targetNamespace=http:xmlns.oracle.compcbpeladapterdbtopCreatePayable InvoiceListEbizDBAdapterV1 xmlns=http:xmlns.oracle.compcbpeladapterdbtopCreatePayableInvoiceList EbizDBAdapterV1 5. Construct a requester ABCS using AIA Service Constructor. Provide the WSDL from this service to the E-Business Suite development team.

21.4.3 Business Event Subscription JCA Connectivity Using OAPPS Adapter

Subscription for Enterprise Business Service EBS Workflow business events can be achieved by having the Business Event Adapter OAPPS adapter available in Oracle JDeveloper as a plug-in, which can be used to invoke any service to raise a business event in E-Business Suite. A WF_BPEL_Q queue gets created as a subscription to the Establishing Resource Connectivity 21-19 event and the adapter reads the events from the WF_BPEL_Q as and when a message arrives in the queue it triggers the adapter service. E-Business Suite should generate the schemas ABMs, which are used to define the contracts WSDLs between AIA and E-Business Suite and to develop AIA requester ABCS. For some of the business objects, the ABMs generated have only event information. In such situations, the business object ID is extracted from the event information published and E-Business Suite is queried to get the whole object. Perform the following tasks as part of the AIA Project Management Lifecycle for the Service Conception and Definition phase and the Service Design and Construction phase: Tasks for Solution Architects in Service Conception and Definition Phase: 1. Identify the requester ABCS for E-Business Suite and add them to the AIA project definition. 2. For new ABCS, work with business analysts to capture the requirements in detail. 3. For existing ABCS, work with business analysts to capture details of extensions to be carried out. 4. Work with developers and drive the design of the ABCS. a. Choose the best connectivity based on the E-Business Suite capability to communicate the required ABM to AIA based on the business requirements: Select Concurrent Program Executable or Business Event Subscription. b. Finalize the format of the message ABM. c. Finalize the contract between E-Business Suite and AIA. Define the WSDL of the AIA requester ABCS. d. Define and finalize the error or fault handling message format between E-Business Suite and AIA. e. Define the error handling mechanism and the style of AIA errors to be displayedloggedalert mechanism to E-Business Suite user. f. Finalize on the MEP between E-Business Suite and AIA. g. Follow the best practices and design asynchronous patterns to avoid long running transactions. h. Finalize on the type of acknowledgment for asynchronous operations. 5. Ensure the metadata of the service is captured in the Oracle Enterprise Repository. 6. Add the service to the deployment plan of the AIA project definition. Tasks for Developers in Service Design and Construction Phase: 1. Analyze the E-Business Suite requester ABCS definition provided by the solution architect. 2. Work with E-Business Suite development and discuss the possible design. 3. Finalize the content of the message from E-Business Suite. 4. Get the schema of the message from E-Business Suite and ensure the following: TargetNameSpace - If higher than version 0, must have suffix VN where V is abbreviation for version and N is the version number. If there is no version 21-20 Developers Guide for Oracle Application Integration Architecture Foundation Pack number, it is considered to be version 0. Example 21–8 provides an example of version 1: Example 21–8 Example of a Version 1 TargetNameSpace xsd:schema xmlns:xsd=http:www.w3.org2001XMLSchema targetNamespace=http:xmlns.oracle.comebizCurrencyExchange xmlns:db=http:xmlns.oracle.comebizCurrencyExchange elementFormDefault=qualified xsd:schema xmlns:xsd=http:www.w3.org2001XMLSchema targetNamespace=http:xmlns.oracle.compcbpeladapterdbtopCreatePayable InvoiceListEbizDBAdapterV1 xmlns=http:xmlns.oracle.compcbpeladapterdbtopCreatePayableInvoiceList EbizDBAdapterV1 5. Construct a requester ABCS using AIA Service Constructor. 6. Provide the WSDL from this service to the E-Business Suite development team. 7. Create an E-Business Suite Adapter Service Composite to be triggered by the business event in E-Business Suite and invoke the JMS producer service. 8. Identify the connection factory name and the JNDI reference. 9. Identify the business event to be subscribed. 10. Identify the schema to be confirmed for the incoming message or business event. 11. Use the SOA Mediator component to create the adapter composite. 12. Identify the target queue name, connection factory name, and the JNDI reference. 13. Annotate the composite.xml. For more information see Section 9.6, How to Annotate the Transport Adapter Composite . 14. Harvest to Oracle Enterprise Repository. For more information see Chapter 3, Harvesting Oracle AIA Content .

21.4.4 Outbound: Oracle E-Business Suite Application Interaction with AIA Services