Implementation of
Oracle Time and
Labor (OTL).
An internal HP guide to Configuration and
Extending OTL for Non-Recurring Elements
(e.g. Overtime claims).
Natha Modhawadia
Oracle e-Business Suite Consultant
Table of Contents
Intended Audience................................................................................................. 4
Foreword................................................................................................................ 4
1.0 OTL Overview.................................................................................................. 5
Time Entry.......................................................................................................... 5
Validation (Time Entry Rules).............................................................................. 5
Approval............................................................................................................. 5
2.0 Start up Checklist............................................................................................ 6
3.0 OTL Implementation Steps..............................................................................6
3.1 Web Browsers............................................................................................... 6
3.2 Configuration Tools....................................................................................... 6
4.0 System Administration Pre-req........................................................................7
4.1 Create Responsibilities................................................................................. 7
4.2 Set System Profile Options...........................................................................7
4.3 Create Messages to be used on Timecard Entry/Review...............................7
5.0 Payroll and Element Configuration...................................................................8
5.1 Set up Elements for Time Entry....................................................................8
5.2 Set up Element Links.................................................................................... 9
5.3 Define Element Sets...................................................................................10
6.0 OTL Configuration.......................................................................................... 11
6.1 Generate Flexfield and Mapping Information Process.................................11
6.2 Define Alternate Names............................................................................. 12
6.3 Define Recurring Time Periods....................................................................13
6.4 Define Approval Periods..............................................................................14
6.5 Define Approval Styles............................................................................... 14
6.8 Implement OTL Fast Formulas for Time Entry Rules...................................15
6.9 Define Holiday Calendar.............................................................................16
6.10 Define Preferences (Detail).......................................................................17
6.11 Define Preferences (Rules/Eligibility Criteria)...........................................17
6.12 View People Preferences...........................................................................17
7.0 Create Dummy Employee..............................................................................18
8.0 Customisation of Self Service Timecards.......................................................19
Intended Audience
This document is intended for internal use only within xxx
It can be used as reference for Oracle HCM/OTL Technical and Functional
Consultants for implementation as well as Support Analyst for support purposes.
This document is not intended for Training, usage or a guide to Work Instructions.
Foreword
It is recommended the steps followed in the document should be the same as
development steps.
Please refer to Oracles release document for the full implementation guide.
Oracle Time and Labor
Implementation and User Guide
Release 12
Part No. B31652-02
References
http://www.otlspecialists.com/
http://www.oracle.anilpassi.com/
Time Entry
Employees have the ability to enter time through a web based self service page
in different formats known as a Timecard. Timecards can be customised so that
the employee can see all the fields relevant to them. Instructions and messages
can be used to aid the employee in entering their timecards quickly and
effectively.
Timecards can also be entered on behalf of the employee (if the employee
doesnt have Self Service access) through Timekeeper. Timekeeper is a standard
OTL responsibility that can containthe same fields, messages, functionality and
Time Entry Rules as the Self Service based solution.
Approval
Once the timecard is entered and submitted for approval, Oracle Workflow
throughseeded workflow will applybusiness rules to process the OTL Timecards.
These can be monitored through Workflow Administrator (New) for support,
traceability and audit.
Approval styles can be created and the pre-defined rules include; OTL Auto
Approve and Approve on Submit can be defined.
HR Supervisor rules can be administered so that only Line Managers are able to
approve claims along with standard delegation and vacation rules. Furthermore,
additional approval can ensure other employees in the same organisation can
approve depending on the type of Claim against specific Roles and Positions.
Custom Error Messages related to Time Entry rules and Fast Formulas can be
added and referenced within code and passed into to Self Service and
Timekeeper entry screens.
Element Definition
Must be Non-Recurring
Must have Allow Multiple Entries flagged to Yes
Input Values
Have one Input Value Called Hours in Format Hours in Decimal format
(2 places)
o Flagged as Required
o Flagged as User Enterable
o Flagged as Database Item
Have a second Input Value called Date Claimed in Format Date
Note It is imperative that the input values are as per the above or else Time
Entry will fail with errors.
The OTL Timecard will result in starting from that Calendar day.
Person - A named individual which you can select from the List of Values.
Entry Level Approval - Determines what time entries are routed to what
approver.
In the example above only HR Supervisor approval is enforced.
create a series of validation rules that can be configured using different input
parameter values.
2. HRMS Manager > Create an OTL Time Entry Rule Formula that returns a value
for success or error.
The fast formula needs to return either "S" meaning the time entry was
successful or an "E" meaning the timecard entries failed the validation. In the
case of "E" an error message should be referenced via the Application Messages
table with the message value being returned to the users self service timecard.
The error condition can be configured as a warning message(which allows time
entry to continue) or an error message(that stops the time entry process until
the condition is resolved).
In addition the application message may also use the token "&TER" which then
returns the time entry rule name in the self service timecard as the actual
timecard warning/error message. This produces the most flexibility as the
formula can be re-used with many different input parameters and display a
different message based on the condition triggered. The only limitation here is
that a time entry rule name can be no longer than 80 characters in length.
It is also worth noting that OTL formulas can be created for any or all of the
modules that you are integrating with i.e.- fast formulas in this context are not
limited to just the Oracle Payroll module.
3. OTL Application Developer > Create your Time Entry Rule or Rules. If you
have created a flexfield with variable inputs you may create mutliple rules for a
single formula subject to variable inputs. As outlined in step 2 the time entry
rule name specified here can also double as the acutal error message to be
displayed on the timecard to the end user.
4. OTL Application Developer > Create your Time Entry Rule Group and add the
necessary time entry rules created at step 3 for the group of workers you are
planning the validation to apply to.
5. OTL Application Developer > OTL Preference Settings > Add the Time Entry
Rule Group created at step 4 to the Time Store Time Entry Rules Preference in an
appropriate folder.
6. OTL Application Developer > Assign the OTL Preference Eligibility Criteria i.e.specify the worker or workers who will be subject to the timecard validations you
have created.
Once the Time Entry Rules have been created as per the previous section these
rules can be grouped together and assigned to a group or employee via
preferences. The rules created can then be visible through either the Self Service
Timecards or through Timekeeper.
N.B Where Earning Type is the Payroll element related for Bank Holidays.
This table can be maintained at anytime of the year.
workers in their business group, and can define groups for other timekeepers (if
the
timekeeper is in the same business group as the people for whom they enter
time). Set
this profile option to No to allow the timekeeper to define groups and enter
timecards
for workers for whom they act as timekeeper only.
OTL: Allow Creation of Public Templates
Set this profile option to Yes to enable the user to create public templates.
OTL: Defer Approval Process on Timecard Submission
This profile option enables you to control the immediate execution of the
approval
process. If you set this profile option to No, then you no longer need to submit
the
Workflow Background Process.
OTL: Number of Past Days for Which Retrieval Considers Changes (days)
This profile option controls the number of past days the retrieval process checks
for
changes.
OTL: Transfer Batch Size
This profile option controls the batch size for the number of timecards the OTL
application transfers into memory, at one time, during the retrieval process. So if
you set it at 100 and had 700 employees, 7 batches would be created.
If you run the retrieval process on a monthly basis for the same organization
(and
workers enter time on a weekly basis), then the OTL application transfers 400
timecards
(100 people with 4 timecards each) in each batch. In this example, the
application still
transfers 100 workers' timecards, however the number of timecards increases
and each
batch requires 4 times the amount of memory space.
Caution: Oracle recommends that you set this profile option to no
higher than 100. If you set this profile to a higher number, then you
may experience errors due to lack of memory space in the OTL
application.
OTL: Transfer to OTLR and/or BEE
This profile option enables you to specify whether you expect to process time
entries to
BEE or to evaluate and process time using OTLR. If you set the Evaluate Rules
preference to Yes for all workers then set this profile option to OTLR Only. If you
set
the Evaluate Rules preference to No for all workers then set this profile option to
BEE
Only. Otherwise, leave the profile with its default value of both OTLR and BEE.
Other layout types exist, but this document will only highlight the
above.
PINK = Standard AOL Messages that can be modified via AOL message form
GREEN = AK prompts that can be modified in the AK region item or attribute forms
RED = Attribute components in the timecard layout that can be modified via the
configuration LDTs
BLACK = Information on the timecard layout that can be controlled via preferences
The configured LDT files are based on seeded LDT files/filenames above. During
and after configuring the custom version, the LDT files will be uploaded with
different names (xx_ hxczzhxclayt0030.ldt). This is to ensure that the original
seeded LDT files remain unaffected by the custom configuration.
BEGIN HXC_LAYOUT_COMP_QUALIFIERS
"Exception Confirmation Layout - Timecard Header"
OWNER = "ORACLE"
QUALIFIER_ATTRIBUTE_CATEGORY = "DISPLAY_HEADER"
QUALIFIER_ATTRIBUTE20 = "Y"
QUALIFIER_ATTRIBUTE30 = "Y"
LAST_UPDATE_DATE = "2004/05/23"
END HXC_LAYOUT_COMP_QUALIFIERS
# END HXC_LAYOUT_COMPONENTS
#
#
#
#
#
#
#
#
#
#
#
BEGIN HXC_LAYOUT_COMPONENTS
"Exception Confirmation Layout - Hours Type Table"
OWNER = "ORACLE"
SEQUENCE = "60"
COMPONENT_DEFINITION = "HOURSTYPE_TABLE"
RENDER_TYPE = "WEB"
PARENT_COMPONENT =
"Exception Confirmation Layout - Top Level Building Block"
COMPONENT_ALIAS = "HOURS_ENTERED"
PARENT_BEAN = "HOURS_ENTERED_HEADER"
LAST_UPDATE_DATE = "2004/05/23"
BEGIN HXC_LAYOUT_COMP_QUALIFIERS
"Exception Confirmation Layout - Hours Type Table"
OWNER = "ORACLE"
QUALIFIER_ATTRIBUTE_CATEGORY = "HOURSTYPE_TABLE"
QUALIFIER_ATTRIBUTE20 = "Y"
QUALIFIER_ATTRIBUTE30 = "Y"
LAST_UPDATE_DATE = "2004/05/23"
END HXC_LAYOUT_COMP_QUALIFIERS
# END HXC_LAYOUT_COMPONENTS
REGION_CODE_APP_SHORT_NAME = "HXC"
ATTRIBUTE_CODE = "HXC_TIMECARD_COST_CENTER"
ATTRIBUTE_CODE_APP_SHORT_NAME = "HXC"
SEQUENCE = "220"
COMPONENT_DEFINITION = "CHOICE_LIST"
RENDER_TYPE = "WEB"
PARENT_COMPONENT =
"Exception Confirmation Layout - Day Scope Building blocks for worker
timecard matrix"
LAST_UPDATE_DATE = "2004/05/23"
BEGIN HXC_LAYOUT_COMP_QUALIFIERS
"Exception Confirmation Layout - Cost Center"
OWNER = "ORACLE"
QUALIFIER_ATTRIBUTE_CATEGORY = "CHOICE_LIST"
QUALIFIER_ATTRIBUTE1 = "Custom9VO"
QUALIFIER_ATTRIBUTE8 = "DisplayValue"
QUALIFIER_ATTRIBUTE9 = "Value#NUMBER"
QUALIFIER_ATTRIBUTE10 =
"oracle.apps.hxc.selfservice.timecard.server.Custom9VO"
QUALIFIER_ATTRIBUTE11 = "TIMECARD_BIND_END_DATE|
TIMECARD_BIND_END_DATE"
QUALIFIER_ATTRIBUTE17 = "OraTableCellText"
QUALIFIER_ATTRIBUTE20 = "N"
QUALIFIER_ATTRIBUTE21 = "Y"
QUALIFIER_ATTRIBUTE22 = "L"
QUALIFIER_ATTRIBUTE25 = "FLEX"
QUALIFIER_ATTRIBUTE26 = "Dummy Cost Context"
QUALIFIER_ATTRIBUTE27 = "Attribute1"
QUALIFIER_ATTRIBUTE30 = "Y"
LAST_UPDATE_DATE = "2004/05/23"
END HXC_LAYOUT_COMP_QUALIFIERS
END HXC_LAYOUT_COMPONENTS
QUALIFIER_ATTRIBUTE1 = "ENTRY_MESSAGE"
QUALIFIER_ATTRIBUTE3 = "Y"
QUALIFIER_ATTRIBUTE20 = "Y"
QUALIFIER_ATTRIBUTE30 = "Y"
LAST_UPDATE_DATE = "2006/05/11"
END HXC_LAYOUT_COMP_QUALIFIERS
END HXC_LAYOUT_COMPONENTS
9.0 Workflow
The following concurrent request needs to s et up at intervals to take submitted
timecards into the approval process.
The set up required for this feature are as follows though the Timekeeper
Group Menu path:
1) The first set up required is to create a Timekeeper. This is a named
employee who will own the group.
2) Create Timecard Group
3) Add Employees to the group created
Value
- XX Business Group
HR:Business Group
- XX Business Group
HR:User Type
- Business Unit
- Yes
- No