WEB-ADI Suryakanth Gunti 1 | P a g e

Beginning to Work with Oracle WEB-ADI

With this article wanted to make you familiar with a built in tool provided by Oracle to load the data into

the application using a simple Excel Upload, this is Oracle WEB-ADI (WEB Application Desktop

Integrator). I know many would already be aware of this technology, but still wanted to make it handy

for folks who are new to this.

To begin with the design we would need two Responsibilities

Desktop Integration Manager

Desktop Integrator

We start with designing the Web Integrator then design the Web Layout and then map them together.

Now to start with navigate to Desktop Integration Manager Responsibility Create Integrator

Ensure that you check the text box “Display in Create Document Page” then click on NEXT

Here you would need to mention type of Interface either Table or API Procedure or API Function

WEB-ADI Suryakanth Gunti 2 | P a g e

I have used a Package Procedure as below:

Note: Ensure that the Procedure is available in the Database.

Below is the code that I have used:

WEB-ADI Suryakanth Gunti 3 | P a g e

Then Click on APPLY

Note: If you want a custom message to be passed to the Excel from the Procedure select FND Message

Code as API Returns and in the Package code use

FND_MESSAGE.CLEAR;

FND_MESSAGE.SET_NAME ('BNE', ‘<Message to Display>’);

This is how it is mapped

Keep clicking on NEXT finally SUBMIT.

Now navigate to Desktop Integrator Responsibility to the link Define Layout

WEB-ADI Suryakanth Gunti 4 | P a g e

Select the Integrator that was created in earlier steps then click on create Button.

Feed in the Layout Name and the Number of Headers required.

Select how and where you want the records to be displayed in the Excel either Line, Header or Context

under placement

Click on NEXT

Finally Click on APPLY

Now navigate to Desktop Integration Manager Responsibility then Manage Integrators

Feed in the Integrated that was created and click on GO

WEB-ADI Suryakanth Gunti 5 | P a g e

Select the Integrator and click on PREVIEW then choose EXCEL 2010, click on NEXT

Click on SAVE

WEB-ADI Suryakanth Gunti 6 | P a g e

Feed in the Shortcut name say XX TST WEBADI and choose the above two check boxes “Save to Shortcut

List” and “Save to Form Function”

To check if the Layout is created in the proper manner and the data is been loaded in the DB in the said

format

Click Create Document

Once done this is how the Excel would look like

WEB-ADI Suryakanth Gunti 7 | P a g e

Now to have a link to a said Responsibility add the Shortcut Name (“XX TST WEBADI”) to the Menu of

the responsibility

Query for the MENU and add the Shortcut Name

Once added navigate to the said Responsibility this is how it looks:

Click on the link to open the Excel to upload the Data

Here is how after loading data

WEB-ADI Suryakanth Gunti 8 | P a g e

If we try to load a Duplicate EMO_NO, it displays a custom error message

Now going further here is how you add a LOV values to the Excel.

First create a Lookup in the application say “XX_WEBADI_LOV”

WEB-ADI Suryakanth Gunti 9 | P a g e

Now navigate the Desktop Integration Manager Responsibility Manage Integrators

Select the Integrator click on UPDATE, navigate to the 2nd Step as below:

Click on UPDATE as highlighted

WEB-ADI Suryakanth Gunti 10 | P a g e

Feed in the details as displayed.

Validation Type : Table Id Column : LOOKUP_CODE – (This will be passed to the program)

Meaning Column : MEANING

Desc Column: DESCRIPTION

Validation Entity : FND_LOOKUP_VALUES

Where clause: lookup_type = 'XX_WEBADI_LOV'

Lov Type : Pop List

Then SAVE and SUBMIT

Now open the Excel this is how it is displayed

After UPLOAD

WEB-ADI Suryakanth Gunti 11 | P a g e

Header Text

If we wish to display the text say User Name at the Header

Click on ADD ATTRIBUTE

WEB-ADI Suryakanth Gunti 12 | P a g e

Click on APPLY

Enable DISPLAYED check box

WEB-ADI Suryakanth Gunti 13 | P a g e

Click on SUBMIT

Navigate to Desktop Integrator Responsibility to the link Define Layout

Select the Integrator and click on GO

Then select the layout created earlier and click on UPDATE

The output would appeal as below

WEB-ADI Suryakanth Gunti 14 | P a g e

Enabling and Disabling a WEB ADI Integrator

To disable a WEB ADI from editing we need to update the SOURCE Column of the Table

“BNE_INTEGRATORS_B” to NULL

SELECT INTEGRATOR_CODE, USER_NAME,

ENABLED_FLAG, DISPLAY_FLAG,

SOURCE

FROM bne_integrators_vl

WHERE USER_NAME = <INTEGRATOR_NAME> -- Say 'XX_TEST_WEBADI'

-- Disabling the Integrator UPDATE bne_integrators_b

SET source = NULL

WHERE integrator_code = <Integrator_Code>; --Say 'XX_TEST_WEBADI_XINTG'

-- ENABLING the Integrator UPDATE bne_integrators_b

SET source = 'C'

WHERE integrator_code = <Integrator_Code>; --Say 'XX_TEST_WEBADI_XINTG'