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 1 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 2 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 3 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 4 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 5 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 6 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 7 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 8 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 9 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 10 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 11 P a g e
Click on APPLY Enable DISPLAYED check box WEB-ADI Suryakanth Gunti 12 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 13 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' WEB-ADI Suryakanth Gunti 14 P a g e