web adi webcast_v3
DESCRIPTION
Web ADITRANSCRIPT
1 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
2
Future Advisor Webcasts
Day Date 2004
time pm ET
Teleconference Access
North America xxxx
International xxxx
Password Advisor
Upcoming live webcasts and recent recordings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Teleconference Access
US amp Canada 877-600-6701
Toll Number 706-758-8276
International Toll-Free
See DOC11486001
Password 85026037
Current Advisor Webcast Schedule ndash DOC7409661
3 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
The following is intended to outline our general
product direction It is intended for information
purposes only and may not be incorporated into
any contract It is not a commitment to deliver any
material code or functionality and should not be
relied upon in making purchasing decision The
development release and timing of any features
or functionality described for Oraclersquos products
remains at the sole discretion of Oracle
Safe Harbor Statement
ltInsert Picture Heregt
WEB ADI Excel Upload Rajesh P
Principle Support Engineer BDE CoE
Srinivas M
Sr Support Engineer Global Human Resources
5
Web ADI Integrators Load Data with Excel
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
6
Topics
bull Web ADI
bull Traditional Custom Import Process
bull Web ADI Custom Import Process
bull Web ADI Components
bull Creating a Custom Integrator
bull Examples
bull Other Options and Features
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
7
Web ADI History
bull Application Data Interchange bull GLDI ndash GL specific
bull ADI ndash
bull Multiple versions
bull PC based application
bull Assets and GL
bull Concurrent request and reporting functionality
bull Web ADI
bull Completely web based
bull Only data export and load ndash no reporting
bull Many applications ndash ICM HR (replaced ADE) GL others
bull Extendable
bull New integrators
bull Custom Layouts
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
8
Web ADI ndash Basic User Process
bull Create a spreadsheet
bull From a form
bull From a menu option
bull Populate or change the spreadsheet
bull Upload to Oracle
bull Fix errors if needed
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
9
Create a Spreadsheet from a Form
bull Some forms have an export data
function
bull This exports to a spreadsheet
using Web ADI
bull Some additional pages ask for
Excel version and format
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
2
Future Advisor Webcasts
Day Date 2004
time pm ET
Teleconference Access
North America xxxx
International xxxx
Password Advisor
Upcoming live webcasts and recent recordings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Teleconference Access
US amp Canada 877-600-6701
Toll Number 706-758-8276
International Toll-Free
See DOC11486001
Password 85026037
Current Advisor Webcast Schedule ndash DOC7409661
3 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
The following is intended to outline our general
product direction It is intended for information
purposes only and may not be incorporated into
any contract It is not a commitment to deliver any
material code or functionality and should not be
relied upon in making purchasing decision The
development release and timing of any features
or functionality described for Oraclersquos products
remains at the sole discretion of Oracle
Safe Harbor Statement
ltInsert Picture Heregt
WEB ADI Excel Upload Rajesh P
Principle Support Engineer BDE CoE
Srinivas M
Sr Support Engineer Global Human Resources
5
Web ADI Integrators Load Data with Excel
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
6
Topics
bull Web ADI
bull Traditional Custom Import Process
bull Web ADI Custom Import Process
bull Web ADI Components
bull Creating a Custom Integrator
bull Examples
bull Other Options and Features
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
7
Web ADI History
bull Application Data Interchange bull GLDI ndash GL specific
bull ADI ndash
bull Multiple versions
bull PC based application
bull Assets and GL
bull Concurrent request and reporting functionality
bull Web ADI
bull Completely web based
bull Only data export and load ndash no reporting
bull Many applications ndash ICM HR (replaced ADE) GL others
bull Extendable
bull New integrators
bull Custom Layouts
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
8
Web ADI ndash Basic User Process
bull Create a spreadsheet
bull From a form
bull From a menu option
bull Populate or change the spreadsheet
bull Upload to Oracle
bull Fix errors if needed
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
9
Create a Spreadsheet from a Form
bull Some forms have an export data
function
bull This exports to a spreadsheet
using Web ADI
bull Some additional pages ask for
Excel version and format
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
3 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
The following is intended to outline our general
product direction It is intended for information
purposes only and may not be incorporated into
any contract It is not a commitment to deliver any
material code or functionality and should not be
relied upon in making purchasing decision The
development release and timing of any features
or functionality described for Oraclersquos products
remains at the sole discretion of Oracle
Safe Harbor Statement
ltInsert Picture Heregt
WEB ADI Excel Upload Rajesh P
Principle Support Engineer BDE CoE
Srinivas M
Sr Support Engineer Global Human Resources
5
Web ADI Integrators Load Data with Excel
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
6
Topics
bull Web ADI
bull Traditional Custom Import Process
bull Web ADI Custom Import Process
bull Web ADI Components
bull Creating a Custom Integrator
bull Examples
bull Other Options and Features
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
7
Web ADI History
bull Application Data Interchange bull GLDI ndash GL specific
bull ADI ndash
bull Multiple versions
bull PC based application
bull Assets and GL
bull Concurrent request and reporting functionality
bull Web ADI
bull Completely web based
bull Only data export and load ndash no reporting
bull Many applications ndash ICM HR (replaced ADE) GL others
bull Extendable
bull New integrators
bull Custom Layouts
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
8
Web ADI ndash Basic User Process
bull Create a spreadsheet
bull From a form
bull From a menu option
bull Populate or change the spreadsheet
bull Upload to Oracle
bull Fix errors if needed
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
9
Create a Spreadsheet from a Form
bull Some forms have an export data
function
bull This exports to a spreadsheet
using Web ADI
bull Some additional pages ask for
Excel version and format
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
ltInsert Picture Heregt
WEB ADI Excel Upload Rajesh P
Principle Support Engineer BDE CoE
Srinivas M
Sr Support Engineer Global Human Resources
5
Web ADI Integrators Load Data with Excel
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
6
Topics
bull Web ADI
bull Traditional Custom Import Process
bull Web ADI Custom Import Process
bull Web ADI Components
bull Creating a Custom Integrator
bull Examples
bull Other Options and Features
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
7
Web ADI History
bull Application Data Interchange bull GLDI ndash GL specific
bull ADI ndash
bull Multiple versions
bull PC based application
bull Assets and GL
bull Concurrent request and reporting functionality
bull Web ADI
bull Completely web based
bull Only data export and load ndash no reporting
bull Many applications ndash ICM HR (replaced ADE) GL others
bull Extendable
bull New integrators
bull Custom Layouts
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
8
Web ADI ndash Basic User Process
bull Create a spreadsheet
bull From a form
bull From a menu option
bull Populate or change the spreadsheet
bull Upload to Oracle
bull Fix errors if needed
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
9
Create a Spreadsheet from a Form
bull Some forms have an export data
function
bull This exports to a spreadsheet
using Web ADI
bull Some additional pages ask for
Excel version and format
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
5
Web ADI Integrators Load Data with Excel
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
6
Topics
bull Web ADI
bull Traditional Custom Import Process
bull Web ADI Custom Import Process
bull Web ADI Components
bull Creating a Custom Integrator
bull Examples
bull Other Options and Features
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
7
Web ADI History
bull Application Data Interchange bull GLDI ndash GL specific
bull ADI ndash
bull Multiple versions
bull PC based application
bull Assets and GL
bull Concurrent request and reporting functionality
bull Web ADI
bull Completely web based
bull Only data export and load ndash no reporting
bull Many applications ndash ICM HR (replaced ADE) GL others
bull Extendable
bull New integrators
bull Custom Layouts
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
8
Web ADI ndash Basic User Process
bull Create a spreadsheet
bull From a form
bull From a menu option
bull Populate or change the spreadsheet
bull Upload to Oracle
bull Fix errors if needed
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
9
Create a Spreadsheet from a Form
bull Some forms have an export data
function
bull This exports to a spreadsheet
using Web ADI
bull Some additional pages ask for
Excel version and format
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
6
Topics
bull Web ADI
bull Traditional Custom Import Process
bull Web ADI Custom Import Process
bull Web ADI Components
bull Creating a Custom Integrator
bull Examples
bull Other Options and Features
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
7
Web ADI History
bull Application Data Interchange bull GLDI ndash GL specific
bull ADI ndash
bull Multiple versions
bull PC based application
bull Assets and GL
bull Concurrent request and reporting functionality
bull Web ADI
bull Completely web based
bull Only data export and load ndash no reporting
bull Many applications ndash ICM HR (replaced ADE) GL others
bull Extendable
bull New integrators
bull Custom Layouts
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
8
Web ADI ndash Basic User Process
bull Create a spreadsheet
bull From a form
bull From a menu option
bull Populate or change the spreadsheet
bull Upload to Oracle
bull Fix errors if needed
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
9
Create a Spreadsheet from a Form
bull Some forms have an export data
function
bull This exports to a spreadsheet
using Web ADI
bull Some additional pages ask for
Excel version and format
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
7
Web ADI History
bull Application Data Interchange bull GLDI ndash GL specific
bull ADI ndash
bull Multiple versions
bull PC based application
bull Assets and GL
bull Concurrent request and reporting functionality
bull Web ADI
bull Completely web based
bull Only data export and load ndash no reporting
bull Many applications ndash ICM HR (replaced ADE) GL others
bull Extendable
bull New integrators
bull Custom Layouts
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
8
Web ADI ndash Basic User Process
bull Create a spreadsheet
bull From a form
bull From a menu option
bull Populate or change the spreadsheet
bull Upload to Oracle
bull Fix errors if needed
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
9
Create a Spreadsheet from a Form
bull Some forms have an export data
function
bull This exports to a spreadsheet
using Web ADI
bull Some additional pages ask for
Excel version and format
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
8
Web ADI ndash Basic User Process
bull Create a spreadsheet
bull From a form
bull From a menu option
bull Populate or change the spreadsheet
bull Upload to Oracle
bull Fix errors if needed
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
9
Create a Spreadsheet from a Form
bull Some forms have an export data
function
bull This exports to a spreadsheet
using Web ADI
bull Some additional pages ask for
Excel version and format
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
9
Create a Spreadsheet from a Form
bull Some forms have an export data
function
bull This exports to a spreadsheet
using Web ADI
bull Some additional pages ask for
Excel version and format
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
10
Create a spreadsheet
bull A spreadsheet is created and populated from the screen
bull Enter the new desired information to upload
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
11
Upload from a spreadsheet
bull After new information is entered select upload from the Oracle menu
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
12
Upload from a spreadsheet
bull After upload you see the success or failure of your data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
13
Extendibility
bull Oracle seeds specific exports and loads
bull The spreadsheet formats called layouts can be
changed or additional ones can be added via setups
bull Each data export or load (ie proposed salaries GL
journals) uses an integrator
bull A programmer can create a new integrator with some
simple setups and possibly a simple program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
14
Traditional Custom Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
15
Traditional Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program
bull Registered concurrent program
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
16
Web ADI Import Process
bull Create a flat file
bull Transfer flat file to DB server
bull Load into temp table
bull Custom program (may not be needed)
bull Read temp table and loop through records
bull Call Oracle API
bull Mark temp table as to what is donenot done
bull Report on errors
bull Method to correctclear errors
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
17
Web ADI Custom Import Build Units
bull Transfer process
bull Unix script
bull Custom temporary table
bull Load control file
bull Custom program (maybe)
bull Registered concurrent program
bull Web ADI integrator setup
bull Web ADI layout setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
18
Web ADI Components
Spreadsheet Oracle API Integrator
(setups point to API)
Data Tables
Spreadsheet Integrator
(setups point to custom API)
Data Tables
Custom API
Oracle API
Or
If the Oracle API input is too complicatedhellip
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
19
Creating a Custom Integrator
bull Perform one-time Web ADI setup and some security setups
bull Identify the Oracle provided API you will be using This will be a procedure within a package
bull hr_job_apicreate_job
bull hr_position_apicreate_position
bull Determine if you need a custom wrapper You may need a custom wrapper if
bull The API uses internal ids that would mean nothing to the user ie organization_id or job_id
bull The integrator needs logic like if the record does not exist create it otherwise update it
bull The integrator needs to call multiple APIs like first create the entry and then create the entry values
bull Write wrapper if you need it
bull Set up the Integrator
bull Create the integrator
bull Create a function for the integrator
bull Add the function to your menu
bull Associate the function to the integrator
bull Define the layout(s)
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
20
Example 1
Create Jobs Integrator Purpose Load Jobs for a one-time conversion to Oracle
bull Use API hr_job_apicreate_job
create_job
(p_validate in boolean default false
p_business_group_id in number
p_date_from in date
p_job_group_id in number
p_segment1 in varchar2 default null
p_segment2 in varchar2 default null
p_segment3 in varchar2 default null
p_attribute1 in varchar2 default null
p_job_definition_id in out nocopy number
p_name out nocopy varchar2
)
bull Looking at the procedure definition only a few parameters are required and most are meaningful to an analyst doing the conversion
bull Not creating a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
21
Example 1
Create the Integrator
bull Web ADI uses Web ADI spreadsheets to load integrator
definitions
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator HR Integrator Setup
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
22
HR Integrator Setup Spreadsheet
bull Use the spreadsheet to define an integrator
bull Associates the integrator and the API
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
23
HR Integrator Function Setup
bull Create a form function in Application Developer responsibility (copy one of
Oraclersquos)
bull Add it to your menu
bull Use the spreadsheet created with HR Maintain Integrator Form Function
Integration
bull Associates the integrator and the function
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
24
HR Integrator
What wersquove done so far
bull Create integrator name
bull Associate integrator with an API
bull Create a function put on menu
bull Associate integrator with a function
Next
bull Create a layout
bull Create a spreadsheet
bull Use it
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
25
HR Integrator Layout
bull Responsibility Desktop Integration
bull Menu Option Define Layout
bull Select your integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
26
HR Integrator Layout - cont
bull Name your layout
bull Can have more than one layout for each integrator
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
27
NOW
THIS IS COOL
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
28
HR Integrator Layout - cont
bull The parameters from the API (magically) appear
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
29
HR Integrator Layout ndash cont
bull Select which should appear in your spreadsheet and where (header
or line)
Add constants and
defaults
Specify what should appear as columns
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
30
Create a Spreadsheet
bull Responsibility Desktop Integration
bull Menu Option Create Document
bull Select Integrator Your Integrator
bull Complete the information
bull Upload the data
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
31
Example 2
Element Entries Integrator
Purpose Load Element Entries through a spreadsheet
bull Use multiple APIs bull pay_element_entry_apicreate_element_entry
bull pay_element_entry_apiupdate_element_entry
bull To call these we need to
bull Decode element and input value names
bull Determine if the element already exsits
bull Need to create a wrapper
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
32
Create a Wrapper
bull Wrapper
bull Performs logic
bull Converts user data entered on the spreadsheet to the ids and formats needed by Oracle API
bull Employee number is converted to assignment id
bull Element Name is converted to element link id
bull Calls Oracle API
bull The wrapper becomes a new API
bull Create an integrator to use the wrapper
Wrapper
PROCEDURE dpl_create_element(
p_effective_date in date
p_employee_number in varchar2
p_element_name in varchar2
p_entry_type in varchar2
p_input_value_1 in varchar2 default null
p_input_value_2 in varchar2 default null
p_input_value_3 in varchar2 default null
p_input_value_4 in varchar2 default null
p_input_value_5 in varchar2 default null
p_entry_value1 in varchar2 default null
p_entry_value2 in varchar2 default null
p_entry_value3 in varchar2 default null
p_entry_value4 in varchar2 default null
p_entry_value5 in varchar2 default null
Oracle API pay_element_entry_apicreate_element_entry ( p_effective_date =gt l_effective_date p_business_group_id =gt l_business_group_id p_assignment_id =gt l_assignment_id p_element_link_id =gt l_element_link_id p_entry_type =gt l_entry_type p_input_value_id1 =gt l_input_value_id1 p_input_value_id2 =gt l_input_value_id2 p_input_value_id3 =gt l_input_value_id3 p_input_value_id4 =gt l_input_value_id4 p_input_value_id5 =gt l_input_value_id5 p_entry_value1 =gt p_entry_value1 p_entry_value2 =gt p_entry_value2 p_entry_value3 =gt p_entry_value3 p_entry_value4 =gt p_entry_value4 p_entry_value5 =gt p_entry_value5 p_entry_value6 =gt p_entry_value6
Wrapper Calls
Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
33
Integrator for the Wrapper
bull Define the integrator to call your procedure (wrapper)
bull Perform other setups for function and menu
bull Create layout
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
34
End Result
bull The spreadsheet columns are the wrapper parameters
bull Complete the spreadsheet and perform the upload
bull Integrator -gt Wrapper -gt Oracle APIs
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
35
Other Options
Spreadsheet Custom
Procedure Integrator
Oracle Open Interface
Table
Oracle Open Interface
Load Open Interface Tables
Spreadsheet Custom
Procedure Integrator
Custom Interface
Table
Custom Interface
Load Custom Interface Tables
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
36
Additional Features
Integrators can be equipped to
bull Export data from Oracle
bull Use lists of values
bull Error handling and Debugging WEB ADIs
bull Associate with Oracle forms ndash ToolsExport
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
37
Using List of Valueshellip Creating Independent Value sets based on a View Step 1 Create a View
Create or replace view XX_Yes_NO_v as
select Y Code Yes Description from dual
union
select N Code No Description from dual
Step 2 Associate View to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_TABLE_LOV
(P_APPLICATION_ID =gt 275 --
P_INTERFACE_CODE =gt GENERAL_724_INTF --GENERAL_663_INTF --
P_INTERFACE_COL_NAME =gt P_BILLABLE_FLAG --
P_ID_COL =gt code -- LOOKUP CODE UPLOADED --
P_MEAN_COL =gt code -- Shown in sheet --
P_DESC_COL =gt description
P_TABLE =gt XX_Yes_NO_v
P_ADDL_W_C =gt code is not null
P_WINDOW_CAPTION =gt Load Types
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_SORT_ORDER =gt yesno
P_USER_ID =gt 2
P_POPLIST_FLAG =gt N
)
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
38
Using List of Valueshellip
Creating Dependent Value sets based on a Java Code Step 1 Create a View appscomnjavaclassesoracleappspawebadiutilities
SQL Class Files - Ex XXCitySqlclass
appscomnjavaclassesoracleappspawebadiintegratorcomponent
Component Class Files - Ex XXCityComponentclass
appscomnjavaclassesoracleappspawebadiintegratorvalidators
Validator Class Files - Ex XXCityValidatorclass
Step 2 Associate Java File to a Integrator Field DECLARE
BEGIN
BNE_INTEGRATOR_UTILSCREATE_JAVA_LOV
(P_APPLICATION_ID =gt 275
P_INTERFACE_CODE =gt GENERAL_723_INTF
P_INTERFACE_COL_NAME =gt CITY_NAME
P_JAVA_CLASS =gt oracleappspawebadiintegratorcomponentXXCityComponent
P_WINDOW_CAPTION =gt Cities List
P_WINDOW_WIDTH =gt 450
P_WINDOW_HEIGHT =gt 300
P_TABLE_BLOCK_SIZE =gt 10
P_TABLE_COLUMNS =gt NULL
P_TABLE_SELECT_COLUMNS =gt NULL
P_TABLE_COLUMN_ALIAS =gt NULL
P_TABLE_HEADERS =gt NULL
P_TABLE_SORT_ORDER =gt yesno -- sortable by meaning not description--
P_USER_ID =gt 2 )
END
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
39
Debugging WEB ADI Integrators
1 Error handling in Wrapper PLSQL Programs
bull raise_application_error (-20001 v_error_message)
Or
bull FND_MESSAGECLEAR
bull FND_MESSAGESET_NAME(BNEWEBADI_ERROR)
bull FND_MESSAGESET_TOKEN(MSGError)
bull fnd_messageraise_error
2 To Debug WEB ADI System Errors
bull 1 Set the following System Profile Options to enable Debug
bull BNE Server Log Filename bnelog
bull BNE Server Log Level TRACE
bull BNE Server Log Path usrtmp Set this Profile option at Site level only
bull 2 Bounce back Apache server
bull 3 Reproduce the issue
bull 4 Investigate the Logfile for the cause
bull 5 Set the Log level to INFORMATION Macro Settings
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
40
Debugging Continuedhellip
1 Functional Setup Test through BNE Admin Servlet
bull BNE Admin Servlet httpltserver_namegtltserver_portgtoa_servletsoracleappsbneframeworkBneAdminServlet
bull The servlet provides BNE Code Level Java Version and Log Information
2 A Basic QUICK Test
Run this basic WebADI test to see if WebADI is functioning
1 Make sure that to have the Oracle Web ADI Responsibility added to the sysadmin user 2 Verify the Menu associated with the Oracle Web ADI responsibility is Web ADI Menu (1)ldquo 3 Add the function such as ldquoHR Integrator Setuprdquo Daily Rates Web-ADI Spreadsheet to the Web ADI Menu (1) menu 4 Check the concurrent request and verify that the menus recompiled successfully 5 Logout and back in then run this WebADI Test Responsibility = Oracle Web ADI gt Create Document gt Viewer = Excel 2000 Next Integrator = HR Integrator Setup General Ledger - Daily Rates Next Continue to accept the defaults and click on Next until the document is created Does this complete successfully
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
41
WebADI Viewlets
The following WebADI Viewlets are available to download from MOS for HR Integrator Setup
Patch 3196431 - Disabling integrators Patch 4125542 - Creating standalone integrators Patch 3196360 - Mail merge example Patch 3196357 - Upgrading ADE to Web ADI Patch 3196355 - Download example Patch 4125537 - Creating integrators Patch 4112747 - Associating Form Functions with integrators
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
42
Gotchasrsquo
bull Pop-up blocker can block Web ADI
bull Excel can not be open when you are creating a
spreadsheet
bull Macro security in Excel must be medium and VB
must be allowed
bull Error handling with Web ADI ndash look at seeded
integrators for examples
bull Protection on the Web ADI sheets is difficult
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
43
Macro Security Settings for Excel 2007
amp 2010 with Oracle E-Business Suite bull Perform the below steps for the E-Business Suite WebADI component to
function properly in Excel 2007 amp 2010
You need to change security option for Excel 2007 or Excel 2010 and IE
bull 1 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Initialize and script ActiveX control not marked as
safe for scripting to Prompt
bull 2 Go to Internet Explorer --gt Tools --gt Internet Options --gtSecurity Tab--
gtCustom Level and change Allow status bar updates via script to Enable
bull 3 Open Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Change Security
Level to Medium
bull 4 Microsoft Excel --gt Tools --gt Macro--gtSecurity --gt Trusted Publishers Tab
and turn on Trust access to Visual Basic Projectldquo
Now Logon to Oracle E-Business Suite --gt Oracle Web ADI Responsibility and
try to create document using Create Document option
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
44
Notes of Interest
bull 3601051 ndash Understanding and Using Web ADI in Oracle HRMS -
Includes lsquoA Step by Step Guide to Creating HRMS Integratorsrsquo
bull 2285271 - Web ADI for Oracle HRMS Implementation and
Configuration Information
bull Web ADI Implementation Guide - bne115igpdf
bull Web ADI User Guide - bne115ugpdf
bull Installing Configuring and Troubleshooting Web AD [ID 4176921 ]
bull Application Desktop Integrator (ADI) - FAQ [ID 1066671]
bull How To Install The Base ADI and Rollup Patches On A User PC [ID 8211531]
bull What Patches Should be Applied for Installing WEB ADI [ID 1971991]
bull Web ADI Tips for Troubleshooting [ID 3904761]
bull Note 1442701 - How to Find ADI (Applications Desktop Integrator) Patches on My Oracle Support
bull Note 1840901 - How to Find and Download the Latest Applications Desktop Integrator (ADI) Patches via Metalink
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
45
Notes of Interest Contd bull Note 3829731 - How to Get the Latest Version of ADI Patches From Metalink
bull How to Find the Latest Version of the Application Desktop Integrator (ADI) [ID 1642321]
bull To find-out the version of Web ADI there are two methods
bull Method 1
bull
bull + Login to Oracle E-business Suite and using Web ADI create a Document
bull + When Excel is launched with the created Document a Menu is created on the Toolbar in Excel called Oracle (in between Data and Window)
bull + From the Oracle menu select About A pop up window is displayed with the version of Web ADI (something like 8xxx)
bull
bull Method 2
bull
bull + Login into E-business Suite as System Administrator
bull + Once the Home Page is up paste the URL below into the same Browser window (replace hostnamedomain and portnumber as applicable)
bull
BNE ADMIN Servlet for 11i
bull httphostnameportnumberoa_servletsoracleappsbneframeworkBneAdminServlet
bull
bull BNE ADMIN Servlet for 12
bull httphostnameportnumberOA_HTMLBneAdminServlet
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
46
Clearing the OA Framework Cache
bull Responsibility Functional Administrator
bull Navigation Path
Core Services =gt Caching Framework =gt Global Configuration =gt Clear All
Cache
bull ML Note How To Clear The Cache Using Functional
Administrator 7590381 bull WARNING Clearing the OA Framework cache in a PRODUCTION instance can cause data issues if multiple users
are engaged and transacting data in the application at the time cache is cleared Please only utilize this in Production if
advised by Oracle Support Services or Oracle Development
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
47
Clearing the Web ADI Cache
bull Sometimes after creating an Integrator it is not available in the Create
Document menu option
bull ML Note 7996461 lsquoIntegrator Not Available In Create Document List
After Form Function Associationrsquo
bull Enter the following URL into your browser httpltservergtltportgtOA_HTMLBneAdminServletbneaction=cache-clear
bull Then press the back button to get back to the Navigator page and
continue working
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
48
Summary
bull Custom Web ADI allow you to create Excel extracts easily
bull Custom Web ADI also allows you to simplify the steps for data
uploads to the E-Business Suite
bull Realize that this is a fairly new tool and undergoing many
enhancements on a frequent basis
bull It might be a little rough around the edges and the
documentation might be a bit on the light side
bull I will be updating this presentation as I continue work on this for
my client and prepare for presenting it at Collaboratersquo11
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
49
Are You Ready
To Get
Proactive
Avoid the unexpected
Donrsquot leave value on the table
Lower overall organizational costs through preventative
maintenance
Reduce risks and maximize uptime
Achieve resolution faster
Streamline and simplify your daily operations
Get even more through connection
Discover more about Get Proactive httpssupportoraclecomCSPmainarticlecmd=show
amptype=ATTampid=13851651DISCOVER
ACT Get Proactive Access proactive capabilities available for your products
by visiting the product pages at My Oracle Support
Article ID 4321
Contact the Get Proactive team
today for help getting started get-proactive_wworaclecom
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
Attention
New Portal with same DocID
Schedule 7409661
Generic Advisor Webcast Note
7409661
Archive 7409641
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
51
select your
product
eg
Oracle Database
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
52
Archives Schedule
copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
53 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU
54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved
THANK YOU