Oracle Applications
Oracle Time and Labor
Configuring The Oracle Time and Labor Timecard User Interface
White Paper∗
Author(s): Oracle Time and Labor Development
Generation Date: June 7, 2012

Abstract

This document details the configuration options a timecard layout designer has when constructing a custom layout. OTL
currently allows customization of timecard layouts via modification of AOL loader files which are then loaded into the database.

c 2012 Oracle Corporation. All rights reserved.



∗
The document source is at: /hrdev/hxc/11.5/doc/whitepapers/hxcconfiguiwp.tex

1
 

Contributors
Name Position
Mark Stewart   Applications Developer
Andrew Rundell   Development Manager
Joel Dupont   Applications Developer
John Finnegan   Principle Functional Analyst
Kris Van Der Pleog   Functional Analyst
Anima Prasad   Group Manager
Balakrishna Bayragi   Senior Applications Engineer
Amarnath Krishnamoorthy   Senior Applications Engineer

Change Record 
Date Author Version Change Reference
February 1st, 2005 Andrew Rundell 115.0 Converted to PDF, WIKI, LaTeX
August 6th, 2007 Amritha Nuthi 115.1 Modified to indicate correct functionality for
package choice list
March 25th, 2008 Amritha Nuthi 115.2 Modified to show only the delivered seeded layouts and
to complete the missing lines in some examples
February 09th, 2010 Amarnath Krishnamoorthy 115.3 Reviewed the document and added few examples which describe
how to create custom choice list, LOV, prompts and text field
June 07th , 2012 Balakrishna Bayragi 115.4 Added section 3.18

Reference Documents
Name Description
Release 11i Documentation Oracle Applications Documentation - information on FNDLOAD
and Flexfields
ADF Applications Development Framework - information on java ob-
 jects, such as View Objects, Application Modules etc.

2
 

Contents
1 Introduction 8
1.1 Executive Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.2 Structure of a Timecard Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2.1 Time Building Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2.2 User Interface Component Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.3 Layout Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.4 Delivered Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.4.1 Payroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.4.2 Pro jects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.4.3 Pro jects and Payroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.4.4 Exception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4.5 Enterprise Asset Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4.6 Purchasing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4.7 Pro jects-Purchasing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.4.8 Payroll Layout delivered in Release 12.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.4.9 Project Layouts delivered in Release 12.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.4.10 Project and Payroll Layouts delivered in Release 12.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.5 Using the OAF Personalization Functionality With Timecard Configuration . . . . . . . . . . . . . . . . . . . . . . . . 19

2 Timecard Configuration Basics 20

2.1 What can be configured on a Timecard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.2 The Layout File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.3 Using an Existing Layout as a Basis for Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.4 Uploading Timecard Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.5 Labels and Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.5.1 Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.5.2 Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.6 Further Configuration Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.6.1 View Ob jects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.6.2 Application Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.6.3 Apache/JServ server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.7 Delivered Configurable BC4J Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.7.1 Configurable Choice List Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.7.2 Package Choice List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.7.3 Custom Alternate Name components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
2.8 LOVs and JRAD/MDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
2.8.1 LOV Custom Ob jects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

3 Examples of Common Customizations 29

3.1 Adding a Comment Field to the Timecard Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.2 Adding a Custom Choice List to the Timecard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.3 Adding a Custom LOV to the Timecard using the Custom LOV Objects . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.3.1 Create the supporting database view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.3.2 Add the LOV component to the timecard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.3.3 Personalize the LOV region . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.4 Adding a Custom LOV to the Timecard without using the Custom LOV Objects . . . . . . . . . . . . . . . . . . . . . 37
3.4.1 Create the View Object for the LOV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.4.2 Create AK attributes used for the LOV screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.4.3 Create an AK region for rendering the LOV screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
3.4.4 Create AK region items inside the AK region for the LOV page . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

3
 

