Custom Web ADI Integrators

8/11/2019 Custom Web ADI Integrators

1/45


2/45

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


3/45

Web ADI

3

Lots of helpful error messages


4/45

Overview

4

An Overview of the Process from the End Users Point ofView

Access from amenu Item


5/45

Overview

5

Enter Invoice Lines with LOVs for Important fields


6/45

Overview

6

Upload data with Validation and AP Interface launch


7/45

Overview

7

All of this from an Excel Spreadsheet.


8/45

Integrator Overview

8

Custom Integrator for AP Invoice creation

Load Invoice Lines from spreadsheet

Validate and load interface table

Call AP Interface Import


9/45

PL/SQL API

9

Create a PL/SQL package to work with the integrator


10/45

PL/SQL API

10

The APInv procedure will validate each line of thespreadsheet, and load the line into the interfacetable.

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


11/45

PL/SQL API

11

The RunImport procedure will call the AP InvoiceInterface, from the last step of the integrator.


12/45

Integrator Step1

12


13/45

Integrator Step2

13


14/45

Integrator Step2

14


15/45

Integrator Step2

15

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 Nullpointer exception.You can go back and update this later.


16/45


17/45

Integrator Step2

17

Validating Columns

Lets validate the Vendor Name before itreaches the PL/SQL API


18/45

Integrator Step2

18

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

Lets also add an LOV

Go to Desktop Integration Manager->Create Component


19/45

Integrator Step2

19

Table-select-column tells excel where to place the value youselect in the spreadsheet.You reference the name of the column, from the parameter name,not the name you put in the spreadsheet.


20/45

Integrator Step2

20

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


21/45

Integrator Step2

21

Adding a Calendar LOV to the Accounting Date field

Create another component


22/45

Integrator Step2

22

Adding a Calendar LOV to the Accounting Date field

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

Go back to the definition, choose update for Accounting Date


23/45

Integrator Step2

23

For Component name, enter the exact name, this fielddoesnt work with wild cards.


24/45

Integrator Step2

24

Back to the spreadsheet


25/45

Integrator Step4

25

Step 4 Create an Uploader. Just take defaults.


26/45

Integrator Step4

26


27/45

Integrator Step5

27

Step 5 define an uploader

Welcome to the Buggiest Screen Ever!

Depending on your level of luck, youll get through thisstep.

If you didnt youll need to have the end user schedulethe import process manually.


28/45

Integrator Step5

28

Note: when you make a selection from the importer type

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


29/45

Integrator Step5

29


30/45

Integrator Step5

30

Try Synchronous or Asynchronous and you'll end up withthis error from excel


31/45

Layout

31

Create a layout for how this looks in Excel


32/45

Layout

32


33/45

Adding to a Menu

33

To Simplify navigation for user, add the newintegrator directly to a menu

Switch to the Desktop Integrationresponsibility

Choose Create Document and select the

integrator that you created


34/45

Adding to a Menu

34

Choose Save


35/45

Adding to a Menu

35


36/45

Adding to a Menu

36

Find it in the database with


37/45

Adding to a Menu

37

Lets add it to Payables

Uses Menu AP_NAVIGATE_GUI12


38/45

Adding to a Menu

38


39/45

Migrating

39

Migrating

DownloadFNDLOAD apps/apps 0 Y DOWNLOAD$BNE_TOP/admin/import/bneint.lct xx_ap_inv_ld.ldtBNE_INTEGRATORS INTEGRATOR_ASN=SQLAP

INTEGRATOR_CODE=XX_WEBADI_PKG_XINTG

UploadFNDLOAD apps/apps 0 Y UPLOAD $BNE_TOP/admin/import/bneint.lctxx_ap_inv_ld.ldt

You wont be able to edit the integrator.


40/45

Migrating

40

Migrating

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

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 NOTINCLUDE BNE_INTEGRATORS_B.SOURCE


41/45

Troubleshooting

41

Change Log Level to TRACE, note: noLOV here.

Restart the Apache Server or youll neversee anything

Thats$ADMIN_SCRIPTS_HOME/adoacorectl.sh

stop

You can view the log from the front end at:

http://hostname:portnumber/OA_HTML/BneAdminServlet

Login as sysadmin first


42/45

Troubleshooting

42

Seems very sensitive to user switching logins.

Also see: Oracle Web Applications DesktopIntegrator (Web ADI) Tips for Troubleshooting(Doc ID 390476.1)

The Servlet may not recognize youre the sysadmin


43/45

Troubleshooting

43

Dont be afraid to open the Macro itself to see

whats going on From Excel, choose View->Macros->Edit

T bl h i


44/45

Troubleshooting

44

Although you are allowed to delete columns fromthe interface definition, it wont work

Find the Records in bne_param_list_items, and remove them

There it is.Into the back end to remove the Columns that I deleted through the GUI.


45/45

Questions & Answers

Discussion

Don Browne

[email protected]

603.952.4641

www.monumentdata.com

45

Documents

Custom Web ADI Integrators