Install Oracle JDeveloper Studio for ADF Development

Here are the steps to install the new Oracle JDeveloper Studio version to design and develop ADF web application development.  I have put the installation steps only for Windows Os.

Recommended CPU, Memory, Display, and Hard Drive Requirements

  • Operating System: Windows 7, Windows XP – Service Pack 3
  • CPU Type and Speed: Pentium IV 2 GHz or faster
  • Memory: For 32-bit systems: 2 GB RAM, For 64-bit systems: 3 GB RAM
  • Hard Drive Space: 3GB


1] Update your JDK

This version of JDeveloper requires JDK 6.0 or later. You can download and install it manually from the below link. However JDK 6 Update 24 is installed automatically when you use the platform-specific installer.

Java SE 6 Microsoft Windows Installation

2] Download the Windows Installer (jdevstudio11121install.exe)

You can download Oracle Installer from the Oracle Technology Network (OTN) web site

Oracle Installer can be used to install Oracle JDeveloper Studio, the ADF Runtime, and Oracle WebLogic Server 11g Release 1 (10.3.5) on your system.

3] Launch the Windows installer

To launch the Windows installer, double-click the jdevstudio11121install.exe file. Click Next to begin the installation process.

4] Choose Middleware Home Directory

You can create a new Middleware Home directory, or select one from a list of existing Middleware Home directories. If you choose a directory that already has Oracle JDeveloper and Oracle WebLogic Server components installed on it, you are taken directly to the Choose Products and Components screen to select additional components to install.

If you choose to create a new Middleware Home directory, the default provided is C:\Oracle\Middleware.

5] Choose Install Type

Select either Complete or Custom depending on the type of installation you want to perform. Selecting Complete will install Oracle JDeveloper Studio, Application Development Framework Runtime, and Oracle WebLogic Server on your system.

6] Confirm Product Installation Directories

View the directories that the components will be installed in. To make changes, click Back and navigate to the desired screen, or click Next to continue with the installation.

7] Choose Shortcut Location

Select the Start Menu folder where you want to place your shortcuts. You can select one of the following options:

  • “All Users” Start Menu folder-Select this option to provide all users registered on this machine with access to installed software. Only users with Administrator privileges can create shortcuts in the All Users folder.
  • Local user’s Start Menu folder-Select this option to ensure that other users registered on this machine will not have access to the Start menu entries for this installation.

8] Installation Summary

It displays the components that will be installed and total disk space that will be utilized.

9] Installation status

It displays the progress of the installation.

10] Installation Complete

Select Run Quickstart to open the Quickstart window once the installation process has ended. Click Done to end the installation process.

To start Oracle JDeveloper Studio on Windows, use any of the following methods:

  • From your Start Menu, select All Programs, then select Oracle Fusion Middleware, and then select JDeveloper Studio
  • You can also start JDeveloper from the command line by running one of the following commands:
    • MW_HOME\jdeveloper\jdeveloper.exe
    • MW_HOME\jdeveloper\jdev\bin\jdevw.exe
    • MW_HOME\jdeveloper\jdev\bin\jdev.exe (to display a console window for internal diagnostic information)


For Detailed Information:

Refer : Installation Guide for Oracle Jdeveloper 11g Release 2 (

Have a great ADF Learning!

Create Hello World Page in OAF!

This tutorial will tell you the basic steps to create a Hello Word Page in OA Framework.

Earlier Posts:

1] Initial Setup in JDeveloper for OAF Development

2] Run Oracle Defined Hello World Page

Step 1: Start JDeveloper. Create a New OA Workspace and Empty OA Project with the New…Dialog

Step 2: Create the OA Component Page

JDeveloper creates your top-level page layout region for you automatically when you create your page.

Step 3: Modify the Page Layout (Top-level) Region

  • Set the ID property to PageLayoutRN.
  • Verify that the Region Style property is set to pageLayout.
  • Verify that the Form property is set to True.
  • Verify that the Auto Footer property is set to True.
  • Set the Window Title property to <your name>: Hello World Window Title. This becomes the window title for the page.
  • Set the Title property to <your name>: Hello World Page Header.
  • Set the AM Definition property to oracle.apps.fnd.framework.server.OAApplicationModule (you will have to type in the value). This is a generic application module supplied by the OA Framework.

