Customized Web ADI

CUSTOMIZED WEB ADI
SUPPLIER UPLOADING
BY
AHSAN HASEEB
TABLE OF CONTENTS
1. OVERVIEW ....................................................................................................................... 1
2. CREATE CUSTOM TABLE, PACKAGE AND INTEGRATOR .................................................................. 6
2.1 SUPPLIER HEADER ....................................................................................................................... 6
2.1.1 CUSTOM TABLE ....................................................................................................................................... 6
2.1.2 CUSTOM PACKAGE ................................................................................................................................... 6
2.1.3 WEB ADI INTEGRATOR ............................................................................................................................. 7
2.2 SUPPLIER SITES ......................................................................................................................... 22
2.2.1 CUSTOM TABLE ..................................................................................................................................... 22
2.2.2 CUSTOM PACKAGE ................................................................................................................................. 22
2.2.3 WEB ADI INTEGRATOR ........................................................................................................................... 23
2.3 SUPPLIER CONTACTS .................................................................................................................. 26
2.3.1 CUSTOM TABLE ..................................................................................................................................... 26
2.3.2 CUSTOM PACKAGE ................................................................................................................................. 26
2.3.3 WEB ADI INTEGRATOR ........................................................................................................................... 27
3. UPLOADING PROCESS ........................................................................................................ 29
3.1 SUPPLIER HEADER ..................................................................................................................... 29
3.2 SUPPLIER SITES ......................................................................................................................... 40
3.3 SUPPLIER CONTACTS .................................................................................................................. 40
AHSAN HASEEB SUPPLIER UPLOADING WEB ADI
1. OVERVIEW
The purpose of this document is to upload SupplierMaster Data (Header, Sites, and Contacts) right into
the Supplier Interface tables (Header, Sites, and Contacts) through Web ADI.
The process of setting up the customized Web ADI consists of the following steps:
After completing the aforementioned steps, the process of uploading Supplier Master Data to system
can be started. This document provides the detailed steps to follow to achieve the steps mentioned
above which are in a plug and play format.
The following fields have been added to the WEB ADIs setup for uploading purposes:
SUPPLIER HEADER FIELD NAMES

FIELD NAMES MANDATORY COMMENTS
This is the most important field in the Web
ADI. It will have to be marked as either
VALIDATE or PROCESS.
VALIDATE Marking a record as
VALIDATE will only evaluate the data
entered in the row through all the
VALIDATE_OR_PROCESS_DATA YES
validations incorporated into the Web ADI
and notify of any errors. Supplier data will
not be imported to interface table
(AP_SUPPLIERS_INT) even if there are no
errors.
PROCESS Data entered in the row will be
imported to the interface tables.

A unique ID given to every supplier header
VENDOR_INTERFACE_ID YES
record in AP_SUPPLIERS_INT table.
VENDOR_NAME YES Vendor Name will be entered in this field.
VENDOR_NAME_ALT
VENDOR_TYPE_LOOKUP_CODE YES Vendor Type will be entered in this field.
PAYMENT_METHOD_LOOKUP_CODE
NUM_1099
VAT_REGISTRATION_NUM
TERM_NAME
ALLOW_AWT_FLAG
ATTRIBUTE_CATEGORY
ATTRIBUTE1
ATTRIBUTE2
ATTRIBUTE3
ATTRIBUTE4
ATTRIBUTE5
ATTRIBUTE6
ATTRIBUTE7
ATTRIBUTE8
ATTRIBUTE9
ATTRIBUTE10
ATTRIBUTE11
ATTRIBUTE12
ATTRIBUTE13
ATTRIBUTE14
ATTRIBUTE15
INVOICE_CURRENCY_CODE
PAYMENT_CURRENCY_CODE
SUPPLIER SITES FIELD NAMES

VALIDATE_OR_PROCESS_DATA YES
validations incorporated into the Web ADI
(AP_SUPPLIER_SITES_INT) even if there are
no errors.

