Apps To Fusion

The objective of this training lesson is to quickly show you how to Extend a Controller in OA Framework.
The basis of this article will be the HelloWorld OA Framework Example. This demonstration has been built using 11.5.10 CU2.
But this should work with any other version of OA Framework.

How will we demonstrate this?
a. We will create a Text Field named HelloWorldField in "OA Framework Page"
b. Using processRequest of the Controller, we will default "Hello not Extended Anil" to HelloWorldField
c. Next we will extend the controller, and assign "Hello Extended Anil" to the field HelloWorldField
Note: You must noe default values in field in this manner, when the field belongs to a VO


Assumptions:-
You have already implemented the Oracle delivered HelloWorld Example.

Follow the below Steps ( Some steps are a repeat of helloWorld tutorial from Oracle).
But this demo will use a cut-down version of helloWorld.
Estimated time:- 15minutes for this exercise.
Step 1. Create a New OA Workspace and a new OA Project and name it anything you desire.
    Package name can be oracle.apps.ak.hello

Also, attach dbc file, and a apps username/password that has responsibility FWK_TBX_TUTORIAL
Step 2. Add a new "OA Page"  named "textExtendCOPage" to the Project in package oracle.apps.ak.hello.webui
    Make sure its property AM Definition is oracle.apps.fnd.framework.server.OAApplicationModule
    Change its id to textExtendCOPage and ensure its of type pageLayout
    Also assign it any window tile  and title in its properties
Step 3. Add a region of type messageComponentLayout. Name it MainRNExt
    The Region Style will be messageComponentLayout
Step 4. Add a field HelloNameField to MainRNExt
The field will be of type messageTextInput. Give it a prompt of "TestPrompt"
Note:- We do not need a Go/Submit button for this demo.
Step 5. Rightclick on MainRNExt to add a new Controller to the region.
Make sure its package is oracle.apps.ak.hello.webui
Name of the controller will be MyTestCO

Step 5. Open the controller java file, which is MyTestCO.java
Make the following changes as highlighted
import oracle.apps.fnd.framework.webui.beans.message.OAMessageTextInputBean;

  public void processRequest(OAPageContext pageContext, OAWebBean webBean)
  {
    super.processRequest(pageContext, webBean);
    OAMessageTextInputBean fieldHelloName =
      (OAMessageTextInputBean)webBean.findChildRecursive("HelloNameField");
    fieldHelloName.setText(pageContext,"Hello not Extended Anil");   
  }
Build and Run the XML Page, the result will be as below



Now, the extension of OA Framework Controller
Extension Step 1. Rightclick on Project and create new
Name of the Class: extendedHelloCO
Package : oracle.apps.ak.extendCO
Extends: oracle.apps.ak.hello.webui.MyTestCO

Extension Step 2. Add the highlighted lines to extendedHelloCO.java
package oracle.apps.ak.extendCO;
import oracle.apps.ak.hello.webui.MyTestCO;
import oracle.apps.fnd.common.VersionInfo;
import oracle.apps.fnd.framework.webui.OAControllerImpl;
import oracle.apps.fnd.framework.webui.OAPageContext;
import oracle.apps.fnd.framework.webui.beans.OAWebBean;
import oracle.apps.fnd.framework.webui.beans.message.OAMessageTextInputBean;
import oracle.apps.fnd.framework.webui.beans.OAImageBean ;


public class extendedHelloCO extends MyTestCO
{
  public void processRequest(OAPageContext pageContext, OAWebBean webBean)
  {
    super.processRequest(pageContext, webBean);
    OAMessageTextInputBean fieldHelloName =
      (OAMessageTextInputBean)webBean.findChildRecursive("HelloNameField");
    fieldHelloName.setText(pageContext,"Hello Extended Anil");   
  }
}

Extension Step 3. Ensure that personalization is turned on for your username.
This can be done by setting profile "Personalize Self-Service Defn" to Yes
Run the XML page, you will still see "Hello Not Extended Anil"
Click on Personalize Page link on right handside top corner.

Select "Complete View" and "Expand All" Option in personalization page.
Click personalize icon for "Message Component Layout: (MainRNExt)"
Set the controller to "oracle.apps.ak.extendCO.extendedHelloCO" at Site level.

Click on Apply, and then click onReturn to Application.

Extension Step 4. Rebuild project in jDev and run page again.
You will now find that your extension has taken effect.



This completes the exercise for the extension of a Controller in OA Framework [OAF].

< Prev		Next >