OAF – Downloading and Configuring JDeveloper

Posted on May 7, 2009. Filed under: Oracle Applications Framework | Tags: , , , , , , , , , , , , |

Download This Article From The Download Folder

This article will describe the process for downloading & installing the correct version of JDeveloper for development on your instance of E-Business Suite. It will discuss how to identify the correct version of JDeveloper to use and how to configure your OAF environment on your local machine.

Oracle JDeveloper (JDev) is the development tool we use to develop Oracle Applications Framework components, due to variations in the framework different versions of Oracle Applications require development to be performed on different versions of JDeveloper or at least the OAF flavour of JDeveloper. JDeveloper can be downloaded from metalink however prior to visiting meta link you will need to establish which version and patch set you are running as regards Oracle Apps.

To identify the correct version of Oracle Applications Framework we need to activate diagnostics. You can do this by ensuring the profile option “FND: Diagnostics” is set to “Yes”. Close your browser session and restart Oracle Applications, Log in and click the “About this Page” Link which can be found in the page footer.

Fig 1

Fig 1

When the “About Page” loads click the “Technology Components” Tab. You will be able to identify the version of Oracle Applications from the OA Framework version.

Fig 2

Fig 2

Now that we have identified the correct version of OAF we can visit metalink https://metalink.oracle.com note 416708.1 and download the corresponding version of JDeveloper. Download the file to a convenient directory on your machine, in this example we would download patch 6908968.
Fig 3

Fig 3

JDeveloper comes as a zip file and does not require any installation as such. We do however need to follow a few setup instructions to get up and running particularly if you are a developer that works on various versions of E-Business suite and thus will be using different versions of JDeveloper.

First unzip the JDeveloper zip file to a convenient directory. I recommend that you create a separate directory such as C:\JDeveloper\JDEV_R12_RUP4 . This will allow you to create further directories in the event that you download more versions and they will not conflict with each other. Once unzipped you will have three directories:

JDEVBIN: This is the JDeveloper software directory and contains the executables for the IDE.

JDEVDOC: This contains all help documentation including the OAF Developer Guide which will become invaluable to you as an OAF developer

JDEVHOME: This is where by default all of your project files and code will be created, sort of a my documents folder for JDeveloper.

Once installed we will need to create some shortcut links for your desktop so that you can launch JDeveloper and access the Developer Guide. Locate and create shortcuts for the following files for your desktop:

C:\yourInstallDirectory\jdevbin\jdev\bin\jdevW.exe for windows and jdev.exe for any other operating system.


The jdevW.exe/jdev.exe links will launch JDeveloper and the index.htm will open the help documentation which contains a link to the OAF Dev Guide.

Before we launch JDeveloper we will complete one more configuration task and re-point the JDEVHOME directory to a central location i.e. My Documents or another partition where you keep all your files. This process is very helpful when it comes to running multiple versions of JDeveloper. Right Click on the “My Computer” icon and select the “Properties” option. Click the “Advanced” tab and then “Environment Variables”. Create a new user variable by clicking on the “New” button and enter JDEV_USER_HOME as the environment variable name and the path to your central directory as the value i.e. d:\my_files\jdev_home.

Fig 4

Fig 4

Click OK and close the “My Computer” windows.

When JDeveloper is launched it will now automatically save your files and settings to the central user home rather than the default home in the installation directory. Always ensure that you back up your central user home to prevent the loss of critical project files.

 Now we have our JDeveloper environment ready we need to get some environment specific setup completed so that you can interact with your E-Business Suite instance. In order to enable us access to apps we will need to obtain the DBC file and copy it to our local machine. The best way of doing this is to log into the application server using a tool like putty and obtain the file from $FND_SECURE by ftp using a tool like winscp, failing this you could obtain it from your DBA. Once you have your DBC file create a folder in your JDEVHOME directory called dbc_files\secure\ (Remember the JDEVHOME is the location that we assigned to the JDEV_USER_HOME environment variable in the previous steps) and copy the DBC file to it.

Fig 5

Fig 5


Now that we have our DBC file we can open JDeveloper and configure the database connection. Launch your JDeveloper download by clicking the jdevW.exe link that we created earlier.

If you are using JDeveloper 10g i.e. for an Oracle Applications Version of R12 then you will be prompted to see if you want to migrate from another version, select “No” for this example. You will also see a tip of the day, click the “Close” button.
Fig 6

Fig 6

Click on the Connections tab and right click the “Database” folder and select “New Database Connection”.

Fig 7

Fig 7

If you are using JDeveloper 9i then the Database folder can be found in the “System – Navigator” pane under the connections node, you will not have the Connections Tab.

Fig 8

Fig 8

You will be presented with the Database Connection Wizard. Click “Next”
When prompted enter a name to represent your connection, this can be anything you like however I have just used the database SID for simplicity
Fig 9

Fig 9

Click “Next” and enter the database username and password, this will need to be the apps account and password, leave the role field blank.
Fig 10

Fig 10

Click “Next” and enter the database hostname, port and SID
Fig 11

Fig 11

 Click “Next” and click “Test Connection”, you should receive a successful connection message.

Fig 12

Fig 12

 OK, now that we have the database connection configured we need to make sure that we can connect to our E-Business suite instance from within JDeveloper. We can use the toolbox tutorial files to do this which get shipped with the JDeveloper build.

