NEOAUG

Custom Web ADI Integrators

 Agenda

Agenda

Web ADI Custom Integrators

Creating an Integrator

Creating an API

Defining the Interface

Defining an Importer

Working around the bugs

Adding the Integrator to a Menu

Migrating

Troubleshooting

2
 Web ADI

Lots of helpful error messages

3
 Overview

An Overview of the Process from the End Users Point of

View

Access from a
menu Item

4
 Overview

Enter Invoice Lines with LOVs for Important fields

5
 Overview

Upload data with Validation and AP Interface launch

6
 Overview

All of this from an Excel Spreadsheet.

7
 Integrator Overview

Custom Integrator for AP Invoice creation

Load Invoice Lines from spreadsheet

Validate and load interface table

Call AP Interface Import

8
 PL/SQL API

Create a PL/SQL package to work with the integrator

9
 PL/SQL API

The APInv procedure will validate each line of the

spreadsheet, and load the line into the interface
table.

Errors are communicated to the spreadsheet via

You get 30 chars per line for an error message

You can define your own custom messages

You can also put plain text in place of WEB ADI
ERROR

10
 PL/SQL API

The RunImport procedure will call the AP Invoice

Interface, from the last step of the integrator.

11
 Integrator Step1

12
 Integrator Step2

13
 Integrator Step2

14
 Integrator Step2

Fix the Prompt Names.

Define defaults and validation rules for each column.
Click Submit from here, NOT Next or youll most likely lose everything to a Null
pointer exception.
You can go back and update this later.

15
 Spreadsheet Example

The spreadsheet so far

16
 Integrator Step2

Validating Columns

Lets validate the Vendor Name before it

reaches the PL/SQL API

17
 Integrator Step2

An invalid value will get you the following on the spreadsheet.

Lets also add an LOV

Go to Desktop Integration Manager->Create Component

18
 Integrator Step2

Table-select-column tells excel where to place the value you

select in the spreadsheet.
You reference the name of the column, from the parameter name,
not the name you put in the spreadsheet.

19
 Integrator Step2
Back into the Integrator definition, Step 2, click update on the Vendor Name field

20
 Integrator Step2
Adding a Calendar LOV to the Accounting Date field

Create another component

21
 Integrator Step2
Adding a Calendar LOV to the Accounting Date field

Change the height from 500 to 300, otherwise the dialog will contain
A LOT of whitespace.

Go back to the definition, choose update for Accounting Date

22
 Integrator Step2

For Component name, enter the exact name, this field

doesnt work with wild cards.

23
 Integrator Step2
Back to the spreadsheet

24
 Integrator Step4

Step 4 Create an Uploader. Just take defaults.

25
 Integrator Step4

26
 Integrator Step5

Step 5 define an uploader

Welcome to the Buggiest Screen Ever!

Depending on your level of luck, youll get through this

step.

If you didnt youll need to have the end user schedule

the import process manually.

27
 Integrator Step5

Note: when you make a selection from the importer type

dropdown the importer rules section should show up. If it
doesnt, start patching.

28
 Integrator Step5

29
 Integrator Step5

Try Synchronous or Asynchronous and you'll end up with

this error from excel

30
 Layout
Create a layout for how this looks in Excel

31
 Layout

32
 Adding to a Menu

To Simplify navigation for user, add the new

integrator directly to a menu

Switch to the Desktop Integration
responsibility

Choose Create Document and select the
integrator that you created

33
 Adding to a Menu

Choose Save

34
 Adding to a Menu

35
 Adding to a Menu

Find it in the database with

36
 Adding to a Menu
Lets add it to Payables

Uses Menu AP_NAVIGATE_GUI12

37
 Adding to a Menu

38
 Migrating

Migrating

Download
FNDLOAD apps/apps 0 Y DOWNLOAD
$BNE_TOP/admin/import/bneint.lct xx_ap_inv_ld.ldt
BNE_INTEGRATORS INTEGRATOR_ASN=SQLAP
INTEGRATOR_CODE=XX_WEBADI_PKG_XINTG

Upload
FNDLOAD apps/apps 0 Y UPLOAD $BNE_TOP/admin/import/bneint.lct
xx_ap_inv_ld.ldt

You wont be able to edit the integrator.

39
 Migrating

Migrating

This only gets you some of the integrator. The Uploader step is missing.
You also need to load the Components and the Layout definitions
separately.

Oracle is moving towards using lcts at $BNE_TOP/patch/115/import/*

bneintegrators.lct doesnt function in my instance. See patch:

Patch 10385955: FNDLOAD USING BNEINTEGRATOR.LCT DOES NOT

INCLUDE BNE_INTEGRATORS_B.SOURCE

40
 Troubleshooting

Change Log Level to TRACE, note: no

LOV here.

Restart the Apache Server or youll never
see anything
Thats
$ADMIN_SCRIPTS_HOME/adoacorectl.sh
stop

You can view the log from the front end at:

http://hostname:portnumber/OA_HTML/Bne
AdminServlet

Login as sysadmin first

41
 Troubleshooting

The Servlet may not recognize youre the sysadmin

Seems very sensitive to user switching logins.

Also see: Oracle Web Applications Desktop

Integrator (Web ADI) Tips for Troubleshooting
(Doc ID 390476.1)

42
 Troubleshooting

Dont be afraid to open the Macro itself to see

whats going on

From Excel, choose View->Macros->Edit

43
 Troubleshooting

Although you are allowed to delete columns from

the interface definition, it wont work

There it is.
Into the back end to remove the Columns that I deleted through the GUI.
Find the Records in bne_param_list_items, and remove them

44
 Questions & Answers

Discussion

Don Browne
Don.Browne@monumentdata.com
603.952.4641
www.monumentdata.com

45