14/09/2016

OracleWebAdi:Explainedstepbystepwithdiagramsandcasestudy|iavinash

Oracle Web Adi : Explained step by step with diagrams and case
study

Avinash

Oracle, Technical

13,107 Views

WhatisWebAdi
Web Applications Desktop Integrator (WebADI) is a self-service Oracle application
accessed using a browser. The WebADI software does not need to be installed on
individual client machines. Processing takes place on the server rather than on
individual client PCs. Web ADI generates Microsoft Excel or Word documents on your
desktop, and uploads the data you have selected to upload. The appearance of the
spreadsheet or word processing document is determined by configurable layouts.
System administrators can restrict the fields that end users work within the
spreadsheet, and can create different layouts for different users. Experienced users can also create their
own layouts to include just the fields they need to work with.

BusinessRequirement(tounderstandwebadi)
To create a sample Wed ADI lets assume that we have a business requirement to enter the out of office
(ooo) contact details for employee. This ooo contact detail is stored in Extra person information window.
Following are the three mandatory fields that need to be stored for an employee before going on leave.
http://iavinash.com/oraclewebadiexplainedstepbystepwithdiagramsandcasestudy/

1/8

14/09/2016

OracleWebAdi:Explainedstepbystepwithdiagramsandcasestudy|iavinash

1. Personal Email address

2. Personal Contact Number
3. Return Date

BusinessSolution(webadisetup)
Now we have a requirement in place the next steps would be to design a
soloution for this using Wed ADI. Though there are different ways to achieve this
(for example link the EIT to Self-Service) we are going to meet the requirement by
Wed ADI. Following are the basic steps to create a WED ADI to upload OOO
contact details for employee.
Adsby Google

PhotoUpload
WebAPI

Code in the package is very simple and easy to understand. Using an api
hr_person_extra_info_api.create_person_extra_info this makes entry into the EIT. Just make sure you
have already create EIT to store OOO information for employee.
l_person_extra_info_idNUMBER
l_object_version_numberNUMBER
l_information_typeVARCHAR2(100):='XX_AVI_OOO_CD'/*
ThisistheEITCode*/
l_person_idNUMBER
l_error_flagboolean:=false
e_no_emp_noEXCEPTION
e_no_detailsEXCEPTION
e_invalid_empexception
BEGIN
IFp_employee_numberISNULL
THEN
l_error_flag:=true
RAISEe_no_emp_no
ELSE
BEGIN
SELECTperson_id
INTOl_person_id
FROMper_all_people_f
WHEREemployee_number=p_employee_number
ANDbusiness_group_id=
fnd_global.per_business_group_id
ANDTRUNC(SYSDATE)BETWEENeffective_start_date
ANDeffective_end_date
EXCEPTION
WHENNO_DATA_FOUND
THEN
l_error_flag:=true
RAISEe_invalid_emp
END
ENDIF

IFp_email_addressISNULLORp_contact_numberISNULLOR

http://iavinash.com/oraclewebadiexplainedstepbystepwithdiagramsandcasestudy/

2/8

14/09/2016

OracleWebAdi:Explainedstepbystepwithdiagramsandcasestudy|iavinash

Following window will

appear. Select
as an integrator. This
is the integrator given by
oracle to create any new integrator. As shown in the Fig.3.

Following screen will

appear. Select
as a layout as shown
in the fig.4.

http://iavinash.com/oraclewebadiexplainedstepbystepwithdiagramsandcasestudy/

3/8

14/09/2016

OracleWebAdi:Explainedstepbystepwithdiagramsandcasestudy|iavinash

Select
None as content as shown
in the Fig.5.

A
review page will appear as
shown in the Fig.6. Click on

.
And then click on upload, as
given in the fig.7 below

Metadata Type

CREATE

Application Short Name

PER

Integrator User Name

XX Out Of Office Contact Details

Form Name

GENERAL

API Package Name

XX_AVI_OOO_CD

API Procedure Name

Enter_OOO_CD

Interface User Name

XX Out Of Office Contact Details

Interface Parameter List Name

XX OOO Details

http://iavinash.com/oraclewebadiexplainedstepbystepwithdiagramsandcasestudy/

4/8

14/09/2016

API Type

OracleWebAdi:Explainedstepbystepwithdiagramsandcasestudy|iavinash

PROCEDURE

Adsby Google

ExcelWeb
WebDesignforBusiness

Navigate to Desktop
Integration Define
Layout. A screen will appear. Select the integrator XX Out Of Office Contact Details we have just
created as shown in the fig.9

http://iavinash.com/oraclewebadiexplainedstepbystepwithdiagramsandcasestudy/

5/8

14/09/2016

OracleWebAdi:Explainedstepbystepwithdiagramsandcasestudy|iavinash

Navigate to Application
Developer Application
Function and create a
function with following
details.
Description

: XX_AVI_OOO_CD

: Enter OOO Contact Details

Following screen will appear (Fig.12).

http://iavinash.com/oraclewebadiexplainedstepbystepwithdiagramsandcasestudy/

6/8

14/09/2016

and click on Add-Ins Oracle

OracleWebAdi:Explainedstepbystepwithdiagramsandcasestudy|iavinash

Upload.

login to oracle

Select the

employee Number 258837

(or the one you have entered)
Others

Extra Information

Select EIT Out Of Office

Contact Details. You will get
the information entered as given in the fig.15

Troubleshooting
forWebADI

If you are getting this errorwhile creating integrator please follow the below steps
1. Goto S

>Application>Menu and query for

2. for this menu add the function

http://iavinash.com/oraclewebadiexplainedstepbystepwithdiagramsandcasestudy/

7/8

14/09/2016

OracleWebAdi:Explainedstepbystepwithdiagramsandcasestudy|iavinash

You might need to enable the Macros before performing the steps. You may perform this as your first
step.
1. Open an empty Excel sheet
2. Click on Excel Option
3. Click on trust center setting
4. Click on macros setting
5. Select the option Enable all macros (not recommended; potentially dangerous code can run) and Trust
access to the VBA project object model
Read Web ADI Troubleshooting : Solve all excel related problems like Run-time error 91 for
comprehensive knowledge on web ADI troubleshooting.
You will also be interested to readsecond part on WEB ADIOracle Web Adi : Explained step by step with

diagrams and case study Part 2

http://iavinash.com/oraclewebadiexplainedstepbystepwithdiagramsandcasestudy/

8/8