MD.

060/70
FUNCTIONAL & TECHNICAL DESIGN
DOCUMENT
Exempt Timecard 1
Daily Entry in Hours

Prepared by: Functional: Cheri McKenna

Technical: Venu Bijumalla
Creation Date: October 19, 2006
Last Updated: November 28, 2006

Last Last Update Description

Updated
By
Venu November 28, Updated the
Bijumalla 2006 Technical
Sections.
Cheri December 13, 2006 Updated
McKenna screenshots
Cheri December 20, 2006 Updating
McKenna comments made
in 12/19
subteammeeting
Cheri December 21, 2006 Updating with
McKenna Payroll answers

Business Systems Page 1 3/12/2009

Document Control

All aspects of document control (Change History, Reviewers/Distribution, Approvers) will be

managed in the BSPTA item for the specification

Business Systems Page 2 3/12/2009

 Contents
Document Control............................................................................................... 2
Introduction ....................................................................................................... 4
Design Principles ................................................................................................ 5
Topical Essay/Business Requirements................................................................... 6
Basic Business Needs.................................................................................... 6
Major Features ............................................................................................. 6
Business Rules ............................................................................................. 6
Definitions/Notes.......................................................................................... 9
Assumptions ................................................................................................ 9
Functional Overview ......................................................................................... 10
Process Overview ....................................................................................... 10
Form/Report/Interface Description............................................................... 10
Validation Rules and Warnings..................................................................... 10
Navigation ................................................................................................. 15
Performance and Volume Expectations ......................................................... 15
Unit Test Cases .......................................................................................... 16
User Procedures ......................................................................................... 16
Technical Overview........................................................................................... 17
File/Table/Object Details ............................................................................. 17
Program Overview ...................................................................................... 17
Process Flow Diagram................................................................................. 18
Program Modules ....................................................................................... 18
Prerequisites .............................................................................................. 19
Process Details........................................................................................... 19
Development Estimates............................................................................... 19

Business Systems Page 3 3/12/2009

Introduction
The Error! Reference source not found. was identified as required functionality during
the gap analysis phase of the OTL implementation. This document is a living document that
will follow the Error! Reference source not found. program through the entire
development life cycle.

Business Systems Page 4 3/12/2009

Design Principles
The purpose of this document will vary with the applicable phase in the lifecycle as indicated
below:
Requirements – Technical and functional team members will contribute to both high level
and detailed requirements in this document. The requirements will be used to design a
solution.
Design – Technical team members will update the document with high level and detailed
design specifications. All related modules will be included in the design including legacy
programs, SQL*Loader scripts, PL/SQL scripts, and error reports. The high level design
includes finalizing the process flow and corresponding narrative.
Coding – The developer will update the document if design changes are made during
coding.
Testing Strategy – Testing strategy and test cases will be documented in the test case
section.
Enhancements and Upgrade – After implementation, this document should be used to
record and changes to the customization.

Business Systems Page 5 3/12/2009

Topical Essay/Business Requirements
Short, high level description of the item that the document addresses

Basic Business Needs

REQUIREMENT SOLUTION

Ability to enter time electronically Standard Functionality

Ability for user to set default Project/Tasks displayed on time entry screen Standard Functionality

System must be “User Friendly’ – people have to want to do this. Fast, easy to use with the ability to Custom Timecard
enter time for 3-4 projects over the course of the month in under 10 minutes.

Ability to use multiple timecard layouts Standard Functionality

Ability to check Home Code and Vacation Accrual Bank balance as of the last pay period on timecard Custom Timecard

Default home codes from PeopleSoft are always displayed on the timesheet. Custom Timecard

Customizable interface (at the department level) that allows capturing department dpecific Custom Timecard
information so that the user is presented with department specific activities, not project account
tasks. Includes:
 Aliases/alternative task names
 Entry of diverse types of numbering systems for activities: i.e., work orders, project
numbers, R&G job codes, etc
 Ability to setup relationships between work orders and project/tasks. Can be one to one or
many (work orders) to one (project/task)
 Project codes (like job numbers) and ability to attach one project code to multiple
project/task numbers. Need to have definitions in the system for project codes

The Fermilab Standard timecard layout should have the following functionality: Custom Timecard
 Elements – Filtered by Eligibility
 Home Project
 Home Task
 Hours
Should be able to display the Projects based on employee eligibility Application setup-
Configuration

Must be able to enter time to specific hours on a 24 hour clock to identify overtime and shift Standard Functionality
premiums

Output format supports text, .xls, and xml

H2 Transaction history for any changes in OTL to time reported after it has been submitted to payroll. Standard Functionality
Transaction history for any time that is entered or corrected by someone other than the person
working the time. Provide a text comment when corrections are made.

Major Features
Ability to enter Payroll Data and Effort Data in one central system
Ability to validate vacation and sick time
Ability to calculate Effort Reporting from ‘Hours’ to ‘Units’

Business Systems Page 6 3/12/2009

Business Rules
ENFORCES AREA OF BUSINESS RULE NOTES:
RULE TIMECARD

TC GENERAL Time will be charged against Activities, Project-Tasks, or Default Home Codes

TC GENERAL The current time periods timecard will open as a default when ‘Creating’ a new
timecard (unless it has already been previously submitted)

TC GENERAL Effort can be recorded for each day of the period.

TC TIME CARD The time card time period will appear on the timecard entry screen
HEADER

TC TIME CARD Vacation and Floating Holiday accruals will display on the timecard for the
HEADER period. (Sick hours will validate but will not be displayed)

TC TIME CARD Vacation Accruals sent from PS will be Zero during an EE‘s probation period.
HEADER

TC TIME CARD EE’s Home Project / Task(s) will be displayed (up to 5) along with the dist. %
HEADER allocated to each Project / Task.

WS Setup TIME No Negative hours will be allowed

ENTRY

TC PAYROLL Effort hours will be entered as total hours per day.

DETAILS /
EFFORT
DETAILS

TC PAYROLL Only enter exceptions - Absence and additional Earning Codes.

DETAILS

TC EFFORT Work orders will be entered as ‘Activities’

DETAILS

TC EFFORT The ‘Description’ field, will be a hyperlinked. The long task description in PA ‘Long Description’
DETAILS will be used to populate the description on the timecard. This hyperlink will will most likely
open another frame to display the full description. expand to a larger
box when clicked
on vs. calling
another frame via
a hyperlink

TC EFFORT The ‘Description’ field will also be used to populate the description tied to the At this time
DETAILS ‘Activity’. This hyperlink will open another frame to display the full Development is
description. not sure how this
will work

TC EFFORT An Activity (alternate name) table will contain the Activity name and its
DETAILS description. The description will populate in the ‘description’ field. This
hyperlink will open another frame to display the full description.

WS Setup EFFORT Chargeback indicator will calculate when appropriate

DETAILS

TC SUMBITTAL Time is submitted weekly for current pay periods or at anytime for future
timecards

Business Systems Page 7 3/12/2009

Validation Rules and Warnings
ENFORCES AREA OF VALIDATION RULES AND WARNINGS NOTES:
RULE TIMECARD
PAYROLL Vacation / FH / Sick - These will now be free form fields .. as part time
DETAILS exempt employees can take hours off based on their schedules

WS Setup VALIDATION Transaction controls may be used to filter available Project / Task /
Activities by employee

WS Setup / VALIDATION At ‘Submittal’ The system will ‘Warn’ the employee that they are
Fast Formula overspending their accruals and the timecard may not be ‘Approvable’.
A ‘soft’ warning will be give for submittals before accruals are updated.
A ‘hard’ warning will be give once the accruals have been updated. The
ability to correct the timecard within the same period will be offered.

WS Setup / VALIDATION Absence codes for Vacation / Sick / Floating Holiday will not validate for
Fast Formula future timecard period entries when the timecard is submitted. An
employee will receive a ‘soft’ warning that the hours submitted will be
validate against their accruals until the timecard is approved. The
timecard will will either be rejected to the employee for correction or the
group timekeeper will modify the rejected timecard to replace the
invalid code with leave without pay so that the timecard can be
approved.

QUESTION: Will ‘Approvers/Timekeepers w/ Approval Authority’ be able to

approve ‘FUTURE’ timecards (as long as the accrual rule kicks in) ?

Business Systems Page 8 3/12/2009

Form Navigation

Button

TC CANCEL The ‘Cancel’ button will take the user back to the initial layout/screen
(1st screen after login). Will clear the screen from the last save.

TC Save for Later The ‘Save for Later’ button will not take the user to any other
layout/screen