A unique ID given to every supplier site
VENDOR_SITE_INTERFACE_ID YES
record in AP_SUPPLIER_SITES_INT table.
Vendor Site Name will be entered in this
VENDOR_SITE_CODE YES
field.
Operating Unit to which the Vendor is to
ORG_NAME YES
be assigned will be entered in this field.
ADDRESS_LINE1 YES Address Line 1 will be entered in this field.
ADDRESS_LINE2
ADDRESS_LINE3
ADDRESS_LINE4
CITY
PROVINCE
STATE
ZIP
COUNTRY
EMAIL_ADDRESS
FAX
PHONE
ALLOW_AWT_FLAG
PAY_AWT_GROUP_NAME
AWT_GROUP_NAME
PURCHASING_SITE_FLAG
PRIMARY_PAY_SITE_FLAG
RFQ_ONLY_SITE_FLAG
PAY_SITE_FLAG
CREATE_DEBIT_MEMO_FLAG
MATCH_OPTION
SHIP_TO_LOCATION_NAME
BILL_TO_LOCATION_NAME
ACCTS_PAY_CODE_COMBINATION
PREPAY_CODE_COMBINATION
PAYMENT_METHOD_LOOKUP_CODE
INVOICE_CURRENCY_CODE
PAYMENT_CURRENCY_CODE
FOB_LOOKUP_CODE
ALWAYS_TAKE_DISC_FLAG
HOLD_UNMATCHED_INVOICES_FLAG
HOLD_FUTURE_PAYMENTS_FLAG
HOLD_ALL_PAYMENTS_FLAG
TERMS_NAME
TERMS_DATE_BASIS
FREIGHT_TERMS_LOOKUP_CODE
PAY_GROUP_LOOKUP_CODE
DISTRIBUTION_SET_NAME
ATTRIBUTE_CATEGORY
ATTRIBUTE1
ATTRIBUTE2
ATTRIBUTE3
ATTRIBUTE4
ATTRIBUTE5
ATTRIBUTE6
ATTRIBUTE7
ATTRIBUTE8
ATTRIBUTE9
ATTRIBUTE10
ATTRIBUTE11
ATTRIBUTE12
ATTRIBUTE13
ATTRIBUTE14
ATTRIBUTE15
PAY_DATE_BASIS
REGIME_NAME
TAX_NAME
VAT_CODE
SUPPLIER CONTACTS FIELD NAMES

VALIDATE_OR_PROCESS_DATA YES validations incorporated into the Web ADI
(AP_SUP_SITE_CONTACT_INT) even if there
are no errors.
A unique ID given to every supplier contact
VENDOR_CONTACT_INTERFACE_ID YES record in AP_SUP_SITE_CONTACT_INT
table.
Vendor Site Name will be entered in this
VENDOR_SITE_CODE YES
field.
ORG_NAME YES Vendor Type will be entered in this field.
TITLE
FIRST_NAME
MIDDLE_NAME
LAST_NAME YES Last Name will be entered in this field.
JOB_TITLE
DEPARTMENT
URL
PHONE
ALT_PHONE
FAX
EMAIL_ADDRESS
2. CREATE CUSTOM TABLE, PACKAGE AND INTEGRATOR
2.1 Supplier Header

2.1.1 Custom Table
The first step is to create a custom table for Supplier Header to host the data temporarily in order to
validate it and forward it to the AP_SUPPLIERS_INT if it passes all the validations incorporated into the
setup.
The following code will be used to create the table:
Please refer to Annexure 1 - Create Table - Header for the code.
2.1.2 Custom Package

After the table is successfully created, the next step is to define the following package in the system.
This package will be used in the Web ADI setup to:
1. Validate the data entered in the Web ADI sheet

2. Upload the validated data into the staging table
3. Transfer the data to AP_SUPPLIERS_INT table
The following code will be used to define the Package and its body:
1. Please refer to Annexure 2 - Create Package - Header for the code to define the package.
2. Please refer to Annexure 3 -Create Package Body - Header for the code to define the package.
2.1.3 Web ADI Integrator

After the package and package body have been defined, the final step is to create the following:
1. Customized Web ADI Integrator

