Totalizer Extensibility Setup Tool

Process	Description
TotalizerExtensibility_v1	Initial release. This setup tool facilitates creation and maintenance of configurations needed by Totalizer extensibility points.
TotalizerExtensibility_v2	The Totalizer Extensibility Setup Tool now includes the Consecutive Day Overtime Reset extension.

• The Totalizer Extensibility Setup Tool must be implemented.

• The system prevents deletion of any custom zone that is in use by a combination rule or paycode A category of time or money that employees earn, for example, Regular Hours, Bonus, or Sick. distribution.

An administrator launches the Totalizer Extension Setup Tool from My Business Processes.

When the Totalizer Extension Setup pane displays, the administrator selects Consecutive Day Overtime Reset from the list, and then proceeds through each step to create, update, or delete overtime custom zones.

The administrator then selects these custom zones during the combination rule definition for subsequent reference when constructing the paycode distribution. Work and pay rules must be created, and then assigned to the employee.

To illustrate consecutive day overtime reset options, let us examine approaches at two organizations.

Rest Days

Organization ABC stipulates that the overtime eligibility period resets after the employee has 2 contiguous rest days. The employee must work more than 5 days before overtime is paid.

Employee A works for two days and then has two rest days. The employee then works for seven days. Overtime is paid on days 6 and 7.

Employee B works for two days and then has one rest day. This pattern repeats and then the employee works for three continuous days. Overtime is paid on days 8 and 9.

In each case, the employee continues to receive overtime until 2 contiguous rest days occur.

Rest Days + Premium Days

Organization XYZ stipulates that the overtime eligibility period resets after the employee has 2 contiguous nonworking days or receives overtime for a specified number of days. The employee must work more than 5 days before overtime is paid. Overtime pay is limited to a maximum of 1 day.

Employee C works for eight days. Overtime is paid on day 6 and the eligibility period resets on the same day.

Before implementing the Consecutive Day Overtime Reset extension, you must complete each of the following steps to configure the custom zone assignment.

• Custom zones: Create custom zones by way of the Totalizer Extensibility Setup Tool for each consecutive day overtime that is applicable within the organization.

• Combination rules: Create a combination rule that includes the selection of each custom zone. See the Combination Rules topic.

• Paycode Distributions: Create a pay code distribution based on the zones and overtimes from the combination rule. This single pay code distribution applies to all types of overtime processing available to employees. See the Paycode Distributions topic.

• Work Rules: Create a work rule by selecting the pay code distribution that is configured with the custom zones. Configure the available overtimes and zones. See the Work Rules topic.

• Pay Rules: Create a pay rule that includes selection of the appropriate work rule. See the Pay Rules topic.

  Note: Assign the pay rule to all employees who rely on Consecutive Day Overtime Reset functionality.

Note: Decision tables are configurable based on user requirements and can be changed accordingly. These tables are dynamic and can be updated at any time without redeployment of the process model.

1. Go to Main Menu > Administration > Application Setup > Business Process setup > Process Models.

2. Select the TotalizerExtensibilitySetup_v2 process and click tap Edit. The process model enters edit mode.

3. Select the Decision Tables tab.

4. Click Tap Everyone's, and then select a decision table to edit.

5. Click Tap Decision Table Editor to add or update the rows in the table.

6. Click Tap Save and close.

7. Repeat the step for each TotalizerExtensibilitySetup_ConsecutiveDayOvertimeReset decision table.
   Caution:

   • Values entered in the decision tables are case-sensitive, and must match configured values in the application

   • Do not remove variables, variable names, or variable types from any decision table.

   • TotalizerExtensibilitySetup_ConsecutiveDayOvertimeReset_v2_InternalParameters — Controls internal parameters that are specific to Consecutive Day Overtime Reset.

     Totalizer Extensibility Setup — Consecutive Day Overtime Reset — Internal Parameters decision table structure

     Column name	Description
     Parameter Name	Parameter lookup key name.
     Parameter Value	Parameter lookup value.

     Totalizer Extensibility Setup — Consecutive Day Overtime Reset — Internal Parameters sample content

     Parameter name	Description
     Admin	Internal user; do not change. Default = SERVICES-LEVEL3
     ResetType	Reset type default value. This value must always = ConsecutiveRestDays
     DefaultNumberOfDays	Identify the day number on which the employee is eligible for overtime after working consecutive days. Default = 6
     DefaultNumberOfRestDays	Determine the number of rest days that must occur before the overtime reset is performed. Default = 2
     Default_MaxNumberOfDaysPremiumPay	Maximum number of days for which overtime is provided. Default = 999
     requiresApproval	Determine whether the overtime reset requires approval. This value must always = false
     OvertimeOverridePrefix	(Optional) Enter a semicolon or comma-separated list of overtime prefixes that filters overtime paycodes displayed on the form. When left blank, all overtime paycodes display. Note: Wildcards, such as * or ?, are supported.
     DefaultLastDayMinimumHours	Last Day Minimum Hours default value. Default = 00:00 Note: Must adhere to the HH:mm format.
     DefaultMinimumHours	Minimum Hours default value. Default = 00:00 Note: Must adhere to the HH:mm format.

   • TotalizerExtensibilitySetup_ConsecutiveDayOvertimeReset_v2_Locale — Provides translation of business process messages and labels that are specific to Consecutive Day Overtime Reset on the task form into different languages.

     Totalizer Extensibility Setup — Consecutive Day Overtime Reset — Locale decision table structure

     Column name	Description
     Locale Parameter Name	Key for which localization is defined.
     Locale Policy	Locale Policy. You can use an asterisk (*) as a wildcard, but put the less-restrictive locale policy names at the bottom of the table because the integration scans cross-reference tables from the top.
     Locale Message	Form label or message shown as the result of a processing error.

     Totalizer Extensibility Setup — Consecutive Day Overtime Reset — Locale sample content

     Key	Locale	Message
     Error_CDRExtensionNameInUse	!= empty	This Zone is already in use.
     Error_CDRExtensionNameRequired	!= empty	Mandatory field cannot be null.
     Error_CDRLastDayMinimumHoursErrorMessageValidation	!= empty	DefaultLastDayMinimumHours must adhere to HH:mm format.
     Error_CDRLastDayMinimumHoursOutOfRangeErrorMessageValidation	!= empty	DefaultLastDayMinimumHours value is out of range. Minimum value: 00:00, Maximum value: 24:00.
     Error_CDRMinimumHoursErrorMessageValidation	!= empty	DefaultMinimumHours must adhere to HH:mm format.
     Error_CDRMinimumHoursOutOfRangeErrorMessageValidation	!= empty	DefaultMinimumHours value is out of range. Minimum value: 00:00, Maximum value: 24:00.
     Label_ButtonClose	!= empty	Close
     Label_CDRAction	!= empty	Action
     Label_CDRActionDelete	!= empty	Delete
     Label_CDRActionUpdate	!= empty	Update
     Label_CDRButtonClose	!= empty	Close
     Label_CDRButtonCreate	!= empty	Create Custom Zone
     Label_CDRButtonDelete	!= empty	Delete
     Label_CDRButtonEdit	!= empty	Edit
     Label_CDRButtonEditDeleteZone	!= empty	Create, Edit or Delete Zone
     Label_CDRButtonGoBackToPrevious	!= empty	Go Back
     Label_CDRButtonNext	!= empty	Next
     Label_CDRButtonOvertimeOverrides	!= empty	Select Overtime Overrides
     Label_CDRButtonSubmit	!= empty	Submit
     Label_CDRButtonUpdate	!= empty	Update
     Label_CDRCheckboxButtonOvertimePreferences	!= empty	Overtime Preferences
     Label_CDRConsecutiveDayWorked	!= empty	Consecutive Day Worked
     Label_CDRConsecutiveType	!= empty	Consecutive Type
     Label_CDRCreatedSuccessfully	!= empty	Zone created successfully
     Label_CDRCustomZoneSetupHeader	!= empty	Custom Zone Setup
     Label_CDRDeletedSuccessfully	!= empty	Zone deleted successfully
     Label_CDRLastDayMinimumHours	!= empty	Last day minimum hours
     Label_CDRMaximumPremiumDays	!= empty	Maximum Premium Days
     Label_CDRMinimumHours	!= empty	Minimum Hours
     Label_CDRName	!= empty	Name
     Label_CDRNewZoneRule	!= empty	New Zone Rule
     Label_CDRNumberofDays	!= empty	Number of Days
     Label_CDROvertimeOverride	!= empty	Overtime Overrides
     Label_CDRRestDays	!= empty	Rest Days
     Label_CDRSelectConsecutiveZone	!= empty	Select Consecutive Zone
     Label_CDRSetupOptionsCreateNew	!= empty	Create Zones
     Label_CDRSetupOptionsEditDeleteZone	!= empty	Edit/Delete Zones
     Label_CDRSummary	!= empty	Summary
     Label_CDRTotalizerExtensionSetup	!= empty	Totalizer Extension Setup
     Label_CDRUpdatedSuccessfully	!= empty	Zone updated successfully
     Label_CDRZoneRule	!= empty	Zone Rule
     Label_CDRZoneType	!= empty	Zone Type

API Details — Consecutive Day Overtime Reset

API name	Type	Resource path
Create a new Consecutive Day Overtime Reset — Custom Zone	POST	/v1/totalizer/extensibility/processor
Update Consecutive Day Overtime Reset — Custom Zone	PUT	/v1/totalizer/extensibility/processor/{id}
Retrieve Consecutive Day Overtime Reset — Custom Zones	GET	/v1/totalizer/extensibility/processor
Delete Consecutive Day Overtime Reset — Custom Zone	DELETE	/v1/totalizer/extensibility/processor/{id}
Retrieve Overtime Rules	GET	/v1/timekeeping/setup/overtime_rules

The system prevents deletion of any custom zone that is in use by a combination rule or employee overtime preference selection.

An administrator launches the Totalizer Extension Setup tool from My Business Processes.

When the Totalizer Extension Setup pane displays, the administrator selects Overtime Preferences from the list, and then proceeds through each step to create, update, or delete overtime preference display names. Upon completion, the names display in combination rule configuration and employee overtime preference selection.

The administrator then selects these custom zones during the combination rule definition for subsequent reference when constructing the paycode combination and distribution. Work and pay rules must be created, and then assigned to the employee.