Sunteți pe pagina 1din 47

Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Pre-Requisites
 Enable the Profile Option
 Enable the Macros options for Excel sheet
 Required Database Objects Creation

Custom Web ADI Setups


 Create Integrator
 Create Interface
 Create Content
 Create Uploader
 Create Importer
 Create Layout
 Define Mapping
 Create Document
 Change the Labels of fields
 Assign LOV and hints to the columns
 Add default value Columns
 Defining the Form Function for Integrator
 Assign Function to Custom Menu

Process the AP Invoice Custom Web ADI


 Upload the data with Web ADI
 Modify the Errored records and re upload
 Verify the Created records from application and Backend

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Introduction:
There are basically two ways to enter data into Oracle: by typing it into a user interface (Java Form or Web Page) or by
taking a file and programmatically interfacing the data. Web ADI falls into the second category in that it takes an Excel
file and programmatically loads the data into Oracle. If you find it easier to enter data into Excel than Oracle forms, you
should look into using Web ADI.

Downloading a Web ADI


The first step in downloading a template is to locate the responsibility and menu that is linked to that template. Some
templates can be downloaded from the Desktop Integration menu and others must be downloaded from a specific
responsibility. For security, some templates are linked to specific responsibilities. For example, we can download the GL
Journals template from the Desktop Integration responsibility but we can’t download the Project Transaction Import
template from the same responsibility.
To download a template you will use the following components: integrator, viewer, layout, and content. Based on how
the menu is setup, some of these components may default for you.

Integrator
The integrator defines what data you will be uploading to Oracle. Each integrator serves a specific purpose and cannot
be used to enter other data.

Viewer
The viewer is the Microsoft program you will use to enter data into the template

Layout
The layout is how the data columns are organized on the template. You have two main sections to a template: a header
and lines. The header information applies to all the lines when the data is uploaded to Oracle.

Content
The content is a text file that you can import into your template. You can use this feature if you have an external system
that outputs text file and you want to import that into the template.

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Pre-requisites for working on Development or use of WEBADIs


1.Check the value for profile option named BNE Allow No Security Rule and set the value to Yes

2. Enable the Macros options for your excel sheet

Select Excel option to set the properties

Click on Trust Centre -> Trust center Settings

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Select Macro Settings -> Enable all macros and check the option Trust access to the VBA Project object model

Apply and save your settings


Assign responsibility Oracle WEBADI or Desktop Integrator to do the development of new WEBADIs

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88
Database Objects Creation
Compile the below Custom table and Package in APPS schema
CREATE TABLE XXAA_APINV_IFACE_TBL

PACKAGE XXAA_APINV_IFACE_PKG
PROCEDURE XXAA_APINV_IFACE_LOAD_PRC
PROCEDURE XXAA_APINV_IFACE_IMPORT_PRC;
/

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Integrator
1. Create Integrator
Navigation : Desktop Integration Manager Responsibility-> Create Integrator

Integrator Name : XXAA APINV Interface Integrator


Internal Name : XXAA_APINV_IFACE_INTEGRATOR
Application : Payables
Next

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

2. Create Interface
Interface Name : XXAA APINV Interface
Interface Type : API – Procedure
Package Name : XXAA_APINV_IFACE_PKG
Procedure/Funtion : XXAA_APINV_IFACE_LOAD_PRC
API Returns : FND Message Code
Click on Apply button

Select the Interface and Click on Next button

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

3. Create Content
Content Name : XXAA APINV Interface Content
Content Type : Text File
Number of columns :9
Apply

Rename the display names as per csv header columns for better under standing
And provide the content parameter (download parameter) as Web ADI: Download "Text File" Parameters

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

4. Create Uploader

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

5. Create Importer
Select importer type as PL/SQL API
Importer Name : XXAA_APINV_IFACE

Click on PL/SQL API Call plus button to add our custom procedure

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Enter following information


API Type : PL/SQL Procedure
Package Name : XXAA_APINV_IFACE_PKG
Procedure Name : XXAA_APINV_IFACE_IMPORT_PRC
API Returns : FND Message Code
Click on apply and then submit button

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88
Layout
1. Create Layout
Navigation: Desktop Integration Responsibility Define Layout
Select the integrator Go Create button