2. Web ADI Layout
3. Web ADI Mapping
2.1.3.1 Create Integrator
An integrator defines all the information that you need to download or upload from a particular
window or database view or for a particular purpose (the type of integrator determines the purpose for
which you can use it). You can set up the appropriate integrators depending on whether you want to
download for reporting or mail merge purposes, or in order to manipulate the data and upload it
again.
In our case, we will configure the Web ADI to upload data.
Navigation:
Desktop Integration Manager Create Integrator
The setup will be as follows:
Integrator Name: Customized - Supplier Header Upload Web ADI

Internal Name: CUST_SUPP_HDR_UPLOAD_ADI
Application Payables
The Display in Create Document Page checkbox will be checked and the following functions will be
added by pressing the highlighted buttons above:
1. Desktop Integration - Create Document

2. Create Document
After completing the steps above, press the Next button. An interface will now be created as follows:
Interface Name: Customized - Supplier Header Interface

Interface Type: API Procedure
Package Name: cust_webadi_supp_header_PKG
Procedure/Function cust_up_supp_hdr_to_stg
Name:
API Returns: FND Message Code
After the entry above, press the Apply button. The following screen will appear:
Click on the highlighted Interface select box to view the parameters of the API as follows:
Click on the Next button. The following screen will appear:

Click on the highlighted Create Content button to create the WebADI sheet template that will be used
for data entry:
Content Name: Customized - Supplier Header Upload ADI

Content Type: Text File
Number of Columns 28
Click on the Apply button.
The content will be created as follows:
The column display names will be manually filled and they will be exactly the same that are included in
the Supplier Header Field Name table in Section 1. The display names are as follows:
1. VALIDATE_OR_PROCESS_DATA
2. VENDOR_INTERFACE_ID
3. VENDOR_NAME
4. VENDOR_NAME_ALT
5. VENDOR_TYPE_LOOKUP_CODE
6. PAYMENT_METHOD_LOOKUP_CODE
7. NUM_1099
8. VAT_REGISTRATION_NUM
9. TERM_NAME
10. ALLOW_AWT_FLAG
11. ATTRIBUTE_CATEGORY
12. ATTRIBUTE1
13. ATTRIBUTE2
14. ATTRIBUTE3
15. ATTRIBUTE4
16. ATTRIBUTE5
17. ATTRIBUTE6
18. ATTRIBUTE7
19. ATTRIBUTE8
20. ATTRIBUTE9
21. ATTRIBUTE10
22. ATTRIBUTE11
23. ATTRIBUTE12
24. ATTRIBUTE13
25. ATTRIBUTE14
26. ATTRIBUTE15
27. INVOICE_CURRENCY_CODE
28. PAYMENT_CURRENCY_CODE
Once all the columns are renamed, Content parameters will be set as follows:
Parameter Name of Web ADI: Download "Text File" Parameters will be selected that has the
application name Web Applications Desktop Integrator.
Click Next. The following screen will appear. Uploader will be defined at this stage:
From Template will be chosen from Uploader drop-down menu.
Press Create which will populate after From Template has been selected in Uploader drop-down
menu.
The following will appear. Ensure your Uploader setup is as follows:
Press Submit. Integrator setup is now complete.

2.1.3.2 Define Layout
A layout identifies the columns to appear in a spreadsheet or Word document. A single integrator can
have multiple layouts for different purposes. If more than one layout is available for an integrator, you
select a layout when you create a document. If only one layout is available, the application selects it for
you automatically.
Navigation:
Desktop Integration Define Layout
After this function is opened, the following will appear:
Select the relevant integrator, i.e. Customized Supplier Header Upload Web ADI in our case and click
on Go.
Provide the Layout name as follows:
Layout Name: Customized Supplier Header Upload ADI Layout

Number of Headers 1
Click Next. The following will appear.

Placement of all the fields will be set as Line. Click Next and the following will appear.
Entry the data entry rows as per your requirement. Click Apply. The Layout will be successfully
created.
2.1.3.3 Define Mapping
Navigation:
Desktop Integration Define Mapping
After this function is selected, the following will appear:
Select the relevant integrator, i.e. Customized Supplier Header Upload Web ADI in our case and click
on Go.
Click on Define Mapping to define a new mapping against the previously selected Integrator.
After clicking on Define Mapping, the following will appear. Enter the required information as follows:
Mapping Name: Customized - Supplier Header Upload - Mapping

