Using Oracle ADF with

Oracle E-Business Suite:

The Full Integration View
Juan Camilo Ruiz
Principal Product Manager, ADF

Sara Woodhull
Principal Product Manager, EBS ATG

Siva Puthurkattil
Oracle Database Administrator, Lake
County, Illinois
1

Copyright 2012, Oracle and/or 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 decisions. The development, release, and
timing of any features or functionality described for Oracle's
products remains at the sole discretion of Oracle.

2
Copyright
Oracle
2012, Oracle
its affiliates.
All reserved.
rights
Copyright
2012,
and/or and/or
its affiliates.
All rights
reserved.

Program
Agenda

Choosing the right technology

Oracle E-Business Suite SDK for Java
Integration examples
Lake County Purchasing Portal

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Extending Oracle E-Business

Suite: Choose the Right
Technologies

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Extending Oracle E-Business Suite

What do you want to build?
Add to existing Oracle E-Business Suite business flow
Create new flow within Oracle E-Business Suite
Build new, separate application

All of these extensions use Oracle E-Business Suite data

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Extending Existing EBS Business Flow

Adding a few new screens
Within Oracle E-Business Suite
EBS
Home
Page

EBS
Screen

EBS
Screen

EBS
Screen

Custom
Screen

Custom
Screen

EBS
Screen

Best practice: build custom screens in same technology as existing

flow for consistent user interface

Oracle Application Framework (OAF), Oracle Forms

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Creating New Flow within EBS

Users move between custom and EBS flows frequently
Within Oracle E-Business Suite
EBS
Home
Page

EBS
Screen

EBS
Screen

EBS
Screen

EBS
Screen

Custom
Screen

Custom
Screen

Custom
Screen

Custom
Screen

Best practice: build custom screens in same technology as existing flow

for consistent user interface

Oracle Application Framework (OAF)
Alternatively incorporate ADF alone or in hybrid pages with OAF

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Creating Separate Application

No user interface interaction with EBS
Within Oracle E-Business Suite
EBS
Home Page

EBS
Screen

EBS
Screen

EBS
Screen

EBS
Screen

Custom
Screen

Custom
Screen

Custom
Screen

Custom
Screen

Separate Application
Custom Start
Screen

Best practice: Choose technology that meets your needs

Oracle Application Framework or Oracle ADF or both (hybrid pages)

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Choose OA Framework If You Need to

New Applications
Use Flexfields
Have same look and feel as the

E-Business Suite application

Use OA Framework

Personalization

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Choose Oracle ADF If You Need to

New Applications
Support multiple data sources such as

Web Services, URL, Java

Have multi-channel rich user interfaces
Same development platform as Oracle

Fusion Applications
Support mobile devices

10

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Oracle ADF Multi-Channel Framework

11

Web

Desktop

Database

Web Services

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Mobile

Legacy Systems

Office

Applications Unlimited

Oracle ADF Rich Client Components

12

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Choose OAF Pages with ADF Regions If

New Applications
Use Oracle ADF embedded in OA Framework pages if your application

needs to:
Use flexfields
Have rich user interface components that are specific to ADF (hierarchy

viewer, carousel)
Have same look and feel as the E-Business Suite application

13

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Embedding ADF Content in an OAF Page

Hybrid Page lets OAF fields coexist with ADF

Rich Content
Container in OAF

OAF Main
Page
Embedded
ADF content

Other OAF fields

such as flexfields

14

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Oracle E-Business Suite

SDK for Java

15

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Oracle E-Business Suite SDK for Java

Enables integration using Oracle ADF
Protect your investment in the future
Co-exist with Fusion Applications

Custom Application
ADF Application
EBS SDK

16

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Oracle E-Business Suite SDK for Java

For Releases 11i to 12.x of Oracle E-Business Suite

E-Business Suite SDK for Java

JAAS
i18n

Session Management
Language
Info

Messages

AppsDataSource

17

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Profile
Apps Log
Handler

Building Custom ADF Applications for EBS

Use E-Business Suite SDK for Java
User
External Application
Server
Custom
Application
(ADF)

Write new applications with any Java EE

including ADF and deploy on external

application server
Use E-Business Suite security
Use AppsDataSource to access EBS

database
AppsDataSource

E-Business Suite
Database
18

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

AppsDataSource Standard Data Source