2. Enter the name : XXAA APINV Interface Layout

3. Include the fields in layout, Select the line in Placement

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Click on Apply button

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88
2. Define Mapping
1. Define mapping
Navigation: Desktop Integration Responsibility -> Defining mapping-> select integrator-> go

2. Click on define mapping button

3. Enter the mapping details


Mapping Name : XXAA APINV Interface Mapping
Mapping Key : XXAA_APINV_IFACE_MAPPING
Number of column :9

4. Map the source and target columns

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88
3. Create Document
1. Create Document :- Test the document with sample data
Navigation: Desktop Integration Responsibility -> Create Document -> select integrator

2. Select the desktop application like excel or word

3. Select the layout if there are multiple layouts


4. Select the content

5. Select the data file

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

6. Select the NONE to open the Excel file

7. Click on create document button

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

8. Click on create document button to download the sheet

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Enter the data and upload and verify the invoice number from application

Note: we have developed the sheet. Now it needs some cosmetic changes

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Changes
1. Change the Labels of fields
Navigation: Go to integrator-> Interface-> Enter the Integrator name and click on Go

Click on Update button

Click on Next

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Select the Integrator

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Change the Prompt Left Label

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Click on the Update button and change Above Prompt then Save and Submit

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

 Create the document to check new changes

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

2. Assign LOV and hints to the columns


Navigation: Go to integrator-> Interface->click on update button of respective attribute (say P_INVOICE_CURRENCY)
to add LOV
check the not null check box to indicate required columns in spread sheet
Select the validation type as table and enter below information
Validation Type : Table
Id Column : CURRENCY_CODE
Meaning Column : CURRENCY_CODE
Desc Column : CURRENCY_CODE
Validation Entity : FND_CURRENCIES

Provide the information under user hint text item as ‘*List–Text’ to give an idea user about what value should be entered
or select

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

 Do the same for other columns too then save and get the new document to see the changes

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

3. Add default value as ‘USD’ to currency code item


Navigation: Go to integrator-> Interface-> select the default type and default value for currency code attribute

Do the changes for all required fields

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Result

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88
Defining the Form Function for Integrator
Define the form function for integrator to run the custom ADI document from any responsibility

1. Define the custom Form Function


Navigation -> Application Developer -> Application -> Function

Function : XXAA_APINV_IFACE_FF
User Function Name : XXAA APINV Interface Integrator

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Properties Type - SSWA servlet function

Form Parameters
bne:page=BneCreateDoc&bne:viewer=BNE:EXCEL2007&bne:reporting=N&bne:integrator=USER_NAME:
XXAA APINV Interface Integrator&bne:noreview=Yes

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Web HTML HTML Call : BneApplicationService

Save it.

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88
Assign Function to Custom Menu
Go and add the function into the custom responsibility
Navigation-> Application Developer -> Application -> Menu

Search for your menu where you want to add this ADI
Menu : AP_NAVIGATE_GUI12
Prompt : XXAA APINV Interface Integrator
Function : XXAA APINV Interface Integrator

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Now you can navigate to your custom responsibility to see the ADI which you have assigned.

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88
Process the AP Invoice Custom Web ADI
1. Once you create document, it will populate the file data on the sheet

2. Fill the required information

3. Upload the data into oracle


Navigation: Add-Ins Tab-> Oracle-> Upload

4. Once we click on upload button, it will pop up the upload page where we have to select ‘Automatically Submit
Import’ check box as we have added import procedure in importer rule. If it is checked then only it will call that import
program, otherwise it wont

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

5. If there is any error, then program will return error message and will rollback the transaction

6. After correcting the data, run again. And if there is no error, then program will insert all validated data into
oracle tables and call the import journal program

Click on Upload button

Wait until Import program completed

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

7. We can monitor the import program from spread sheet itself by clicking on monitor button
Click on the Monitor to check the request id
Nav : Add-Ins Oracle Monitor

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

Verify the concurrent request id from application

Click on View Output button

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88
Search with Invoice number from payables responsibility

RAJU CHINTHAPATLA
Web ADI - Oracle Custom WEB ADI Setups and Process for AP Invoice Interface OracleApps88
Check the from the backend tables

RAJU CHINTHAPATLA

S-ar putea să vă placă și