Mapping Key: CUST_SUPP_HDR_UPLOAD_MAP
Click Next. The following will appear.

Source and Target columns on this page will be entered. All 28 (number of columns) parameters of the
Package Procedure(used in the interface setup)in the Web ADI will be associated with the content
columns of the Web ADI sheet on this page.
After mapping is defined for all the columns, click on Apply. Mapping will be saved.
After the completion of this step, data can be uploaded to the interface table through Web ADI.
2.2 Supplier Sites

2.2.1 Custom Table
The first step is to create a custom table for Supplier Sites in order to host the data temporarily in order
to validate it and forward it to the AP_SUPPLIER_SITES_INT if it passes all the validations incorporated
into the setup.
Please refer to Annexure 1 - Create Table Sites for the code.


3. Transfer the data to AP_SUPPLIER_SITES_INT table
1. Please refer to Annexure 2 - Create Package - Sites for the code to define the package.
2. Please refer to Annexure 3 - Create Package Body - Sites for the code to define the package.

The integrator for Supplier Sites will be created just like created in Section 2.1.3.1.
The setup for Integrator will be as follows:
Integrator Name: Customized - Supplier Sites Upload Web ADI

Internal Name: CUST_SUPP_SIT_UPLOAD_ADI
The setup for Interface will be as follows:

Interface Name: Customized - Supplier Sites Interface
Package Name: cust_webadi_supp_sites_pkg
Procedure/Function cust_up_supp_sites_to_stg
Name:
The setup will for Content will be as follows:
Content Name: Customized - Supplier Sites Upload ADI

the Supplier Sites Field Name table in Section 1. The display names are as follows:
2. VENDOR_SITE_INTERFACE_ID
3. VENDOR_NAME
4. VENDOR_SITE_CODE
5. ORG_NAME
6. ADDRESS_LINE1
7. ADDRESS_LINE2
8. ADDRESS_LINE3
9. ADDRESS_LINE4
10. CITY
11. PROVINCE
12. STATE
13. ZIP
14. COUNTRY
15. EMAIL_ADDRESS
16. FAX
17. PHONE
18. ALLOW_AWT_FLAG
19. PAY_AWT_GROUP_NAME
20. AWT_GROUP_NAME
21. PURCHASING_SITE_FLAG
22. PRIMARY_PAY_SITE_FLAG
23. RFQ_ONLY_SITE_FLAG
24. PAY_SITE_FLAG
25. CREATE_DEBIT_MEMO_FLAG
26. MATCH_OPTION
27. SHIP_TO_LOCATION_NAME
28. BILL_TO_LOCATION_NAME
29. ACCTS_PAY_CODE_COMBINATION
30. PREPAY_CODE_COMBINATION
31. PAYMENT_METHOD_LOOKUP_CODE
32. INVOICE_CURRENCY_CODE
33. PAYMENT_CURRENCY_CODE
34. FOB_LOOKUP_CODE
35. ALWAYS_TAKE_DISC_FLAG
36. HOLD_UNMATCHED_INVOICES_FLAG
37. HOLD_FUTURE_PAYMENTS_FLAG
38. HOLD_ALL_PAYMENTS_FLAG
39. TERMS_NAME
40. TERMS_DATE_BASIS
41. FREIGHT_TERMS_LOOKUP_CODE
42. PAY_GROUP_LOOKUP_CODE
43. DISTRIBUTION_SET_NAME
44. ATTRIBUTE_CATEGORY
45. ATTRIBUTE1
46. ATTRIBUTE2
47. ATTRIBUTE3
48. ATTRIBUTE4
49. ATTRIBUTE5
50. ATTRIBUTE6
51. ATTRIBUTE7
52. ATTRIBUTE8
53. ATTRIBUTE9
54. ATTRIBUTE10
55. ATTRIBUTE11
56. ATTRIBUTE12
57. ATTRIBUTE13
58. ATTRIBUTE14
59. ATTRIBUTE15
60. PAY_DATE_BASIS
61. REGIME_NAME
62. TAX_NAME
63. VAT_CODE
The layout for Supplier Sites will be created just like in Section 2.1.3.2.
The setup for Layout will be as follows:
Layout Name: Customized Supplier Sites Upload ADI Layout

