Desktop Integrators You Mean

I Can Load Data Straight From a

Spreadsheet?
Lee Briggs
Director, Financials Practice
BizTech
LBriggs@BizTech.com
Session ID: 7627

Please set your cell phones to

silent mode.

Agenda

Introductions
Application Desktop Integrator and Web-ADI
R12 New Functionality
Creating a Custom Integrator - Preparation
Create the Integrator
Define the Layout
Start Loading Data
More than the Basics Lists of Values
Q&A

About Lee Briggs

Director, Finance Practice with BizTech

10 Years of Oracle Application implementation experience
Financials and Supply Chain from 11.5.3 through R12.1.3
Custom Reporting using FSGs, OBIEE, and BI Publisher
Experience with clients across all industries, with a focus
on Business Services, Professional Services and Banking
industries
Chair of the ADI SIG
Oracle Certified Specialist in General Ledger and Payables

About BizTech
Leading Mid-Atlantic Oracle Platinum Partner and IT Services
firm focused on Oracle Applications and Technology solutions
Over 400 successful Oracle implementations over the past
15 years
Based in King of Prussia, PA with offices in New Jersey, New
York City and Washington DC
Service Fortune 500 companies, organizations and
government agencies
100 + Oracle certified and experienced consultants

Client-Centric Practice Areas

Oracle Applications
-

Oracle Technology and Business Intelligence

Full Portfolio of Oracle Applications Solutions

Implementation, Upgrade, Migration
Since 1990 MPL6 to R12 Experience
Over 400 successful implementations to date

- End to end service offering in BI and EPM

- Fully staffed team of Data Architects and DBAs
- Solid experience in RAC, HA and HS designs
- Understand full Oracle technology stack

Oracle
Applications

Oracle
Technology
BI/EPM

Clients
Managed
Services
ITO
Managed Services and IT Outsource

- Remote or Onsite services

- Full portfolio of Oracle Applications and Technologies
- World-Class Data Center with 24x7 Support
- Instant capacity, operational focused business model

Oracle
Software
Provider
Oracle Software Provider
-

Full Portfolio of Oracle License Resell

Help Clients Optimize License models
RapidApp BI Software for the agile enterprise
RapidApp Auditor to manage change and GRC

Oracle Application Desktop Integrator

(ADI)
Integral part of Oracle Financial Applications
Initially released as a stand-alone application
installed on a client pc
Spreadsheet-based extension of General
Ledger and Assets
Enables users to create budgets, record
financial transactions and run financial reports
in Microsoft Excel

Oracle Application Desktop Integrator

(ADI)
Enables user to revise budgets, create journal
entries and define financial reports from any
location without being connected to the
server
Required to be connected to transfer data to
or from Oracle Applications

Application Desktop Integrator Full Features

Journals
Budgeting
Report Definition
Report Publishing
Formatting Reports
Report Drilldown
Create Assets
Physical Inventory
Diagnostics

Web ADI
From release 11.5.9, Oracle began to migrate
towards Web ADI
Uses Internet computer architecture to lower
the cost of ownership by having the product
centrally installed and maintained
No client installation is required
Provides superior performance

Web ADI
Initially a journals-only
solution
Additional functionality
gradually released

R12 ADI is De-Supported

Oracle Support Note 377640.1 advises that
Client/Server ADI is not supported for R12
All FSG reporting within Oracle Applications is
being moved to BI Publisher and Report
Manager
11.5.10 Documentation for General Ledger no
longer refers to Client ADI, but instead directs
users to use preconfigured Web-ADI solutions
for Journal Uploads, Budget Uploads.

R12 New Functionality

Web ADI is repackaged as Desktop
Integrator
As well as pre-packaged integrators, provides
functionality to now build custom integrators
to load data to ANY interface table or API

Creating a Custom Integrator:

Preparation
BNE% Profile Options
Profile Name

Value

BNE Server Log Level

Trace

BNE Server Log Path

$BNE_TOP/log

BNE Servlet Path

/oa_servlets/

BNE UIX Base Path

/OA_HTML/cabo

BNE UIX Physical Directory

$COMMON_TOP/webapps/oacore/html/cabo/

BNE Upload Import Directory

$BNE_TOP/upload/import

BNE Upload Staging Directory

$BNE_TOP/upload

BNE Upload Text Directory

$BNE_TOP/upload

Creating a Custom Integrator:

Preparation
Replace $BNE_TOP and $COMMON_TOP with
the actual values
With DBA assistance, check the following
directories exist with 777 permissions
$BNE_TOP/log
$COMMON_TOP/webapps/oacore/html/cabo
$BNE_TOP/upload/import
$BNE_TOP/upload

Creating a Custom Integrator:

Preparation
Most important preparation tip
Once these profile options have been updated,
bounce the ENTIRE instance

Assign your user two responsibilities

Desktop Integration Manager
Desktop Integration

Creating a Custom Integrator:

Preparation
Microsoft Excel setup
You must Trust Access to Visual Basic Project
You must allow Macros to run

Creating a Simple Custom Integrator

No validation of data in the integrator

No look-ups
No content
No custom upload parameters
User enters ALL data

