NEOAUG. Custom Web ADI Integrators

Transcription

1 NEOAUG Custom Web ADI Integrators

2 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 Web ADI Lots of helpful error messages 3

4 Overview An Overview of the Process from the End Users Point of View Access from a menu Item 4

5 Overview Enter Invoice Lines with LOV s for Important fields 5

6 Overview Upload data with Validation and AP Interface launch 6

7 Overview All of this from an Excel Spreadsheet. 7

8 Integrator Overview Custom Integrator for AP Invoice creation Load Invoice Lines from spreadsheet Validate and load interface table Call AP Interface Import 8

9 PL/SQL API Create a PL/SQL package to work with the integrator 9

10 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

11 PL/SQL API The RunImport procedure will call the AP Invoice Interface, from the last step of the integrator. 11

12 12 Integrator Step1

13 13 Integrator Step2

14 14 Integrator Step2

15 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

16 Spreadsheet Example The spreadsheet so far 16

17 Integrator Step2 Validating Columns Lets validate the Vendor Name before it reaches the PL/SQL API 17

18 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

19 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

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

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

22 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

23 Integrator Step2 For Component name, enter the exact name, this field doesn t work with wild cards. 23

24 Integrator Step2 Back to the spreadsheet 24

25 Integrator Step4 Step 4 Create an Uploader. Just take defaults. 25

26 26 Integrator Step4

27 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

28 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 29 Integrator Step5

30 Integrator Step5 Try Synchronous or Asynchronous and you'll end up with this error from excel 30

31 Layout Create a layout for how this looks in Excel 31

32 32 Layout

33 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

34 Adding to a Menu Choose Save 34

35 35 Adding to a Menu

36 Adding to a Menu Find it in the database with 36

37 Adding to a Menu Lets add it to Payables Uses Menu AP_NAVIGATE_GUI12 37

38 38 Adding to a Menu

39 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

40 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 : FNDLOAD USING BNEINTEGRATOR.LCT DOES NOT INCLUDE BNE_INTEGRATORS_B.SOURCE 40

41 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: AdminServlet Login as sysadmin first 41

42 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 ) 42

43 Troubleshooting Don t be afraid to open the Macro itself to see what s going on From Excel, choose View->Macros->Edit 43

44 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

45 Questions & Answers Discussion Don Browne