27 January 2010
Introduction
WebSphere Adapter for Oracle E-Business Suite (hereafter called Oracle EBS Adapter), as an
important product of the IBM WebSphere Adapter family, provides first class integration with
Oracle E-Business Suite (hereafter called Oracle EBS). It can help you integrate existing Oracle
EBS system resources into service-oriented architecture (SOA) business solutions.
Oracle E-Business Suite is a new generation Enterprise Resource Planning (ERP) that has great
deal of users in the worldwide ERP market. To enable external interaction, Oracle EBS exposes
several kinds of interface types, such as Oracle Open interface, Concurrent Program, Java
Service, XML Gateway, PL/SQL API, and so on. Therefore, to integrate with Oracle EBS through
these interfaces is a big challenge that IT engineers are facing.
This article illustrates how to integrate Oracle EBS with WebSphere Process Server through
Oracle Open Interface and Concurrent Program using WebSphere Adapter for Oracle E-Business
Suite.
WebSphere Adapter
WebSphere Adapters implement the Java EE Connector Architecture (JCA) and Enterprise
MetaData Discovery specifications to provide a perfect and quick integration experience with
Copyright IBM Corporation 2010
Integrating Oracle E-Business Suite through the Oracle Open
Interface and Concurrent Program using WebSphere Adapters
Trademarks
Page 1 of 18
developerWorks
ibm.com/developerWorks/
graphical discovery tools without resorting to writing code. It delivers generic technology and
business application adapters with wizards that quickly and easily service enable legacy
applications, ERP, HR, CRM, and supply chain systems.
WebSphere Adapters build up the communication bridge between the enterprise applications (like
SAP, Siebel, Oracle e-Business Suite, and so on) and WebSphere platform (Figure 1). It also
enables the WebSphere platform with the capability to access the external data sources through
various technologies, such as JDBC, e-mail, FTP, and so on.
WebSphere Adapter for Oracle E-Business Suite provides inbound and outbound bi-directional
interaction with Oracle EBS.
Inbound
Inbound processing enables an application to receive notification when objects in Oracle EBS
system are changed. The change causes a trigger, or a business event, to update the event store
with information about the change. Periodically, the adapter polls the event store, retrieves, and
processes events, and then delivers them to the export component of a module that is part of an
application that runs in WebSphere Process Server or WebSphere Enterprise Service Bus. Figure
2 shows the inbound processing.
Outbound
Outbound processing enables an application to access or modify data in Oracle EBS system.
An application running in WebSphere Process Server or WebSphere Enterprise Service Bus
invokes a service in an outbound module, which sends a request to the adapter to process one or
Integrating Oracle E-Business Suite through the Oracle Open
Interface and Concurrent Program using WebSphere Adapters
Page 2 of 18
ibm.com/developerWorks/
developerWorks
more business objects. The adapter connects to Oracle EBS system, inserts the data into Oracle
Interface Tables, and executes the specific Oracle Concurrent Program that validates and applies
the data into Oracle Base Tables. Figure 3 shows the outbound processing.
Interaction between WebSphere Adapter for Oracle E-Business Suite V7.0 and
Oracle E-Business Suite R12
This article will introduce the mechanism and practice of integrating Oracle EBS through Oracle
Open Interface and Concurrent Program using WebSphere Adapter for Oracle EBS. In Figure
4, it shows the outbound direction interaction. The Oracle invoice data can be first inserted into
Account Payables (hereafter called AP) Interface Tables, and then moved to Account Payables
Base Tables after validation.
The main steps of the process are:
1. Define a stored procedure that wraps the invoice import Concurrent Program. This article will
introduce why and how to define such kinds of stored procedures.
2. Run the Oracle EBS Adapter EMD process to discover the AP Interface Tables and the
predefined stored procedure. This will generate the adapter outbound module.
3. Deploy the module on WebSphere Process Server.
4. During the Oracle EBS Adapter outbound runtime, the invoice data is inserted into the AP
Interface Tables, and then the predefined stored procedure is invoked automatically to
Integrating Oracle E-Business Suite through the Oracle Open
Interface and Concurrent Program using WebSphere Adapters
Page 3 of 18
developerWorks
ibm.com/developerWorks/
execute the specific Concurrent Program to validate and apply the invoice data into the AP
Base Tables. Now, the invoice data becomes effective in the Oracle EBS system.
5. The invoice data can be queried through the Oracle EBS administration console.
Figure 4. Interaction scenario between Oracle EBS Adapter and Oracle EBS
Page 4 of 18
ibm.com/developerWorks/
developerWorks
Concurrent Program requires different parameter list and parameter values, which totally depend
on the business module to access.
Page 5 of 18
developerWorks
ibm.com/developerWorks/
9. In the Find Objects in the Enterprise System window, click Edit Query.
a. In the Specify the Query Properties window, type APPS in the Schema name or pattern
field.
b. Select the Prompt for additional configuration settings when adding business
object check box, and then click OK.
c. Click Run Query to display the objects discovered by the query.
10. Filter the table ap_invoices_interface under Synonyms Nicknames node and click the Add
icon (>) to select the object to be imported, as shown in Figure 6.
Page 6 of 18
ibm.com/developerWorks/
developerWorks
Page 7 of 18
developerWorks
ibm.com/developerWorks/
12. As in Steps 10 and 11, select the table AP_INVOICE_LINES_INTERFACE and configure
the primary key, parent table, and foreign key. Select the Parent object owns child object
(cascade) check box and Preserves AP_INVOICE_LINES_INTERFACE when the parent is
updated check box, and then click OK, as shown in Figure 8.
Page 8 of 18
ibm.com/developerWorks/
developerWorks
13. Through the above steps, two interface tables, AP_INVOICES_INTERFACE and
AP_INVOICE_LINES_INTERFACE, are selected (Figure 9). Click Next.
14. In the Specify Composite Properties window, only the Create operation remains. Leave the
default values for the other fields, and then click Next.
15. In the Specify the Service Generation and Deployment Properties window, do the following
(Figure 10):
Integrating Oracle E-Business Suite through the Oracle Open
Interface and Concurrent Program using WebSphere Adapters
Page 9 of 18
developerWorks
ibm.com/developerWorks/
16. Name the new module CreateAPInvoice, and then click Finish.
Integrating Oracle E-Business Suite through the Oracle Open
Interface and Concurrent Program using WebSphere Adapters
Page 10 of 18
ibm.com/developerWorks/
developerWorks
Until now, the outbound module CreateAPInvoice is generated for runtime use.
Scenario test
Next, you will test the generated module CreateAPInvoice:
1. Start WebSphere Process Server V7.0 in WebSphere Integration Developer.
2. Deploy the module CreateAPInvoice on to WebSphere Process Server.
3. Start the test client and fill in the sample test data as shown in Table 1 and Table 2. The test
data can also be found in the provided download files.
Value
Notes
invoice_id
216410
invoice_num
cp-1000
invoice_type_lookup_code
STANDARD
invoice_date
2009-12-14
vendor_name
AccessMicron
Supplier name
vendor_site_code
IRELAND
invoice_amount
63
Invoice amount
invoice_currency_code
USD
Currency of invoice
terms_name
description
Invoice description
source
org_id
204
vendor_email_address
test@cn.ibm.com
Value
Notes
invoice_id
216410
line_number
line_type_lookup_code
ITEM
amount
63
Line amount
accounting_date
2009-12-14
item_description
Page 11 of 18
developerWorks
ibm.com/developerWorks/
quantity_invoiced
unit_price
100
org_id
204
4. Click the Continue icon to send the outbound invoice data (Figure 11).
Page 12 of 18
ibm.com/developerWorks/
developerWorks
Page 13 of 18
developerWorks
ibm.com/developerWorks/
Page 14 of 18
ibm.com/developerWorks/
developerWorks
and Concurrent Program. The adapter first inserts the invoice data in to Oracle nterface table
AP_INVOICES_INTERFACE and AP_INVOICE_LINES_INTERFACE, and then the Adapter
invokes the stored procedure IMPORT_AP_INVOICE to execute the Concurrent Program
APXIIMPT to validate and apply data from the interface tables to the base tables. Finally, query the
imported invoice from the Oracle EBS administration console.
The key points to complete this scenario successfully are as follows:
1. The stored procedure that wraps all related actions to invoke business specific Concurrent
Program was defined correctly. The stored procedure contains two parts:
FND_GLOBAL.APPS_INITIALIZE to initialize the system parameters.
FND_REQUEST.SUBMIT_REQUEST to invoke the specific Concurrent Program with the
corresponding parameters.
All the parameter values should be provided correctly according to the specific Concurrent
Program.
2. The Adapter generated the correct business objects, service definition, and configuration files.
When running the External Service wizard in WebSphere Integration Developer, the interface
tables and stored procedure should be configured correctly, including the primary key, foreign
key, parent-child relationship, and the in-place operation AfterCreateSP.
3. The invoice data was inserted into the interface tables successfully. The imported invoice
data should be well defined so that it can be inserted into the interface tables. That means the
invoice data inserted into several interface tables should be consistent and valid.
4. The Concurrent Program was executed successfully. With the configured stored procedure,
the specific Concurrent Program will be executed automatically. The Concurrent Program can
be executed successfully when providing the appropriate parameter values.
Conclusion
In this article, we introduced the mechanism to integrate Oracle E-Business Suite R12 through
Oracle Open Interface and Concurrent Program by using WebSphere Adapter for Oracle EBusiness Suite V7.0. The article described a detailed development, configuration, and test process
of one business scenario that creates an Oracle invoice into the Oracle E-Business Suite Account
Payables module.
Page 15 of 18
developerWorks
ibm.com/developerWorks/
Downloads
Description
Name
Size
Code sample
script_test_data.zip
3KB
Page 16 of 18
ibm.com/developerWorks/
developerWorks
Resources
Page 17 of 18
developerWorks
ibm.com/developerWorks/
Kai Zhang
Kai Zhang is a Software Engineer at the IBM China Software development and has
great interest in Information Retrieve, SOA, and Web 2.0.
Page 18 of 18