Workforce Compliance

Fast Formula Reference

Guide
Oracle Fusion Time and Labor

June 29, 2020 | Version 1.00

Copyright © 2020, Oracle and/or its affiliates
Confidential: Public
PURPOSE STATEMENT
This document provides an overview of features and enhancements included in release 13.20.04.01 It is intended solely to
help you assess the business benefits of upgrading to 13.20.04.01 and to plan your I.T. projects.

DISCLAIMER
This document in any form, software or printed matter, contains proprietary information that is the exclusive property of
Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle software
license and service agreement, which has been executed and with which you agree to comply. This document and
information contained herein may not be disclosed, copied, reproduced or distributed to anyone outside Oracle without
prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any
contractual agreement with Oracle or its subsidiaries or affiliates.
This document is for informational purposes only and is intended solely to assist you in planning for the implementation
and upgrade of the product features described. It is not a commitment to deliver any material, code, or functionality, and
should not be relied upon in making purchasing decisions. The development, release, and timing of any features or
functionality described in this document remains at the sole discretion of Oracle.
Due to the nature of the product architecture, it may not be possible to safely include all features described in this document
without risking significant destabilization of the code.

1 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
TABLE OF CONTENTS
Purpose Statement 1
Disclaimer 1
Introduction 3
Formula Name: ORA_WFM_WCR_APPR_REMIND_ESCALATE_AP 4
Description 4
Parameters 4
Outputs 6
Example 6

Formula Name: ORA_WFM_WCR_ATTESTATION_ANSWER_NOTIFY_MGR_AP 7

Description 7
Parameters 7
Outputs 7
Function 7
Example 8

Formula Name: ORA_WFM_WCR_MISSING_TIME_CARD_AP 9

Description 9
Parameters 9
Outputs 9

Formula Name: ORA_WFM_WCR_MISSING_DAY_TIME_ENTRIES_AP 10

Description 10
Parameters 10
Outputs 10
Examples 10

Formula Name: ORA_WFM_WCR_IN_OUT_DANGLERS_AP 12

Description 12
Parameters 12
Outputs 12
Function 12
Example 13

2 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
INTRODUCTION
Oracle Fusion Fast Formula Cloud Services is an easy way to configure the existing functionality in Oracle Fusion Time and
Labor Cloud Services. Formulas are pieces of code that can receive information from calling program (packages), access
database information, and return values to the calling program. The calling program can use this information to modify the
process functionality. The formula language hides the complexity of accessing the tables and columns.
A formula can return more than one value to the calling program. Different programs that call the formula expect outputs to
return differently. The formula type determines the number and data type of the values to return.
 Some programs expect the defined names for outputs. In this case, if the formula doesn't use these expected
names, the process errors out at run time. The location of an expected name in the return statement doesn’t
matter.
 Some programs expect the output to return by location. In this case, if the formula doesn't find the output in the
expected location, the process errors out at run time. The name of the output doesn’t matter.
Workforce compliance rules identify upcoming compliance exceptions by reviewing time card data and unprocessed time
events to help you prevent or quickly resolve any exceptions. For example, notify managers when young people are
approaching mandated worked time limits. Or, notify managers when anyone starts a new shift before the minimum rest
period is over.

3 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
FORMULA NAME: ORA_WFM_WCR_APPR_REMIND_ESCALATE_AP

Description
This fast formula determines whether the time card was approved by the worker, their manager, or both. If not, it sends the
specified approval reminder and escalation messages. Before generating the messages, the formula checks whether the
worker is on the manually maintained exclusion list. If yes, then the process doesn't generate or send reminder and
escalation notifications.
Depending on your time approval configuration, workers might need to approve their time cards to indicate they consider
the time card data to be accurate. And, managers approve submitted time cards as part of the approval workflows. The
forumula continues to send reminders if the time card approval statuses don't change.This formula uses an array to process
time card data. It isn't associated with any delivered workforce compliance rule templates.
Initial release: 13.20. 07

Parameters
ORA_WFM_WCR_APPR_REMIND_ESCALATE_AP Parameter Info

NAME DATA DESCRIPTION

TYPE

APPROVAL_TYPE Fixed text Specify who gets the reminders. You can configure worker
reminders with different parameters than the manager reminders
and escalations. The formula has different escalation and
delegation options.
The formula doesn't differentiate between payroll and project
managers. It just looks at who the approver is.
Valid values: Worker, Manager, or Both
Default and NULL values: Manager
The Worker type looks at the worker approval status. The Manager
type looks at the time card status.

