Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA
Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com
2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
Oracle Enterprise Business Suit (EBS) 12.1.3 Connector User Guide V1.0
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
Contents Oracle Enterprise Business Suit (EBS) 12.1.3 Connector ........................................................... 3 User Guide V1.0 ..................................................................................................................... 3 1. Introduction ....................................................................................................................... 5 2. Technologies ...................................................................................................................... 6 3. High level Architectural Diagram ....................................................................................... 6 4. About Oracle EBS ............................................................................................................... 7 5. How to Publish Oracle EBS12.1.3 web services.................................................................... 8 6. Different Types of Object Services .................................................................................... 11 7. Configure web service ...................................................................................................... 12 8. Web Service Methods and Parameters ............................................................................. 13 9. Configure SOA Header ..................................................................................................... 14 10. Enabling the Oracle EBS Connector ................................................................................. 14 11. Creating Oracle EBS Connection ..................................................................................... 14 12. Connector Read and Write notes .................................................................................... 16 13. Assumptions & Limitations ............................................................................................. 19
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
1. Introduction
Informatica Cloud Connector SDKs are off-cycle, off-release add-ins that provide connectivity to SaaS and on-premise applications not supported natively in Informatica Cloud. Connector SDKs can be enabled anytime for your cloud org Id, and are designed to address common use cases including getting data into, and out of, the supported application.
Connector SDKs do not require any separate software installation on the machine running the Informatica Cloud Secure Agent. The Connector uses an internal Java application to communicate with the Secure Agent, as shown in the architecture diagram below:
Once you have enabled the Connector Package software for your org Id, you need to create an connection in Informatica Cloud to access the AOS
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
2. Technologies Connector is developed using following technologies - JDK 1.6, JAX-WS API 3. High level Architectural Diagram
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
EBS Connector: using JAX-WS API to invoke Oracle EBS published Web service methods dynamically Oracle EBS published Web service: Every object in Oracle EBS12.1.3 exposed as web service with standard operation for Read, Write, Update & Delete data from/to Oracle EBS12.1.3 4. About Oracle EBS Oracle E-Business Suite (also known as Applications/Apps or EB-Suite/EBS) consists of a collection of enterprise resource planning (ERP), customer relationship management (CRM), and supply-chain management (SCM) computer applications either developed or acquired by Oracle. The software utilizes Oracle's core Oracle relational database management system technology. The E-Business Suite (current version: 12.1.3 contains several product lines, including: Oracle CRM Oracle Financials Oracle HRMS Oracle Mobile Supply Chain Applications Oracle Order Management Oracle Procurement Oracle Project Portfolio Management Oracle Quotes Oracle Transportation Management Oracle Warehouse Management Systems Oracle Inventory. Oracle Enterprise Asset Management Each product comprises several modules, each separately licensed. Significant technologies incorporated into the applications include the Oracle database technologies, (engines for RDBMS, PL/SQL, Java, .NET, HTML and XML), the "technology stack" (Oracle Forms Server, Oracle Reports Server, Apache Web Server, Oracle Discoverer, Initiator and Sun's Java).
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
5. How to Publish Oracle EBS12.1.3 web services
Login into Oracle EBS
Entering Into Integration Repository
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
Integration Repository is a catalogue of annotated interfaces available in Oracle E-Business Suite applications. Different interface types are PL/SQL apis, Open Interface Tables, XML Gateway Map, EDI gateway Map, Java API etc.
Expose a Interface (PL/SQL) as Web Service in R12.1.3 Deploy in Oracle server
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
After deployment of API, the WSDL can be used by any SOA client
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
Hosted Web services are secured via FND_USER/SSO credentials
6. Different Types of Object Services
Module Object Description WSDL HR Get Absence Details PER_ABSENCE_RECORD HR Get Location Details HR_LOCATION_RECORD AR Get Installment AR_PREPAYMENTS_PUB INV Get Serial Difference INV_SERIAL_NUMBER_PUB OM Get Order OE_ORDER_PUB AP Create Supplier Header AP_VENDOR_PUB_PKG AR Create Customer Header HZ_CUST_ACCOUNT_V2PUB FA Create Asset FA_ADDITION_PUB AR Create AR Invoice AR_INVOICE_API_PUB INV Generate Serial Number INV_SERIAL_NUMBER_PUB AR Create Miscellaneous AR Receipt AR_RECEIPT_API_PUB AR Create and Apply AR Receipt AR_RECEIPT_API_PUB SYS Create User FND_USER_PKG HR Create Location HR_LOCATION_API OM Update Order Header OE_ORDER_PUB OM Update Order Line OE_ORDER_PUB
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
7. Configure web service
Make sure / add wsdl urls are added into two places <Secure agent install path>\Informatica Cloud Secure Agent\main\bin\rdtm\javalib\507100\ EBSWSDLConfig.ini <Secure agent install path>Informatica Cloud Secure Agent\main\tomcat\plugins\507100\ EBSWSDLConfig.ini
Note: In all the above configured URLs, fnd_user_pkg is mandatory which used for EBS user authentication. Ex: http://bg4ws0372.sonata.local:8005/webservices/SOAProvider/plsql/fnd_user_pkg/?wsdl
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
8. Web Service Methods and Parameters Web service operation method is presented in WSDL which is configured in EBSWSDLConfig.ini The list of operation presented WSDL will be presented in Informatica cloud UI when create task. Each method input parameter format is different from one method to another method
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
9. Configure SOA Header Some Oracle EBS web service(Order Management) method require SOAHeader is mandatory in such case the method should be configured with soa header element in soaheader.properties in two location
Note that Oracle EBS Connector SDK needs to be enabled by Support or Informatica Representative. It might take 15 minutes for the Connector SDK to get downloaded to your Secure Agent after being enabled.
11. Creating Oracle EBS Connection
Before you can use the Oracle EBS Connector SDK in a data synchronization task, you must follow these steps to create a connection in Informatica Cloud: 1. Click on the Configuration tab. 2. Click on the Connections page. 3. Click the New button.
Connection Property Description Connection Name Provide the Name of the connection Description (optional) Provide the description Type Select Oracle EBS (Informatica Cloud) Secure Agent Secure Agent that Informatica Cloud uses to access the Web Service. User Name Provide the user name Password Provide the password Host Name of the Host (Oracle EBS Server) Port Oracle EBS web service port number
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
12. Connector Read and Write notes
1. Read Setting value for Input 1. EBS methods may return one or more records, depends on method. 2. All element under the Input parameter should be removed in case of writing to flat file (in Create Target)
3. User should enter values for input parameters in Data Filter page (It may be not mandatory for some method operations) 4. If inputs parameters are optional and no parameters are defined, then all the records will be returned.
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
Informatica Worldwide Headquarters, 100 Cardinal Way, Redwood City, California 94063, USA Phone: toll-free in the US: 1.800.653.3871 www.InformaticaCloud.com 2011 Informatica Corporation. All rights reserved. Informatica and the Informatica logo are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners.
13. Assumptions & Limitations
1. User has to configure wsdl urls in two places
<secure agent install path>\Informatica Cloud Secure Agent\main\bin\rdtm\javalib\507100\ EBSWSDLConfig.ini <secure agent install path>Informatica Cloud Secure Agent\main\tomcat\plugins\507100\ EBSWSDLConfig.ini 2. User has to configure soaheader in two places (If a EBS method requires soaheader while read/write/update
<secure agent install path>Informatica Cloud Secure Agent\main\tomcat\plugins\507100\ ebssoaheader.properties 3. User has to validate the mapping in Field mapping. 4. Pagination/batch is not supported for read/write operations