Number of Headers 1
The mapping for Supplier Sites will be created just like in Section 2.1.3.3.
The setup for Mapping will be as follows:
Mapping Name: Customized - Supplier Sites Upload - Mapping

Mapping Key: CUST_SUPP_SITES_UPLOAD_MAP
2.3 Supplier Contacts

2.3.1 Custom Table
The first step is to create a custom table for Supplier Contacts in order to host the data temporarily in
order to validate it and forward it to the AP_SUP_SITE_CONTACT_INT if it passes all the validations
incorporated into the setup.
Please refer to Annexure 1 - Create Table Contacts for the code.


6. Transfer the data to AP_SUP_SITE_CONTACT_INT table
3. Please refer to Annexure 2 - Create Package - Contacts for the code to define the package.
4. Please refer to Annexure 3 - Create Package Body - Contacts for the code to define the package.

The integrator for Supplier Contacts will be created just like created in Section 2.1.3.1.
The setup for Integrator will be as follows:
Integrator Name: Customized - Supplier Contacts Upload Web ADI

Internal Name: CUST_SUPP_CON_UPLOAD_ADI
The setup for Interface will be as follows:

Interface Name: Customized - Supplier Contacts Interface
Package Name: cust_webadi_supp_contacts_pkg
Procedure/Function cust_up_supp_cont_to_stg
Name:
The setup will for Content will be as follows:
Content Name: Customized - Supplier Contacts Upload ADI

the Supplier Contacts Field Name table in Section 1. The display names are as follows:
2. VENDOR_CONTACT_INTERFACE_ID
3. VENDOR_NAME
4. VENDOR_SITE_CODE
5. ORG_NAME
6. TITLE
7. FIRST_NAME
8. MIDDLE_NAME
9. LAST_NAME
10. JOB_TITLE
11. DEPARTMENT
12. URL
13. PHONE
14. ALT_PHONE
15. FAX
16. EMAIL_ADDRESS
The layout for Supplier Contacts will be created just like in Section 2.1.3.2.
The setup for Layout will be as follows:
Layout Name: Customized Supplier Contacts Upload ADI Layout

Number of Headers 1
The mapping for Supplier Contacts will be created just like in Section 2.1.3.3.
The setup for Mapping will be as follows:
Mapping Name: Customized - Supplier Contacts Upload - Mapping

Mapping Key: CUST_SUPP_CONT_UPLOAD_MAP
3. UPLOADING PROCESS
3.1 Supplier Header

Once the integrator, layout and mapping have been created, the uploading process can be initiated.
Just like conventional method of supplier uploading process, Supplier Header is uploaded first which is
followed by Supplier Sites and Supplier Contacts respectively. The uploading process is as follows:
Navigation:
Desktop Integration Create Document
The following window will open:

Select the relevant Integrator for which the data is to be uploaded and click Next.
Select the Viewer and click Next.
Select the Content and click Next. The following will appear:
You will have to attach a .CSV file to import into the WebADI sheet that will be generated. If you would
like to carry out your data entry on the WebADI sheet, you can simply attach a BLANK .csv file. After
attaching the file, click Continue.
After verifying all the information, click on Create. The following screen will appear:
Click on Open and an Excel file will open.