ESCL_TO_LEVEL Fixed The formula compares the value on the process with the value set
Number in the rule. If the process value is less, the formula sends an
escalation reminder. If the process value is more, it doesn't send an
escalation message.
Valid values are Arabic numerals.
Default and NULL values: 0

ENABLE_DELEGATION Yes or No Valid values: Yes or No

Default and NULL values: No

REM_UNITS_AFTER_END_DATE Fixed Number of units after the time card period end date when the
Number process and rule run and generate the reminder message. If today
is greater than or equal to the time card period end date + this
number, then the rule can send the reminder message. Otherwise,
it doesn't send the message.
The parameter assumes Days if the selected UOM is D, Hours if it's
H, and Minutes if it's M.
Valid values are Arabic numerals.
Default and NULL values: 7

4 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
 NAME DATA DESCRIPTION
TYPE

ESCL_UNITS_AFTER_END_DATE
Fixed Number of units after the time card end date when the process
Number and rule run and generate the escalation message. If today is
greater than or equal to the time card period end date + this
number, then the rule can send the escalation message to the
appropriate manager in the hierarchy. Otherwise, it doesn't send
the message.
The parameter assumes Days if the selected UOM is D, Hours if it's
H, and Minutes if it's M.
Valid values are Arabic numerals.
Default and NULL values: 10

ESCALATION_CADENCE Fixed Determines how long after the first escalation to send the
Number escalation notification to the next management level. For example,
If escalation cadence = 7, the management level increases every 7
units. The unit comes from the UOM parameter.
Valid values are Arabic numerals.
Default and NULL values: 7

UOM Fixed Used to define what the number of units is after the time card
Text period end date. If D, for days, then the parameter for start
reminder and escalations is measured in days. If H, then the
parameter is measured in number of hours. If M, then the
parameter is measured in number of minutes.
Valid Values: D (Days), H (Hours), M (Minutes)
Default and NULL values: D (Days)

OVERRIDE_WRKR_REM_MSG Message Reminder message for missing worker approval. The default
message is HWM_FF_WCR_WRKR_APPR_RMDR

OVERRIDE_MGR_REM_MSG Message Reminder message for missing manager approval. The default
message is HWM_FF_WCR_MGR_APPR_RMDR

OVERRIDE_WRKR_ESCL_MSG Message Escalation message for missing worker approval. The default
message is HWM_FF_WCR_WRKR_APPR_ESCL

OVERRIDE_MGR_ESCL_MSG Message Escalation message for missing manager approval. The default
message is HWM_FF_WCR_MGR_APPR_ESCL

5 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
Outputs
ORA_WFM_WCR_APPR_REMIND_ESCALATE_AP Output Info

ERROR CODE MESSAGE TEXT

OUT_MSG The message generated by the rule and sent to the worker’s email and worklist notification.
Three message templates were delivered (two for reminders and one for escalations). You can
reference them using the Alerts Composer tool and the Event Alert: HWM Time Approval
Reminders and Escalations alert template. To change the content of the message, you can edit
the alert template body.

Example
Parameter Settings

PARAMETER SETTING COMMENTS

APPROVAL_TYPE Both Send reminders and escalations for both

the time card and worker approval tasks

UOM D Days

REM_UNITS_AFTER_END_DATE 0

ESCL_UNITS_AFTER_END_DATE 1

ESCL_TO_LEVEL 5

ESCALATION_CADENCE 1

ENABLE_DELEGATION No

Override messages Using the default messages

Scenario: The 07/21/20 -- 07/27/20 time card was submitted on 07/26/20 and approval notifications were immediately
sent to the worker and manager. Neither the worker nor their manager approved the time card on 7/26/20 or the next day.
The manager is a first level manager, M1. In this example, the Generate Time Exceptions from Compliance Rules process is
scheduled to run daily.
Results:
1. On 07/28/20, the first day after the time card period ends, the process sends reminder notifications to both the
worker and the manager because they haven't approved the time card.
2. If the worker and manager still haven't approve the time card, when the process runs on 07/29/20, it sends them
both second reminders. It also sends escalation notifications. A notification goes to the worker's manager to let the
manager know their worker hasn't approved their time card. Another notification goes to the manager's manager
to let the second level manager know that the worker's direct manager hasn't approved the time card.
3. If the worker and manager still haven't approved the time card, when the process runs on 07/30/20, it sends third
reminders to the worker and their manager. It sends second escalation notifications to the manager and the
manager's manager. It also sends escalation notifications to the manager’s manager and manager's manager's
manager to let the second and third level managers know that the first level manager hasn't approved the time
card.
The reminders and escalations continue until the worker and their manager approve the time card. The escalation level
continues until the process notifies the fifth-level manager. At that point, the reminders and escalations continue to go to
the same people.

6 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
FORMULA NAME: ORA_WFM_WCR_ATTESTATION_ANSWER_NOTIFY_MGR_AP

Description
This fast formula determines whether the attestation answer requires the formula notify the manager. The message severity
is an output associated with the generated message. This formula uses an array to process time card data. It isn't associated
with any delivered workforce compliance rule templates.
Initial release: 13.19.10

Parameters
ORA_WFM_WCR_MISSING_DAY_TIME_ENTRIES_AP Parameter Info

NAME DATA TYPE DESCRIPTION

QUESTION_CODE Fixed text Code of the question asked in the attestation.

ANSWER_CODE Fixed text Code of the answer submitted in the attestation.

OVERRIDE_MSG_CODE Message Code of the message that overrides the code of the delivered
default message
ORA_WFM_WCR_ATTESTATION_ANSWER_NOTIFY_MGR_AP,
which is HWM_FF_WCR_ACCESS_ATTN_RESP

Tag Values Fixed text Optional, comma-separated tags

Outputs
ORA_WFM_WCR_MISSING_DAY_TIME_ENTRIES_AP Output Info

ERROR CODE MESSAGE TEXT

OUT_MSG Specify whether the output message is informational, warning, or error

Function
If the question code is equal to the value specified for the Question code parameter and the answer code is equal to
specified value of the Answer code parameter, then generate an exception. And, depending on the setup, send a notification
to the manager.

7 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
Example
The attestation set that includes a meal break attestation. The attestation time category from this attestation set helps
identify a clock out done more than 5 hours after the previous clock in. Because the elapsed duration is more than 5 hours,
the meal break attestation appears. When the person confirms they didn’t take a meal break, they're asked why--personal or
business reasons? If it was for business reasons, their manager is notified because organizational policy requires that the
manager grant a penalty.
From Web Clock Events to Attestations

DAY 1 DAY 2 DAY 3 DAY 4 DAY 5

Web Clock events In: 8:02a In: 8:03a In: 8:01a In: 8:03a In: 7:58a
Out: 1:01p Out: 1:58p Out: 1:58p Out: 1:58p

Time entry 8:02a – 1:01p 8:03a – 1:58p 8:01a -- 8:03a – 1:58p 7:58a – 1:58p

Elapsed duration 4h 59m 5h 55m 5h 55m 6h 00m

between In and
Out

Meal break 0 0 0 0 0

Attestation None because the A question about None because the A question about A question about
elapsed duration the meal break person didn't clock the meal break the meal break
is less than 5h. appears because out, and it's this appears because appears because
the elapsed action that causes the elapsed the elapsed
duration is more the attestation to duration is more duration is more
than 5h. The appear. than 5h. The than 5h. The
person answers person answers person answers
that they didn't that they did take that they didn't
take their meal their meal break. take their meal
break for business They need to break for personal
reasons. report it or ask reasons.
their manager to
do so.

8 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
FORMULA NAME: ORA_WFM_WCR_MISSING_TIME_CARD_AP

Description
This fast formula determines whether a time card exists. If the formula doesn't find one, the corresponding defined message
is generated. The message severity is an output associated with the generated message. This formula uses an array to
process time card data. It isn't associated with any delivered workforce compliance rule templates.
Initial release: 13.19.10

Parameters
ORA_WFM_WCR_MISSING_TIME_CARD_AP Parameter Info

NAME TYPE DESCRIPTION

OVERRIDE_MSG_CODE Message Code of the message that overrides the code of delivered default
code, which is HWM_FF_WCR_MISSING_TIME_CARD

TAGS_COMMA_SEPARATOR Fixed text Comma-separated tags

Outputs
ORA_WFM_WCR_MISSING_TIME_CARD_AP Output Info

ERROR CODE MESSAGE TEXT

OUT_MSG Specify whether the output message is informational, warning, or error

9 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
FORMULA NAME: ORA_WFM_WCR_MISSING_DAY_TIME_ENTRIES_AP

Description
This fast formula determines whether the person is scheduled 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 generated.
The message severity is an output associated with the generated message. This formula uses an array to process time card
data. It isn't associated with any delivered workforce compliance rule templates.
Initial release: 13.19.10

Parameters
ORA_WFM_WCR_MISSING_DAY_TIME_ENTRIES_AP Parameter Info

NAME DATA TYPE DESCRIPTION

OVERRIDE_MSG_CODE Message Code of the message that overrides the code of the delivered
default message, which is HWM_FF_WCR_MISSING_DAY_ENTRIES