TC Continue to The ‘Continue to Confirmation’ button will take the user to the 1st
Review confirmation page

TC TrashCan Icon The ‘Clear’ trashcan icon will delete at the ‘row’ level only

TC Save and This button will navigate the employee to the ‘Start / Home’ screen (NOT
Return to the navigator)
Tmecard Home

Definitions/Notes
Descriptions of new, confusing, or critical terms

Assumptions
This design assumes that the following statements are true:

ENFORCES ASSUMPTION WHERE NOTE:

RULE

WS Home Codes will be stored in EBSHR vs. PeopleSoft Oracle HR - DFF

WS An alert or Notification will be sent to the Employee if a change is made

to a rejected timecard

TC / OTLR An employee can map to 5 Home Codes

TC Note to Approver / Reviewer is free form field that is at the ‘week’ level
and is displayed at the header of the timecard

TC Timecard will Auto-Populate the Holidays via the Holiday Calendar. The
default data will be modifiable.

Business Systems Page 9 3/12/2009

Functional Overview

Process Overview
Visio diagram that depicts the data flow from source to destination. Does not identify specific
modules, platforms, etc, just the steps to move the data

Form/Report/Interface Description
Fermilab Exempt Custom Timecard – Daily Entry in Hours – TC Calculates Units

Business Systems Page 10 3/12/2009

CUSTOMIZATION A– Display ‘Accrual Balance’
CUSTOMIZATION LABEL DISPLAY DATA MAP FROM STORE IT _____
MAINTAINED IN
TC Accrual Balance - none- NA

WS (FF) As of: Month Date, Year Sunday prior to the update

date TBD

WS (FF) Vacation Balance Number (follow PS Interface

w/ label ‘days’)

WS (FF) Sick Balance NO DISPLAY PS Interface

WS (FF) Floating Holiday Number (follow PS Interface

Balance w/ label ‘days’)

NOTE:
- We will be receiving the ‘Sick’ accrual balance … It will be validated against but will not be displayed.
-PS will send an accrual balance of ‘0’ for Vacation during an employee’s initial probation period.

CUSTOMIZATION B– Display ‘Labor Distribution’

CUSTOMIZATION LABEL DISPLAY DATA MAP FROM STORE IT _____
MAINTAINED IN

Default Home Task - none- NA

Project Project Number Oracle HR Employment DFF

Record

Task Task Number Oracle HR Employment DFF

Record

% % allocated Oracle HR Employment DFF

Record

CUSTOMIZATION C– Display of Period Drop Down and Comments block

-Renamed ‘Comments’ label for the free form data entry box to ‘Note to Approver / Reviewer’. This comment box will be displayed to
the Approver / Reviewer once the timecard is submitted. This box is at the ‘week level’

CUSTOMIZATION LABEL DISPLAY MAP FROM STORE IT _____

MAINTAINED IN DATA

Period No Drop Down

should be
made available

Note to Approver / Free From NA

Reviewer Field

Business Systems Page 11 3/12/2009

CUSTOMIZATION D– Payroll Details

-Timecard will display Monday through Sunday

-Saturday/Sunday will not be editable
--Timecard will use the delete functionality (label renamed to ‘Clear’) to clear entries made in the start and stop fields

CUSTOMIZATION LABEL DISPLAY DATA MAP FROM STORE IT _____

MAINTAINED IN

WS Hours Drop Down of Absence Elements Drop down will default from
Type employees assigned
Preference Tree

WS Details Drop Down of family members that The drop down will populate
correspond w/ DFS. No other lists with the appropriate choices
have been identified

Units Create a Pull down to only NA

allow the choice of 4 or 8 or
5 or 10 hours – WF Payroll

Delete Trash Can icon NA

TC TotalL Calculated field based entries

made Monday through Friday

CUSTOMIZATION E.1 and E.2 – Buttons

Cancel – Close form take user back to 1st search page (do not close form w/out a warning that changes have not been saved .. do
you want to .. yes/no)
Save for Later – Save/Store data entered. User will NOT be automatically linked to a different screen
'Save and Return to Timecard Home' - This button will navigate the employee to the ‘Start / Home’ screen (NOT the navigator)
Continue to Review – Save/Store data and continue to confirmation/submittal page
Calculate Hrs to Units – This button will calculate (weekly summary) using the following formula. The ‘Total Units Available’ is
equal to 40 - # of units entered in the Payroll Details.

