Web adi webcast_v3

54
1 © Copyright © 2013, Oracle and/or its affiliates. All rights reserved.

description

Web ADI

Transcript of Web adi webcast_v3

Page 1: Web adi webcast_v3

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

Page 2: Web adi webcast_v3

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

Page 3: Web adi webcast_v3

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

Page 4: Web adi webcast_v3

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

Page 5: Web adi webcast_v3

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

Page 6: Web adi webcast_v3

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

Page 7: Web adi webcast_v3

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

Page 8: Web adi webcast_v3

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

Page 9: Web adi webcast_v3

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

Page 10: Web adi webcast_v3

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

Page 11: Web adi webcast_v3

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

Page 12: Web adi webcast_v3

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

Page 13: Web adi webcast_v3

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

Page 14: Web adi webcast_v3

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

Page 15: Web adi webcast_v3

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

Page 16: Web adi webcast_v3

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

Page 17: Web adi webcast_v3

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

Page 18: Web adi webcast_v3

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

Page 19: Web adi webcast_v3

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

Page 20: Web adi webcast_v3

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

Page 21: Web adi webcast_v3

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

Page 22: Web adi webcast_v3

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

Page 23: Web adi webcast_v3

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

Page 24: Web adi webcast_v3

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

Page 25: Web adi webcast_v3

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

Page 26: Web adi webcast_v3

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

Page 27: Web adi webcast_v3

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

Page 28: Web adi webcast_v3

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

Page 29: Web adi webcast_v3

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

Page 30: Web adi webcast_v3

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

Page 31: Web adi webcast_v3

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

Page 32: Web adi webcast_v3

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

Page 33: Web adi webcast_v3

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

Page 34: Web adi webcast_v3

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

Page 35: Web adi webcast_v3

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

Page 36: Web adi webcast_v3

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

Page 37: Web adi webcast_v3

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

Page 38: Web adi webcast_v3

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

Page 39: Web adi webcast_v3

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

Page 40: Web adi webcast_v3

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

Page 41: Web adi webcast_v3

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

Page 42: Web adi webcast_v3

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

Page 43: Web adi webcast_v3

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

Page 44: Web adi webcast_v3

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

Page 45: Web adi webcast_v3

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

Page 46: Web adi webcast_v3

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

Page 47: Web adi webcast_v3

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

Page 48: Web adi webcast_v3

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

Page 49: Web adi webcast_v3

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

Page 50: Web adi webcast_v3

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

Page 51: Web adi webcast_v3

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

Page 52: Web adi webcast_v3

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

Page 53: Web adi webcast_v3

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

Page 54: Web adi webcast_v3

54 copy Copyright copy 2013 Oracle andor its affiliates All rights reserved

THANK YOU