Step 4: Create the Second Region (Main Content Region)

Create your second region under the page layout region by selecting the page layout region in the Structure window and choosing New > Region from the context menu.

  • Replace the default value in the ID property with MainRN.
  • Set the Region Style property to messageComponentLayout (this provides an indented single- or multiple-column layout for the child items of the region).

Step 5: Create the First Item (Empty Field)

Create your first item under the second region (main content region) by selecting the second region in the Structure window and choosing New > messageTextInput from the context menu. This item will take any name as parameter.

  • Set the ID property to HelloName.
  • Verify that your Item Style property is set to messageTextInput (this style provides a text label and an input field).
  • Set the Prompt property to Name.
  • Set the Visual Length to 20.
  • Set the Data Maximum Length to 50.

Step 6: Create a Container Region for the Go Button

To add a non-message-type bean such as a submitButton to a messageComponentLayout region, you must first add the bean to a messageLayout region.

Select the messageComponentLayout region and select New > messageLayout.

Name this region ButtonLayout.

Step 7: Create the Second Item (Go Button)

Create your Go button item by selecting the messageLayout region, ButtonLayout, in the Structure window and choosing New > Item from the context menu.

Set the following properties for your button item:

  • Set the value of the ID property to Go.
  • Set the Item Style property to submitButton.
  • Set the Attribute Set property to /oracle/apps/fnd/attributesets/Buttons/Go.

Step 8: Save Your Work (Save-All)

Step 9: Run Your Page Using the Run Option

You can try out your page using the Run option on the context menu. If you are using a database other than what you already have in your project settings, you will need to modify the Runtime Connection project settings by selection your project file and choosing Project Properties… from the main menu. Specifically, you must use a combination of Username, Password, (Responsibility) Application Short Name and Responsibility Key that is valid for your database to enable your session to log in.

The output will be like:

Here the Go Button has no functionality. Now to add some functionality to this Button, we need to add a Controller.

Step 10: Add a Controller

Add a controller to display a message when the user clicks on the Go button. Select your second region (MainRN) and choose Set New Controller… from the context menu.

Step 11: Edit Your Controller

When you create a controller .java file will be automatically created and it will contain below 2 methods.

  • public void processRequest(OAPageContext pageContext, OAWebBean webBean) { }
  • public void processFormRequest(OAPageContext pageContext, OAWebBean webBean) { }

Now you need to add the below code in the java file to add the required functionality.

  • Add the following line as the last line of the import section to make the OA Framework OAException routines available:
import oracle.apps.fnd.framework.OAException;
  • Add the below code in processFormRequest method
      if (pageContext.getParameter("Go") != null)
      String userContent = pageContext.getParameter("HelloName");
      String message = "Hello, " + userContent + "!";
      throw new OAException(message, OAException.INFORMATION);

Step 12: Build Your Controller

Build your controller by selecting Rebuild from the context menu within the code editor window.

Step 13: Test Your Work Using the Run Option

Save your work, and then test it using the Run option. Type something into your field and then click the Go button. You should see the page with an informational message that contains what you typed into the field, as shown:

Congratulations…! You have created your first OA Page. I will try to put articles on how to create search, create and update page in OAF in future. See ya!

My First Hello World Page in OA Framework!

My First Hello World Page in OA Framework!

If you are new to OAF Development and want to create a new Hello World Page, then this tutorial will help you. For that first you need to do a Setup to use JDeveloper to develop and run your OA Pages.

You can refer here for that.

After the Setup is completed, you are all set to run your first OA Page. Oracle itself has created the Hello World page for you! Just go through the below steps to run the page.

1] Open Oracle JDeveloper and go to File > Open. Open the “toolbox.jws” file from the location \jdevhome\jdev\myprojects.

2] Right click on Tutorial and then click on Project properties.

3] Go to Oracle Applications > Database Connections tab

4] Click on New to create a new database connection. Choose the Connection Type as Oracle (JDBC).

5] Give your Oracle Apps database username and password.

6] Choose the thin driver and give Host Name, Port and SID details of your Oracle Application Database Server. You can get the details in your tnsnames.ora file.