Creating a Simple Custom Integrator

1. Create the Integrator
2. Define the Integrator Layout
3. Start Loading Data

Create the Integrator

Responsibility: Desktop Integration Manager
Navigation: Create Integrator

Enter Integrator Information

Enter Integrator Information

Integrator Name
The name of the integrator as the user will see it

Internal Name
The name of the integrator as the system sees it

Application
The name of the module that owns the
interface table

Security Rules
First Gotcha (No mention of Security Rules
in Implementation and Administration
Manual)
Add two Security Functions
Desktop Integration Create Document (Code:
BNE_ADI_CREATE_DOCUMENT)
Create Document (Code:
BNE_CREATE_DOCUMENT)

Create the Interface

Create the Interface

Interface Name
What you will refer to the interface name as

Interface Type
Select from Table, API Procedure, API Function

Table Name
Select the Table Name you will be populating data

GOTCHA #2 Click on APPLY!

Create the Interface

Create the Interface

Once youve clicked on Apply, every column
from the table will be displayed here
Best Practice Use forms personalization to
increase number of rows returned (25 per
page by default!)
Best Practice Identify the Required Fields,
and the fields you want.
Best Practice Set every other field listed to
not display

Create Content

Create Uploader List

Create Uploader List

Uploader List (new in R12.1.3) allows you to
specify what options are available to the user
upon upload
What rows to upload (all, flagged, etc)
How the rows are validated
Whether to invoke an import process
automatically

Define Importer List

Define Importer List

Importer List allows you to specify how to
move uploaded data from interface tables to
base tables
Allows you to apply validation rules to apply
before import to base tables

Define the Layout

Responsibility: Desktop Integration Manager
Navigation: Define Layout

Define the Layout

Define the Layout

Select the Integrator for which you are
defining the layout
Over 225 seeded integrators will also show in
this list

Create the Layout

Create the Layout

Layout Name
You can have multiple Desktop Layouts for the
same integrator

Number of Header Records

Dependent on what youre trying to accomplish
with the data youre loading

Create the Layout

Create the Layout

Here, you can control where fields appear
(Header or lines)
Example
AP Invoice Headers import
Operating Unit could be the same for all invoice
headers
Invoice Currency could be the same for all invoice
headers
Vendor would be different for each invoice header

Create the Layout

You can also default information in here,
whether its constant, derived by SQL, on an
environment variable
Default Invoice currency to USD
Default User information

Created By : FND_GLOBAL.USER_ID
Last Updated By: FND_GLOBAL_ID
Last Update Login: FND_GLOBAL.LOGIN_ID
Creation Date: SYSDATE
Last Update Date: SYSDATE

Create the Layout

GOTCHA #3
Updates to the layout and integrators will not
always show up once youve saved an requeried the layout
DBAs will need to clear Java cache on the
instance after EVERY change, or assign
yourself Functional Administrator
responsibility, and clear the Cache yourself!!

Start Loading Data!

Responsibility: Desktop Integration
Navigation: Create Document

Start Loading Data - Select the Integrator

Start Loading Data - Select the Viewer

Start Loading Data - Select the Viewer

Viewers include various versions of:
Microsoft Excel
Microsoft Project
Microsoft Word
Mobile Sales Deployment for Windows

Start Loading Data - Select the Layout

Start Loading Data Review your Criteria

Start Loading Data

More than the Basics List of Values

Component
Components allow you to return list of values for
a field
Example Let me present a list of all my AP Invoice
Types so I can pick from them, rather than having to
type the Invoice Type (and get it exactly right)

More than the Basics List of Values

Responsibility Desktop Integration Manager
Navigation Manage Components

More than the Basics List of Values

More than the Basics List of Values

Parameter Name

Parameter Value

Table-column-alias

INVOICE_TYPE_LOOKUP_CODE

Table-column-sort

ASCENDING

Table-columns

LOOKUP_CODE,MEANING,DESCRIPTION

Table-headers

Lookup Code,Meaning,Description

Table-select-column

INVOICE_TYPE_LOOKUP_CODE

Window-caption

Lookup Code,Meaning,Description

Window-height

500

Window-width

400

More than the Basics List of Values

Navigation Manage Integrators
Select the Integrator
Select the Interface Page
Update the attribute for List of Values

More than the Basics List of Values

More than the Basics List of Values

Label

Value

Validation Type

Table

ID Column

LOOKUP_CODE

Meaning Column

LOOKUP_CODE

Desc Column

DESCRIPTION

Validation Entity

FND_LOOKUP_VALUES_VL

Where Clause

(Nvl('', Territory_Code) = Territory_Code

Or Territory_Code Is Null) And
Lookup_Type = 'INVOICE TYPE' And
(Lookup_Type='INVOICE TYPE') And
(View_Application_Id=200) And
(Security_Group_Id=0) And Enabled_Flag
= 'Y'

Component Name

XXPC AP Invoice Type

LOV Type

Standard

More than the Basics List of Values

Questions?
Lee Briggs
Director, Financial Practice
LBriggs@BizTech.com
Twitter: BizTechOracle