After the file has loaded and opened, a message will show on screen as shown in screenshot above.
Click on Close and the Web ADI will show on screen as follows:
Enter the required and relevant data on the Web ADI sheet.
Note: The required fields have been highlighted in section 1. If you get any error, make sure you have
filled the required fields and have entered the correct data in the relevant fields.
After entering the data in the Web ADI sheet, click on Oracle tab and click on Upload.
Choose Flagged Rows and Validate before Upload and click on Upload.
The WebADI will notify you of successfully completion or failure after processing all the entered rows
but the data has not been inserted in the interface tables as there was VALIDATE in
VALIDATE_OR_PROCESS DATA field. The message only means that the validation was successful.
This step is to make sure that all the information entered in the relevant fields is correct and the
required fields have also been filled.
Once the data has been validated, it can be uploaded to the interface tables. All that has to be done is
replace the VALIDATE with PROCESS in VALIDATE_OR_PROCESS_DATA field.
Choose Flagged Rows and Validate before Upload and click on Upload.
This message now means that the data has been inserted into interface tables.
User will have to move on to Payables responsibility and run the Supplier Open Interface
Importrequest as shown below.
Once the request is completed, its output can be viewed by clicking on View Output as shown below.
This output shows that the supplier have been imported in the system. User will also be able to view
the newly created Supplier Header in the system by navigating to Suppliers function in Payables
responsibility. The supplier SHAMROCK INC. imported is shown on Suppliers screen below:
The supplier header is created and is now available so that its sites and contact information can also be
created.
3.2 Supplier Sites

The uploading process of Supplier Sites is the same as described in the section 3.1. The only thing
different is that the request to run after the data has been inserted into interface table is Supplier
Sites Open Interface Import.
3.3 Supplier Contacts

The uploading process of Supplier Contacts is the same as described in the section 3.1. The only thing
different is that the request to run after the data has been inserted into interface table is Supplier
Contacts Open Interface Import.

Customized Web ADI - Supplier Uploading

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Customized Web ADI - Supplier Uploading

Hochgeladen von

Copyright:

Verfügbare Formate

SUPPLIER HEADER FIELD NAMES

imported to the interface tables.

SUPPLIER SITES FIELD NAMES

imported to the interface tables.

SUPPLIER CONTACTS FIELD NAMES

2. CREATE CUSTOM TABLE, PACKAGE AND INTEGRATOR

2.1 Supplier Header

The following code will be used to create the table:

Please refer to Annexure 1 - Create Table - Header for the code.

2.1.2 Custom Package

1. Validate the data entered in the Web ADI sheet

2.1.3 Web ADI Integrator

1. Customized Web ADI Integrator

2.1.3.1 Create Integrator

In our case, we will configure the Web ADI to upload data.

The setup will be as follows:

Integrator Name: Customized - Supplier Header Upload Web ADI

1. Desktop Integration - Create Document

The setup will be as follows:

Interface Name: Customized - Supplier Header Interface

Click on the Next button. The following screen will appear:

The setup will be as follows:

Content Name: Customized - Supplier Header Upload ADI

Click on the Apply button.

The content will be created as follows:

From Template will be chosen from Uploader drop-down menu.

The following will appear. Ensure your Uploader setup is as follows:

Press Submit. Integrator setup is now complete.

2.1.3.2 Define Layout

Desktop Integration Define Layout

After this function is opened, the following will appear:

Provide the Layout name as follows:

Layout Name: Customized Supplier Header Upload ADI Layout

Click Next. The following will appear.

2.1.3.3 Define Mapping

Desktop Integration Define Mapping

After this function is selected, the following will appear:

The setup will be as follows:

Mapping Name: Customized - Supplier Header Upload - Mapping

Click Next. The following will appear.

2.2 Supplier Sites

The following code will be used to create the table:

Please refer to Annexure 1 - Create Table Sites for the code.

2.2.2 Custom Package

1. Validate the data entered in the Web ADI sheet

2.2.3 Web ADI Integrator

The setup for Integrator will be as follows:

Integrator Name: Customized - Supplier Sites Upload Web ADI

The setup for Interface will be as follows:

The setup will for Content will be as follows:

Content Name: Customized - Supplier Sites Upload ADI

The setup for Layout will be as follows:

Layout Name: Customized Supplier Sites Upload ADI Layout

2.2.3.3 Define Mapping

The setup for Mapping will be as follows:

Mapping Name: Customized - Supplier Sites Upload - Mapping

2.3 Supplier Contacts

The following code will be used to create the table:

Please refer to Annexure 1 - Create Table Contacts for the code.

2.3.2 Custom Package

4. Validate the data entered in the Web ADI sheet

2.3.3 Web ADI Integrator

The setup for Integrator will be as follows: