24221030 enhance oracle sshr with advanced personalizations and oa fwk extensions
TRANSCRIPT
![Page 1: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/1.jpg)
Enhance Oracle SSHR with Enhance Oracle SSHR with
Advanced Personalizations and Advanced Personalizations and
OA FWK ExtensionsOA FWK ExtensionsRamesh Sannegowda
02-Mar-2007SEOUC 2007
![Page 2: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/2.jpg)
OverviewOverview
• Overview
– Personalizations/Extensions, What’s the difference?
– Where are personalizations/page meta data stored
– Add new items to a page/region
– Identify available fields via ‘About page’
![Page 3: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/3.jpg)
Overview cont..Overview cont..
• Overview cont…
– SPEL language for dynamic personalizations
– Using JDR utilities
– Custom Look & Feel (CLAF)
– Extending Business Components
– Deploying extensions
![Page 4: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/4.jpg)
Personalizations/ExtensionsPersonalizations/Extensions
• Difference between personalizations and extensions
– Personalizations
• Declaratively alter the UI to meet user/business need
– Change Label, Show/Hide fields etc.
– Extensions
• Programmatically extend application functionality
– Add business logic, Add new fields etc.
![Page 5: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/5.jpg)
Personalizations/ExtensionsPersonalizations/Extensions
• Difference between personalizations and extensions contd..
– OAF components: Declarative and Programmatic
• Declarative/UIX (page metadata): XML
• Programmatic: Java
– Personalizations
• Global Personalize link
• Region/Item level personalize link
– Extensions
• JDeveloper with OA FWK extensions available as patch on Metalink
![Page 6: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/6.jpg)
PersonalizationsPersonalizations
• Where are personalizations/page meta data stored?
– Source files
• $PROD_TOP/mds/selfservice/<function>/webui
– Seeded personalizations
• $PROD_TOP/mds/selfservice/<function>/webui/customizations
– Database MDS repository (user personalizations)
• JDR_PATH
• JDR_COMPONENTS
• JDR_ATTRIBUTES
![Page 7: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/7.jpg)
PersonalizationsPersonalizations
• Adding new items to page/region
![Page 8: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/8.jpg)
PersonalizationsPersonalizations
• Adding additional items to page/region
![Page 9: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/9.jpg)
PersonalizationsPersonalizations
• Adding additional items to page/region
OA.jsp?akRegionCode=
HR_PROCESS_PEOPLE_TOP_SS
&akRegionApplicationId=800
&language_code=US
&pDestination=HR_ACTIONS_SS&pCalledFrom=
&retainAM=Y&addBreadCrumb=Y
&pPersonId={!PersonId}
![Page 10: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/10.jpg)
PersonalizationsPersonalizations
• Adding additional items to page/region
![Page 11: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/11.jpg)
PersonalizationsPersonalizations
• Identify available fields via ‘About Page’
![Page 12: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/12.jpg)
PersonalizationsPersonalizations
• Identifying available fields via About page
![Page 13: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/13.jpg)
PersonalizationsPersonalizations
• Identifying available fields via About page
![Page 14: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/14.jpg)
PersonalizationsPersonalizations
• Identifying available fields via About page
![Page 15: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/15.jpg)
PersonalizationsPersonalizations
• Add new Region
![Page 16: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/16.jpg)
PersonalizationsPersonalizations
• Add new Region
![Page 17: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/17.jpg)
PersonalizationsPersonalizations
• Dynamic personalizations– SPEL language
• Simplest Possible Expression Language
• Used to set (true/false, yes/no)– Read Only
– Rendered
– Required
– Disabled
• ${oa.<viewObject>.<viewAttr>}, ${oa.function.<functionName>}, ${oa.FunctionSecurity.<FunctionName>}
![Page 18: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/18.jpg)
PersonalizationsPersonalizations
• Dynamic personalizations (example)– Step 1: Create a function with a name that describes the rule
you want to implement. For example, assume you have a text field whose Read Only property should be True if the user DOES NOT have access to the MANAGER_READ_ONLY function when logged in using the MANAGER responsibility.
– Step 2: Create a grant for this function. In this example, we would create a function grant for MANAGER_READ_ONLY in the context of the responsibility MANAGER.
– Step 3: Set the Read Only property using the following SPEL syntax:${oa.FunctionSecurity.<FunctionName>}
![Page 19: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/19.jpg)
PersonalizationsPersonalizations
• Dynamic personalizations (example contd..)
– The test will return False if <FunctionName> is granted to the current user/responsibility, otherwise True.
– In this example, we would set the Read Only property to: ${oa.FunctionSecurity.MANAGER_READ_ONLY}
– If the user is logged in to the MANAGER responsibility and has been granted access to this function, the OA Framework returns False in the function security test. When the Read Only property is set to False, the item is updateable.
![Page 20: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/20.jpg)
PersonalizationsPersonalizations
• SPEL binding
![Page 21: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/21.jpg)
Maintain PersonalizationsMaintain Personalizations
• Maintain personalizations using JDR utilities– jdr_utils.listcustomizations– jdr_utils.printdocument– jdr_utils.listcontents– jdr_utils.deletedocument
• Examples– jdr_utils.listcustomizations('/oracle/apps/per/selfservice/commo
n/server/customizations/site/0/AsgSummaryVO');– jdr_utils.printdocument('/oracle/apps/per/selfservice/common/s
erver/customizations/site/0/AsgSummaryVO');– jdr_utils.deletedocument('/oracle/apps/per/selfservice/common
/server/customizations/site/0/AsgSummaryVO');– jdr_utils.listcontents('/oracle/apps/per/selfservice/personalinfor
mation/webui/customizations/site/0');
![Page 22: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/22.jpg)
Custom Look & Feel (CLAF)Custom Look & Feel (CLAF)
• Components of LAF
– Style Sheets (XSS)
– Icons
– Renderers (.uit)
• Create Custom LAF using
– Base LAF
– Simple LAF
– Another Custom LAF
![Page 23: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/23.jpg)
Custom Look & Feel (CLAF)Custom Look & Feel (CLAF)
• Style Sheets
– Control Font and Color of HTML components
• OA_HTML/cabo/styles/<ClafId.xss>
• Icons
– Control LAF of Web Beans
• Renderers
– Controls how Web Beans lay out children and generate HTML
– Defined declaratively (.uit extension)
• OA_HTML/cabo/templates/ClafID/ClafId.uit
![Page 24: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/24.jpg)
Custom Look & Feel (CLAF)Custom Look & Feel (CLAF)
• CLAF User Interface
![Page 25: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/25.jpg)
Custom Look & Feel (CLAF)Custom Look & Feel (CLAF)
• CLAF User Interface
![Page 26: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/26.jpg)
Custom Look & Feel (CLAF)Custom Look & Feel (CLAF)
• CLAF User Interface
![Page 27: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/27.jpg)
Custom Look & Feel (CLAF)Custom Look & Feel (CLAF)
• CLAF User Interface
![Page 28: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/28.jpg)
Custom Look & Feel (CLAF)Custom Look & Feel (CLAF)
• Adding custom renderers
– Edit $OA_HTML/cabo/lafs/ClafId.xml
<renderer name="pageLayout">
<template name="pageLayout.uit">
</template>
</renderer>
![Page 29: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/29.jpg)
Custom Look & Feel (CLAF)Custom Look & Feel (CLAF)
![Page 30: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/30.jpg)
Custom Look & Feel (CLAF)Custom Look & Feel (CLAF)
![Page 31: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/31.jpg)
ExtensionsExtensions
• Extend VO to add new columns
– Used to add new fields to a page using personalizations
• Extend VO to smart filter LOVs, Picklists
• Extend EO to add validation
• Avoid extending CO code
![Page 32: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/32.jpg)
ExtensionsExtensions
• Extend EO/VO
– Review ‘About this Page’ for the page/region that you want to add new fields
– Determine the VO that you will be extending
– Import the package that contains the VO into your JDeveloper project
– Create new VOEx by extending the seeded VO
– Add new attribute to the VOEx
– Substitute seeded VO with VOEx in the JPX file
– Use JPXIMPORT.bat to import the JPX file to database
![Page 33: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/33.jpg)
ExtensionsExtensions
• Extend EO/VO
![Page 34: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/34.jpg)
ExtensionsExtensions
• Extend EO/VO
![Page 35: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/35.jpg)
ExtensionsExtensions
• Extend EO/VO
![Page 36: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/36.jpg)
ExtensionsExtensions
• Adding validation to enforce business rules
![Page 37: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/37.jpg)
ExtensionsExtensions
• Adding validation to enforce business rules
![Page 38: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/38.jpg)
ExtensionsExtensions
• Adding validation to enforce business rules
![Page 39: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/39.jpg)
ExtensionsExtensions
• Deploying Extensions
– Do not replace the original object
– Extend and Substitute
– Move all the files and directories in your custom package to the middle tier
– Run JpxImport utility to migrate the substitutions
– Bounce Apache
![Page 40: 24221030 Enhance Oracle Sshr With Advanced Personalizations And Oa Fwk Extensions](https://reader031.vdocuments.net/reader031/viewer/2022013121/55906c131a28ab5a488b46e0/html5/thumbnails/40.jpg)