Business Systems Page 12 3/12/2009

Add Another Row – Add a addition row for data entry

Business Systems Page 13 3/12/2009

CUSTOMIZATION F – Static text

Include legal disclaimer statement: Statement TBD

CUSTOMIZATION G – Effort Details

Effort Details – DATA FIELDS

CUSTOMIZATION LABEL DISPLAY DATA MAP FROM
MAINTAINED IN

Total Editable Fields Mon – Sun all numbers should round

Home Task to the tenth
Allocation

Project LOV DROP DOWN will default from employees

assigned Preference Tree – PA original source

Task LOV (view should be of task # and first X characters DROP DOWN will default from employees
of the description) assigned Preference Tree – PA original source
Will the pulldown view include the task
description ?

Activity LOV Hyperlink - DROP DOWN will default from

employees assigned Preference Tree – Name
Description Default from Alternate Names Description or
Task Description (Task description will use the
long task description in PA)
Project / Task /
Activity fields
should all be
available until the
initial field is
chosen. (If
Project is chosen
/ Activity should
not be available)

Total Hr’s Calculation off all hours entered Monday – Sunday

by row

Total Units Calculation by row using the following

formula.

The ‘Total Units Available’ is equal to 40 - #

of units entered in the Payroll Details.
Must round to the tenth

Daily Total Calculation of all hours entered in a day

Calculation of all hours entered in a week
Calculation of Units calculated in a week -
(cannot exceed 40, must round to the tenth)

Business Systems Page 14 3/12/2009

 Delete This button will delete the details for the rows
Row(s) chosen.

Example of a completed timecard

Validation Rules and Warnings

Rules that will be specifically addressed by this specification

Navigation
If user interaction is required – may only be needed for forms/screens

Performance and Volume Expectations

Number of expected transactions and response time requirements

Business Systems Page 15 3/12/2009

Unit Test Cases
Test cases that will validate of the requirements have been satisfied. The individual unit test
cases need to be listed within the table below. The Comment column should be utilized as a
status of the test case (i.e. This test failed and the test is being re-executed after a code
change…). The Developer and the Analyst should put their initials in the appropriate column
once they have verified that the test has been successful

Test Case Comment Developer Tested Analyst

Tested

User Procedures
Outline of the user procedures that will need to be created/updated because of this
customization.

Business Systems Page 16 3/12/2009

Technical Overview

File/Table/Object Details
Object Name Object Type Purpose
fnal_custom_home_codes_pkg Database Package This is a custom package. The
gethomecodes procedure of this package will
be used to populate the Home Project/Tasks
details in the Section B.
per_accrual_calc_functions Database Package The get_net_accrual procedure of this
package will be used to get the Accrual
Balances.
hxc_deposit_wrapper_utilities Database Package The timecard_hours_type_list function of
this package will be used to fill the Hours Type
field on the Payroll Details section.
hxc_timecard_utilities Database Package The get_time_periods procedure of this
package will be used to populate the Periods
field in the Section C.
hxc_timecard Database Package The create_timecard procedure of this
package will be used to store the timecard
details into the Self Service tables.
hxc_self_service_timecard Database Package The fetch_blocks_and_attributes
procedure of this package will be used to
retrieve the existing timecard data from the
database and store it into the Java view
objects.
hxc_lock_api Database Package The release_lock procedure of this package
will be used to release the locks from the
hxc_locks table.
fnal_otl_custom_pkg Database Package This is a custom package. The
getAltNamesWhere procedure will be used
to filter the rows for Project and Task fields.

Program Overview
Oracle Applications Framework (OA Framework) is the Oracle Applications development and
deployment platform for HTML based business applications. The Exempt Timecard Daily Entry
in Hours page will be designed and developed using Oracle 9i JDeveloper with OA Extension.

The Exempt Timecard Daily entry in Hours screen will be invoked from the search screen.
This screen can be used for entering a new timecard or modifying an existing timecard. This
screen can be used to report the time against the Payroll elements (Sick, Jury Duty etc) or
Effort details (Projects/Tasks) or both. The payroll elements data and effort details will be
stored for each day as per the user input.

The Section A and Section B data is static i.e., display only. The Section A has the Accrual
balance information which will be extracted from the seeded database package. The Section
B has Home Projects/Tasks allocation information which will be extracted from the Employee
Assignments DFF.