TAGS_COMMA_SEPARATOR Fixed text Comma-separated tags

Outputs
ORA_WFM_WCR_MISSING_DAY_TIME_ENTRIES_AP Output Info

ERROR CODE MESSAGE TEXT

OUT_MSG Specify whether the output message is informational, warning, or error

Examples
For these examples, the current day is Wednesday, March 4, 2020. The relevant column has a green background for easy
identification.
Example 1: The formula generates a missing day exception because the person is scheduled to work and no entry exists.
Missing Day Exception

START AND MON TUE WED THU FRI SAT SUN

END TIMES 2 MAR 2020 3 MAR 2020 4 MAR 2020 5 MAR 2020 6 MAR 2020 7 MAR 2020 8 MAR 2020

Schedule 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00

Reported 8:00 – 16:00

Example 2: The formula doesn’t generate an exception because the person is scheduled to work and an entry exist.
No Missing Day Exception

START AND MON TUE WED THU FRI SAT SUN

END TIMES 2 MAR 2020 3 MAR 2020 4 MAR 2020 5 MAR 2020 6 MAR 2020 7 MAR 2020 8 MAR 2020

Schedule 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00

Reported 8:00 – 16:00 8:00 – 16:00 9:00 – 14:00

10 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
Example 3: The formula doesn't generate an exception because the person isn't scheduled to work and no entry exists.
No Missing Day Exception

START AND MON TUE WED THU FRI SAT SUN

END TIMES 2 MAR 2020 3 MAR 2020 4 MAR 2020 5 MAR 2020 6 MAR 2020 7 MAR 2020 8 MAR 2020

Schedule 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00 8:00 – 16:00

Reported 8:00 – 16:00 8:00 – 16:00

Example 4: The formula doesn't generate an exception because the person has an absence and no entry exists.
No Missing Day Exception

START AND MON TUE WED THU FRI SAT SUN

END TIMES 2 MAR 2020 3 MAR 2020 4 MAR 2020 5 MAR 2020 6 MAR 2020 7 MAR 2020 8 MAR 2020

Schedule 8:00 – 16:00 8:00 – 16:00 Sick 8:00 – 16:00 8:00 – 16:00

Reported 8:00 – 16:00 8:00 – 16:00

11 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
FORMULA NAME: ORA_WFM_WCR_IN_OUT_DANGLERS_AP

Description
This 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 generated. The message severity is an output
associated with the generated message. This formula uses an array to process time card data. It isn't associated with any
delivered workforce compliance rule templates.
Initial release: 13.17.05

Parameters
ORA_WFM_WCR_IN_OUT_DANGLERS_AP Parameter Info

NAME DATA TYPE DESCRIPTION

TAGS_COMMA_SEPARATOR Fixed text Comma-separated tags

MESSAGE_CODE_START Message Code of the message that overrides the code of the delivered
default message for entries missing the start time, which is
HWM_FF_WCR_MISSING_START_TIME

MESSAGE_CODE_END Message Code of the message that overrides the code of the delivered
default message for entries missing the end time, which is
HWM_FF_WCR_MISSING_STOP_TIME

Outputs
ORA_WFM_WCR_IN_OUT_DANGLERS_AP Output Info

ERROR CODE MESSAGE TEXT

OUT_MSG Specify whether the output message is informational, warning, or error

Function
Because workforce compliance rules don't account for incomplete entries, the default logic sets missing start time entries to
12:00a 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:00a 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.

12 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
Example
The formula generates a missing start exception on Tuesday, March 6, 2018. It generates a missing end exception on
Wednesday, March 8, 2018.
Missing End Exception

START AND MON TUE WED THU FRI

END TIMES 2 MAR 2020 3 MAR 2020 4 MAR 2020 5 MAR 2020 6 MAR 2020

Start and End Ties Imported 8:00 – 16:00 0:00 – 17:00 9:00 – 23:59 8:00 – 16:00 21:59 – 23:59
from Time Collection Device

Start and End Times Shown 8:00 – 16:00 – 17:00

in the Application

Duration Imported from 8 0 0 2

Time Collection Device

Duration Shown in the 8 -- -- 2

Application

13 White Paper | Workforce Compliance Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
CONNECT WITH US
Call +1.800.ORACLE1 or visit oracle.com.
Outside North America, find your local office at oracle.com/contact.

blogs.oracle.com facebook.com/oracle twitter.com/oracle

Copyright © 2020, 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 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, electronic or mechanical, for any purpose, without
our prior written permission.

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. 0120

Workforce Compliance Fast Formula Reference Guide

June, 2020