iSalesOrderDetailsOAF Implementation

Author: Sudhakar Jeedipalli

Task 1: Setup your environment for your OAF development

Create the new workspace

The Directory Name ...jdevhome\jdev\myprojects is default. So, you only need confirmthat it is set as expected.

Enter the File Name and Default Package as per the standards.

Attach the DBC File Name of the particular database connection you are using for this project. Enter the Application User Name, Password, Application Shrot Name and Responsibilty Key attached to your application login.

Task 2: Create the Model-layer components

Create the BC4J Package for your Application Module (AM)Every OA Framework page has to have a connection to the E-Business Suite database. The BC4J component that holds the connection and transaction is called an Application Module (AM). Before creating AM, you have to create the …server BC4J package which will contain the both AMs as well as VOs only. So, you have to create the AM within this package.

Click OK and then Save the Project

Create the Application Module (AM)

Currently you have not defined any View Objects (VOs); so, there are no VOs available to add tothe AM at this time. So, click Finish button and then Save the Project.

Within your newly created Application Module SalesOrderQueryAM two files will be generated they are,SalesOrderQueryAM.xml – the declarative (XML-based) components of the AMSalesOrderQueryAMImpl.java – the programmatic (Java-based) components of the AM

Within your newly created BC4J Package two more files will be generated they are,bc4j.xcfg – the XML configuration which lists all the BC4J Componentsserver.xml – the declarative (XML-based) components of the server

NOTE:While you only need an EO on an OA Framework page if that page is going to do an Insert, Update, or Delete i.e., DML Operations. Before creating EO, you have to create the …schema.server BC4J package which will contain the EOs only. So, you have to create the EO within this package

" We are creating an EO in this excercise, because we are going to create a simple Search or Query Page which don't require any DML operations."

Create your View Object (VO)According to Oracle Applications Development standards and just good programming practice, your VO should include only the attributes (columns) that are going to appear in the UI. So, you will create a VO, linked to your previously created EO, which includes just a few of the columns from the table.

The VO and AM will share the same BC4J package. So, you have to create the VO within the AM’s BC4J package.

Enter the SQL query for serach items and test the query.

Click OK and then click Next > button

· Deselect the SalesOrderQueryVOImpl: Generate Java File checkbox.· Select the SalesOrderQueryVORowImpl: Generate Java File and its Accessors checkboxes as part of adhering to Oracle Applications Development standards that allow extensibility.

Click the Finish button and then Save the Project

Add your VO to your AMAll VOs must be contained within an AM. In this exercise, your AM is SalesOrderQueryAM. You need to add the SalesOrderQueryVO to your SalesOrderQueryAM.

Select SalesOrderQueryVO from the Available View Objects pane, and shuttle it to the Data Modelpane. Notice that when shuttled, SalesOrderQueryVO becomes SalesOrderQueryVO1. This is expected behavior. You are taking the VO from just a definition to a instance of that definition.

We need to setup as shown above in Properties category because while not critical at this point, itis part of enabling Passivation on an OA Framework Page. Once the setup is done click theApply and OK buttons respectively, finally save your work.

Note: All AMs should be set this way

Task 3: Create the View-layer ComponentsFirst you have to create the …webui BC4J package to hold the OA Page components.

Create your page (PG)

Make sure the Page is creating in ...webui Package

Create your Query RegionA very common process on OA Framework pages within the E-Business Suite is a Query page. This is so common that a special UI object, the Query bean, has been created to handle task. A query bean consists of two regions, the Query region and the Results table.

Save your Project.

Create your Results Table Region

Change the Style property to messageStyledText for all the items.

Set the following properties:Search Allowed: TrueSelective Search Criteria: TrueUser Personalization: True

In the same way select the remaining columns in the Structure panel, and using the Property Inspector, set the following properties:Search Allowed: True (If the column is a Search item)Selective Search Criteria: True (If the column is a Search item)User Personalization: True

You can change the Company logo (Here I have taken the SANMINA Logo) by setting Image URI property of the corporateBrandingImage with the .gif image path as shown above.

Note: All the .gif images should be located in the path \jdevhome\jdev\myhtml\OA_MEDIA

Set your project’s Run Options

Shuttle OADiagnostics from Available Options to Selected Options using the > button and saveyour work.

Rebuild the SalesOrderDetails.jws file and make sure the Workspace compiled with No errors.

Run the SalesOrderQueryPG.xml file, then it will automatically instantiate the Embedded OC4J Server to open the OA Page in the browser.

Enter the OrderNumber and then click the Go button. We can see the Order Details shown above

Task 4: Add a List of Values (LOV) to QueryA reusable, sharable LOV has both Model-layer and View-layer components.

First create the …lov.server BC4J Package which hold the LOV Application Module (AM) and View Object (VO)

Create your LOV Application Module (AM)Related LOV View Objects (VO) should be grouped into a common Application Module (AM). For example, any LOV View Objects that you create for the SalesOrder application should be included in one Application Module (AM).

Create your LOV View Object

Add your VO to your AMView Objects can be used only within the context of a containing application module. Before you can use the OrderNumLovVO in your LOV, you must add it to the LOV Application Module OrderNumLovAM.

Task 5: Create your View-layer components for the LOVFirst create the …lov.webui BC4J Package for holding the LOV Region

Create your LOV Region

Attach the sanmina.oracle.apps.xxsan.oe.lov.server.OrderNumLovAM to the AM Definition Property.

Change the Region Style Property to listOfValues and Advance Search Allowed Property to True

Change the Scope Property to Public

Add a table to your LOV

Add a Simple Search Region to your QueryRN

Create an OrderNumber Search Item for your Query

Set the CSS Class property to OraField Text

Create Search Mappings for your workOA Framework uses the mappings that you define between your custom search items and columns in the ResultsTableRN to automatically handle the query when the user selects the Go button.

Modify your Existing Page to use the LOVChange the Item Style Property of the SearchOrderNum to messageLovInput and then attach the Order Number LOV path to the External Lov Property.

Click Yes button

Define your LOV MappingsCreate mappings between base page items and LOV items. The mappings identify the data input/output relationships between page items and LOV items.

Note: A Return Item is the attribute returned by the LOV. A Criteria Item is the attribute passed to the attribute passed to the LOV, and is the basis for the LOV’s query (Select).

Change the Construction Mode property of the QueryRN to autoCustomizationCriteria and make sure the following properties are set in the following way.

Include Simple Panel: TrueInclude Views Panel: TrueInclude Advanced Panel: TrueInitial Panel: simple

Change the Search Allowed and Selective Search Criteria properties of the OrderNumber to False.

Rebuild the Workspace and run the SalesOrderQueryPG.xml to see the modified OAF page with Torch light option i.e., LOV at the Order Num field.

Click the Torch Light option.

Select the Order Number and then click the Quick Select option. Then that Order Number will copied to the Order Num field in the main Page.

After the Order Num is populated, Click the Go button to get the Order details shown below.