3.4.5 Run the migration script to copy the LOV definition from AK to the MDS repository . . . . . . . . . . . . . . 42
3.4.6 Modify a layout to include the LOV component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.4.7 Include the new LOV View Object into your Apache/Jserv environment . . . . . . . . . . . . . . . . . . . . . . 43
3.5 Changing the title of the timecard page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
3.6 Changing the label for a column in the Timecard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
3.7 Adding a Component to the Timecard Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
3.7.1 Create AK data for the component prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.7.2 Create wrapper PL/SQL function to call the payroll code function and return it in the format needed for the
package choice list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.7.3 Create the component to show the label for our custom field and add it to the layout . . . . . . . . . . . . . . 52
3.7.4 Create the component to show the read-only function result and add it to the layout . . . . . . . . . . . . . . . 52
3.8 Adding a Component to the Timecard Matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
3.9 Adding an OTL Information Type to the Timecard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
3.10 Adding additional element input values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
3.11 Configuring the Cost Center component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
3.12 Adding OTLR Detail to the Review and Confirmation Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
3.12.1 Creating the Detail Time Building Blocks in the Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
3.13 Adding the Details Page DFF Segments to the Timecard matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
3.13.1 Setting the Attribute Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
3.13.2 Aliasing A Segment Value To Set The Attribute Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
3.13.3 The Simple Approach: An Always-execute choice list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
3.13.4 Other Segment Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
3.14 Configure Expenditure Type As Choice List Using Alternate Names in Projects Payroll Layout . . . . . . . . . . . . . 74
3.14.1 Define a New OTL Alternate Names Type Descriptive Flexfield Context / Segment: . . . . . . . . . . . . . . . 74
3.14.2 Mapping the Segments/Attributes to respective components: . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
3.14.3 Creating Alternate Name for the Alternate Name Type ET EXPENDITURE TYPES: . . . . . . . . . . . . . . 75
3.14.4 Create A Custom View and Define Layouts: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
3.15 Configuring Cost Center as a LOV in Payroll Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
3.15.1 Create AK attributes used for the LOV screen : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
3.15.2 Create an AK region for rendering the LOV screen: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
3.15.3 Create AK region items inside the AK region for the LOV page: . . . . . . . . . . . . . . . . . . . . . . . . . . 79
3.15.4 Migration of Ak Region to MDS Repository,Creation of Custom View and Define Layouts: . . . . . . . . . . . 80
3.16 Adding Custom LOVs, Custom Choice List and Text Field to a Payroll Layout . . . . . . . . . . . . . . . . . . . . . . 83
3.16.1 Create AK attributes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
3.16.2 Add Attributes to AK Region: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
3.16.3 Create database views: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
3.16.4 Create AK regions for rendering the LOVs: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
3.16.5 Create AK region items inside the AK region for the LOV page: . . . . . . . . . . . . . . . . . . . . . . . . . . 90
3.16.6 Setting up the Custom LOV xml and java files: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
3.16.7 Migration of Ak Region to MDS Repository: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
3.16.8 LDT file customization to change prompt from Hours Type to Job Type: . . . . . . . . . . . . . . . . . . . . . 95
3.16.9 LDT file customization to include choice list: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
3.16.10 LDT file customization to include source and destination LOVs: . . . . . . . . . . . . . . . . . . . . . . . . . . 97
3.16.11LDT file customization to include text field: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
3.17 Configure an Entry Level Processing Timecard Layout to capture Project, Task and Expenditure Type Information in
Cost Allocation Key Flexfield segments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
3.17.1 Create AK attributes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
3.17.2 Add Attributes to AK Region: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
3.17.3 Create database views: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
3.17.4 Add Project Id, Task Id and Expenditure Type segments to Cost Allocation KFF: . . . . . . . . . . . . . . . . 104
3.17.5 LDT file hxczzhxclayt0025.ldt customization to include JOB and LOCATION choice lists: . . . . . . . . . . . . 105

4
 

3.17.6 LDT file hxczzhxclayt0025.ldt customization to add Cost Center field: . . . . . . . . . . . . . . . . . . . . . . . 106
3.17.7 LDT file hxczzhxclayt0025.ldt customization to map Project Information to Cost Allocation KFF: . . . . . . . 107
3.17.8 Attributes data stored in database: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
3.17.9 Batch Element Entry form showing the additional segments in Cost Allocation KFF: . . . . . . . . . . . . . . . 113
3.18 Confirmation Check box on Timecard review page for Time Accuracy . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

