Custom Web ADI Integrators
-
Upload
vinod-patel -
Category
Documents
-
view
280 -
download
5
Transcript of Custom Web ADI Integrators
-
8/11/2019 Custom Web ADI Integrators
1/45
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
3/45
Web ADI
3
Lots of helpful error messages
-
8/11/2019 Custom Web ADI Integrators
4/45
Overview
4
An Overview of the Process from the End Users Point ofView
Access from amenu Item
-
8/11/2019 Custom Web ADI Integrators
5/45
Overview
5
Enter Invoice Lines with LOVs for Important fields
-
8/11/2019 Custom Web ADI Integrators
6/45
Overview
6
Upload data with Validation and AP Interface launch
-
8/11/2019 Custom Web ADI Integrators
7/45
Overview
7
All of this from an Excel Spreadsheet.
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
9/45
PL/SQL API
9
Create a PL/SQL package to work with the integrator
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
11/45
PL/SQL API
11
The RunImport procedure will call the AP InvoiceInterface, from the last step of the integrator.
-
8/11/2019 Custom Web ADI Integrators
12/45
Integrator Step1
12
-
8/11/2019 Custom Web ADI Integrators
13/45
Integrator Step2
13
-
8/11/2019 Custom Web ADI Integrators
14/45
Integrator Step2
14
-
8/11/2019 Custom Web ADI Integrators
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.
-
8/11/2019 Custom Web ADI Integrators
16/45
-
8/11/2019 Custom Web ADI Integrators
17/45
Integrator Step2
17
Validating Columns
Lets validate the Vendor Name before itreaches the PL/SQL API
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
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.
-
8/11/2019 Custom Web ADI Integrators
20/45
Integrator Step2
20
Back into the Integrator definition, Step 2, click update on the Vendor Name field
-
8/11/2019 Custom Web ADI Integrators
21/45
Integrator Step2
21
Adding a Calendar LOV to the Accounting Date field
Create another component
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
23/45
Integrator Step2
23
For Component name, enter the exact name, this fielddoesnt work with wild cards.
-
8/11/2019 Custom Web ADI Integrators
24/45
Integrator Step2
24
Back to the spreadsheet
-
8/11/2019 Custom Web ADI Integrators
25/45
Integrator Step4
25
Step 4 Create an Uploader. Just take defaults.
-
8/11/2019 Custom Web ADI Integrators
26/45
Integrator Step4
26
-
8/11/2019 Custom Web ADI Integrators
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.
-
8/11/2019 Custom Web ADI Integrators
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.
-
8/11/2019 Custom Web ADI Integrators
29/45
Integrator Step5
29
-
8/11/2019 Custom Web ADI Integrators
30/45
Integrator Step5
30
Try Synchronous or Asynchronous and you'll end up withthis error from excel
-
8/11/2019 Custom Web ADI Integrators
31/45
Layout
31
Create a layout for how this looks in Excel
-
8/11/2019 Custom Web ADI Integrators
32/45
Layout
32
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
34/45
Adding to a Menu
34
Choose Save
-
8/11/2019 Custom Web ADI Integrators
35/45
Adding to a Menu
35
-
8/11/2019 Custom Web ADI Integrators
36/45
Adding to a Menu
36
Find it in the database with
-
8/11/2019 Custom Web ADI Integrators
37/45
Adding to a Menu
37
Lets add it to Payables
Uses Menu AP_NAVIGATE_GUI12
-
8/11/2019 Custom Web ADI Integrators
38/45
Adding to a Menu
38
-
8/11/2019 Custom Web ADI Integrators
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.
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
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
-
8/11/2019 Custom Web ADI Integrators
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.
-
8/11/2019 Custom Web ADI Integrators
45/45
Questions & Answers
Discussion
Don Browne
603.952.4641
www.monumentdata.com
45