eo extension in r12

http://oracleanil.blogspot.com/

EO Extension in R12 We are extending the EO to perform below tasks

1) Defaulting the EmployeeId automatically 2) Set default value for Hire Date 3) Hire Date should not be less than System Date 4) End Date is not less than System Date as well as Hire Date.

Task 1 & 2 When we are navigating from search page to create page employee number is not populating automatically and user enters the employee number manually so there are chances that user may get error of primary key violation.

We click on “About this page” link to check the EO associated with this page as we know defaulting of attributes is done in EOImpl.

We can see that page has QueryVO1 attached. Click on QueryVO1. Here we can see that it is based on FwkTbxEmployeesEO that we need to extend for defaulting employee number.


As we can see that FwkTbxEmployeesEO is present in oracle.apps.ak.solution.schema.server package hence we will copy the solution package from $JAVA_TOP and copy/ftp in myprojects/oracle/apps/ak folder as well as in myclasses/oracle/apps/ak folder. Create a new OA workspace as well as new Project. Now right click on your project and click on New

Select Entity Object under Business Tier ADF Business Components click OK


1. Give the name as ExtFwkTbxEmployeesEO and click on Browse for extends and select the original EO. Change the package name to oracle.apps.ak.ajay.schema.server.

2. In the Step 2 of 5: Attributes pane press the New from Table button to acquire the

attributes the EO will support. Shuttle all attributes in the Available pane to the Selected pane by pressing the >> button.

3. Locate the RowId attribute and remove it from the Available pane by selecting it and pressing the < button. If this is not done the existing view object will fail to work on the page.


4. Press the Next button 2 times to get to the Step 4 of 5: Java pane. Deselect the Accessors and Select the Create by clicking in the check boxes. Also select the ValidateEntity() by clicking in the check boxes. Remember that this extended EO will inhereit the Accessors from the parent. Use the parent code whenever possible. Press the Next button.

5. Do not generate the Default View Object. Leave this checkbox unchecked.


6. Press the Finish button to create the new Entity Object. NOTE: Remember, this action generates a fully functional Entity Object which functions exactly like the parent. Any changes should be added to this extended Entity Object by method overriding or overloading. After the new code is created and the substitution is in place, all changes will run as if they had been made to the parent class.

Now Edit the ExtFwkTbxEmployeesEOImpl and add the defaulting logic for EmployeeId as well as for Hire Date. For this we will override the Create method and set the EmployeeId based on sequence value from database. Here is the modified create method.


public void create(AttributeList attributeList) { super.create(attributeList); OADBTransaction dbt = getOADBTransaction(); Number empId = dbt.getSequenceValue("FWK_TBX_EMPLOYEES_S");

//FWK_TBX_EMPLOYEES_S is the sequence name existing in the database setEmployeeId(empId); setStartDate(dbt.getCurrentDBDate());

//Defaulting the Hire Date with Current system Date

} Task 3 & 4 are refers to check that Hire date and end date are not less than system date and end Date is not less than Hire Date For this we will override setStartDate, setEndDate and validateEntity() method Here are the final methods you need to copy to your ExtFwkTbxEmployeesEOImpl File import oracle.jbo.domain.Date; import oracle.apps.ak.solution.schema.server.FwkTbxEmployeesEOImpl; import oracle.apps.fnd.framework.OAAttrValException; import oracle.apps.fnd.framework.OAException; import oracle.apps.fnd.framework.OARowValException; import oracle.apps.fnd.framework.server.OADBTransaction; import oracle.apps.fnd.framework.server.OAEntityDefImpl; import oracle.jbo.AttributeList; import oracle.jbo.Key; import oracle.jbo.domain.Number; import oracle.jbo.server.EntityDefImpl; /**Overriding SetStartDate Method to validate hiredate should not be less than current date */ public void setStartDate(Date value){ validateStartDate(value); super.setStartDate(value); } public void validateStartDate(Date value){ if (value!=null){ long sysDate = getOADBTransaction().getCurrentDBDate().dateValue().getTime(); long dateValue = value.dateValue().getTime(); if (dateValue<sysDate){ throw new OAAttrValException(OAException.TYP_ENTITY_OBJECT, getEntityDef().getFullName(), getPrimaryKey(), "StartDate", value, "AK", "FWK_TBX_T_START_DATE_PAST"); } } }


/**Overriding setEndDate Method to validate enddate should not be less than current date & hiredate. */ public void setEndDate(Date value){ validateEndDate(value); super.setEndDate(value); } public void validateEndDate(Date value){ if (value!=null){ long sysDate = getOADBTransaction().getCurrentDBDate().dateValue().getTime(); long dateValue = value.dateValue().getTime(); if (dateValue<sysDate){ throw new OAAttrValException(OAException.TYP_ENTITY_OBJECT, getEntityDef().getFullName(), getPrimaryKey(), "EndDate", value, "AK", "FWK_TBX_T_END_DATE_PAST"); } } } /**Overriding validateEntity() Method to validate Enddate is not less than hiredate */ protected void validateEntity() { super.validateEntity(); Date startDate = getStartDate(); Date endDate = getEndDate(); if (endDate.dateValue().getTime()<startDate.dateValue().getTime()){ throw new OARowValException(OARowValException.TYP_ENTITY_OBJECT, getEntityDef().getFullName(), getPrimaryKey(), "AK", "FWK_TBX_T_START_END_BAD"); } } Now we need to perform the substitution so open project properties and go to Business Components Substitutions Select FwkTbxEmployeesEO in available list and Ext FwkTbxEmployeesEO in Substitute list and click on Add button.


Now we need to deploy the files from local to server. For this we will navigate to myclasses/oracle/apps/ak/ and zip up ajay folder and FTP it on $JAVA_TOP/oracle/apps/ak/ and unzip the folder there Now we need to run the jpximporter command. java oracle.jrad.tools.xml.importer.JPXImporter $JDEV_USER_HOME/myprojects/Extend.jpx -username apps -password apps -dbconnection "(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=xxx.xx.oracle.com)(PORT=1521))(CONNECT_DATA=(SID=1346)))" Now bounce the Apache and test your changes by running the page from application. Here is new create page now

You can see that Employee number is automatically generated and hire date is defaulted to current date as well. But right now our Employee Number is updateable so through personalization we will set its read only property to true at site level.


For this Click on Personalize page Complete View Expand All Click on personalize icon for messageTextInput: Number

Set “Read Only” property as true and click on Apply.


Here is your new page looks like with attribute level error thrown for Hire Date and End date less than Current Date.

Cheers.. ☺ AJ

eo extension in r12

Documents