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 LOV s 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
12 Integrator Step1
13 Integrator Step2
14 Integrator Step2
Integrator Step2 Fix the Prompt Names. Define defaults and validation rules for each column. Click Submit from here, NOT Next or you ll 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 doesn t work with wild cards. 23
Integrator Step2 Back to the spreadsheet 24
Integrator Step4 Step 4 Create an Uploader. Just take defaults. 25
26 Integrator Step4
Integrator Step5 Step 5 define an uploader Welcome to the Buggiest Screen Ever! Depending on your level of luck, you ll get through this step. If you didn t you ll 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 doesn t, start patching. 28
29 Integrator Step5
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
32 Layout
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
35 Adding to a Menu
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
38 Adding to a Menu
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 won t be able to edit the integrator. 39
Migrating Migrating This only get s 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 lct s at $BNE_TOP/patch/115/import/* bneintegrators.lct doesn t 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 you ll never see anything That s $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 you re 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 Don t be afraid to open the Macro itself to see what s going on From Excel, choose View->Macros->Edit 43
Troubleshooting Although you are allowed to delete columns from the interface definition, it won t 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