Professional Documents
Culture Documents
August 2018 Using Oracle Composer in Oracle Fusion Talent Management
August 2018 Using Oracle Composer in Oracle Fusion Talent Management
August 2018
Introduction........................................................................................ 3
Editing a Page in Oracle Composer ................................................... 4
Manage Your Sandbox .................................................................. 4
Invoke Page Composer ................................................................. 4
Select Customization Layer ........................................................... 5
Select Design or Source View ....................................................... 5
Working with Shared Components................................................. 6
Customizing Dialog Boxes ............................................................. 6
Customization Examples ................................................................... 8
Adding Content to Page................................................................. 8
Add Hyperlink ..................................................................................... 9
Switch Region....................................................................................15
Rearrange Toolbar.............................................................................24
Reorder Tabs.....................................................................................25
Introduction
This white paper gives a high level overview of the concepts behind Oracle Composer and
presents a variety of tasks that a system administrator can perform on the Oracle Fusion
Talent Management suite of applications as of release 10. This paper also demonstrates how
to configure user interface (UI) display options using extensibility product attributes to address
your business requirements.
TABLE 1. GLOSSARY
TERM DEFINITION
3
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
4
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
5
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
6
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
3. In Design mode, invoke the dialog to trigger the creation. Switch back to Source mode to
access the dialog in the component navigator.
7
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Customization Examples
This white paper focuses on creating UI cosmetic changes. See the scenarios in this document f or the following
customizations.
• Add Hyperlink
• Add Report
• Switch Region
• Rearrange Toolbar
• Reorder Tabs
After you have selected a location, confirm that the selection is a valid container by referencing the
component navigator shown in Figure 7. If the highlighted component is not a valid container,
traverse the hierarchy to find a container that reflects your desired location.
8
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Add Hyperlink
Requirement: Add an external link to the Team Talent Overview page to provide reference materials to managers.
1. In Source view, select the region on the page where you would like the hyperlink to display.
2. Click the Add Content button. Select the Open action next to Components.
3. From the list of Components, click Add Hyperlink. A default hyperlink component will be
added into the selected region on the page.
9
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
4. Edit the Hyperlink dialog. Enter the URL in the Destination field and the display text in the
Text field. To force the hyperlinked page to open in a new tab, enter “_blank” in the Target
Frame field.
5. If required, modify the styling options in the Style tab. Select Apply to view changes in the
page. In the following example, we have modified the font size, font color, and background
color.
6. To test the page, select Design view from the View dropdown or exit from Composer.
10
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Requirement: Add Instructional text to the My Goals page to communicate goal setting policies to your workforce.
1. In Source view, select the region on the page where you would like the text to display.
Note: For the My Goals page, selecting the region displayed in Figure 12 allows you to add
text between the Goal Plan selector and the list of goals.
2. Select to add a component of type Text or, if you are familiar with HTML, HTML markup.
Depending on your selection, a default text box or HTML input region appears on the page.
3. If using a text box, switch view to Design mode. Click the Edit Text link in the Text
component to enter your instructional text, as shown in Figure 13.
4. Enter additional styling options by selecting the tools icon next to the Done Editing link.
5. Close the Composer dialog to view the text as an end user will see it.
11
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
6. If using HTML markup, switch view to Design mode. Click the tool icon in the HTML
markup component, as shown in Figure 15.
7. In the HTML markup dialog, enter instructions in HTML in the Value field. Use inline styles
to define font, size, color and other options.
8. Apply the changes. Exit composer to view the page with the additional instructional text.
Add Report
Requirement: Add an OTBI report to My Team Goals that highlights workers with goals at risk .
1. In Source view, select the region on the page where you would like the report to display.
Note : For the My Team Goals page, selecting the region displayed in Figure 18 will allow you
to add the report below My Team Goals header.
12
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
2. Click the Add Content link in the Composer menu to open the dialog for selecting Resource
Catalog components.
3. Select an existing OTBI report from the Reports and Analytics folder hierarchy.
4. Click the Add link and the report will appear on the My Team Goals page as shown in Figure
21.
13
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
5. To configure the appearance of the embedded report, select it in the Composer and click the
Edit link. Set style and other properties using the Component Properties dialog shown in
Figure 22.
6. Exit composer to view the page with the styled report container.
14
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
3.
Figure 24: Text Styling Options
4. Switch to Design mode to view the changes. In the example in Figure 25, we changed the font
color and font size.
Switch Region
Requirement: Switch the layout of regions on the Talent Review Meeting page.
1. Select the target region to locate source panelAccordion: pa1, as shown in Figure 26.
15
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
16
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
3. Click Apply to check the result, and click OK to confirm your changes.
Requirement: Make Category a required field on the Goal Management details page.
1. Select to edit the field Category.
2. Select the down arrow next to the Required attribute on Category and select Expression
Builder.
3. Remove the expression #{bindings.CategoryDisplay.hints.mandatory} in the text box and
replace it with the value “true”.
4. To include the required asterisk next to the label Category, select to edit the
panelLabelandMessage:Category component from the component navigator.
5. Select the checkbox on the Show Required attribute.
17
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
6. After applying these changes, confirm that the field Category has the required asterisk and
triggers an error if a category is not selected.
Note: Do not remove the delivered expression on system required goal fields, including start date, goal
plan, goal name, measurement name, and task name. Modification of the required property on these
fields may cause data integrity issues.
18
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
4. Select Segment Code and select the values for render, read only, or other desired attributes.
5. Select Apply, then select OK.
6. From the View menu, select Design to check both results.
19
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
4. Highlight the Manager Name from the component navigator and select Edit.
5. Check the Read Only property.
20
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Requirement: Modify the goal detail fields displayed when adding goals in the performance document.
1. Navigate to the Goals section of the performance document.
2. Select to configure the page in design mode. To access the Add Goal popup component,
select the region on the page shown in Figure 36.
3. In the component navigator, click Edit Task Flow for the second region listed below the top
node. To confirm the correct region, display the hover text over the region. The correct
region is “CreateGoal.jsff”.
4. If the popup details are not displayed, select to edit the popup region and change the Child
Creation to immediate.
5. Navigate using the component navigator to select elements on the dialog and edit the display
properties for those elements.
21
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Requirement: Remove rich text buttons to make the Rich Text Editor (RTE) less busy.
1. Navigate to the properties and page components by clicking the UI target entity. In the
Confirm Shared Component Edit dialog, click Edit.
2. Click Edit to open the Display Options of Component Properties dialog box.
22
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
3. In the Toolbox Layout field, enter the desired toolbox options. See all options in Table 2.
4. Click Apply to check the result.
Administrators have control over the layout of the toolbar using the built-in string commands shown
in Table 2. Select the commands to determine which are available in the UI.
COMMAND DEFINITION
all All the buttons the richTextEditor provides by default. Use "all" to ignore all other built-in strings
formatAll Bold, Italic, Underline, Superscript, Subscript, Strikethrough. Use "formatAll" to ignore these sub-
commands:
- "formatCommon": Bold, Italic, Underline
- "formatUncommon": Superscript, Subscript, Strikethrough
23
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
For custom toolbox content: when the RTE encounters a string in toolboxLayout that it does not
recognize, like “customToolbarXyz”, it will look for a facet of that name and render the content, if
available. In the future more facets may be added, thus, prefix your unique strings with “custom” to be
upgrade-safe.
The toolboxLayout attribute allows you to:
• Add as many custom toolbars as desired, for example
toolboxLayout="customToolbar1 all customToolbar2"
• Stack as many toolbars as desired, for example
toolboxLayout="all newline customToolbar newline customGroup"
• Show multiple rows of toolbars, for example
toolboxLayout="customToolbar1 newline all"
• Reorder the button groups, for example
toolboxLayout="format color mode stretch history font"
• Remove toolbar content that isn't desired, for example to not display date buttons:
toolboxLayout="font mode color format justify"
Rearrange Toolbar
3. Toolbar is highlighted in the Source view. Click Edit to open the Child Component Properties
dialog.
24
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
4. Deselect the Switcher of a particular widget to disable the view and select the up or down
arrows to reorder the components.
5. Click Apply to check the result.
Reorder Tabs
Requirements: Reorder the tabs of the Person Details page in Talent Review Meeting.
1. In Design view, select the marker in the Top Talent box, and then the Show Details button in
the Action toolbar.
2. Switch back to Source view and select the UI Show Details button.
3. In the Confirm Shared Component Edit dialog, click Edit.
25
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
4. In the Source view, scroll to dialog: Details: Susan Copeland and click open the following
node region [Edit Task Flow] hyperlink.
5. Select the node panelTabbed: above.
6. On the Component Properties dialog, you can select the ascending order of the tabs that
appear below General.
7. Click Apply to check the result.
26
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
8. Switch to the Design view, select the marker in the Top Talent box, and then click Show
Details.
27
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
4. Highlight individual menu items or the menu group and select Edit. At the group level, you
can reorder the menu items or unselect the Display checkbox on the Child Component tab.
5. Edit the properties of individual menu items as well, including unselecting the Visible
checkbox to hide the menu item.
Note: There is conditional logic to set the Show Component property for each menu item.
Use caution when modifying the expression on this property, as it may result in UI behavior
that is inconsistent with profile settings.
28
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Requirement: Increase the number of characters that are displayed on job description.
1. Highlight job description on the Career Development page in either Design or Source mode
and select to edit the component.
2. Enter the text length at which you desire truncation in the Truncate At property and save your
changes.
3. Exit from Composer to see the truncation change on the job description display.
29
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
30
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Oracle Composer provides a control for resetting a Taskflow to its original state. The Reset Task Flow
button removes all administration extensibilities, regardless of who last updated it, or when it was
done.
31
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Requirement: Disable the add button in the performance document Goal section for workers only.
1. Navigate to a Performance Document in either the Manager or the worker Self Evaluation
task.
2. In Design view, select to edit the component properties of the Add button on the Goals
section of the document.
3. Open the Expression Builder dialog for the Disabled property on the page.
4. Enter the following expression: #{pageFlowScope.pRoleTypeCode ==’WORKER’}. This
expression will evaluate to true when a performance document is being accessed by a worker.
The Add button will continue to display, but will be shown disabled, as in the following
figure.
5. To hide the Add button, apply a similar expression to the property Visible. For the visible
property, create an expression that evaluates to false when the performance document is
32
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Note: There are many seeded expressions on the Attachment component’s properties. Do
not modify seeded expressions.
3. Scroll down to the Read Only property and select to edit using the Expression Builder.
4. Enter the following expression: #{pageFlowScope.pTaskCode ne 'MGREVAL'}.
5. Test your expression by navigating to the document in different tasks. When the document is
in Manager Evaluation, the attachment plus sign appears.
When the document is on a different task, the Attachment plus sign is not available.
Requirement: When a goal is categorized with a specific value, require users to enter success criteria.
33
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Customization supports setting the properties of one component based on the value of another
component on the page. Values of different page components are exposed as binding parameters in
the Expression Builder dialog.
Note: The value of the binding parameter reflects the value retrieved at the time the page was
invoked. If the user changes the value on the page, the new value will not be reflected.
1. Navigate to the goal details page and in Source mode, select to edit Success Criteria.
2. Navigate to Expression Builder for the property Read Only.
3. Choose the value Category from the list of Binding Parameters. This value will be copied into
the Expression Builder text box.
4. Select the option to Type a value or expression, as shown in Figure 59.
Requirement: Make the Success Criteria and Comments attributes on goals read-only based on the type user.
In this example, we will make Success Criteria read-only and Comments attribute editable for workers
editing their own goals. If the goal is accessed by someone other than the worker, we will make Success
Criteria attribute editable and Comments attribute read-only.
Success Criteria and Comments attributes of a goal can only be edited on the detailed view of a goal.
The detailed view of a goal is shared between different page flows used by different roles. The worker
flow always starts on the worker’s My Goals page. The page flow scope parameter pParentFlow can be
used to determine if the flow originated on My Goals page.
1. Navigate to the goal details page and in Source mode, select to edit Success Criteria. Navigate
to Expression Builder for the property Read Only and enter the following expression:
#{pageFlowScope.pParentFlow == ‘WORKER_HOME’}
When this expression evaluates to true, which is the case for the worker, the Success Criteria
appears as read-only to the user.
2. Select to edit Comments and, using Expression Builder for the property Read Only, enter the
following expression: #{pageFlowScope.pParentFlow ne ‘WORKER_HOME’}
34
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
This expression evaluates to true for managers and HR and makes the Comments attributes
read-only for them.
3. Test your changes by exiting out of Composer for worker and manager users.
35
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
Conclusion
Oracle Composer enables system administrators to configure UI display options to suit their
company's needs. It offers flexibility and extensibility to a large extent through modifying a page layout,
editing task flow components, and changing objects on a page, and the like. Oracle Fusion applications
provide key features, such as transportability and upgrade-safe customizations, through the capabilities
of various composers in the Extensibility Framework.
36
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
GOAL Goals
OS Overall Summary
QUESTIONNAIRE Questionnaire
37
Using Oracle Composer to Modify Display Options in Oracle Fusion Talent Management
organization goal
pGoalEditMode Identifies if page is being CREATE_GOAL Goal page is being displayed for
rendered for the addition of new goal.
a new goal or to edit an
EDIT_GOAL Goal page is being displayed to
existing goal
edit an existing goal
38
Using Oracle Composer to Copyright © 2015, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only and the
Modify Display Options in contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
Oracle Fusion Talent Management warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability
August 2018 or fitness for a particular purpose. We specifically disclaim any liability with respect to this document and no contractual obligations
Author: Rondi Mertes are formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any
Contributing Authors: Santosh Kumar, Ashoka means, electronic or mechanical, for any purpose, without our prior written permission.
Shetty, Surlina Yin
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective
Oracle Corporation
owners.
World Headquarters
500 Oracle Parkway
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under licens e
Redwood Shores, CA 94065
and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo
U.S.A.
are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark licensed through X/Open
Worldwide Inquiries: Company, Ltd. 0112
Phone: +1.650.506.7000
Fax: +1.650.506.7200