7] After that click on Test Connection button to check if the JDeveloper can connect to the specified database or not. If the status is success then go ahead or check the above settings if you get different status.

8] Go to Run Options and select OADiagnostic and OADeveloperMode.

9] In the Runtime Connection tab, add the path of your DBC file name and give your Oracle Apps username and password. Click Ok. Also add Application Short Name as AK and Responsibility Key as FWK_TBX_TUTORIAL.

10] Go to Oracle Application Front end and add the responsibilities “OA Framework ToolBox Tutorial” & “OA Framework ToolBox Tutorial Labs” to the user that you have added on the Runtime Connection tab above.

11] Now right click on Tutorial and Rebuild the project. You should get zero errors. If you get few warnings it is ok.

12] Now go to toolbox > Tutorial > Web Content and Run the test_fwktutorial.jsp page.

13] Click on Hello, World!

14] Here is your Hello World page.

You might get errors while running the project. Here I have listed such few errors and their solutions.

Error: oracle.apps.fnd.framework.OAException: Application: ICX, Message Name: Could not find the specified responsibility.

Solution :

1 . Check that the user name and password are correct in the project settings.(Make sure to give Application username and password.)

2. Check the Responsibility key and Application short name.

3. Check whether the user name given in point #1 is attached to the responsibility mentioned in the point #2.

4. Check your dbc file for correct settings.

Error: oracle.apps.fnd.framework.OAException: Application: FND, Message Name: FND_GENERIC_MESSAGE. Tokens: MESSAGE = java.lang.NullPointerException;

Solution :

Set profile “Sign-On:Notification” to “No” at site level.

Initial Setup in JDeveloper for OAF Development

Initial Setup in JDeveloper for OAF Development


If you want to do some OAF Development in JDeveloper for the first time, you will need to do the following things.

1] Download JDeveloper Patch

Based on your instance release level, check out the version of JDeveloper to use using below link.

You can identify the OA Framework version in your instance by activating diagnostics and click the “About This Page” from any OAF page. Click the “Technology Components” tab. The OA Framework version in the top row of the table can then be matched to the JDeveloper Patch.

Download the JDeveloper Patch.

2] Extract the JDeveloper patch in a directory say D:\DevSuiteHome_1\jdev

The patch actually contains below three directories

  • jdevbin – Includes an extended version of the Oracle JDeveloper 10g executable and OA Framework class libraries.
  • jdevhome – Includes the OA Framework Toolbox Tutorial source and developer working area.
  • jdevdoc – Contains documentation.

3] Define an environment variable

Define an environment variable JDEV_USER_HOME for your local machine. This has to be set to jdevhome\jdev directory. In above example it has to be D:\DevSuiteHome_1\jdev\jdevhome\jdev.

My Computer Properties Advanced tab Environment Variables New


Value: D:\DevSuiteHome_1\jdev\jdevhome\jdev

4] Extract

Extract D:\DevSuiteHome_1\jdev \jdevbin\ into D:\DevSuiteHome_1\jdev \jdevhome.

It will create following directories

D:\DevSuiteHome_1\jdev \jdevhome\jdev\myhtml

D:\DevSuiteHome_1\jdev \jdevhome\jdev\myprojects

5] Get the DBC file

Obtain the FND database connection (.dbc) file from the system administrator who installed the OA Framework database where you want to do your development.

For the instance to use, you can get the .dbc file from $FND_SECURE and put it in <JDEV_USER_HOME>\dbc_files\secure i.e. D:\DevSuiteHome_1\jdev\jdevhome\jdev \dbc_files\secure

6] Creating a Desktop Shortcut to JDeveloper

To facilitate launching JDeveloper, create a desktop shortcut to jdevbin\jdev\bin\jdevw.exe.

7] Configuring the Environment Encoding of JDeveloper

Confirm the environment encoding of your JDeveloper if it is appropriately set.

Go to Tools – Preferences – Environment – Encoding

If Encoding is not set to “UTF-8”, set it to “UTF-8”.

The initial setup is now complete!….Now you are ready to develop your first OAF page. For more information you can refer OAF Developer’s Guide.