Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
for Release 13
Oracle Fusion Time and Labor
ORACLE WHITE PAPER | OCTOBER 2018
Table of Contents
Description 2
Description 12
Rule Function 12
Examples 12
Formula Name:
ORA_WFM_TCR_OT_EARNED_DAYS_FOR_ENTRIES_THAT_SPAN_DAYS 16
Description 16
Rule Function 16
Description 17
Rule Function 17
Example 18
Description 19
Rule Function 19
Example 20
Description 21
Rule Function 22
Examples of WORK_ANY_WEEKEND_DAY is No 23
Examples 25
Description 26
Examples of WORK_ANY_WEEKEND_DAY is No 27
Description 30
Description 31
Examples 31
Description 33
Rule Function 33
Example 34
A formula can return more than one value to the calling program. Different programs that call the
formula expect outputs to return differently. Based on the formula type, the number and data type of
values to return are already defined.
» Some programs expect the defined names for outputs: the location of an output in the return
statement does not matter. If defined names are expected and the formula does not use the
expected names, the process errors out at run time.
» Some programs expect the output to return by location; in this case the name of the output does not
matter.
Description
This time calculation rule fast formula is associated with the delivered rule template Time Allocation Template. If
there is a time allocation assigned to the worker using the Manage Allocation Assignments task, then the formula
uses this allocation. Otherwise, it uses the allocation selected in the rule configuration. In both cases, the allocation
formula uses either reported or calculated time, based on the processing sequence of the allocation rule in the rule
set. It allocates the time identified by the source time category across the output time attributes. This formula uses
an array to process time data.
To view, on the time card review page, the cost segment outputs configured in the time allocation:
1. Configure the time review layouts for workers and managers accordingly.
2. Associate the appropriate layout set with the worker time entry setup profiles.
ASSIGN_FRACTION_TO_LAST_ROW Yes or No Indicates whether to adjust the last row of the time allocation output
so that total allocated hours match the number of hours identified by
the allocation rule. Time allocations of type Percent and Equally use
this parameter.
50 Cardiac Care
50 Intensive Care
Example 1: The time that the worker reported includes no conflicts with the worker's assigned allocation.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 4 8 AM – 4 8 AM – 4 8 AM – 4 8 AM – 4
PM (8) PM (8) PM (8) PM (8) PM (8)
Daily Total 8 8 8 8 8 40
Daily Total 8 8 8 8 8 40
Example 2: The time that the worker reported includes conflicts with the worker's assigned allocation.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 2 8 AM – 12 8 AM – 4 8 AM – 12
PM (6) PM (4) PM (8) PM (4)
Regular Emergency 1 PM – 5 8 AM – 4 1 PM – 5
PM (4) PM (8) PM (4)
Daily Total 8 8 8 8 4 4 40
Regular Emergency 4 8 4 12
Daily Total 8 8 8 8 4 4 40
1 20 Cardiac Care
2 20 Intensive Care
Example 1: The time card period total equals the defined allocation quantity.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 4 8 AM – 4 8 AM – 4 8 AM – 4 8 AM – 4
PM (8) PM (8) PM (8) PM (8) PM (8)
Daily Total 8 8 8 8 8 40
Daily Total 8 8 8 8 8 40
Example 2: The time card period total is less than the defined allocation quantity.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 12 8 AM – 4 8 AM – 4 8 AM – 4 1 PM – 5
PM (4) PM (8) PM (8) PM (8) PM (4)
Daily Total 4 8 8 8 4 32
Daily Total 4 8 8 8 4 32
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 4 8 AM – 6 8 AM – 4 8 AM – 4 8 AM – 4 8 AM – 4
PM (8) PM (10) PM (8) PM (8) PM (8) PM (8)
Daily Total 8 10 8 8 8 8 50
Regular 2 8 10
Daily Total 8 10 8 8 8 8 50
Example 4: The time card period total is greater than the defined allocation quantity and the time that the worker
reported includes conflicts with the worker's assigned allocation.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 2 8 AM – 12 8 AM – 4 8 AM – 12 8 AM – 12
PM (6) PM (4) PM (8) PM (4) PM (4)
Regular Emergency 1 PM – 5 8 AM – 4 8 AM – 12
PM (4) PM (8) PM (4)
Daily Total 8 8 8 8 8 4 4 48
Regular Emergency 4 8 4 16
Daily Total 8 8 8 8 8 4 4 48
5 20 Cardiac Care
10 10 Intensive Care
15 Balance Operation
Example: The time that the worker reported includes conflicts with the worker's assigned allocation.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 4 8 AM – 4 8 AM – 4 8 AM – 4 8 AM – 12
PM (8) PM (8) PM (8) PM (8) PM (4)
On-Call Emergency 8 AM – 12
PM (4)
Regular Emergency 1 PM – 5 8 AM – 4 8 AM – 4 PM
PM (4) PM (8) (8)
Daily Total 8 12 8 16 4 4 8 60
Regular Operation 2 4 6
On-Call Emergency 4 4
Regular Emergency 4 8 8 20
Daily Total 8 12 8 16 4 4 8 60
Example 1: The time that the worker reported includes no conflicts with the worker's assigned allocation.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 4 8 AM – 4 8 AM – 4 8 AM – 4 8 AM – 4
PM (8) PM (8) PM (8) PM (8) PM (8)
Daily Total 8 8 8 8 8 40
Calculated Regular Cardiac Care 2.66 2.66 2.66 2.66 2.66 13.3
Example 2: The time that the worker reported includes conflicts with the worker's assigned allocation.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 2 8 AM – 12 8 AM – 4 8 AM – 12
PM (6) PM (4) PM (8) PM (4)
Regular Emergency 1 PM – 5 8 AM – 4
PM (4) PM (8)
Daily Total 8 8 8 8 4 4 40
Regular Emergency 4 8 12
50 Cardiac Care
50 Intensive Care
Example 1: The time that the worker reported includes no conflicts with the worker's assigned allocation.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 7 AM – 12 8 AM – 5 8 AM – 5
PM (5) PM (9) PM (9)
Regular Emergency 1 PM – 4 8 AM – 5
PM (3) PM (9)
Regular Emergency 3 8 11
Overtime Emergency 1 1
1 20 Cardiac Care
2 20 Intensive Care
Example: The time that the worker reported includes conflicts with the worker's assigned allocation. The time card
period total is greater than the defined allocation quantity.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 2 8 AM – 12 7 AM – 12 8 AM – 12 8 AM – 12
PM (6) PM (4) PM (5) PM (4) PM (4)
Regular Emergency 4 PM – 6 1 PM – 5 4 PM – 6 8 AM – 4 8 AM – 12
PM (2) PM (4) PM (2) PM (8) PM (4)
Daily Total 10 8 10 8 8 4 4 52
Regular Emergency 2 4 2 8 4 20
Daily Total 10 8 10 8 8 4 4 52
Regular Emergency 4 8 4 16
Overtime Emergency 2 2 4
Daily Total 10 8 10 8 8 4 4 52
5 20 Cardiac Care
10 10 Intensive Care
15 Balance Operation
Example: The time that the worker reported includes conflicts with the worker's assigned allocation.
Worked Weekly
Department Mon Tue Wed Thu Fri Sat Sun
Time Total
Reported Regular 8 AM – 6 7 AM – 4 8 AM – 4 8 AM – 4 8 AM – 5
PM (10) PM (9) PM (8) PM (8) PM (9)
On-Call Emergency 4 PM – 6 8 AM – 12 8 AM – 4 PM
PM (2) PM (4) (8)
Daily Total 10 9 8 10 9 4 8 58
Regular Operation 5 9 14
On-Call Emergency 2 4 8 14
Daily Total 10 9 8 10 9 4 8 58
Regular Operation 5 8 13
On-Call Emergency 4 8 12
Overtime Emergency 2 2
Overtime Operation 1 1
Daily Total 10 9 8 10 9 4 8 58
RESOLVE_SPAN_RULE Fixed Text Rule to use to determine on what day to calculate time for reported
time entries that span days. Valid values are:
» START_DAY: Time calculation rules should treat time entries as
being entirely on the start day.
» STOP_DAY: Time calculation rules should treat time entries as
being entirely on the stop day.
» DAY_WITH_MOST_TIME: Time calculation rules should treat time
entries as being entirely on the day with the longest time duration.
» SPLIT_AT_DAY_START: Time calculation rules should split time
entries at the time where one day ends and the other starts.
» SCHEDULE_REF_DAY: Time calculation rules treat all time entries
as being on the reference day of the scheduled shift
DAY_START_TIME Time HH:MM Time, in hours and minutes, that marks the start of the day
GROUPING_THRESHOLD Fixed Number Threshold, in minutes, used to group reported time entries on one or
another of the multiple days.
ORA_HWM_FF_DAY_SPLIT_FLAG Exclude Internal indicator to split the day. Does not show on the rule pages.
Rule Function
Specifies to resolve time entries that span multiple days using the rule {RESOLVE_SPAN_RULE}. In cases where
the time entries span multiple days equally, use {HANDLING_TIES}. For this rule, the day start time is
{DAY_START_TIME} and the threshold for grouping time entries on one day or another is
{GROUPING_THRESHOLD} minutes.
Examples
Scenario: The work day starts at 4:00 AM.
Payroll Time Type Day 1 Day 2 Day 3 Day 4 Day 5 Day 6 Day 7
Payroll Time Type Day 1 Day 2 Day 3 Day 4 Day 5 Day 6 Day 7
Payroll Time Type Day 1 Day 2 Day 3 Day 4 Day 5 Day 6 Day 7
Hours 12 8 8 12 8
Example 4: The spanning days rule is day with most time and the tie-handling rule is stop day.
Payroll Time Type Day 1 Day 2 Day 3 Day 4 Day 5 Day 6 Day 7
Hours 4 8 16 4 8 8
Payroll Time Type Day 1 Day 2 Day 3 Day 4 Day 5 Day 6 Day 7
Hours 8 7 13 8 7.5 5
Example 6: The spanning days rule is the reference day of the scheduled shift
Reported Regular (hours) 11:00 PM- 11:00 PM- 11:30 PM- 11:00 PM- 11:30 PM-
7:00 AM 6:30 AM 7:30 AM 7:00 AM 7:00 AM
Time Regular (hours) 11:00 PM- 11:00 PM- 11:30 PM- 11:00 PM- 11:30 PM-
Calculations 7:00 AM (from 6:30 AM (from 7:30 AM (from 7:00 AM (from 7:00 AM (from
Use… Day 1) Day 2) Day 3) Day 4) Day 5)
» The day to use in calculations that include reported time entries that span days
» The earned day for reported time entries that span days
By default, the formula uses rule parameter values. When there are no values from the rule, it uses the values
composing the worker's work day definition. This fast formula uses an array to process time card data.
OVERTIME_DAY_START_TIME Time HH:MM Time, in hours and minutes, that marks the start of the day to use in
time calculation rules that calculate overtime
EARNED_RESOLVE_SPAN_RULE Fixed Text Rule to use to determine the earned day for reported time entries that
span days. Valid values are:
» START_DAY: Time calculation rules should treat time entries as
being entirely on the start day.
» STOP_DAY: Time calculation rules should treat time entries as
being entirely on the stop day.
» DAY_WITH_MOST_TIME: Time calculation rules should treat time
entries as being entirely on the day with the longest time duration.
» SPLIT_AT_DAY_START: Time calculation rules should split time
entries at the time where one day ends and the other starts.
SCHEDULE_REF_DAY: Time calculation rules treat all time entries as
being on the reference day of the scheduled shift
EARNED_GROUPING_THRESHOLD Fixed Number Threshold, in minutes, used to group reported time entries on one or
another of the multiple days.
ORA_HWM_FF_DAY_BREAKER_FLAG Exclude Internal indicator to split the day. Does not show on the rule pages.
Rule Function
Specifies to resolve time entries that span multiple days using the rule {EARNED_RESOLVE_SPAN_RULE} for
earned day. Automatically uses the rule SPLIT_AT_DAY_START for overtime. When determining the earned day, in
cases where the time entries span multiple days equally, use {EARNED_HANDLING_TIES}. For this rule, the day
start time is midnight and the threshold for grouping time entries on one day or another is
{EARNED_GROUPING_THRESHOLD} minutes. When determining the overtime day, the day start time is
{OVERTIME_DAY_START_TIME}.
Description
This time calculation rule fast formula determines unit quantities for reported time based on specific time attributes. It
generates a unit time attribute for the day if the reported time category hours on that day include the specified time
attributes. This fast formula uses an array to process time card data. It isn't associated with any delivered time
calculation rule templates.
WORKED_TIME_CONDITION Time category Time category of reported hours that include the specified time
attributes used to determine whether to generate a units time attribute.
NUMBER_OF_UNITS Fixed number Numeric value for the number of units with UN unit of measure to
allocate for each detail found.
Note that for start and stop times, the rate amount and periodicity values in the generated Units time entry are reset
to empty values.
Rule Function
For each detail time card record found, based on time category, add the number of units specified in
NUMBER_OF_UNITS to the time card with a unit amount of 'UN' (Units).
Payroll Time Type Day 1 Day 2 Day 3 Day 4 Day 5 Day 6 Day 7
Description
This time calculation rule fast formula determines unit quantities for reported time that spans a specific time range. It
generates a unit time attribute for the day if the reported time category hours span the specified time range. This fast
formula uses an array to process time card data. It isn't associated with any delivered time calculation rule
templates.
WORKED_TIME_CONDITION Time category Time category of reported hours that include the specified time attributes
used to determine whether to generate a units time attribute.
NUMBER_OF_UNITS Fixed number Numeric value for the number of units with UN unit of measure to allocate
for each detail found.
Both start and stop time parameters must have a value in every rule associated with this formula. Start and stop
time parameters indicate to generate the specified unit of measure if reported time during that time range included
time entries identified by the specified time category.
Rule Function
For each detail time card record found, based on time category, if the time card start time is between
START_TIME_HHMM24 and STOP_TIME_HHMM24, add the number of units specified in NUMBER_OF_UNITS to
the time card with a unit amount of UN (Units).
Payroll Time Type Day 1 Day 2 Day 3 Day 4 Day 5 Day 6 Day 7
Description
This time calculation fast formula determines unit quantity for reported weekend time. It generates a unit time
attribute for the day if the reported time category hours occur on a weekend day. This fast formula uses an array to
process time card data. It isn't associated with any delivered time calculation rule templates.
WORKED_TIME_CONDITION Time category Time category of reported hours that include the specified time
attributes used to determine whether to generate a units time attribute.
NUMBER_OF_UNITS Fixed number Numeric value for the number of units with UN unit of measure to
allocate for each detail found.
WORK_ANY_WEEKEND_DAY Yes or No If Yes, generate the number of units when the worker associated with a
rule using this formula works any day defined as weekend day.
If No, generate the number of units only when the worker associated
with a rule using this formula works all days defined as weekend days.
» If WORK_ANY_WEEKEND_DAY is Yes, add the number of units specified in NUMBER_OF_UNITS to the time
card with a unit amount of UN (Units), regardless if the worker worked only one or every day defined as a
weekend day.
» If WORK_ANY_WEEKEND_DAY is NO, add the number of units specified in NUMBER_OF_UNITS to the time
card with a unit amount of UN (Units), only if the worker worked every day defined as weekend days.
Example 1
Payroll Time Type Mon Tue Wed Thu Fri Sat Sun
Weekend Allowance 1
(units)
Example 2
Payroll Time Type Mon Tue Wed Thu Fri Sat Sun
Weekend Allowance 1
(units)
Example 3
Payroll Time Type Mon Tue Wed Thu Fri Sat Sun
Weekend Allowance 1
(units)
Example 1
Payroll Time Type Mon Tue Wed Thu Fri Sat Sun
Weekend Allowance
(units)
Example 2
Payroll Time Type Mon Tue Wed Thu Fri Sat Sun
Weekend Allowance
(units)
Description
This time entry rule fast formula determines whether reported units time entries for the units time category are less
or greater than the defined minimum and maximum unit quantities. It compares the reported time category quantity
to the defined minimum and maximum unit quantities. If the reported unit quantities are less or greater than the
defined limits, the corresponding defined message appears. If no message is defined, the default message appears.
The message severity is an output associated with the displayed message. This fast formula uses an array to
process time card data. It isn't associated with any delivered time calculation rule templates.
WORKED_TIME_CONDITION Time category Time category of reported units to sum and compare with the defined
minimum and maximum unit quantities.
MIN_HOURS Fixed number Minimum hours required for the worker associated with the rule that
uses this formula to qualify for units.
OVERRIDE_MSG_CD_MIN_QTY Message Message overriding the default one that appears if the summed units
value is less than the minimum units required.
OVERRIDE_MSG_CD_MAX_QTY Message Message overriding the default one that appears if the summed units
value exceeds the maximum units allowed.
OVERRIDE_MSG_CD_MIN_HRS Message Message overriding the default one that appears if the minimum
number of required reported hours was not reached.
Regular Meal Meal Allowance Rule Parameter Rule Parameter Rule Parameter
Error Status
(hours) (hours) (units) MIN_HOURS MIN_UNITS MAX_UNITS
7 1 1 1 1 1 No errors
Description
This time entry rule fast formula determines whether reported units time entries for the Units time category are less
or greater than the defined minimum and maximum unit quantities. It compares the reported time category quantity
to the defined minimum and maximum unit quantities. If the reported unit quantities are less or greater than the
defined limits, the corresponding defined message appears. If no message is defined, the default message appears.
The message severity is defined as an output associated with the displayed message. This fast formula uses an
array to process time card data. It isn't associated with any delivered time calculation rule templates.
WORKED_TIME_CONDITION Time category Time category of reported units to sum and compare with the defined
minimum and maximum unit quantities.
WORK_ANY_WEEKEND_DAY Yes or No If Yes, generate the number of units when the worker associated with
a rule using this formula works any day defined as weekend day.
If No, generate the number of units only when the worker associated
with a rule using this formula works all days defined as weekend days.
OVERRIDE_MSG_CD_MIN_QTY Message Message overriding the default one that appears if the summed units
value is less than the minimum units required.
OVERRIDE_MSG_CD_MAX_QTY Message Message overriding the default one that appears if the summed units
value exceeds the maximum units allowed.
OVERRIDE_MSG_CD_MIN_HRS Message Message overriding the default one that appears if the minimum
number of required reported hours was not reached.
Example 1
Sun 7 1 1 1 No error
Example 2
Sun 7 1 1 1 No error
Example 3
Sat 3 1 1 1 No error
Example 4
Example 5
Examples of WORK_ANY_WEEKEND_DAY is No
Example 1
Sat 7 1 1 1 No error
Sun 7 1 1 1 No error
Example 2
Sat 7 1 1 1 No error
Example 3
Example 5
Sun 7 1 1 1 No error
Example 6
Description
This workforce compliance fast formula determines whether a time card exists. If the formula doesn't find one, the
corresponding defined message is created. The message severity is an output associated with the displayed
message. This fast formula uses an array to process time card data. It isn't associated with any delivered workforce
compliance rule templates.
OVERRIDE_MSG_CODE Message Message code that overrides the delivered default message code,
which is HWM_FF_WCR_MISSING_TIME_CARD
Description
This workforce compliance fast formula determines whether the worker is schedule to work the current day. If yes, it
determines whether time entries exist for the current day. If the formula doesn't find any entries, the corresponding
defined message is created. The message severity is an output associated with the displayed message. This fast
formula uses an array to process time card data. It isn't associated with any delivered workforce compliance rule
templates.
OVERRIDE_MSG_CODE Message Message code that overrides the delivered default message code,
which is HWM_FF_WCR_MISSING_DAY_ENTRIES
Examples
For these examples, the current day is Wednesday, March 7, 2018. The relevant column has a green background
for easy identification.
Example 1: A missing day exception is generated because the worker is scheduled to work and no entry exists.
Schedule 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00
Example 2: No exception is generated because the worker is scheduled to work and an entry exist.
Schedule 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00
Schedule 8:00 – 16:00 8:00 – 16:00 Sick 8:00 – 16:00 8:00 – 16:00
Description
This workforce compliance fast formula determines whether time entries are incomplete, meaning that either the
start or end time is missing. If the formula finds an incomplete entry, the corresponding defined message is created.
The message severity is an output associated with the displayed message. This fast formula uses an array to
process time card data. It isn't associated with any delivered workforce compliance rule templates.
MESSAGE_CODE_START Message Message code that overrides the delivered default message code for
entries missing the start time, which is
HWM_FF_WCR_MISSING_START_TIME
MESSAGE_CODE_END Message Message code that overrides the delivered default message code for
entries missing the end time, which is
HWM_FF_WCR_MISSING_STOP_TIME
Rule Function
Since the rule engine, and thus workforce compliance rules, doesn't account for incomplete entries, default logic
sets missing start time entries to 12:00 AM and a duration of 0. It sets missing end time entries to 23.59.59 and a
duration of 0.
» The formula generates a missing start message if the time entry start time is 12:00 AM and the duration is 0.
» The formula generates a missing end message if the time entry stop time is 23.59.59 and the duration is 0.
Start and End Ties 8:00 – 16:00 0:00 – 17:00 9:00 – 23:59 0:00 – 04:00 21:59 – 23:59
Imported from Time
Collection Device
Duration Imported 8 0 0 4 2
from Time Collection
Device
Duration Shown in 8 – – 4 2
the Application
CONNECT W ITH US
blogs.oracle.com/oracle
Copyright © 2018, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
facebook.com/oracle warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any means,
twitter.com/oracle electronic or mechanical, for any purpose, without our prior written permission.
oracle.com Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 1018