In this chapter we will cover:
Getting started with personalizations
Setting the personalization profile options
Discovering information about a page
Clearing the cache
Creating a user-level personalization
Adding tool tips
Creating an item
Re-ordering items on a page
Adding a button to a page
Hiding a button on a page
Making a field required
Adding a flexfield to a page
Using SPEL to trigger personalizations
Deactivating personalizations
Deleting personalizations
OA Framework pages have been implemented using an object-oriented design approach that allows us to be pretty flexible when it comes to making changes to the user interface. The objects that we see on each page are made up of smaller objects that are stored independently in a repository called Meta Data Service (MDS).
In this chapter, we will discuss how to make changes to the user interface through personalization. When we personalize a page, we are altering the declaration of a page's interface. At runtime, objects are loaded from the repository and are rendered in a browser. What we see is determined by the metadata definition, which specifies how objects are displayed on the page. We can create a personalization at multiple levels such as site, function, organization, or responsibility. The good thing is that they can be configured directly from the UI page and are likely to survive an upgrade, as opposed to extensions. One thing you cannot modify with personalizations is the business logic.
At the end of this chapter, readers will have an understanding of how we can personalize OA Framework pages in EBS. Readers will understand which responsibilities are used to administer personalizations and which profile options need to be changed to view the personalization links. Throughout this chapter, we will be creating a variety of different examples that will give a broad understanding of what we can achieve through personalizing OA Framework pages.
It is important that we understand some common terminology and gain an understanding of how an OA Framework page is constructed before we get started. Let's start off by understanding that OA Framework has been developed by Oracle and is based upon a Model View Controller (MVC) architecture developed using Java 2 Platform, Enterprise Edition (J2EE).
Model: A model can be thought of as the data and is implemented using Oracle Business Components for Java (BC4J). This comprises three layers, which are the entity object (EO), view object (VO), and application module (AM).
Entity object: This is based upon a database table and all of the database transactions will go through the EO.
View object: This is based upon any number of entity objects or it can be an SQL statement, if the page is read only.
Application module: This is a container for the view object and it manages transactions that occur. Each page has a root AM to maintain the transaction context.
View: A view defines a user interface that is rendered as an HTML page. This is implemented with user interface XML (UIX).
Controller: A controller is java code that handles events when they occur at runtime. There are two methods that are called when the page runs.
In this recipe, we are going to set up some records that we will use throughout the chapter. We are going to demonstrate our personalizations in the manager self-service screens. We will need to perform the following tasks before we get started with personalizing OA Framework pages:
Creating a custom responsibility
Creating a new user
Creating an employee record
Assigning a manager
Attaching an employee to a user record
Now to create our new responsibility that we will use to access core HR screens, we will create a test employee record and ensure that the employee is a manager of other employees. This will be used to access some of the self-service screens where we will create some personalizations in the upcoming recipes.
Perform the following steps to create a new responsibility called XX Test HRMS Manager:
Log in to Oracle E-Business with the System Administrator responsibility.
Navigate to Security | Responsibility | Define and the Responsibilities window will open.
Enter the required data as given in the following table:
Item name
Item value
Responsibility Name
XX Test HRMS ManagerApplication
Human ResourcesResponsibility Key
XXTESTHRMSMGRDescription
XX Test HRMS ManagerData Group
Name
StandardApplication
Human ResourcesMenu
GLB HRMS NavigatorRequest Group
Name
HR Reports and ProcessesClick on the Save button in the toolbar (or press Ctrl + S) to save the record.
The Responsibilities screen should now appear as shown in the following screenshot:
Now create a test manager self-service responsibility.
Click on the new record icon.
Enter the required data as given in the following table:
Item name
Item value
Responsibility Name
XX Test Manager Self-ServiceApplication
Human ResourcesResponsibility Key
XXTESTMGRSSDescription
XX Test Manager Self-ServiceData Group
Name
StandardApplication
Human ResourcesMenu
Manager Self ServiceRequest Group
Name
Click on the Save button in the toolbar (or press Ctrl + S) to save the record.
Exit the form.
We are going to create a user called XXUSER that we will use throughout the chapter for our personalizations. We will add the responsibilities, that we will use throughout the chapter. Also, the user will be assigned an employee record so that when we access the manager self-service screens, there is relevant data available for our personalizations that we are going to create.
To create the user, perform the following steps:
Log in to Oracle and select the System Administrator responsibility.
Navigate to Security | User | Define.
Enter
XXUSERin the User Name field.Enter a password in the Password field and press the Tab key.
Enter the password again and press the Tab key.
Set Password Expiration to None.
Navigate to the Direct Responsibilities tab.
Add the following responsibilities:
Application Developer
Functional Administrator
Manager Self-Service
System Administrator
XX Test HRMS Manager
XX Test Manager Self-Service
The Users screen should now appear as shown in the following screenshot:
Save the form.
Now we are going to create an employee called Employee Manager, which we will use throughout the chapter for our personalizations. As suggested by the name, this employee will be the manager of other employees.
To create the employee, perform the following steps:
Log in to Oracle with the
XX Test HRMS Managerresponsibility.Navigate to People | Enter and Maintain.
When the Find Person screen opens, click on the New button.
Enter the required data as given in the following table:
Item name
Item value
Last
ManagerFirst
EmployeeGender
Male (or Female)
Action
Create Employment
Person Type
EmployeeSocial Security
123123123Date of Birth
28-MAR-1970Update the Latest Start Date field to
01-JAN-1990.Save the record, and when prompted, click on the Correction button.
Click on OK, when prompted with the message The original hire date will be updated to be the same as the start date.
Make a note of the employee number that has been automatically generated.
Note
If the employee number has not been automatically generated, type one manually and save the record as a Correction.
The data entered should look similar to the following screenshot:
We are now going to update the assignment record of an existing employee so that the employee we have just created is the manager of an existing hierarchy and when we perform some personalizations, there is some data returned in the forms we are going to personalize.
To assign a manger, perform the following steps:
In the Enter and Maintain person screen, click on the Find Person (torch) icon in the toolbar.
Enter
1197for the employee number.Click on the Assignment button.
Enter our employee number in the Worker Number field. (The employee number is
2110for the employee that was created in the preceding recipe. It may be a different number on the environment you are using.)Tab out of the field and select the Correction button, if prompted.
The Name fields will automatically populate to Manager, Employee, and so on (our test employee), when we tab out of the Worker Number field.
Save the form and close it.
We are going to associate the employee we have just created to our user called XXUSER. When we log in as the XXUSER responsibility, the self-service screen will display data on the screens appropriate to the employee record that we have associated with our user. As we have assigned our employee record as the manager of other employees, we will see the data of the employees in the screens we are going to access in manager self-service.
To create the user, perform the following steps:
Select the System Administrator responsibility.
Navigate to Security | User | Define.
Press the F11 key to enter a query.
Enter
XXUSERin the User Name field and press Ctrl + F11 to execute the query.In the Person field enter
ManagerandEmployee, and press the Tab button.Save the form.
There are three profile options that allow us to personalize self-service screens. The three profile options are as follows:
Personalize Self-Service Defn: When set to Yes, a Personalize Page link will appear at the top of each self-service page
F ND: Personalization Region Link Enabled: When set to Yes, a Personalize Region link will appear on each region of a self-service page
FND: Diagnostics: When set to Yes, an About this Page link will appear at the bottom of each self-service page
To set the three profile options, perform the following steps:
Log in to Oracle with
XXUSERand select the Functional Administrator responsibility.Navigate to Core Services | Profiles.
In the Name field of the Search screen, type
Personalize%.Click on the Go button.
You will see that the Personalize Self-Service Defn profile option value is set to No at site level, as shown in the following screenshot (circled):
We are now going to update the profile option to Yes at user level for the XXUSER user:
Click on the Update Value (pencil) icon.
Click on the User tab and click on the Add Another Row button:
In the User field, enter the name of our user,
XXUSER.Click on the Go button.
Click on the Quick Select icon for the Yes value as shown in the following screenshot:
When you are returned to the Profiles screen, click on the Update button and wait for the confirmation that the record has been saved.
Now navigate to Core Services | Profiles to return to the profiles screen.
We will now check to see if the value has been set. To do this, perform the following steps:
In the Name field of the Search screen, type
Personalize%.In the Access Levels region, enter
XXUSERin the User field.Click on the Go button.
The value we set for our user will be displayed as shown in the following screenshot. We can see that there is a Personalize Page link that has now appeared as a result of setting the profile option to Yes.
We are now going to set the values for the other two profiles options at user level in the same way.
Repeat these steps but this time set the FND: Personalization Region Link Enable profile option to Yes.
We can now see that the personalize region links are now displayed in the self-service page, as shown in the following screenshot:
We are now going to set the value of the FND: Diagnostics profile option at site level in the same way:
In the Name field of the Search region, enter
FND: Diagnostics.Click on the Go button.
Click on the Update Value (pencil) icon.
Under the Site tab, set the Site Value field to Yes.
Click the Update button and wait for the confirmation that the record has been saved.
Now navigate to Core Services | Profiles to return to the Profiles screen.
In the Name field of the Search screen, type
FND: Diagnostics.Click on the Go button.
We can now see that the About this Page link is now displayed in the self-service page, as shown in the following screenshot:
The About this Page link is used to find key information about the objects and the structure of the page. It is essential when we want to create personalizations and also if we need to extend a page.
To look at the information available on the About this Page link, perform the following steps:
Log in to Oracle with the
XXUSERand select the Functional Administrator responsibility.Navigate to Core Services | Profiles.
Scroll to the bottom of the page and select the About this Page link.
If we look at the page, we can identify some key information as shown in the following screenshot:
Click on the Expand All link and scroll down the page.
We can see the objects that are displayed on the page such as items and buttons. We can also see the view object used for the table, as shown in the following screenshot:
Now if we click on the FndProfileSearchVO link, we can see the following query behind the view object, as shown in the following screenshot:
When we make changes to a screen in self-service, the page is often stored in the cache. We might therefore not see the changes that we make on the screen. When this occurs, we will need to clear the cached page so that we will see the changes we have made to a page through personalization. We will need to clear the cache when we add some of the personalizations in the recipes in this chapter. When we are required to clear the cache, we can perform the following tasks.
To clear the cache, perform the following steps:
Log in to Oracle with
XXUSERand select the Functional Administrator responsibility.Navigate to Core Services | Caching Framework.
Click on the Global Configuration link from the left-hand side navigation pane.
In the Global Cache Configuration screen, click on the Clear All Cache button as shown in the following screenshot:
When prompted with the warning shown in the following screenshot, click on the Yes button:
We will now create a user-level personalization. This feature allows end users to save a search they commonly use. However, not all search pages have this feature.
To create a user-level personalization, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to Absence Management.
Click on the Advanced Search link as shown in the following screenshot:
In the Advanced Search screen, select the Show table data when any condition is met radio button.
Enter
Services-Westin the Department condition as shown in the following screenshot:
Click on the Save Search button.
In the View Name field shown in the following screenshot, enter
XXX Services-West Report:
In the Column Properties region, shift the Employee Number and Location columns to the Columns Displayed list.
Shift Employee Number up in the list so that it is just after the Name field.
In the Sort Settings region, set the First Sort column to Name.
Set Sort Order to ascending.
The steps performed here are summarized in the following screenshot:
Click on the Apply button.
We will now see the view, which we created in the list of personalized views, in the following screenshot:
Click on the Apply button and we will return to the Advanced Search region.
Click on the View button.
Select XXX Services-West Report and click on the Go button.
We can see that the view we created returns the records we would expect, given the restrictions we made.
A tool tip is used to add text to a screen to provide information about a region or item. In this recipe, we are going to add some tips to the screen. We will be adding a simple tool tip to a page and we will also add text that we retrieve from a message stored in the message repository. We will also show the difference between a short tip type and a long tip type. We will perform the following tasks in this recipe:
Adding a tool tip to a page
Creating new messages
Adding a short tip type
Adding a long message tip type
We are now going to add a tool tip to a page. It could relate to anything and really does depend on what we are trying to achieve. Common uses for tool tips are providing information about a region and instructions about an item on a page.
To add a tooltip, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to Absence Management.
Click on the Action icon.
Click on the Personalize Page link at the top-right corner of the page.
Click on the Complete View radio button.
Click on the Expand All link.
On the top line of the page (Page Layout: Oracle Self Service Human Resources: Absence Management), select the Create Item icon as shown in the following screenshot:
From the Level drop-down list, select Site.
Complete the properties of the item as per the following table:
Property
Value
ID
XX_ABS_TIPText
XX Absence Management region tip
Click on the Apply button.
Scroll down to the bottom of the application and click on the Return to Application link.
We can also use the message dictionary to use as a tip. This will allow us to modify the screen tip or merge data into the message, if required. We will now define two messages in Oracle EBS, which we will use to create a short tip and a long tip on a page. Each message, by default, displays this text before each message: APP:<application short name>-<Number> unless the number field is null or 0.
To create a message, perform the following steps:
Log in to Oracle with the Application Developer responsibility.
Navigate to Application | Messages and the Messages window will open.
Create a new message with the following data:
Item name
Item value
Name
XX_ABS_TYPE_STLanguage
USApplication
Application Object LibraryNumber
0Current Message Text
Absence Type Short TipSave the form.
Create the second message with the following data:
Item name
Item value
Name
XX_ABS_TYPE_LTLanguage
USApplication
Application Object LibraryNumber
0Current Message Text
This is a longer tip that may span multiple lines.Save and exit the form.
The form should appear as shown in the following screenshot (the image has been amended to remove blank lines):
We are now going to create a personalization that will add a short tip to a self-service screen. The short tip called XX_ABS_TYPE_ST will reference the message that we have just created.
To add a short tooltip on an item, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to Absence Management.
Click on the Action item.
Under the Absence Summary tab, click on the Personalize Search link in the Search region.
Click on the Personalize icon for the Message Choice: Absence Type item.
Click on the Choose Levels Displayed button.
Shift all of the items other than Site and Responsibility back to the Available Levels side as summarized in the following screenshot:
Click on the Apply button.
Set Tip Message Name at responsibility level of XX_ABS_TYPE_ST.
Set Tip Type at the Responsibility level to shortTip as shown in the following screenshot:
Click on the Apply button.
Click on the Return to Application link.
We are now going to create a personalization that will add a long tip to a self-service screen. The short tip will reference the message we have just created called XX_ABS_TYPE_LT. We will see the difference between the tips we have created and how they are displayed on the screen.
To add a long tool tip on an item, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to Home | Absence Management.
Click on the Action icon for an employee record.
Under the Absence Summary tab, click on the Personalize "Search" link in the Search region.
Click on the Personalize icon for the Message Choice: Absence Type item.
Click on the Choose Levels Displayed button.
Shift all of the items other than Site and Responsibility back to the Available Levels side.
Click on the Apply button.
Set Tip Message Name to the responsibility level XX_ABS_TYPE_LT.
Set Tip Type to the responsibility level longMessage, as shown in the following screenshot:
Click on the Apply button.
Okay, in this recipe we are going to add an item to a screen. We can add an item to a screen without extending a page as long as the field exists in the view object of the region we are extending. A view object will nearly always contain many more data items than are visible on the screen. To find out the items that are in the view object, we need to do a little bit of investigation into the view object. Once we have checked the available items, we can personalize the page to make the items visible on the screen. We can also order the items in the region we are displaying them.
To add an item to a page, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to Home | Personal Information.
Click on the Action icon for an employee record.
We are going to add a new item to the Basic Details region. This item will specify the employee original start date after the Full Name field.
However, before we add the item, we need to find out some information about the page as we need to know the view object that is used by the Basic Details region and the name of the attribute for the original start date item.
Scroll down to the bottom of the page and click on the About this Page link.
Then, click on the Expand All link.
Scroll down until you see the details for the Basic Details region.
We can see that the view object for this region is BasicDetailsCurrentVO.
Scroll down and expand the Business Component References Details section.
Click on oracle.apps.per.selfservice.personalinformation.server.BasicDetai lsCurrentVO for the basic details view object.
If we look at the attributes returned by the view object, we will notice that the original start date field is called OriginalDateOfHire:
Now that we have the information about the item we want to add, we can create the item through personalization:
Scroll to the bottom of the page and click on the Return to About Page link.
Scroll down to the bottom of the next page and click on the Return to Page: Personal Information link.
In the Personal Information page, click on the Personalize "Basic Details" link.
In the Personalize Region: Basic Details screen, click on the Create Item icon for the Default Single Column: Basic Details object as shown in the following screenshot:
From the Item Style list, select MessageStyledText to add a display only field.
Set the values of the following properties:
Property
Value
ID
XXOrigHireDatePrompt
Orig. Hire DateView Attribute
OriginalDateOfHireView Instance
BasicDetailsCurrentVOClick on the Apply button.
We will now re-order the items in the region and we will also set the CSS Class property of the item so that the font matches the other items in the region.
To re-order items in a region, perform the following steps:
Navigate to Home | XX Test Manager Self-Service | Personal Information.
Click on the Action icon.
Click on the Personalize "Basic Details" link.
Click on the Complete View radio button.
Click on the Expand All link.
For the Default Single Column: Basic Details object, click on the Reorder icon, as shown in the following screenshot:
In the Function table, click on the up arrow icon until the Orig. Hire Date field is in the desired location, as shown in the following screenshot:
Click on the Apply button.
Click on the Update Item icon for the Message Styled Text: Orig. Hire Date field, as shown in the following screenshot:
Set the CSS Class property to OraDataText.
Click on the Apply button.
Click on the Return to Application link.
We are now going to add a button to a page that is going to link to a website when the button is clicked. The link will go to the Google Search page, but this link could easily be a link to a new page that we have created.
To add a button to the Basic Details page, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to Home | Personal Information.
Click on the Action icon.
Click on the Personalize "Basic Details" link.
Click on the Complete View radio button.
Click on the Expand All link.
In the Personalize Region: Basic Details screen, click on the Create Item icon for Default Single Column: Basic Details as shown in the following screenshot:
In the Create Item page, select Button from the Item Style drop-down list.
Complete the details of the following property items as per the table:
Property
Value
ID
XX_BasicDetails_BtnDestination URI
http://google.comPrompt
GoogleClick on the Apply button.
Click on the Return to Application link.
We have now created a button in the Basic Details region. The button will open the URL that we have entered in the Destination URI property. We can see this in the following screenshot:
Okay, well what if we want to go to another OA Framework page? We can do this too. We will now update the button to call another OA Framework page, but first we must gather some information to get the URL of the page we want to navigate to. Let's get the information for the My Employee Information page:
Navigate to Home | My Employee Information.
Click on the About this Page link.
Click on the Page Context tab.
Click on the Expand All link.
Scroll down to the (JSP) My Employee Information line.
Note
You will notice that the page has lots of information on it. Now that we have clicked on the Expand All link, a quick way to find the information we require would be to bring up the browser search page facility and search for the name of the page we want the information for as shown in the following screenshot. To activate the search facility in a browser window, press CTRL + F. We can then type in the characters we want to search for. We can use this to help speed up our fact finding as often there is a lot of information on a page we need to sift through. In this example, we can see that the My Employee Information page has a function of
HR_MGR_VIEWS_SSand a destination URL ofOA.jsp?page=/oracle/apps/per/selfservice/mgrviews/webui/ManagerViewsPG&OAFunc=HR_MGR_VIEWS_SS.
Navigate back to Home | Personal Information.
Click on the Action icon.
Click on the Personalize "Basic Details" link.
Click on the Complete View radio button.
Click on the Expand All link.
In the Personalize Region: Basic Details screen, click on the Update Item icon for the Button: Google item we created earlier, as shown in the following screenshot:
Update the details of the following property items as per the table:
Property
Value
Destination Function
HR_MGR_VIEWS_SSDestination URI
OA.jsp?page=/oracle/apps/per/selfservice/mgrviews/webui/ManagerViewsPG&OAFunc=HR_MGR_VIEWS_SSPrompt
My Employee InfoClick on the Apply button.
Click on the Return to Application link.
You should now have opened the My Employee Information page as shown in the following screenshot:
To perform this recipe, we will use the button created in the Adding a button to a page recipe.
Now, we are going to show how we can hide a button. We are going to show the button on the page for our custom responsibility, but hide it for other users. We can do this by setting the Rendered property of the button to False at the Site level and set it to True at the Responsibility level for our custom responsibility.
To hide a button on a page, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to Home | Personal Information.
Click on the Action icon.
Click on the Personalize "Basic Details" link.
Click on the Complete View radio button.
Click on the Personalize icon for the Button: My Personal Info object.
Click on the Choose Levels Displayed button.
Shift all levels other than the Site and Responsibility levels to the left-hand side as shown in the following screenshot:
Click on the Apply button.
Set the Rendered property at the Responsibility level to True:
Navigate to the Home page.
Change the responsibility to Manager Self-Service.
Navigate to the Personal Information page.
Click on the Action icon.
We can also change the Required property of an item to make users enter data. At this stage, you should be getting the idea about changing properties of items and getting a feel for what can be achieved. To gain a better understanding, it would be a good idea to investigate what properties can be changed and what effect it has on the item. Next, we will make a field required.
To make a field required on a page, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to Home | Personal Information.
Click on the Action icon.
In the Basic Details region, click on the Update button.
Select the Correct or complete the current details radio box and click on Next.
Click on the Personalize "Basic Details" link.
Click on the Complete View radio button.
Click on the Expand All link.
Press Ctrl + F to bring up the search facility on the browser.
Type in
Firstand scroll down to Message Text Input: First Name (which will be highlighted from the find).Click on the Personalize icon for the First Name field.
Click on the Choose Levels Displayed button.
Shift all levels other than the Site and Responsibility levels to the left-hand side.
Click on the Apply button.
Set the Required property at the Responsibility level to true as shown in the following screenshot:
Click on Apply.
Click on the Return to Application link.
In this recipe, we are going to show how we can create a descriptive flexfield (DFF) and then display the flexfield on the screen. Again, we need to gather some information about the page and find out if a flexfield is available for a particular region. We will then configure a segment on the DFF and show how we can display it on the screen.
To add a flexfield to a page, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to the Absence Management page.
Click on the Action icon for an employee record.
Click on the Create Absence button and the Enter Absence Details screen will open as shown in the following screenshot:
Scroll down to the bottom of the page and click on the About this Page link.
Scroll down to the Flexfield References section and we will see what flexfields are available on this screen.
The following screenshot shows us that the PER_ABSENCE_ATTENDANCES flexfield is available:
Now, we have the flexfield name and we can add a descriptive flexfield segment to the flexfield. First, we will get the title of the Additional Absence Information DFF. To do this, perform the following steps:
Log in to Oracle with the Application Developer responsibility.
Navigate to Flexfield | Descriptive | Register and the Descriptive Flexfields window will open.
Press the F11 key to enter a query and enter
PER_ABSENCE_ATTENDANCESin the Name field.Press CTRL + F11 to execute the query and the following record should be returned.
We can see that the PER_ABSENCE_ATTENDANCES flexfield is returned from the query. Make a note of the flexfield title Additional Absence Details.
Exit the Descriptive Flexfields screen and navigate to Flexfield | Descriptive | Segments and the Descriptive Flexfields Segments window will open.
Press F11 to enter a query.
When in ENTER-QUERY mode, type
Additional Absence Detailsin the Title field and press Ctrl + F11 to execute the query.If the Freeze Flexfield Definition checkbox is checked, uncheck it.
Click on OK when the warning message appears.
Click on the Segments button for the Global Data Elements record.
The steps taken are summarized in the following screenshot:
Now, we can create a new DFF segment for the Global Data Elements context as performed in the following steps:
Enter the following data in the Segments Summary screen:
Property
Value
Number
45Name
Test DFFWindow Prompt
Test DFFColumn
ATTRIBUTE20Value Set
Displayed
checked
Required
checked
Click on the Open button.
Enter the following data:
Property
Value
Name
Test DFFDescription
Test DFFEnabled
checked
Displayed
checked
Required
unchecked
Display Size
10Description Size
10Concatenated Description Size
25List of Values
Test DFFWindow
Test DFFWhen you change the Display Size field, click on OK when the warning appears.
Click on Save.
Close the Segments screen.
Close the Segments Summary screen.
Check the Freeze Flexfield Definition checkbox to recompile the flexfield definition.
Click on OK when the warning appears.
Click on Save and OK when a note message appears.
Exit the form.
Now that we have created a DFF segment, we are going to show the flexfield in the Create Absence screen. To do this, perform the following steps:
Change responsibility to the XX Test Manager Self-Service responsibility.
Navigate to the Absence Management page.
Click the Action icon for an employee record.
Click on the Create Absence button.
Click on the Personalize Page link.
Click on the Complete View radio button.
Click on the Expand All link.
Press Ctrl + F to bring up the search facility on the browser.
Type in
Additionaland scroll down to the Flex: Additional Absence Details record (which will be highlighted from the find).Click on the Personalize icon for the Flex: Additional Absence Details field.
The steps are summarized in the following screenshot:
Click on the Choose Levels Displayed button.
Shift all of the items other than Site back to the Available Levels side.
Click on the Apply button.
Set the Rendered at Site level to true.
Click on the Apply button.
Scroll to the bottom of the page and click on the Return to Application link.
SPEL stands for Simplest Possible Expression Language. A SPEL statement will return a Boolean value of either True or False and can be used for conditionally setting a property of an item on a page.
In this recipe, we are going to use SPEL to set the properties of an item. We are going to set the Read Only property based on a SPEL statement. If the SPEL statement returns True, the item will be made read only to the user.
To set properties using SPEL, perform the following steps:
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to the Absence Management page.
Click on the Action icon for an employee record.
Click on the Create Absence button.
Click on the Personalize Page link.
Click on the Complete View radio button.
Click on the Expand All link.
Press Ctrl + F to bring up the search facility on the browser.
Type in
Commentsand scroll down to the Message Text Input: Absence Comments record (which will be highlighted from the find).Click on the Personalize icon.
Click on the Choose Levels Displayed button.
Shift all of the items other than Site and Responsibility back to the Available Levels side.
Click on the Apply button.
Set the Read Only property at the Responsibility level to SPEL.
Set the Responsibility level for the SPEL statement to ${oa.FunctionSecurity.XXABSREADONLY}, as shown in the following screenshot:
Click on the Apply button.
Scroll down to the bottom of the page and click on the Return to Application link.
We are now going to create a function that we will add to a menu.
To create a function, perform the following steps:
Log in to Oracle with
XXUSERand select the Application Developer responsibility.Navigate to Application | Function.
Create a function with the following details:
Item name
Item value
Function
XXABSREADONLYUser Function Name
XX Absence Read OnlyDescription
XX Absence Read OnlyType
SubfunctionThe function will be displayed as shown in the following screenshot:
Save the record and dismiss the confirmation message.
We will now add a function to a menu attached to the XX Test Manager Self Service responsibility. The function will be present in the menu, which will mean that the SPEL statement will return True.
To add a function to a menu, perform the following steps:
Log in to Oracle with
XXUSERand select the Application Developer responsibility.Navigate to Application | Menu.
Query back the Manager Self Service menu.
Add the function XXABSREADONLY to the menu with the following details:
Item name
Item value
Seq
200Function
XX Absence Read OnlySave the menu and dismiss the confirmation message to compile the menu.
We can see that the function has now been added to the menu as shown in the following screenshot:
In this recipe, we will show how we can deactivate personalizations.
Log in to Oracle with
XXUSERand select the XX Test Manager Self-Service responsibility.Navigate to Absence Management.
Click on the Action icon for an employee record.
Click on the Create Absence button.
We can see our personalization that adds the flexfield as shown in the following screenshot. But we now want to deactivate this personalization.
Click on the Personalize Page link.
Click on the Manage Levels button, as shown in the following screenshot:
In the resulting page, check the Site level checkbox.
Click on the Deactivate button, as shown in the following screenshot:
You can see that the personalization has now been deactivated:
Scroll down to the bottom of the page and click on the Return to Personalization Structure link.
Scroll down to the bottom of the page and click on the Return to Application link.
In this recipe, we will discover how we can delete personalizations. We have created personalizations in the personal information screen. We are going to show how we can find the regions belonging to the personal information pages and how we can delete them from the Functional Administrator responsibility.
To delete personalizations, perform the following steps:
Log in to Oracle with
XXUSERand select the Functional Administrator responsibility.Navigate to Personalization | Application Catalog.
In the Document Path field, enter the following path of the personal information page from the Creating an item recipe discussed earlier in this chapter.
/oracle/apps/per/selfservice/personalinformation/Click on the Manage Personlizations icon for OverviewPG.
A summary of the steps is shown in the following screenshot:
Check the Select checkboxes of the personalizations we want to delete.
Click on the Delete Personalizations button as shown in the following screenshot:
Click on the Yes button to confirm the deletion as shown in the following screenshot:
