You are on page 1of 14

Time Submission Rule Fast

Formula Reference Guide


Oracle Fusion Time and Labor

February 07, 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 | Time Submission Rule 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:
WFM_TSR_SUBMIT_OR_SAVE_ON_NUMBER_OF_DEVICE_EVENTS_AP 4
Description 4
Parameters 4
Outputs 4
Example 5

Formula Name: WFM_TSR_SUBMIT_OR_SAVE_ON_NUMBER_OF_HOURS_AP 6


Description 6
Parameters 6
Outputs 6
Example 7

Formula Name: WFM_TSR_SUBMIT_OR_SAVE_ON_SPECIFIC_DAY_AP 8


Description 8
Parameters 8
Outputs 8
Example 9

Formula Name: WFM_TSR_SUBMIT_OR_SAVE_ON_WORK_SCHEDULE_AP 10


Description 10
Parameters 10
Outputs 10
Examples 11

2 White Paper | Time Submission Rule 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.

Time submission rule formulas determines when to automatically save and submit time card entries created with time
events imported from time collection devices. For example, automatically save a time card after each Out application event.
Or, automatically submit a time card after receiving the Out application event for the last scheduled shift of the week.

3 White Paper | Time Submission Rule Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
FORMULA NAME:
WFM_TSR_SUBMIT_OR_SAVE_ON_NUMBER_OF_DEVICE_EVENTS_AP

Description
This fast formula is associated with the delivered rule template Number of Time Entries Template. It compares the reported
Out events imported from the time collection device that match the conditions of the specified time category with the
minimum entries defined for the Submit action. If the number of reported Out events is the minimum or more, the formula
submits the time card. Otherwise, it compares the Out events with the minimum entries defined for the Save action. If the
number of Out events is the minimum or more, it saves the time card. If neither condition is met, the formula sets the time
card status to Entered. This template uses an array processing formula.
Initial release: 11.1

Parameters
WFM_TSR_SUBMIT_OR_SAVE_ON_NUMBER_OF_DEVICE_EVENTS_AP Parameter Info

NAME DATA TYPE DESCRIPTION

WORKED_TIME_CONDITION Time category Time category that identifies the reported time entries to use to
determine whether to save or submit the time card.

MIN_ENTRY_SUBMIT Fixed number Minimum reported Out events required to automatically submit the
time card.

MIN_ENTRY_SAVE Fixed number Minimum reported Out events required to automatically save the
time card.

Outputs
WFM_TSR_SUBMIT_OR_SAVE_ON_NUMBER_OF_DEVICE_EVENTS_AP Output Info

NAME MESSAGE SEVERITY

OUT_FINAL_TSR Time card action automatically started

4 White Paper | Time Submission Rule Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
Example
Your people clock out and in when taking their breaks (2 per work day), and meal. They also clock out just before leaving for
the day, for a total of 4 clock outs in a standard work day. The time card period is weekly. You create a rule with this formula
that automatically completes the appropriate action:
1. If the total reported Out events are 35 hours or more, submit the time card.
2. Else, if the total reported Out events are 7 hours or more, save the time card.
3. Else, set the time card status to Entered.
Submit if More Than 35 hours, Save if More Than 7 Hours

DEVICE PAYROLL DAY 1 DAY 2 DAY 3 DAY 4 DAY 5


EVENT TIME TYPE

In Regular 8:00a 8:00a 8:00a 8:00a 8:00a

Out and In Break 10:00a 10:00a 10:00a 10:00a 10:00a

Out and In Regular 10:15a 10:15a 10:15a 10:15a 10:15a

Out and In Lunch 12:00p 12:00p 12:00p 12:00p 12:00p

Out and In Regular 1:00p 1:00p 1:00p 1:00p 1:00p

Out and In Break 3:00p 3:00p 3:00p 3:00p 3:00p

Out and In Regular 3:15p 3:15p 3:15p 3:15p 3:15p

Out Regular 5:00p 5:00p 5:00p 5:00p 5:00p

Output Save time Save time Save time Save time Submit time
card card card card card

5 White Paper | Time Submission Rule Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
FORMULA NAME: WFM_TSR_SUBMIT_OR_SAVE_ON_NUMBER_OF_HOURS_AP