Standard Data Source for external applications

User
External Application
Server
Custom
Application
(ADF)

Configure AppsDataSource for access to

Oracle E-Business Suite database

Dedicated FND user with special UMX|

APPS_SCHEMA_CONNECT role
External server does not need APPS

password
External application can call stored

Users

AppsDataSource

Roles Oracle E-Business

Suite Database
19

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

procedures available in APPS

Oracle E-Business Suite SDK for Java

Java Authentication and Authorization Service (JAAS)
User B

User A

JAAS
Custom
Application
(ADF)

JAAS provides FND users and UMX roles

for securing external application

Use with separate application that does

not need to share session context with

EBS (UI independent of EBS UI)
Use AppsDataSource to provide access to

database
Users
Roles
20

AppsDataSource
Oracle E-Business
Suite Database

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Oracle E-Business Suite SDK for Java

Session Management
EBS provides users and responsibilities

User

Create, validate, destroy EBS sessions

Share session context with EBS

Custom
Application
(ADF)

Seamless
Navigation

EBS

Log in once and navigate seamlessly

between ADF and EBS

Use AppsDataSource to provide access

to database
AppsDataSource
Oracle E-Business
Suite Database
21

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Either separate ADF pages or Hybrid

Users
Resps

OAF Pages

Oracle E-Business Suite SDK for Java

Session terminology
Session refers to Oracle E-Business Suite ICX session
User session or EBS session
Context information such as user name, responsibility, NLS locale, other

information
Identified by ICX session cookie on browser

Shared session means same EBS user session across technologies

22

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Using Session Management

Sharing session and context with EBS session
Must use AppsDataSource to access EBS data
Requires session management APIs (instead of JAAS)
Can use EBS routines that require user or context
Can use Message Dictionary
Can use profile options
Can use logging

23

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Using JAAS
Session uses JAAS for authentication/authorization
Must use AppsDataSource to access EBS data
Does not share EBS session or context
Use EBS users and UMX roles instead of responsibilities
Can use services and EBS routines that do not need EBS context
Can use logging

24

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

JAAS or Session Management

When Do I Use JAAS?
JAAS uses container-managed security
Provides EBS user names and UMX roles to secure application
Use with basic or custom login screen, or launch from EBS Home Page

after EBS login

Leverage ADF security features
If user logs out of external application, there is no effect on EBS (user

never even needs to use EBS interface directly)

User will see pages in language set in browser preference

25

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

JAAS or Session Management

When Do I Use Session Management?
Session management uses EBS security
Use for shared EBS session and user context
Allows seamless navigation between EBS and ADF
Use with EBS login screen (only)
Launch external application pages from EBS home page
For ADF applications, call FND routines for component-level security
If user logs out of external application, user automatically logs out of EBS
User will see pages in language set in EBS preference
Embed ADF regions on OA Framework pages

26

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

ADF Extensions with Oracle E-Business Suite

Accessing Oracle E-Business Suite Data
SOAP Services
From SOA Suite, you can use Apps Adapter
Integrated SOA gateway for Native Services

Public APIs from Oracle E-Business Suite

Use AppsDataSource
Access any Public PL/SQL API in Integration Repository

27

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Examples of Using
Oracle E-Business Suite
SDK for Java

28

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Three Examples
Different Use Cases
Standalone application using JAAS, independent session
Lake County

Application using session management with separate UI

Oracle Electronic Kanban

ADF UI embedded in OA Framework page, using session

management
HCM Organization Chart

29

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Organization Chart in HCM

HCM embeds ADF in OA Framework using EBS SDK
Available in Release 12.1 HRMS RUP5 - Patch 13418800

(R12.HR_PF.B.Delta.5)

30

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Oracle Electronic Kanban (roadmap)

Entire application built using ADF but part of EBS
Uses session

management
Launches from EBS

home page
Logging out logs out

EBS too
Calls EBS PL/SQL APIs

31

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Lake County, Illinois

Separate ADF application using JAAS
Created UMX role in EBS
corresponds to enterprise role in ADF

Added to existing responsibility

Built ADF application using enterprise role for security

32

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Lake County Purchasing Portal

Developed in Oracle ADF

33

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Purchasing Portal
Developed in Oracle ADF
Presented By: Siva Puthurkattil
(Oracle Database Administrator)

34

