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'