Description
This fast formula is associated with the delivered rule template Number of Hours Submission Template. It compares the
reported hours imported from the time collection device that match the conditions of the specified time category with the
minimum hours defined for the Submit action. If the total hours are the minimum or more, it submits the time card.
Otherwise, it compares the total hours with the minimum defined for the Save action. If the total hours are the defined
minimum or more, it saves the time card. If neither condition is met, it sets the time card status to Entered. This template
uses an array processing formula.
Initial release: 11.1

Parameters
WFM_TSR_SUBMIT_OR_SAVE_ON_NUMBER_OF_HOURS_AP Parameter Info

NAME DATA TYPE DESCRIPTION

WORKED_TIME_CONDITION Time category Time category that identifies the reported time entries to use to
determine whether to save or submit the time card.

MIN_HOURS_SUBMIT Fixed number Minimum total reported hours required to automatically submit the
time card.

MIN_HOURS_SAVE Fixed number Minimum total reported hours required to automatically save the
time card.

Outputs
WFM_TSR_SUBMIT_OR_SAVE_ON_NUMBER_OF_HOURS_AP Output Info

NAME MESSAGE SEVERITY

OUT_FINAL_TSR Time card action automatically started

6 White Paper | Time Submission Rule Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
Example
Your people typically work 8 Regular hours per day and 5 days per week, which is the time card period. You create a rule
with this formula that automatically completes the appropriate action:
1. If the total Regular hours are 40 hours or more, submit the time card.
2. Else, if the total Regular hours are 8 hours or more, save the time card.
3. Else, set the time card status to Entered.
Submit if More Than 40 Hours, Save if More Than 8 Hours

DAY PAYROLL REPORTED OUTPUT


TIME TYPE TIME

1 -- 4 Regular 8a – 12p Save time card


1p – 5p

5 Regular 8a – 12p Submit time card


1p – 5p

7 White Paper | Time Submission Rule Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
FORMULA NAME: WFM_TSR_SUBMIT_OR_SAVE_ON_SPECIFIC_DAY_AP

Description
This fast formula is associated with the delivered rule template Specific Day Submission Template. It compares the reported
hours imported from the time collection device that match the conditions of the specified time category with the minimum
hours defined for the Submit action. If the total hours are the minimum or more, it submits the time card. Otherwise, it
compares the total hours with the minimum defined for the Save action. If the total hours are the defined minimum or more,
it saves the time card. If neither condition is met, it sets the time card status to Entered. This template uses an array
processing formula.
Initial release: 11.1

Parameters
WFM_TSR_SUBMIT_OR_SAVE_ON_SPECIFIC_DAY_AP Parameter Info

NAME DATA TYPE DESCRIPTION

WORKED_TIME_CONDITION Time category Time category that identifies the reported time entries to use to
determine whether to save or submit the time card.

SAVE_SUBMIT_ON_MON Fixed text Submit or save time cards with time entries on or after Monday.
Valid values are Save and Submit.

SAVE_SUBMIT_ON_TUE Fixed text Submit or save time cards with time entries on or after Tuesday.
Valid values are Save and Submit.

SAVE_SUBMIT_ON_WED Fixed text Submit or save time cards with time entries on or after Tuesday.
Valid values are Save and Submit.

SAVE_SUBMIT_ON_THU Fixed text Submit or save time cards with time entries on or after Thursday.
Valid values are Save and Submit.

SAVE_SUBMIT_ON_FRI Fixed text Submit or save time cards with time entries on or after Friday. Valid
values are Save and Submit.

SAVE_SUBMIT_ON_SAT Fixed text Submit or save time cards with time entries on or after Saturday.
Valid values are Save and Submit.

SAVE_SUBMIT_ON_SUN Fixed text Submit or save time cards with time entries on or after Sunday.
Valid values are Save and Submit.

Outputs
WFM_TSR_SUBMIT_OR_SAVE_ON_SPECIFIC_DAY_AP Output Info

NAME MESSAGE SEVERITY

OUT_FINAL_TSR Time card action automatically started