Purchasing Portal

35

Purchasing Portal
Purpose deliver a solution that meets the major business needs of the purchasing domain.

Currently these are scattered around in EBS and the custom application - Bid Interface.

Bid Interface (written in ASP)- Allows vendors to register with the Lake County for various service areas.

Whenever there is a bid published on the Lake County website, the registered vendors would get an

automatic notification about the bid.

Vendors need to register in order to download the Bid documents.

Leveraging EBS SDK for Role/Responsibility based security solution for the purchasing portal.

Unified reporting solution.

36

Purchasing Portal
EBS Environment
Oracle R12.1.3 (Oracle Financials, HR & Payroll), Oracle DB 11g, RHEL 5.7 on

VMWare ESX 5
JDeveloper 11.2.1.0, WebLogic 10.3.6, Oracle E-Business Suite SDK for Java.
EBS - UMX Roles to Responsibilities Mapping:
UMX|BOSS_BID_ACCESS_REPORTS -> BOSS Inquiry
UMX|BOSS_BID_ADMIN -> Purchasing Super User

37

Purchasing Portal
Login Page

38

Purchasing Portal
Reports Tab
Users need BOSS Inquiry Responsibility

39

Purchasing Portal

Purchasing Portal
EBS Security
User who doesnt have the access to the Reports Tab.

41

Purchasing Portal
Legacy application drawbacks.
Information retrieval was cumbersome for users as it is from multiple

application sources.
Multiple applications with its own access credentials made application access

tiring to user community .

Everybody had access to every screen.

No role based access.

42

Purchasing Portal
Benefits of the new portal with ADF and EBS SDK
Unified web application interface to support the purchasing functionality.
Leveraging EBS credentials, users need not remember additional passwords.
Admin tasks of role based access controls are hassle free.
Ability to show a map of geographical distribution of the Lake county vendor base

in the new system.

43

Purchasing Portal
Phase 1 Status: Live
Went live in Aug 2012.

Challenges
Page not authorized message due to deployment issues.
System-jazn.xml was not updated with the Resource grants after deployment.
Solution: Check the resource permissions in application policies from EM.
Navigation in EM Application ->Security -> Policies

Mapping UMX roles to Responsibilities.

44

Purchasing Portal
Next Phase
Phase 2 of the project would replace all the legacy and custom applications with the unified

web-based purchasing portal and make it available to the public.

References:
MyOracle Support Id: 974949.1

https://blogs.oracle.com/jruiz/entry/securing_adf_applications_using_the

45

Bonus Example of EBS SDK (Non-ADF)

Endeca embedded in OA Framework Rich Content Container

46

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Roadmap

Oracle HCM Organization Chart Feature

47

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Summary
Choose the right technology for your EBS extension
OA Framework, Oracle ADF, or both

Use Oracle E-Business Suite SDK for Java with Oracle ADF
AppsDataSource
EBS security
With or without EBS context

48

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Resources
Oracle E-Business Suite Software Development Kit for Java (My

Oracle Support Doc ID 974949.1)

Oracle E-Business Suite System Administrator's Guide Security
See Oracle Application Framework Documentation Resources, Release 12

(Doc ID 391554.1)
See OA Framework - How to find the correct version of JDeveloper to use with

eBusiness Suite 11i or Release 12.x (Doc ID 416708.1)

ADF blogs

49

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

What JDeveloper Version to Use?

Use JDeveloper 11g R1
Latest 11.1.1.6.0
Tooling for Oracle Fusion Middleware Stack

Use JDeveloper 11g R2

Latest 11.1.2.3.0
ADF specific release
Supports latest Java EE standards
Various core improvements

50

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

E-Business Suite Technology Stack Blog

blogs.oracle.com/stevenChan

51

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

Direct from EBS Development

Latest EBS techstack news

Certification announcements

Primers, FAQs, tips

Desupport reminders

Latest upgrade recommendations

Statements of Direction

Early Adopter Programs

Subscribe via email or RSS

ADF Adventures Blog

blogs.oracle.com/jruiz

52

Copyright 2012, Oracle and/or its affiliates. All rights reserved.

ADF Development for EBS Developers

Sample Code

Videos

References

Other ADF related topics

Subscribe via email or RSS

Q&A

53

Copyright 2012, Oracle and/or its affiliates. All rights reserved.