The Section C contains the Period dropdown which has the list of the Timecard Periods
entered, empty and archived. The timecard periods will be extracted from the seeded
database package.

Business Systems Page 17 3/12/2009

 The Hours Type in the Payroll Details Section will be populated from the Alternate Names
assigned to the Employee/Group. The employee should select the units from the dropdown
box. This section has “Add Another Row” and “Recalculate” buttons. By clicking the Add
Another Row, a new empty row will be created for entry. The Recalculate button is used to
calculate the Units entered for the payroll details. The “Delete (Trash can)” icon is used to
delete the selected payroll detail row.

The employee can either report time to a project/task or Activity (which is tied back to a
project and task). In the Effort Details Section, the Project, Task and Activity values will be
extracted from the Alternate Names assigned to the employee/group. This section has “Add
Another Row” and “Calculate Hrs to Units” buttons. The “Add Another Row” button is used to
add an empty row in the effort details section. The “Calculate Hrs to Units” button calculates
the total hours entered and also converts the hours to units in the Effort Details section. The
“Delete (Trash can)” icon is used to delete the selected effort detail row.

The page has three buttons “Cancel”, “Save for Later” and “Continue to Review”. When the
user clicks the “Cancel” button, the control will be taken back to “Search page”. When the
user clicks the “Save for Later” button, the data entered will be stored into the Time Store.
When the user clicks the “Continue to Review”, the control will be changed to Review page.

Process Flow Diagram

Detailed Visio that identifies every step/module in the process

Program Modules
Name Type Purpose Location Execution Method
FNALExHoDyTimeCardPG.xml XML This file /fnal/oracle/apps/hxc/otl/webui This page will be invoked
will from the Timecard Search
contain screen.
the
Exempt
Timecard
Daily Entry
in Hours
Page
definition
in XML
format.
ProjectLOVRN.xml XML This file /fnal/oracle/apps/hxc/otl/lov/webui This region will be invoked
contains when the user clicks on the
the Project Flash Light Icon on the
LOV project field.
region
definition
in XML
format.
This
region can
be shared
across
different
pages.
TaskLOVRN.xml XML This file /fnal/oracle/apps/hxc/otl/lov/webui This region will be invoked
contains when the user clicks on the
the Task Flash Light Icon on the task
LOV field.
Business Systems Page 18 3/12/2009
 region
definition
in XML
format.
This
region can
be shared
across
different
pages.
FNALExHoDyTimeCardCO.java Java Java /fnal/oracle/apps/hxc/otl/webui The controller code will be
Controller executed at the page
file rendering time.
associated
with the
Exempt
Timecard
Daily Entry
in Hours
Page. This
file will
have the
java code
which
controls
the UI,
responds
to the
user
actions
and
directs the
flow on
the page.
ProjectLOVCO.java Java Java /fnal/oracle/apps/hxc/otl/lov/webui The controller code will be
Controller executed at the project
file region rendering time.
associated
with the
Project
LOV
region.
TaskLOVCO.java Java Java /fnal/oracle/apps/hxc/otl/lov/webui The controller code will be
Controller executed at the task region
file rendering time.
associated
with the
Task LOV
region.
TBBExHoDyVO.xml XML The /fnal/oracle/apps/hxc/otl/server In the controller code any
Timecard reference to this view object,
Building the query will be retrieved
Blocks from the xml definition.
View
definition
in XML
format.
TimeAttributesExHoDyVO.xml XML The /fnal/oracle/apps/hxc/otl/server In the controller code any
Business Systems Page 19 3/12/2009
 Timecard reference to this view object,
Attributes the query will be retrieved
View from the xml definition.
definition
in XML
format.
TimecardPeriodVO.xml XML A non- /fnal/oracle/apps/hxc/otl/server This view is independent of
query the query and this view will
based be referred in
view FNALExHoDyTimecardCO.java
object for to fill the Periods field.
the
timecard
periods
definition
in XML
format.
HoursTypeVO.xml XML Hours /fnal/oracle/apps/hxc/otl/server This view will be referred in
Type View FNALExHoDyTimecardCO.java
definition to populate the Hours Type
in XML Field in the Payroll Details
format. section.

Prerequisites
This screen will be invoked from the Timecard Search Page.
Process Details

Development Estimates
The development and unit test will take minimum 160 hours.

Business Systems Page 20 3/12/2009