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

Overview
An Overview of the Process from the End Users Point of
View

Access from a
menu Item

Overview
Enter Invoice Lines with LOVs for Important fields

Overview
Upload data with Validation and AP Interface launch

Overview
All of this from an Excel Spreadsheet.

Integrator Overview

Custom Integrator for AP Invoice creation

Load Invoice Lines from spreadsheet
Validate and load interface table
Call AP Interface Import

PL/SQL API

Create a PL/SQL package to work with the integrator

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