8 White Paper | Time Submission Rule Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
Example
Your people typically work 8 Regular hours per day and 5 days per week, which is the time card period. You create a rule
with this formula that automatically completes the appropriate action:
1. If any time entries match the time category condition on Monday, save the time card.
2. Else, if any time entries match the time category condition on Tuesday, save the time card.
3. Else, if any time entries match the time category condition on Wednesday, save the time card.
4. Else, if any time entries match the time category condition on Thursday, save the time card.
5. Else, if any time entries match the time category condition on Friday, submit the time card.
6. Else, if any time entries match the time category condition on Saturday, submit the time card.
7. Else, if any time entries match the time category condition on Sunday, submit the time card.
8. Else, set the time card status to Entered.
Save if Mon, Tues, Wed, or Thu; Submit if Fri, Sat, or Sun

DAY PAYROLL REPORTED OUTPUT


TIME TYPE TIME

1 -- 4 Regular 8a – 12p Save time card


1p – 5p

5 Regular 8a – 12p Submit time card


1p – 5p

9 White Paper | Time Submission Rule Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
FORMULA NAME: WFM_TSR_SUBMIT_OR_SAVE_ON_WORK_SCHEDULE_AP

Description
This fast formula is associated with the delivered rule template Work Schedule Submission Template. It compares the
reported Out event imported from the time collection device that match the conditions of the time category with the submit
range. It calculates the submit range using the defined threshold, last scheduled work day, and time. If the Out event is in
that range, it submits the time card. Otherwise, the formula compares the reported Out event with the save range. If the Out
event is in that range, it saves the time card. If neither condition is met, it sets the time card status to Entered. This template
uses an array processing formula.
Initial release: 11.1

Parameters
WFM_TSR_SUBMIT_OR_SAVE_ON_WORK_SCHEDULE_AP Parameter Info

NAME DATA TYPE DESCRIPTION

WORKED_TIME_CONDITION Time category Time category that identifies the reported time entries to use to
determine whether to save or submit the time card.

SUBMIT_THRESHOLD_IN_MINUTES Fixed number Minutes used with last scheduled work day and reported time
entries to determine whether to submit the time card.

SAVE_THRESHOLD_IN_MINUTES Fixed number Minutes used with last schedule day and reported time entries to
determine whether to save the time card.

Outputs
WFM_TSR_SUBMIT_OR_SAVE_ON_WORK_SCHEDULE_AP Output Info

NAME MESSAGE SEVERITY

OUT_FINAL_TSR Time card action automatically started

10 White Paper | Time Submission Rule Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
Examples
Scenario: Your people typically work 8 Regular hours per day and 5 days per week, which is the time card period. You create
a rule with this formula that compares the total day and weekly hours to the scheduled total of 40 hours. The submit
threshold is 4 and the save threshold is 9. If the formula can't find the schedule or the total hours equals 0, then submit the
time card.
Example1: The total reported payroll hours equal 30 hours, which is less than both the 36 submit and 31 save threshold hours
so the formula sets the time card status to Entered.
Time Card Status Is Entered

DAY PAYROLL REPORTED OUTPUT


TIME TYPE TIME

1 Regular 5h 8h
3h

2 Regular 8h 8h

3 Regular 2h
6h 8h

4 Regular 5h
1h 6h

30h

Example 2: The total reported payroll hours equal 32 hours, which is between the 36 submit and 31 save threshold hours so
the formula saves the time card.
Time Card Status Is Saved

DAY PAYROLL REPORTED OUTPUT


TIME TYPE TIME

1 Regular 5h 8h
3h

2 Regular 8h 8h

3 Regular 2h
6h 8h

4 Regular 5h
3h 8h

32h

11 White Paper | Time Submission Rule Fast Formula Reference Guide | Version 1.00
Copyright © 2020, Oracle and/or its affiliates | Confidential: Public
Example 3: The total reported payroll hours equal 38 hours, which is over the 36 submit threshold hours so the formula
submits the time card.
Time Card Status Is Submitted

DAY PAYROLL REPORTED OUTPUT


TIME TYPE TIME

1 Regular 5h 8h
3h

2 Regular 8h 8h

3 Regular 2h
6h 8h

4 Regular 5h
3h 8h

5 6h 6h

38h

12 White Paper | Time Submission Rule 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

Time Submission Rule Fast Formula Reference Guide


February, 2020

You might also like