Using Wed Application Desktop Integrator for Inbound Interfaces

Author: Amit Jain

Declaration
I hereby declare that this document is based on my personal experiences. To the best of my knowledge, this document does not contain any material that infringes the copyrights of any other individual or organization including the customers of Cognizant.

Target Readers
Oracle Apps Customization Oracle Apps Implementation Oracle Inbound Interfaces

Keywords
Oracle Web ADI Data Load to Staging tables.

Introduction

Page 1 of 10

The scope of this document is to give an overview about leveraging Web ADI to replace the common use of Data Loader while dealing with the Oracle Inbound Interfaces. Data loader is a very conventional way of loading the data into the staging tables using the cumbersome data formats received as data files. Over a period of time, we have seen that Data loader approach factors in a great degree of propensity to errors. Therefore, I have used Web ADI to load the data across all the interfaces used in the client system. It extended a great ease to the users in preparing the data files in the excel format, debugging the fall outs from the Data file and a better GUI to the users for loading the data.

What is Web ADI?

The Oracle Web Applications Desktop Integrator integration with Microsoft Excel enables to bring your Oracle E-Business Suite data to a spreadsheet where familiar data entry and modeling techniques can be used to complete Oracle E-Business Suite tasks. We can create formatted spreadsheets on the desktop that allows to download, view, edit, and create Oracle E-Business Suite data. Use data entry shortcuts (such as copying and pasting or dragging and dropping ranges of cells) or Excel formulas to calculate amounts to save time. This combines speed and accuracy by invoking lists of values for fields within the spreadsheet. After editing the spreadsheet, we can use the Oracle Web Applications Desktop Integrator validation functionality to validate the data before uploading it to Oracle E-Business Suite. Validation messages are returned to the spreadsheet, allowing you to identify and correct invalid data. The fields that appear in the spreadsheet, their positions, and their default values can all be customized through the Oracle Web Applications Desktop Integrator Layout functionality. This allows to create a more productive work environment by removing unnecessary fields from the spreadsheet, and by organizing the spreadsheet in a way that conforms to your practices.
Advantages

Load data into database tables Familiar medium (Excel) User Friendly FTP tool is not required. No need to provide access of server to end user

Page 2 of 10

Requirement & Problems Faced

The business users had been preparing the Pipe delimited files all the time to contain the data for Customers, Serial Numbers (Install Base), Inventory Items etc. The files were loaded into the Oracle Staging tables and then subsequently picked by the respective Oracle Interfaces. This entire process was very vulnerable to human errors while entering the data and cumbersome error handling techniques. Therefore, we suggested business to completely weed out the process of preparing the Pipe Delimited files and instead use the Spreadsheet for entering the data and uploading it.
Solution

APPS Setup
Desktop Integrator responsibility. Add 2 subfunctions in Menu Desktop Integration Menu 1. HR Integrator Setup 2. HR Maintain Integrator Form Functions (Application Developer Application Menu)

Profile: BNE Allow No Security Rule should be Yes

Page 3 of 10

Low Level Security in MS Excel

MS Excel Tools Macros Security

References 1. Oracle WF User Guide. 2. Oracle Metal link For further details contact: Soumya Darshi Bal Email: Soumya_bal@infosys.com

Page 4 of 10

SQL/PLSQL
Table Creation CREATE TABLE xxtest_tbl (empno NUMBER ,ename VARCHAR2(100) ); Custom Package Specification CREATE OR REPLACE PACKAGE xxtest_pkg IS PROCEDURE xxtest_proc ( p_employee_number NUMBER ,p_employee_name VARCHAR2); END xxtest_pkg; Custom Package Body CREATE OR REPLACE PACKAGE BODY xxtest_pkg IS PROCEDURE xxtest_proc ( p_employee_number NUMBER ,p_employee_name VARCHAR2) IS BEGIN INSERT INTO xxtest_tbl (empno ,ename) VALUES (p_employee_number ,p_employee_name); END xxtest_proc; END xxtest_pkg;

Page 5 of 10

Create Custom Integrator

Desktop Integrator Create Document

After selecting HR Integrator Setup, Save document with help of wizard by clicking Next-Next

Page 6 of 10

Open Document and make entry as follows: Metadata CREATE Application Short Name XX_TOP Integrator User XXTEST View Name Null Form Name Null API Package Name XXTEST_PKG API Procedure Name XXTEST_PROC Interface User Name XXTEST_USER Interface Parameter List Name XXTEST_PM API Type PROCEDURE API Return Type Number

Page 7 of 10

Define Layout
Desktop Integrator Define Layout

Page 8 of 10

Data Upload
Desktop Integrator Create Document Select your custom Integrator which we created Now download excel sheet as we did earlier. It is ready for data upload now.

Page 9 of 10

References: Training conducted by one of my erstwhile colleague@ Fujitsu Consulting

Page 10 of 10