Download - OA Personalization
-
7/27/2019 OA Personalization
1/36
OA Personalization
Table of Contents
1 Personlaizations ................................................................................................................... 32 Profile Options ...................................................................................................................... 33 Peronalization Levels .......................................................................................................... 34 Personalization Icons .......................................................................................................... 55 Personalization Features and Properties .......................................................................... 6
5.1 Rendered65.2 Hiding a Region......................85.3 Required......................85.4 Read Only10
5.5 Prompt..105.6 Maximum Length......................105.7 Tip Message......................115.8 Initial Value........................135.9 Enabling DFF..15
6 Creation of Items ..................................................................... Error! Bookmark not defined.06.1 Button...206.2 Message Check Box..226.3 Separator.236.4 Flex...246.5 Url Include286.6 Static Styles Text296.7 Link306.8 Message Styled Text.326.9 Message Text Input336.10 Raw Text..34
7 Reorder..358 Functional Administrator Responsibility Functions.36
-
7/27/2019 OA Personalization
2/36
Version 1.0 Page 2
1. Personalization
OA Personalization Framework allows you to personalize your user interface (UI) of Oracle Self-Service Web Applications without modifying any underlying code.
Following are some common types of personalizations you can accomplish with OAPersonalization Framework:
Change the prompt for a field or other text on a page Hide or show a field on a page Make the fields mandatory and non mandatory Reorder fields or items on a page Restrict data that a user can access Add new buttons, links, text items, images, etc. (Creation of Items)
2. Profile Options:
S. No Profile Option Level Purpose
1 Disable Self-service Personal Site Level orApplication Level
Disables all thepersonalizationsmade
2 Personalize Self Service Defn User or Site GlobalPersonalizationbutton on every pagewill appear to do thenecessary
personalization3 FND: Personalization Region
Link EnabledUser or Site Personalization link
appears at everyregion on the selfservice page
3. Personalization Levels
There are different Levels available at which the Personalizations can be made are
Function Custom/Seeded Site Organization and Responsibility Level
-
7/27/2019 OA Personalization
3/36
Version 1.0 Page 3
Function Level:
You can create personalizations for a region at the Function level, such that the personalizations arevisible only when you display the region by selecting a specific function. For Example, suppose you have
an updatable region and you want that region to be updatable when accessed from FunctionA in themenu, but to be read-only when accessed from FunctionB in the menu. To accomplish this, you create aFunction level personalization that makes all the fields read-only for FunctionB. You can have only oneset of personalizations per region per function.
Site Level:
A site refers to an installation of Oracle Self-Service Web Applications. Personalizations that you make atthe site level affect all users of the current installation.
Organization Level:
Depending on the context you choose, an Organization can be a plant, a unit, a department, a division
within a company or even a complete company (BG). Personalizations that you make at the Organizationlevel affect all users of that Organization.
Responsibility Level:
When you make personalizations at the responsibility level for a specific responsibility, the changes areeffective only for the users of that responsibility.
-
7/27/2019 OA Personalization
4/36
Version 1.0 Page 4
4. Personalization Icons
Launches a focused version of the Page Hierarchy Personalization page, for the selected region.
To Reorder the Fields
To Create a New Item
To delete the Items
Choose the Context levels to where exactly the personalizations have to be made
You can either Activate, Inactivate, or Delete existing personalizations at the requiredlevels
http://matrixde.ashokleyland.com:8000/OA_HTML/OA.jsp?page=/oracle/apps/fnd/framework/personalization/webui/ChooseContextPG&retainAM=Y&addBreadCrumb=S&PERZ=Y&bypass=y&pg=/oracle/apps/per/selfservice/personalinformation/webui/OverviewPG.BasicDetailsOverview&if=HR_PERINFO_SS&il=IN&is=0&io=101&ir=50123&ia=800&iu=1151&te=OA.jsp?akRegionCode=HR_OVERVIEW_TOP_SS&akRegionApplicationId=800&OAFunc=HR_PERINFO_SS&transactionid=1992477755&retainAM=Y&addBreadCrumb=N&oas=Hz-VJYL6Ybllra3zo2tVZQ..&PersonalizationParam=PersonalizationParamAdmin&pv=CLS&OAIG=11249&_ti=1992477755&oapc=10&oas=LuSqqbwv6YJxxIsmsE50pw..http://matrixde.ashokleyland.com:8000/OA_HTML/OA.jsp?page=/oracle/apps/fnd/framework/personalization/webui/ChooseContextPG&retainAM=Y&addBreadCrumb=S&PERZ=Y&bypass=y&pg=/oracle/apps/per/selfservice/personalinformation/webui/OverviewPG.BasicDetailsOverview&if=HR_PERINFO_SS&il=IN&is=0&io=101&ir=50123&ia=800&iu=1151&te=OA.jsp?akRegionCode=HR_OVERVIEW_TOP_SS&akRegionApplicationId=800&OAFunc=HR_PERINFO_SS&transactionid=1992477755&retainAM=Y&addBreadCrumb=N&oas=Hz-VJYL6Ybllra3zo2tVZQ..&PersonalizationParam=PersonalizationParamAdmin&pv=CLS&OAIG=11249&_ti=1992477755&oapc=10&oas=LuSqqbwv6YJxxIsmsE50pw..http://matrixde.ashokleyland.com:8000/OA_HTML/OA.jsp?page=/oracle/apps/fnd/framework/personalization/webui/ChooseContextPG&retainAM=Y&addBreadCrumb=S&PERZ=Y&bypass=y&pg=/oracle/apps/per/selfservice/personalinformation/webui/OverviewPG.BasicDetailsOverview&if=HR_PERINFO_SS&il=IN&is=0&io=101&ir=50123&ia=800&iu=1151&te=OA.jsp?akRegionCode=HR_OVERVIEW_TOP_SS&akRegionApplicationId=800&OAFunc=HR_PERINFO_SS&transactionid=1992477755&retainAM=Y&addBreadCrumb=N&oas=Hz-VJYL6Ybllra3zo2tVZQ..&PersonalizationParam=PersonalizationParamAdmin&pv=CLS&OAIG=11249&_ti=1992477755&oapc=10&oas=LuSqqbwv6YJxxIsmsE50pw..http://matrixde.ashokleyland.com:8000/OA_HTML/OA.jsp?page=/oracle/apps/fnd/framework/personalization/webui/ChooseContextPG&retainAM=Y&addBreadCrumb=S&PERZ=Y&bypass=y&pg=/oracle/apps/per/selfservice/personalinformation/webui/OverviewPG.BasicDetailsOverview&if=HR_PERINFO_SS&il=IN&is=0&io=101&ir=50123&ia=800&iu=1151&te=OA.jsp?akRegionCode=HR_OVERVIEW_TOP_SS&akRegionApplicationId=800&OAFunc=HR_PERINFO_SS&transactionid=1992477755&retainAM=Y&addBreadCrumb=N&oas=Hz-VJYL6Ybllra3zo2tVZQ..&PersonalizationParam=PersonalizationParamAdmin&pv=CLS&OAIG=11249&_ti=1992477755&oapc=10&oas=LuSqqbwv6YJxxIsmsE50pw..http://matrixde.ashokleyland.com:8000/OA_HTML/OA.jsp?page=/oracle/apps/fnd/framework/personalization/webui/ChooseContextPG&retainAM=Y&addBreadCrumb=S&PERZ=Y&bypass=y&pg=/oracle/apps/per/selfservice/personalinformation/webui/OverviewPG.BasicDetailsOverview&if=HR_PERINFO_SS&il=IN&is=0&io=101&ir=50123&ia=800&iu=1151&te=OA.jsp?akRegionCode=HR_OVERVIEW_TOP_SS&akRegionApplicationId=800&OAFunc=HR_PERINFO_SS&transactionid=1992477755&retainAM=Y&addBreadCrumb=N&oas=Hz-VJYL6Ybllra3zo2tVZQ..&PersonalizationParam=PersonalizationParamAdmin&pv=CLS&OAIG=11249&_ti=1992477755&oapc=10&oas=LuSqqbwv6YJxxIsmsE50pw..http://matrixde.ashokleyland.com:8000/OA_HTML/OA.jsp?page=/oracle/apps/fnd/framework/personalization/webui/ChooseContextPG&retainAM=Y&addBreadCrumb=S&PERZ=Y&bypass=y&pg=/oracle/apps/per/selfservice/personalinformation/webui/OverviewPG.BasicDetailsOverview&if=HR_PERINFO_SS&il=IN&is=0&io=101&ir=50123&ia=800&iu=1151&te=OA.jsp?akRegionCode=HR_OVERVIEW_TOP_SS&akRegionApplicationId=800&OAFunc=HR_PERINFO_SS&transactionid=1992477755&retainAM=Y&addBreadCrumb=N&oas=Hz-VJYL6Ybllra3zo2tVZQ..&PersonalizationParam=PersonalizationParamAdmin&pv=CLS&OAIG=11249&_ti=1992477755&oapc=10&oas=LuSqqbwv6YJxxIsmsE50pw.. -
7/27/2019 OA Personalization
5/36
Version 1.0 Page 5
5. Personalization Features/Properties:
5.1 Rendered:
We can eitherenable or disable a field using Rendered optionSelect the value from the poplist which generally displays Inherit, true, false and SPEL.
For Example: To disable Alias field click on Personalize Name
Select the Pen icon and disable the field in Self Service Page
Select the Value from the Poplist.The poplist generally displays the choices Inherit, true, false, and SPEL,
-
7/27/2019 OA Personalization
6/36
Version 1.0 Page 6
And also select the levels where you want to personalize the field
Once you click on Apply, it takes you to the main personalization pageSo now click on Return to Application
Alias field is no more visible in this region.
5.2 Hiding a Region
-
7/27/2019 OA Personalization
7/36
Version 1.0 Page 7
To hide the region select the region you want to hide
For Eg: to hide OTHERClick on Personalize Other
Click on Personalize Default Single Column Basic Details
-
7/27/2019 OA Personalization
8/36
Version 1.0 Page 8
The region is hided.
5.3 Required
Similarly to make the field mandatory or non mandatory select the values from the Poplist
You will find a *which indicates mandatory and the field to be entered
5.4 Read Only
-
7/27/2019 OA Personalization
9/36
Version 1.0 Page 9
To make to non updatable select read only
5.5 Prompt
To change the prompt
5.6 Maximum Length
Example: To set the Maximum Length of Proxy Name, click on personalize page
The Maximum Length of Proxy Name is 30 characters.Gave the value 2 characters at the function level
So the user can enter only 2 characters.
5.7 Tip Message:
To add additional instructional text for users in the form of tips.
-
7/27/2019 OA Personalization
10/36
Version 1.0 Page 10
Select Application Developer Responsibility -> Application -> Messages -> Add a New Message
Select Tip Type as longMessage from the Poplist
Select the Message Name which we have created in the Message form through Application DeveloperResponsibility
-
7/27/2019 OA Personalization
11/36
Version 1.0 Page 11
Apply
5.8 Initial Value
To specify a default value. Incase if it is a free field you can directly give the default value.Note: This does not work in all cases if you want to default a value for a free field
Prerequisite:
-
7/27/2019 OA Personalization
12/36
Version 1.0 Page 12
Set the Profile Option FND:OA:Enable Defaults to Yes
To default a value from a List of Values
For Example: To default the Title as Mr
Query the Lookup
Select the code from the of Mr.
Go to Personalization page
-
7/27/2019 OA Personalization
13/36
Version 1.0 Page 13
Select the Add Blank Value as False
And in Initial Value paste the code of Mr.
Apply
The value is defaulted.
5.9 Enabling DFF
Select a particular region and search for the flex
-
7/27/2019 OA Personalization
14/36
Version 1.0 Page 14
Click on Personalize Page
Search for the required flex
-
7/27/2019 OA Personalization
15/36
Version 1.0 Page 15
Change the value for the Rendered to True at the required Level and click on apply and return toapplication.
Now you can see the segments in the DFF displayed:
If you want enable only some segments in DFF then go toPersonalize Page-> Search for the Required Flex-> Click on the Pencil -> In the Segment List Enter theCode of the structure and the required segments in that structure of the DFFExample: For Further Contact R'ship Information in the segment list we need to enter IN|GuardianName|Guardian Birth Date
Descriptive Flex Field:
-
7/27/2019 OA Personalization
16/36
Version 1.0 Page 16
Click on apply and return to application: Now you can see only two segments of DFF displayed:
If you want to display segments only in Read only mode then go to Personalize Page-> Search for theRequired Flex-> Click on the Pencil -> In the Segment list for the required segment add ($RO$)
Example: IN|Guardian Name($RO$)|Guardian Birth Date
-
7/27/2019 OA Personalization
17/36
Version 1.0 Page 17
Click on apply button and return to application:Now the Guardian Name will be in read only Mode
-
7/27/2019 OA Personalization
18/36
Version 1.0 Page 18
6. Creation of Items
6.1 Create Button
A button item style creates a push button, which allows the user to trigger some action in response to aclick. The button fires an "onclick" event when it is activated
-
7/27/2019 OA Personalization
19/36
Version 1.0 Page 19
Enter Component Id: ButtonEnter URL : javascript:void window.open("http://www.oracle.com")(in order to display this in a new page)Apply
Click on the Button and it opens the url
-
7/27/2019 OA Personalization
20/36
Version 1.0 Page 20
6.2 Message Check Box
The Message Check Box item style is a combination of the checkBox and inlineMessage controls.
-
7/27/2019 OA Personalization
21/36
Version 1.0 Page 21
Enter Component Id : Message Check BoxPrompt : Message Check Box
Initial Value : YApply
6.3 Separator
The separator item style creates a horizontal separator. A dotted line appears on the screen.
Enter Component Id : SeparatorApply
-
7/27/2019 OA Personalization
22/36
Version 1.0 Page 22
6.4 Creating Flex
If we want to create any Flex in the web page first we need to see whether that DFF exists in that Webpage or not:
To Check the DFF in the Web pages click on About this page hyperlink which will on the left downcorner of the webpage:
-
7/27/2019 OA Personalization
23/36
Version 1.0 Page 23
Check for the available flex fields in the Flex field Reference
Copy the item name of the required flex and go the page definition and click on the Expand ALL
Search for the VO for the required flex field. Search (CTRL TAB+ F TAB) and paste the copied item nameand click on the find next
-
7/27/2019 OA Personalization
24/36
Version 1.0 Page 24
Copy the VO Against the required flex item:
Click on Return to page Hyperlink which is on left corner of the page :
Click on the Personalize page at required level :
Click on Create item :Select the level as function LevelAnd item style as Flex
Enter the Value for ID : Flex1In the Appl Short Name field : PER (For Human Resources)In the Name field : Enter the DFF NameIn the Prompt Field : Enter the Prompt Name for Flex item
In Read only Field : Select False from LOVIn the Rendered field : Select True from LOVIn the View Instance : Copy the VO copied against the flex item
-
7/27/2019 OA Personalization
25/36
Version 1.0 Page 25
Click on Apply .In the personalization structure you can find the flex created .
Click on Return to application Hyperlink:
You can see the segment displayed on the webpage:
-
7/27/2019 OA Personalization
26/36
Version 1.0 Page 26
6.5 URL include
-
7/27/2019 OA Personalization
27/36
Version 1.0 Page 27
The urlInclude item style allows you to includes HTML content loaded from an external source under theparent region.
Enter Component Id : Urlinclude
Source URI : Enter the urlApply
6.6 Create Static Styled Text
Text that is for display only and not for editing purposes
-
7/27/2019 OA Personalization
28/36
Version 1.0 Page 28
Enter Component Id : SSTPrompt : This is for your informationMessage Name : FULL NameApply
This includes the prompt and the message name
6.7 Create Link
Enter Component Id : LinkDestination URL : Give the urlApply
-
7/27/2019 OA Personalization
29/36
Version 1.0 Page 29
The link item style creates an HTML link tag.
When you click on the Link, it takes you to the tag
-
7/27/2019 OA Personalization
30/36
Version 1.0 Page 30
6.8 Create Message Styled Text
-
7/27/2019 OA Personalization
31/36
Version 1.0 Page 31
A text field that can be updated and have a default value.
Enter Component Id : MessStyledText
Destination URL : This is your personal informationApply
6.9 Message Text Input
The Message Text Input item style is a Text Input field.
-
7/27/2019 OA Personalization
32/36
Version 1.0 Page 32
Enter Component Id : HobbiesPrompt : HobbiesApply
Enables a free field to enter the information
6.10 Create Raw Text
The raw text style allows you to enter HTML tags to display text in bold.
Enter Component Id : Raw Text
-
7/27/2019 OA Personalization
33/36
Version 1.0 Page 33
Prompt : Please enter your hobbiesText : Enter your hobbiesApply
7 Reorder
You can reorder the items either for a particular region or at the page level at different levels.
-
7/27/2019 OA Personalization
34/36
Version 1.0 Page 34
8. Functional Administrator Responsibilty Functions:
You can use this responsibility incase if you come across any errors while doing thepersonalizations. Using this responsibility you can either deactivate or delete personalizations
-
7/27/2019 OA Personalization
35/36
Version 1.0 Page 35
Select the Document Name of the particular page where you are getting an error and go to
Go to Functional Administrator Responsibility -> Select Personalizations Tab
In Application : Select Human Resources from the List of Values
And in the Document Path give the document name of the particular page where you are gettingan error
Click on Manage Personalizations and it takes you to that particular page where you have done thepersonalizations
-
7/27/2019 OA Personalization
36/36
Shows you the levels where you have done the personalizations.So either delete or deactivate and retest the same.