Professional Documents
Culture Documents
Web Adi Sample
Web Adi Sample
Web Adi Sample
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.
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.
Select Macro Settings -> Enable all macros and check the option Trust access to the
VBA Project object model
Business requirement :
We need to insert a new supplier details through API in supplier table
Attached sample code for reference
CREATEORREPLACEPACKAGEBODYAPPS.xx_supplier_creation
AS
PROCEDUREsupplier_import_pr(
p_vendor_numberVARCHAR2,
p_vendor_nameVARCHAR2,
p_enabled_flagVARCHAR2,
p_vendor_type_codeVARCHAR2,
p_invoice_currencyVARCHAR2,
p_payment_currencyVARCHAR2,
p_term_idNUMBER,
p_payment_methodVARCHAR2
)
AS
l_vendor_recap_vendor_pub_pkg.r_vendor_rec_type;
l_vendor_recl_vendor;
l_return_statusVARCHAR(10);
l_msg_countNUMBER;
l_msg_dataVARCHAR2(240);
l_vendor_idNUMBER;
l_party_idNUMBER;
error_expEXCEPTION;
err_paymentEXCEPTION;
BEGIN
l_vendor_rec.segment1:=p_vendor_number;
l_vendor_rec.vendor_name:=p_vendor_name;
l_vendor_rec.ext_payee_rec.default_pmt_method:=pi_payment_method;
l_vendor_rec.enabled_flag:=p_enabled_flag;
l_vendor_rec.vendor_type_lookup_code:=p_vendor_type_code;
l_vendor_rec.start_date_active:=SYSDATE;
l_vendor_rec.invoice_currency_code:=p_invoice_currency;
l_vendor_rec.terms_id:=p_term_id;
l_vendor_rec.payment_currency_code:=p_payment_currency;
fnd_msg_pub.initialize;
ap_vendor_pub_pkg.create_vendor(p_api_version=>1.0,
p_init_msg_list=>'F',
p_commit=>'F',
x_return_status=>
l_return_status,
x_msg_count=>l_msg_count,
x_msg_data=>l_msg_data,
p_vendor_rec=>l_vendor_rec,
x_vendor_id=>l_vendor_id,
x_party_id=>l_party_id
);
Ifpi_payment_methodNOTIN
('Check','Clearing','Electronic','Wire','PrePurchaseAggrement')
then
RAISEerr_payment;
ENDIF;
IFl_return_status='E'
THEN
RAISEerror_exp;
ENDIF;
EXCEPTION
WHENerr_payment
THEN
raise_application_error(20000,'PleasecheckthePayment
MethodintheListofvalues');
WHENerror_exp
THEN
raise_application_error(20000,l_msg_data);
WHENOTHERS
THEN
raise_application_error(20000,SQLERRM);
END;
END;
/
1. Creating Integrator:
Choose the Excel Options has 2003, 2007 etc which is relevant to your desktop
Select the Layout has Integrator Setup for creating new Integrator
This is how the excel file looks like for creating integrator in this EXCEL sheet some of
the fields are LOV , to see which of the fields double click on the each column List of
Values will be displayed
By using WEB ADI we can Upload, Download and Update the records into the system.
We should create our custom integrator according to our business requirement. Here we
need to upload data so Choose CREATE has Metadata Type.
4.
Navigation -> Desktop Integrator -> Define Layout -> Select your custom integrator name
Now all the available fields will be displayed which has been used in the Procedure
parameters
The layout is divided into two important sections1. Required fields, where all mandatory parameters need to be aligned as per the requirement.
Instruct parameters can be used to provide some tips to users who are using this WEBADI for
uploading data
2. Optional fields are non mandatory fields, we need to select the ones which needs to be
available in our custom integrator
Click Next To define certain important layout features This functionality is available only to R12
users
Data Entry Rows Using this property we can define the default number of rows which the ADI
will create when initialized, in 11i we user had to insert the new row in case of access data
Read Only Using this feature we can define that which of the columns in our integrator will be
available as read only
Width Using this option we can define the width of each of the columns which will be
available under the custom ADI
Move Up/Down we can re-arrange the order of display of column in our integrator
Now you WEBADI will be available for use using seeded WEB ADI responsibility
Navigation -> Desktop Integrator-> Create Document -> Search for the custom integrator which
you created
Click next and click on create the document which will now download your custom integrator
Click on Create Document and please wait till the document has been created.
Our document has been created with the needed fields
Once the document has been created, please enter the details for creating new vendor.
We can also create exception in the procedure for validating any of the data.
For example
In the above example Payment method should be entered only within the mentioned list ,
which we described in the procedure. If user enters any of the other values it has been
captured and the error message has been notified to user for that particular row
Now the error has been cleared by changing the payment type has Check and
1 Row has been successfully uploaded
Integrator user name can be derived from bne_integrators_vl table with help of following query:
Parameters
bne:page=BneCreateDoc&bne:viewer=BNE:EXCEL2007&bne:reporting=N&bne:integr
ator=USER_NAME:Supplier Details&bne:noreview=Yes
Save it.
6.
Now you can Navigate to your custom responsibility to see the ADI which you have
assigned.
Click next and Create document and your custom integrator is available to user for uploading data
Thank You