4 Technical Reference Guide 116

4.1 Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
4.1.1 Global attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
4.1.2 Accrual Balance Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
4.1.3 Choice List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
4.1.4 Descriptive FlexField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
4.1.5 Display Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
4.1.6 Display Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
4.1.7 Display Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
4.1.8 Hidden Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
4.1.9 Hours Type Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
4.1.10 Inter-Period Navigation Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
4.1.11 Key Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
4.1.12 List Of Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
4.1.13 Message Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
4.1.14 Notification Day Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
4.1.15 Package Choice List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
4.1.16 Page Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
4.1.17 Spacer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
4.1.18 Submit Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
4.1.19 Submit Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
4.1.20 Summary Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.1.21 Table Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.1.22 Template Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.1.23 Text Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.1.24 Timecard Fragmentation Cluster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.1.25 Time Building Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.2 Tokens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.3 Seeded Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
4.3.1 HXC CUI TIMECARD Region . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
4.3.2 HXC CUI TIMECARD REVIEW Region . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
4.3.3 HXC CUI TIMECARD CONFIRMATION Region . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
4.4 Seeded Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
4.5 CUI Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

5 Troubleshooting and Frequently Asked Questions 138

5.1 FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

5
 

List of Tables
1 Payroll Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2 Pro jects Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3 Pro jects and Payroll Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4 Exception Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5 Enterprise Asset Management Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
6 Purchasing Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
7 Pro jects-Purchasing Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
8 R12.1 Payroll Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
9 Projects Layouts - With Project & Task details concatenated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
10 Projects and Payroll Layouts - With Project & Task details concatenated . . . . . . . . . . . . . . . . . . . . . . . . . 18
11 Delivered Custom Choice List View Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
12 Component Tables Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
13 Global Attributes, applicable to every component. Required attribute(s) in bold. . . . . . . . . . . . . . . . . . . . . . 117
14 Choice List Components. Required Attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
15 Descriptive flexfield component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . 120
16 Display text component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . . 121
17 Inter Period Navigational Control component qualifing attributes. Required attribute(s) are displayed in bold. . . . . 121
18 Key notation component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . 122
19 List of Values component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . 124
20 Message Box component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . 125
21 Package Choice List component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . 126
22 Page Status component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . . 126
23 Spacer component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . . . . . 126
24 Submit Button component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . 127
25 Submit Icon component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . . 127
26 Summary Table component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . 127
27 Table Layout component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . 128
28 Template Control component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . 128
29 Text Field component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . . . . . . . 129
30 Time Building Block component qualifing attributes. Required attribute(s) are displayed in bold. . . . . . . . . . . . . 130
31 Currently recognized tokens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
32 Timecard region seeded prompts (Part 1.) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
33 Timecard region seeded prompts (Part 2.) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
34 Timecard Review region seeded prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
35 Timecard Confirmation region seeded prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
36 Seeded Timecard Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
37 Configurable User Interface Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
38 Configurable User Interface Error Codes (Part 2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

6
 

1.4.9 Project Layouts delivered in Release 12.1

The projects layouts delivered for ORACLE E-BUSINESS SUITE 12.1 with the product are listed in table 9.

Layout Name Layout Code Layout Type Filename

Projects Timecard Layout - With PROJECTS-DETAILS-TIMECARD TIMECARD hxczzhxclayt0082.ldt
Project & Task details concatenated
Projects Review Layout - With PROJECTS-DETAILS-REVIEW REVIEW hxczzhxclayt0083.ldt
Project & Task details concatenated
Projects Confirmation Layout - PROJECTS-DET-CONFIRM CONFIRMATION hxczzhxclayt0088.ldt
With Project & Task details concate-
nated
Projects Details Layout - With PROJECTS-DET-DETAIL DETAIL hxczzhxclayt0087.ldt
Project & Task details concatenated
Projects Export Timecard Layout - PROJECTS-DET-EXP-TIMECARD   EXPORT hxczzhxclayt0086.ldt
With Project & Task details concate-
nated
Projects Notification Layout - With PROJECTS-DET-NOTIF NOTIFICATION hxczzhxclayt0084.ldt
Project & Task details concatenated
Projects Fragmented Timecard View PROJECTS-DET-FRAGMENT FRAGMENT hxczzhxclayt0085.ldt
- With Project & Task details con-
catenated
Projects Change and Late Audit En- PROJECTS-DET-AUDIT-LAYOUT AUDIT hxczzhxclayt0091.ldt
try Layout - With Project & Task
details concatenated
Projects Change and Late Review PROJECTS-DET-AUDIT-REV REVIEW hxczzhxclayt0089.ldt
Layout - With Project & Task de-
tails concatenated
Projects Change and Late Confirma- PROJECTS-DET-AUDIT-CONFIRM   CONFIRMATION hxczzhxclayt0092.ldt
tion Layout - With Project & Task
details concatenated
Projects Change and Late Audit No- PROJECTS-DET-AUDIT-NOTIF   NOTIFICATION hxczzhxclayt0090.ldt
tification Layout - With Project &
Task details concatenated

Table 9: Projects Layouts - With Project & Task details concatenated

1.4.10 Project and Payroll Layouts delivered in Release 12.1

The projects-payroll layouts delivered for ORACLE E-BUSINESS SUITE 12.1 with the product are listed in table 10.

17
 

Layout Name Layout Code Layout Type Filename

Projects and Payroll Timecard Layout - With PROJECTS-DET-ALT-TIMECARD   TIMECARD hxczzhxclayt0093.ldt
Project & Task details concatenated
Projects and Payroll Review Layout - With PROJECTS-DET-ALT-REVIEW   REVIEW hxczzhxclayt0094.ldt
Project & Task details concatenated
Projects and Payroll Confirmation Layout - With PROJECTS-DET-AL-CONF CONFIRMATION hxczzhxclayt0100.ldt
Project & Task details concatenated
Projects and Payroll Details Layout - With PROJECTS-DET-ALT-DETAIL   DETAIL hxczzhxclayt0098.ldt
Project & Task details concatenated
Projects and Payroll Export Layout - With PROJPAY-DETAIL-EXPORT   EXPORT hxczzhxclayt0099.ldt
Project & Task details concatenated
Projects and Payroll Notification Layout - With PROJECTS-DET-ALT-NOTIF NOTIFICATION hxczzhxclayt0095.ldt
Project & Task details concatenated
Projects and Payroll Fragmented Timecard View PROJECTS-DET-ALT-FRAG   FRAGMENT hxczzhxclayt0096.ldt
- With Project & Task details concatenated
Projects and Payroll Change and Late Audit PROJECTS-DET-ALT-AUD-LAYOUT   AUDIT hxczzhxclayt0104.ldt
Entry Layout - With Project & Task details
concatenated
Projects and Payroll Change and Late Re- PROJECTS-DET-ALT-CLA-REVIEW   REVIEW hxczzhxclayt0101.ldt
view Layout - With Project & Task details
concatenated
Projects and Payroll Change and Late Con- PROJECTS-DET-ALT-CLA-CONF   CONFIRMATION hxczzhxclayt0103.ldt
firmation Layout - With Project & Task de-
tails concatenated
Projects and Payroll Change and Late Notifi- PROJECTS-DET-ALT-CLA-NOTIF   NOTIFICATION hxczzhxclayt0102.ldt
cation Layout - With Project & Task details
concatenated
Entry Level Processing Projects - Payroll ELP-PROJ-DET-PAY-TIMECARD   TIMECARD hxczzhxclayt0105.ldt
Timecard Layout - With Project & Task de-
tails concatenated
Entry Level Processing Projects - Payroll Re- ELP-PROJ-DET-PAY-REVIEW   REVIEW hxczzhxclayt0106.ldt
view Layout - With Project & Task details
concatenated
Entry Level Processing Projects - Payroll ELP-PROJ-DET-PAY-CONF   CONFIRMATION hxczzhxclayt0110.ldt
Confirmation Layout - With Project & Task
details concatenated
Entry Level Processing Projects - Payroll De- ELP-PROJ-DET-PAY-DETAIL   DETAIL hxczzhxclayt0109.ldt
tails Layout - With Project & Task details
concatenated
Entry Level Processing Projects - Payroll Ex- ELP-PROJ-DET-PAY-EXP-LAYOUT   EXPORT hxczzhxclayt0108.ldt
port Layout - With Project & Task details
concatenated
Entry Level Processing Projects - Payroll No- ELP-PROJ-DET-PAY-NOTIF   NOTIFICATION hxczzhxclayt0107.ldt
tification Layout - With Project & Task de-
tails concatenated

Table 10: Projects and Payroll Layouts - With Project & Task details concatenated

18
 

1.5 Using the OAF Personalization Functionality With Timecard Configuration

In short, for any page rendered with the Oracle Time and Labor (OTL) timecard configuration utility, no UI components can be
Personalized  using the standard Oracle Applications Framework (OAF) functionality. All changes to the page must be made via the
Oracle Time and Labor page layout definition.
The one exception to this rule are the pages rendered in the LOV pop-up windows. While the LOVs themselves are controlled by the
OTL timecard configuration utility, the pages rendered in the pop-up list of values windows are not. Thus, the OAF  Personalization 
functionality can be used to personalize those windows. For example, if the project id column in the Projects LOV pop-up should be
hidden, a customer should create a personalization at the desired level and hide that column. If the columns should be renamed or
reordered, again, this should be done via the personalization framework delivered with the OAF.

19
 

business group id
business group name

Specifically:

Attribute ID: CUSTOM PERSON ID

Attribute Name: My Custom LOV - Person ID
Application: Oracle Time and Labor
Data type: Number
Value Length: 15
Style: Text
Label: Person ID

Attribute ID: CUSTOM FULL NAME

Attribute Name: My Custom LOV - Full Name
Application: Oracle Time and Labor
Data type: Varchar2
Value Length: 240
Style: Text
Label: Full Name

Attribute ID: CUSTOM LAST NAME

Attribute Name: My Custom LOV - Last Name
Application: Oracle Time and Labor
Data type: Varchar2
Value Length: 40
Style: Text
Label: Last Name

Attribute ID: CUSTOM DATE OF BIRTH

Attribute Name: My Custom LOV - Date of Birth
Application: Oracle Time and Labor
Data type: Date
Value Length: 1
Style: Text
Label: Date of Birth

Attribute ID: CUSTOM EMPLOYEE NUMBER

Attribute Name: My Custom LOV - Employee Number
Application: Oracle Time and Labor
Data type: Varchar2
Value Length: 30
Style: Text
Label: Employee Number

Attribute ID: CUSTOM BUSINESS GROUP ID

Attribute Name: My Custom LOV - Business Group ID
Application: Oracle Time and Labor
Data type: Number
Value Length: 15
Style: Text
Label: Business Group ID

39
 

Attribute ID: CUSTOM BUSINESS GROUP NAME

Attribute Name: My Custom LOV - Business Group Name
Application: Oracle Time and Labor
Data type: Varchar2
Value Length: 60
Style: Text
Label: Business Group Name

3.4.3 Create an AK region for rendering the LOV screen

Region ID: MY CUSTOM LOV
Region Name: My custom LOV
Application Name: Oracle Time and Labor
Object Name: ICX PROMPTS
Region Style: List of Values
Application Module Definition Name: oracle.apps.hxc.selfservice.timecard.server.TimecardAM
Display Rows: 10 (or however many rows you want displayed in the LOV)
Controller Object Type: oracle.apps.hxc.selfservice.configui.webui.LovCO
Add Indexed Children: (checked)

Leave all other fields blank or to their default value. Save the record.

3.4.4 Create AK region items inside the AK region for the LOV page
Next you need to create region items for each of the things you want to show on the LOV. Using the AK Regions window, query the
region that you created in the previous step, and with that row selected, click on the Region Items button. Complete the following
fields: Attribute Type, Application, Attribute Name, Sequence, Node Display, Queryable, View Usage Name, View Attribute Name.
In addition, make a note of the value for Item Name - this will be auto-generated from the attribute code and you do not need to
change it, but you need to know it for when you create the LOV component definition.
So for our example, you would create the following region items inside the LOV region.

Attribute Type: Attribute

Application: Oracle Time and Labor
Attribute Name: My Custom LOV - Person ID
Sequence: 10
Node Display: Checked
Queryable: Checked
Item Name: CustomPersonId
View Usage Name: CustomPersonVO
View Attribute Name: PersonId

Attribute Type: Attribute

Application: Oracle Time and Labor
Attribute Name: My Custom LOV - Full Name
Sequence: 20
Node Display: Checked
Queryable: Checked
Item Name: CustomFullName
View Usage Name: CustomPersonVO
View Attribute Name: FullName

Attribute Type: Attribute

40
 

Application: Oracle Time and Labor

Attribute Name: My Custom LOV - Last Name
Sequence: 30
Node Display: Checked
Queryable: Checked
Item Name: CustomLastName
View Usage Name: CustomPersonVO
View Attribute Name: LastName

Attribute Type: Attribute

Application: Oracle Time and Labor
Attribute Name: My Custom LOV - Date of Birth
Sequence: 40
Node Display: Checked
Queryable: Checked
Item Name: CustomDateOfBirth
View Usage Name: CustomPersonVO
View Attribute Name: DateOfBirth

Attribute Type: Attribute

Application: Oracle Time and Labor
Attribute Name: My Custom LOV - Employee Number
Sequence: 50
Node Display: Checked
Queryable: Checked
Item Name: CustomEmployeeNumber
View Usage Name: CustomPersonVO
View Attribute Name: EmployeeNumber

Attribute Type: Attribute

Application: Oracle Time and Labor
Attribute Name: My Custom LOV - Business Group ID
Sequence: 60
Node Display: Checked
Queryable: Checked
Item Name: CustomBusinessGroupId
View Usage Name: CustomPersonVO
View Attribute Name: BusinessGroupId

Attribute Type: Attribute

Application: Oracle Time and Labor
Attribute Name: My Custom LOV - Business Group Name
Sequence: 70
Node Display: Checked
Queryable: Checked
Item Name: CustomBusinessGroupName
View Usage Name: CustomPersonVO
View Attribute Name: BusinessGroupName

41
 

3.4.5 Run the migration script to copy the LOV definition from AK to the MDS repository
3.4.6 Modify a layout to include the LOV component
For our example, the component definition is:-
########################################################################
# My Custom Person LOV #
#######################################################################
BEGIN HXC LAYOUT COMPONENTS "My Custom Layout - Custom Person LOV"
OWNER = "CUSTOM"
COMPONENT VALUE = "CUSTOMPERSON"
SEQUENCE = "140"
COMPONENT DEFINITION = "LOV"
RENDER TYPE = "WEB"
PARENT COMPONENT =
"My Custom Layout - Day Scope Building blocks for worker timecard matrix"
REGION CODE = "MY CUSTOM AK PROMPT REGION"
REGION CODE APP SHORT NAME = "HXC"
ATTRIBUTE CODE = "MY CUSTOM PERSON PROMPT"
ATTRIBUTE CODE APP SHORT NAME = "HXC"

BEGIN HXC LAYOUT COMP QUALIFIERS "My Custom Layout - Custom Person LOV"
OWNER = "CUSTOM"
QUALIFIER ATTRIBUTE CATEGORY = "LOV"
QUALIFIER ATTRIBUTE1 = "CustomPersonVO"
QUALIFIER ATTRIBUTE2 = "N"
QUALIFIER ATTRIBUTE3 = "MY CUSTOM LOV"
QUALIFIER ATTRIBUTE4 = "809"
QUALIFIER ATTRIBUTE5 = "12" # display width
QUALIFIER ATTRIBUTE6 = "CustomFullName|CUSTOMPERSON-DISPLAY|CRITERIA|N|CustomPersonId|CUSTOMPERSON|
RESULT|N|CustomFullName|CUSTOMPERSON-DISPLAY|RESULT|N|CustomBusinessGroupId|BUSINESSGROUP|RESULT|N"
QUALIFIER ATTRIBUTE7 = "BUSINESSGROUP|CustomBusinessGroupId"
QUALIFIER ATTRIBUTE8 = "CustomFullName"
QUALIFIER ATTRIBUTE9 = "CustomPersonId"
QUALIFIER ATTRIBUTE10 = "my.custom.server.CustomPersonVO"
QUALIFIER ATTRIBUTE20 = "N"
QUALIFIER ATTRIBUTE21 = "Y"
QUALIFIER ATTRIBUTE22 = "L"
QUALIFIER ATTRIBUTE25 = "FLEX"
QUALIFIER ATTRIBUTE26 = "MYFLEX"
QUALIFIER ATTRIBUTE27 = "Attribute1"
QUALIFIER ATTRIBUTE28 = "CUSTOMPERSON"
END HXC LAYOUT COMP QUALIFIERS
END HXC LAYOUT COMPONENTS

Note: If you wish to also show the new LOV field on the review and confirmation layouts you will need to modify them to
include the component as well. The easiest way to accomplish this is to copy the component definition over from the timecard layout,
changing the component name, parent component name and qualifier name. Then you just need to modify the copied definition to
make it render as a read only text field–this is done by adding a value of ’Y’ for qualifier attribute30:
QUALIFIER ATTRIBUTE30 = ’Y’

42
 

3.4.7 Include the new LOV View Object into your Apache/Jserv environment
First of all you need to compile any Java code that was generated when you created your View Objects. Typically you will have a
VOImpl.java file, but there are others you can choose to create when you generate your VO. Once you have the class files you will
need to get these and the xml file to your apache/JServ environment. The easiest way to do this is to create a directory and then
prefix this to your JServ classpath.   Note: In the directory you will need to maintain the full structure of the package you used to
create your VO. For our example, the files are in the package ’my.custom.server’. So in the directory you add to your classpath you
should have the following structure/files (assuming ’custom’ is the name of your directory):

custom/my <directory>
custom/my/custom/ <directory>
custom/my/custom/server/ <directory>
custom/my/custom/server/CustomPersonVO.xml
custom/my/custom/server/CustomPersonVOImpl.class

After altering the JServ classpath to include your directory you should bounce Apache/JServ for the changes to take effect. The
final task needed to implement your new LOV is to compile your modified layout against the database, and if necessary assign it to
the relevant users via the preference screen.

3.5 Changing the title of the timecard page

The default title for the timecard entry page is:
Time Entry: @RI NAME, @RA NUMBER

Where  RI NAME  is the token for the name of the employee entering time and  RA NUMBER  is their employee number.
To change the title modify the text associated with prompt  HXC TIMECARD HEADER TITLE , within the AK  HXC CUI TIMECARD
region. Alternatively, you can create a new prompt and then alter the layout definition to use that prompt instead of the delivered
one.
So, for example, lets change the title to say   Timecard for Employee , where  Employee  is the name of the employee.
Go to Application Developer Common Modules ¿ AK regions form, query for  HXC CUI TIMECARD , highlight the correct row (if 
you have more than one result from doing a partial match), and then press the ’Region Items’ button at the bottom of the form. In
the region items form, query on the Attribute ’Timecard Header Title’ (you can look up the attribute names based on the attribute
code by searching in the ’Seeded Prompts’ section. Refer Table 31: Timecard region seeded prompts) and then change the ’Attribute
Long Label’ text for the item to:
Timecard for @RI NAME

3.6 Changing the label for a column in the Timecard

Changing any label in OTL can be done by editing the text for the label in the professional AK form. To identify the attribute name
which you need to change there are two methods. Firstly, you can search for the text of the prompt in the reference section of this
document to find the name of the attribute. The second method, if the correct label cannot be found, or there are multiple choices
as to which it may be is the inspect the layout file.
Prompts can be attached to components in two ways - to best illustrate these two methods lets take a look at a couple of examples
using the inter-period navigation control on the Projects timecard layout.
BEGIN HXC LAYOUT COMPONENTS
"Projects Timecard Layout - Inter Period Nav Control"
OWNER = "ORACLE"
REGION CODE = "HXC CUI TIMECARD"
REGION CODE APP SHORT NAME = "HXC"
ATTRIBUTE CODE = "HXC TIMECARD PERIOD LABEL"
ATTRIBUTE CODE APP SHORT NAME = "HXC"

43