Click File > Open and navigate to JDEV_USER_HOME/myprojects and select the file toolbox.jws If you are running JDeveloper 10g you will automatically be in your JDev User Home with 9i you may have to navigate there manually due to a bug in the IDE.

If you are running JDeveloper 9i select the “Show Categories” icon, this will help us identify the test jsp page to run later.

Fig 13

Fig 13

If you are running JDeveloper 10g select the “Applications Navigator” tab to see the opened workspace. 

Now that we have the toolbox workspace open we need to modify the project settings in Tutorial.jpr, navigate to the project node under the toolbox node and right click on the “Tutorial” node and select “Project Properties” in 10g and “Project Settings” in 9i.
You will be presented with a properties screen with several options in the left hand pane, expand the “Oracle Applications” node and select the “Run Time” sub menu item. Your screen will look similar to this.
Fig 14

Fig 14

Configure the credentials as above. Select your DBC file that we downloaded earlier, enter YOUR username and password for Oracle Applications and ensure that you have the responsibility “Framework Toolbox Tutorial” assigned to that logon. To check that your logon is configured correctly run the SQL:

select fnd_web_sec.validate_login('<UserName>','<Password>') from dual;

This should return ‘Y’ as the result indicating that your account is setup correctly.

Repeat the above test for the Guest account specified in your DBC file (Usually GUEST/ORACLE).

Enter ICX as the application short name and FWK_TBX_TUTORIAL as the responsibility, these parameters define which responsibility we will be running the project under.

Select OK when you have finished.

We are now ready to run the test project:

In JDeveloper 9i navigate to the file test_fwktutorial under Workspaces > toolbox.jws > Tutorial.jpr > HTML Sources > test_fwktutorial.jsp

In JDeveloper 10g navigate to the file test_fwktutorial under Applications > toolbox > tutorial > Web Content > test_fwktutorial.jsp

Right click the test_fwktutorial.jsp node and select “Run” in 10g and “Run test_fwktutorial.jsp” in 9i

Fig 15

Fig 15

If you are running on a remotely hosted environment prepare for this process to be slow (anywhere from 2 – 10 minutes dependant on your network) you are now effectively running an embedded server from your local machine and a lot of information will be pinging to and from your machine and the application server on the environment, normally these two components would be hosted on the same server and thus the performance will be seriously degraded.
Once complete you should see the below screen.
Fig 16

Fig 16

Congratulations! You have successfully configured JDeveloper.
If you experience problems configuring your JDeveloper version then refer to meta link note 330236.1 for guidelines on raising a service request.

Make a Comment

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

14 Responses to “OAF – Downloading and Configuring JDeveloper”

RSS Feed for Oracle Apps Tech Blog Comments RSS Feed

Awesome article !! Would be great if you can come up with some extensions & deployment in OAF

Thanks for the feedback Raj much appreciated. I have recently written an article on VO substitution and deployment which I will be publishing shortly. Click this link to sign up to my blog and you will get new articles delivered direct to your inbox http://feedburner.google.com/fb/a/mailverify?uri=OracleAppsTechBlog&loc=en_US

[…] Now that we have identified the VO we need to extend, oracle.apps.pa.project.server.ProjectListGenVO, we need to setup our JDeveloper environment so that we can create a new View Object that contains our extended code. If you have not already got your JDeveloper environment setup then do so now, you can read how to at the Apps Tech Blog post “OAF – Downloading and Configuring JDeveloper”.  […]

Very Nice blog for the Beginners. Continue
blogging with some extensions and deployment

[…] this link if you want to see detail on how to setup your JDeveloper environment and connect to EBS https://keithturley.wordpress.com/2009/05/07/oaf-downloading-and-configuring-jdeveloper/ GA_googleAddAttr("AdOpt", "1"); GA_googleAddAttr("Origin", "other"); […]

hi………. this is siva………….. i am doing OAF……..please send the any martial of OAF and scripts (jsvnagakumar@gmail.com)


Awesome article……….. useful of basic OAF developers……
any one if you have OAF material please send this mail (jsvnagakumar@gmail.com)

Great article. Thanks.

Thanks its really helpful.

A motivating discussion is definitely worth comment.
There’s no doubt that that you ought to publish more about this subject, it may not be a taboo matter but typically people do not speak about these subjects. To the next! Best wishes!!

Your way of explaining the whole thing in this piece of writing is genuinely nice, every one be capable of simply know
it, Thanks a lot.

I have read some good stuff here. Definitely worth bookmarking for revisiting.
I surprise how much effort you set to create any such great
informative website.

Greetings, I am using JDeveloper 10g for EBS R12 OAF extension during the JDev setup when prompted with the migration question, I selected “Yes”; didn’t find this article until after the fact. Will this cause me any issues with extension? Can you explain what this migration does?

Hi Nicole,

The migration feature allows you to migrate all your settings and files from one version of JDeveloper to another. I am guessing you have had a previous installation of Oracle products on your machine. This won’t affect your development process moving forward it is a one off activity when you install a new version of JDev for OAF.

Where's The Comment Form?

  • May 2009
    M T W T F S S
    « Apr   Dec »

Liked it here?
Why not try sites on the blogroll...

%d bloggers like this: