Implementation Guide | PUBLIC Document Version: 2H 2021 – 2022-03-03 © 2022 SAP SE or an SAP affiliate company. All rights reserved. Implementing Time Management in SAP SuccessFactors THE BEST RUN Content 1 Change History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2 Core Concepts and Activation of Time Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 2.1 Basics of Time Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 2.2 Time Management in SAP SuccessFactors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 2.3 Activating Time Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 3 Implementation of Employee Central Time Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 3.1 Permissions Required for Time Management in General. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Activating the Time Management Configuration Search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 3.2 Time Recording Variants. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 3.3 Work Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Creating a Regular Work Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Individual Work Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Creating a Temporary Work Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 3.4 Creating a Holiday Calendar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 3.5 Implementation of Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Permissions for User Interfaces in Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Basic Setup of Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Customization of Absence Recording. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Team Absence Calendar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Updates to Time Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 Termination End Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 Purchase and Payout of Leave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Time Account Snapshots. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Country/Region-Specific Features for Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236 Integration of Time Off and Payroll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305 Activating Mobile Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305 Setting Up Alerts And Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 Handling Global Assignments and Concurrent Employment in Time Off. . . . . . . . . . . . . . . . . . . 316 Recommendations and Restrictions for Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316 Troubleshooting Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318 3.6 Implementation of Time Sheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 Basic Setup of Time Sheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 Permissions in Time Sheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 New Time Sheet UI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 Customization of Attendance Recording. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 2 PUBLIC Implementing Time Management in SAP SuccessFactors Content Additional Time Recording Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 Time Valuations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .350 Time Collectors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 Time Compensation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .384 Integrating Time Sheet with Employee Central Payroll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399 Setting Up Email Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .399 Recommendations and Restrictions for Time Sheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399 Troubleshooting: Known Issues in Time Sheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400 4 Implementation of SAP SuccessFactors Time Tracking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 4.1 Setting Up Single Record Approval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 4.2 Night Shift Bandwidth. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 Setting Up Night Shift Bandwidth in a Work Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 Creating a Time Type Group for Night Shift Bandwidth. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 Setting Up Time Valuations for Night Shift Bandwidth. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 Permission to Record Time Outside the Night Shift Bandwidth. . . . . . . . . . . . . . . . . . . . . . . . . 410 4.3 Advanced Filtering Options for Holiday-Related Premium Pay. . . . . . . . . . . . . . . . . . . . . . . . . . . . 413 5 Recalculation in Time Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 5.1 Configuring Recalculation in Time Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 Time Management Configuration Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 Effect of the Earliest Possible Recalculation Date on Recalculation. . . . . . . . . . . . . . . . . . . . . . 417 Business Rule Functions for Recalculation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 Time Management Recalculation Event. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 5.2 Triggering Recalculation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .419 How Recalculation is Triggered. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 5.3 Recalculation in Time Management - Process Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .421 The Time Management Recalculation Task and 'TLMTriggerRecalculation' Job. . . . . . . . . . . . . 422 Viewing Time Management Recalculation Results from the Execution Manager. . . . . . . . . . . . . 423 Workflow and Approval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .428 5.4 Recalculation in Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428 Recalculation Triggers in Time Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 Recalculating Absences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430 Recalculating Transfer Dates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .430 Recalculating Accruals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 How Recalculation and Other Time Off Jobs Interact. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 How Recalculation Affects Time Account Payouts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 5.5 Recalculation in Time Sheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .433 Recalculation Triggers in the Time Sheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 Recalculating Time Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .436 How Recalculation and Other Time Sheet Jobs Interact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438 5.6 How Recalculation Affects Time Management Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438 Implementing Time Management in SAP SuccessFactors Content PUBLIC 3 5.7 Retry Counter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .447 6 Rules and Rule Functions in Time Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .449 6.1 Concepts Common to All Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 Defining The "Time Off" Rule Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450 Defining The Start Date of A Rule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450 Using Employee-Specific Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .451 Using ELSE Statements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 Using Lookup Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452 Using Variables to Store Interim Rule Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455 6.2 Common Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 Accrual Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 Accrual Transfer Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480 Period-End Processing Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .487 Interim Account Update Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 Take Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .494 Time Off Workflow Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .498 On Change Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500 Flexible Account Creation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501 Periodic Update for Balance Reduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 6.3 Rule Scenarios for Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 6.4 Time Sheet Validation Rule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 6.5 Notes on Rule Functions in Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510 Rule Functions for Absence Calculations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511 Rule Functions depending on Working Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548 Job Information Rule Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563 Average Full-Time Equivalent Rule Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .583 Calculate Balance(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589 Calculate Balance for Types(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590 Calculate Entitlement Balance(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591 Cap Accrual(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592 Generate External Code For Time Off(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .592 Get Balance For Posting Types In Period(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593 Get Completed Calendar Weeks Between Dates (ISO Standard)(). . . . . . . . . . . . . . . . . . . . . . 595 Get Completed Remaining Calendar Weeks (ISO Standard)(). . . . . . . . . . . . . . . . . . . . . . . . . . 597 Get Employee Status(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599 Get Months Taking Account Of Threshold(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600 Get Months From Hire Date Taking Account Of Threshold. . . . . . . . . . . . . . . . . . . . . . . . . . . . 602 Get Number Of Calendar Days(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604 Get Number Of Eligible Days(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605 Get Number Of Holidays For Period(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .606 Get Number Of Months From Hire Date(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607 4 PUBLIC Implementing Time Management in SAP SuccessFactors Content Get Number Of Postings For Posting Types in Period(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .609 Get Sum Of Accruals Since Last Transfer(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610 Get Sum Of Advances(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 Get Time Management Earliest Recalculation Date (). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .613 Has Payouts in Period(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .613 Has Temporary Work Schedule(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614 Is Employee Active(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614 Is Time Management Recalculation Active (). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .616 Rule Functions for Dependents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616 Date and Time-Specific Rule Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624 6.6 Notes on Rule Functions in Time Sheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628 Get Working Time Account on Key Date(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .628 Get Number of Valuated Hours for Time Sheet(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629 Has Allowances In Period(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630 Get Number of Allowances in Period(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631 6.7 Country/Region Specific Rules and Rule Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632 Egypt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632 India. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .634 Saudi Arabia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651 Singapore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654 Thailand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663 United Arab Emirates (UAE). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665 7 Jobs in Time Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668 7.1 The 'TLMTriggerTask' Job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668 8 Data Retention Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670 9 Imports in Time Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671 9.1 Job Information Import with Time Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671 Validations for Leave of Absence Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .671 Validations on Forward Propagated Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672 Assigning Time Recording Profiles to Multiple Employees. . . . . . . . . . . . . . . . . . . . . . . . . . . . 673 9.2 Importing Work Schedules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674 9.3 Importing Balances for Time Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675 9.4 Importing Existing Leave Requests into Time Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677 Limitations and Restrictions of Importing Leave Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . 678 9.5 Import of External Time Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680 Creating Time Recording Profiles for Employees with Imported Times. . . . . . . . . . . . . . . . . . . . 681 Downloading Import File Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682 Filling In the Template for External Time Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684 Preventing Users from Editing Imported Time Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685 Implementing Time Management in SAP SuccessFactors Content PUBLIC 5 10 Time Management Data Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .687 10.1 Absence Counting Method Time Off Data Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687 10.2 Accrual Calculation Account Type Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688 10.3 Accrual Calculation Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689 10.4 Accrual Calculation Base Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690 10.5 Accrual Lookup By Seniority. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690 10.6 Accrual Rule Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692 10.7 Accrual Rule Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693 10.8 Accrual Transfer Rule Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693 10.9 Employee Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .694 Employee Time Calendar Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699 Employee Time Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702 Setting up Additional Restrictions for the Employee Time Object. . . . . . . . . . . . . . . . . . . . . . . 703 10.10 Holiday. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704 10.11 Holiday Calendar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704 10.12 Initial Accrual Transfer Date Rule Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .705 10.13 Interim Account Update Rule Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706 10.14 Period-End Processing Rule Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706 10.15 Periodic Time Account Update Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707 10.16 Periodic Update Rule Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708 10.17 Planned Working Time Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708 10.18 Shift Classification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709 10.19 Take Rule Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710 10.20 Temporary Time Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710 10.21 Time Account. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711 10.22 Time Account Change Calendar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 716 10.23 Time Account Payout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .718 10.24 Time Account Purchase Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719 10.25 Time Account Snapshot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721 10.26 Time Account Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722 10.27 Time Account Type Accrual Transfer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732 10.28 Time Account Type Date Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .734 10.29 Time Account Type Eligibility Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735 10.30 Time Account Type Waiting Period. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736 10.31 Time Management Alert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736 10.32 Time Management Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738 10.33 Time Management Employee Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739 10.34 Time Management Retention Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739 10.35 Time Off Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740 10.36 Time Off Rule Constants. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740 10.37 6 Time Off Rule Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741 PUBLIC Implementing Time Management in SAP SuccessFactors Content 10.38 Time Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741 10.39 Time Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743 10.40 Work Schedule Day Model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749 10.41 Work Schedule - Period. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751 10.42 Work Schedule - Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753 10.43 Work Schedule - Simple. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754 11 Proxy Management in Time Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757 11.1 Consideration of Role-Based-Permissions (RBP) in Proxy Management. . . . . . . . . . . . . . . . . . . . . 758 11.2 Proxy Management in Time Management Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .759 Implementing Time Management in SAP SuccessFactors Content PUBLIC 7 1 Change History Learn about changes to the documentation for Implementing Time Management in SuccessFactors in recent releases. 2H 2021 Type of Change Description Change We've changed the name of the guide to Implementing Time Management in SAP SuccessFactors. Change We've added information that users re­ quire the Edit permission for the Time Account Payout and Time Account Pur­ chase objects if the objects are secured, in order to use the employee self-service (ESS) feature to apply for a payout or to purchase leave. More Info ● Assigning User Permissions for Self-Service Time Account Payout [page 198] ● Assigning User Permissions for Self-Service Leave Purchase [page 229] Change Time Off Employee Self-Service Pur­ We've added some information about a permission required in the Recurring De­ chase Leave [page 47] duction object for users who want to use the employee self-service (ESS) feature to purchase leave. New Calculate Average Value For Numeric In the Calculate Average Value For Nu­ meric Job Info Field Based on Months() Job Information Field Based on Months() [page 568] rule, you can now select the Contract End Date as the Accruable End Date. For example, if you want to maintain the end date of a contract manually after hiring a contract employee. New Many Time Management data objects now include an automatically generated ID called the Entity UUID ("Universally Unique Identifier"), used to provide a stable ID for integration purposes. ● Time Management Data Objects [page 687] ● Time Management Alert [page 736] ● Temporary Time Information [page 710] Change We've improved the restrictions section of the documentation for the Get Bal­ ance For Posting Types In Period rule. New We've added a note about the visibility of Time Off Objects timestamp and user information of Time Management MDF objects. 8 PUBLIC Get Balance For Posting Types In Pe­ riod() [page 593] Implementing Time Management in SAP SuccessFactors Change History Type of Change Description More Info New We've created a section with a general overview of Time Management and some basic configuration instructions. Some of the topics in there are new. Some have been moved there from other sections of the guide. Core Concepts and Activation of Time Management [page 18] Change We've changed the structure of the sec­ tion about Time Off. Some topics have been moved to other parts of the guide. Implementation of Time Off [page 43] Change We've changed the structure of the sec­ tion about Time Sheet. Some topics have been moved to other parts of the guide. Implementation of Time Sheet [page 322] Change Setting Up Time Valuations for Pre­ We've added a note about what you mium Pay [page 356] need to be aware of when setting up time valuations for premium pay without Time Tracking. New We've added a section about Time Tracking. Implementation of SAP SuccessFac­ tors Time Tracking [page 404] New We've added information about ad­ vanced filtering options for holiday-re­ lated premium pay. Advanced Filtering Options for HolidayRelated Premium Pay [page 413] Change We've consolidated all information about Imports in Time Management [page imports into Time Management in one 671] section. Change We've restructured the documentation of how to import external data into Time Sheet. Import of External Time Data [page 680] New We've added information about how Time Tracking customers can prevent users from editing imported time in the time sheet. Import of External Time Data [page 680] Change We've consolidated all information about Time Management Data Objects [page Time Management Data Objects in one 687] section. New We've added a new collision resolution item, Allow concurrent records, and an example. Time Management Collision Resolution [page 124] New We've made the CreatedDate, CreatedBy, LastModifiedDate, and LastModifiedBy fields visible by default. Time Off Objects Change We've added information that during an Recalculating Time Sheets [page 436] ongoing recalculation for an employee, the affected employee can't change their time sheet on the UI. Implementing Time Management in SAP SuccessFactors Change History PUBLIC 9 Type of Change Description More Info New We've added the new rule function "Get Number of Allowances in Period()". This rule function returns the number of al­ lowances in any given period. Get Number of Allowances in Period() [page 631] Change We've added information about a restric­ Setting Up Continued Pay Feature in Spain [page 295] tion when linking absences for Spain that were created using the Employee Self Service. New Creating a Time Type for Calculating We've added a topic describing how to create a time type for sick leave for Ger­ Sick Pay Dates [page 261] many that allows the system to propose dates for continued pay and the sick pay supplement. New Requesting an Absence with Calcula­ We've added a topic describing how to tion of Sick Pay Dates [page 262] request an absence for an employee who is on sick leave, receiving a proposal for continued pay and sick pay supple­ ment dates. New We've added a topic describing how to set up concurrent absences in the United Kingdom. Setting Up Concurrent Absences in the United Kingdom [page 299] New We've added a topic describing how to set up concurrent absences in Spain. Setting Up Concurrent Absences in Spain [page 297] New We've added a topic describing how to set up concurrent absences in the Neth­ erlands. Setting Up Concurrent Absences in The Netherlands [page 284] Change We've moved the topic, Changing the Display Language, to the Operating Time Management guide. Changing the Display Language Change We've moved the topic, Closing Time Ac­ Closing Time Accounts counts, to the Operating Time Manage­ ment guide. Change We've moved the topic, Calendars in Calendars in Time Off Time Off, to the Operating Time Manage­ ment guide. Change We've moved the topic, Other Fields in Other Fields in Time Off Time Off, to the Operating Time Manage­ ment guide. Change We've moved the topic, Cross-Midnight Processing in Time Recording, to the Op­ erating Time Management guide. Cross-Midnight Processing in Time Re­ cording Change We've moved the topic, Cross-Midnight Processing in Time Recording, to the Op­ erating Time Management guide. Cross-Midnight Processing in Time Re­ cording 10 PUBLIC Implementing Time Management in SAP SuccessFactors Change History Type of Change Description Change We've moved two topics about collisions to the Operating Time Management guide, Overview of Clock Time Collisions and Overview of Duration Collisions. More Info ● Overview of Clock Time Collisions ● Overview of Duration Collisions Change We've moved the topic, Assigning Time Recording Profiles to Employees, to the Operating Time Management guide. Assigning Time Recording Profiles to Employees Change We've moved the topic, Workflow Proc­ esses of the Submit Time Sheet Job, to the Operating Time Management guide. Workflow Processes of the Submit Time Sheet Job Change We've moved the topic, Special Cases: Accrual Adjustments by the System, in­ cluding its sub-topics Booking With Amount Zero and Shifting the Posting Date, to the Operating Time Manage­ ment guide. ● Special Cases: Accrual Adjust­ ments by the System ○ Booking With Amount Zero ○ Shifting the Posting Date Change We've moved the topic, Assigning Admis­ Assigning Admissibility Rules to Em­ sibility Rules to Employees, to the Oper­ ployees ating Time Management guide. New We've added a topic about Setting up Additional Restrictions for the Employee Time Object. Setting up Additional Restrictions for the Employee Time Object [page 703] Type of Change Description More Info New There is a new user interface (UI) availa­ ble for Time Sheet. It can be used on both desktop and mobile, and supports the following: New Time Sheet UI [page 339] 1H 2021 ● Working time that ends at midnight ● Single record approval (when SAP Time Tracking is active) New We've added the Night Shift Bandwidth Night Shift Bandwidth [page 406] parameter, which tells the time evalua­ tions which time worked can be counted as part of a night shift. New We've added information about the 'TLMTriggerTask' job under Jobs in Time Management of the Getting Started sec­ tion. Implementing Time Management in SAP SuccessFactors Change History The 'TLMTriggerTask' Job [page 668] PUBLIC 11 Type of Change Description New We've added the TimeManagementTerminationEndHandli ngAlert in the Role-Based Permissions in Time Management. New We've added the field <Full Day> in the section Other Fields in Time Off along with this information: When the setting Permitted Fractions for Unit Day or Permitted Fractions for Unit Hours in the Time Type object is set to Only full day bookings allowed, then the field Full Day field on the Time Off UI is hidden. Change We've improved an example for calculat­ Time Account Balance Calculation ing balances for time accounts (example [page 112] 4, scenario 4). Change We've improved an example for the rule Get Completed Remaining Calendar function 'Get Completed Remaining Cal­ Weeks (ISO Standard)() [page 597] endar Weeks (ISO Standard)' (example 2). New We've added information about how to maintain an expected return date for consecutive leave of absences (LOAs). We've added this information under Known Issues, too. New We've added a topic for Employee Time Calendar Fields under Time Off Data Ob­ jects Employee Time Calendar Fields [page 699] New Upon customer request, we added a note under Searching Users in the Team Absence Calendar explaining how the user search relates to permissions. Searching Users in the Team Absence Calendar [page 152] New Time Type [page 743] We've added a note about a validation error in the Time Type object topic. A val­ idation error is raised when you delete or deactivate (by setting the mdfSystemStatus to inactive) a time type which is referenced in the available time types under the time profile. Change We've added the possibility to enter the external code for the upload of the ac­ More Info Full Day Accruals on Actual Working Time [page 85] crual calculation base object in any for­ mat. New We've added notes to improve a number of documents. ● sence Recording [page 110] ● 12 PUBLIC Configuring Workflows for Ab­ Defining the Validity Period of Time Accounts [page 68] Implementing Time Management in SAP SuccessFactors Change History Type of Change Description More Info New We've added the document Restricting the Target Population to Peers. Restricting the Target Population to Peers [page 151] New We've added information in the Accruals and Entitlements document: ● General information on accruals ● Separation of Accruals and Entitle­ ments [page 88] ● Best Practice Tip: Daily Accrual Transfers [page 97] ● Validations for Leave of Absence Import [page 671] ● Validations on Forward Propagated Records [page 672] and entitlements ● New A best practice tip on daily accrual transfers We've added information about the im­ port of leave of absences and forward propagated records Change We've added a note about the support Configuring Leave Loading Periods for future dated leave loading calculation [page 245] periods. Change We've added the new execution type for terminated employees. New We've added information about the new option to retrigger an alert for one user directly from the Admin Alerts user in­ terface. New Time Off Configuration [page 740] We've added a note to the information onTime Off Configuration about the number of allowed entries for a job infor­ mation status. New We've added information on restrictions applying to the creation of custom fields in Time Sheet generic objects. Restrictions on Custom Fields in Time Sheet [page 346] New We've added a new user interface (UI) for Time Sheet that supports accessibil­ ity standards and can be used on both desktop and mobile devices. New Time Sheet UI [page 339] New We've made it possible to approve time sheet entries separately, not just on a weekly basis. Setting Up Single Record Approval [page 404] Change We've updated the information on recal­ culation to reflect that recalculation is now processed as an event-based Time Management task. Recalculation in Time Management [page 415] Change We've updated the information on work schedule day models with additional guidance on non-work days and time tracking. Work Schedule Day Model [page 749] Implementing Time Management in SAP SuccessFactors Change History Configuring Year-End Processing Jobs for Leave Loading [page 247] PUBLIC 13 Type of Change Description More Info New We've moved information on Collisions Between Absences [page 122] from the Operating Time Management guide to the Implementing Employee Central Time Management guide. Collisions Between Absences [page 122] New We offer a new Time Tracking feature. New We've added a note on posting types for a couple of rule functions. ● Get Number Of Postings For Post­ ing Types in Period() [page 609] Change We've removed the Enabling Time Off in Provisioning documentation because it's no longer relevant. New We've added a note on how to ensure that the target population is respected by the team absence calendar to Setting Up the Team Absence Calendar and Team Absence Caledar UI documenta­ tion. ● Get Balance For Posting Types In Period() [page 593] ● Team Absence Calendar UI [page 48] ● Setting Up the Team Absence Cal­ endar [page 148] Leave Purchase [page 212] Change We've added a note regarding a setting you must make in the time account type to ensure that leave can be purchased for the desired period. New We've added a topic about controlling Permission to Access Team Absence access to the team absence calendar for Calendar [page 151] certain user groups. 2H 2020 Table 1: What's New for Time Management What's New Cross-midnight processing is now available in some work schedules. 14 PUBLIC More Info ● Work Schedule - Period [page 751] ● Work Schedule - Schedule [page 753] ● Work Schedule Day Model [page 749] Implementing Time Management in SAP SuccessFactors Change History What's New We've enhanced the documentation for the rule functions af­ fected by the availability of cross-midnight processing in work schedules. More Info ● Get Absence In Hours For Period() [page 530] ● Get Absence In Days For Period() [page 512] ● Get Absence In Days For Period Based On Calendar Days For Time Types() [page 515] ● Get Absence In Days For Period Based On Working Days For Time Types() [page 518] ● Get Absence In Days For Period Based On Working Days For Time Types Excluding Weekdays() [page 521] ● Get Absence In Days For Period Based On Working Days For Time Types Excluding Weekdays() [page 521] ● Get Absence in Days For Period with Threshold() [page 527] ● Get Absence In Hours For Period For Time Types() [page 532] ● Get Completed Months Of Time Types In Period() [page 535] ● Get Number of Absences for Period for Time Types() [page 537] ● Get End Time Of Working Day () [page 548] ● Get Next Working Day() [page 549] ● Get Number Of Working Days Or Hours For Period() [page 552] We've restructured the time recording section. ● Get Previous Working Day() [page 555] ● Get Start Time Of Working Day () [page 558] ● Get Working Time In Hours () [page 559] ● Has Absences In Period() [page 539] ● Has Working Time In Interval () [page 561] ● Is Consecutive Limit for Time Type Reached() [page 541] Implementation of Time Sheet [page 322] You activate Time Sheet in Provisioning now. We've added some information about editing or deleting temporary changes to work schedule assignments. Edit or Delete Assignment of Temporary Change of Work Schedule Users can now search for users outside their peers group or the reporting hierarchy of a manager. Searching Users in the Team Absence Calendar [page 152] Employees can purchase additional time off or leave. Deduc­ tions from payroll fund the leave purchase time account. Leave Purchase [page 212] There's a new Time Off data object for periodic update rule parameters. Periodic Update Rule Parameters [page 708] Various updates and corrections have been made to the Re­ calculation documentation. Recalculation in Time Management [page 415] Users can now request their Leave Loading payment on top of their annual leave pay through MSS or ESS pages. Leave Loading [page 240] Implementing Time Management in SAP SuccessFactors Change History PUBLIC 15 What's New More Info We've added some functions specific to Time Management. Calculate Average Value For Numeric Job Information Field Based on Months() [page 568] Get Absence In Days For Period Based On Working Days For Leave Of Absence Time Types() [page 524] Get Purchased Leave Quantity or Equivalent Quantity (in Weeks) for Period [page 625] Employees working in cross-midnight shifts can now create, edit, or delete absences crossing midnight. Cross-Midnight Processing We now support a duration display according to work sched­ Creating a Leave of Absence (LOA) Time Type [page 59] ule for leave of absence time types. It is now possible to create and edit recurring absences with start and end dates in the past. Enabling Recurring Absences [page 136] It is now possible to create a non-working day model with breaks and flextime bandwidth for a clock-time user. There is now a retry counter that prevents erroneous time sheets, absences, and accruals from being recalculated more than three times. Retry Counter [page 447] It is now possible to create ad hoc time accounts for occa­ sional (ad hoc) events such as purchased leave, a compen­ satory day off, or relocation. Creating Time Accounts You can now configure the bookable period of a time account Defining the Bookable Period of Time Accounts [page 74] more flexibly and set custom fields on a time account. Accrual transfer dates are now adjusted automatically. Automatic Adjustment of Accrual Transfer Dates [page 99] Time Account Type Accrual Transfer [page 732] The Time Account Type Accrual Transfer object now has a history in which all accrual transfer dates are stored. Existing Time Account Type Accrual Transfer objects have been auto­ matically migrated to contain that history. The Time Account Type Accrual Transfer History is needed for the Automatic Adjustment of Accrual Transfer Dates feature. Users need a view permission to view the time types in the Time Off Employee Self-Service UI for a Time Profile object that is set to "secured" or for Available Time Types. 1. Restricting Access to Time Objects [page 56] The view permission on the Time Profile is set under User Permissions Permissions Time Management Object . 2. The view permission on Available Time Types is set un­ der User Permissions Time Management Object Permissions. The recalculation job doesn't import external time data and external time records anymore. Recalculation in Time Management [page 415] We now raise a validation error if you raise an error message using the onChange rule in the Employee Time object field definition. Please use take rules to raise error messages. Adding Additional Validation Checks for Leave Requests [page 120] 16 PUBLIC Implementing Time Management in SAP SuccessFactors Change History What's New More Info We added a note that you can create only one entry per job information status without a specified time account type. Time Off Configuration [page 740] Implementing Time Management in SAP SuccessFactors Change History PUBLIC 17 2 Core Concepts and Activation of Time Management Learn more about core concepts in time management, the different time management solutions in SAP SuccessFactors, and how to activate them. Basics of Time Management [page 18] Time Management is about tracking the times when employees are at work (attendance management) and when they aren’t (absence management). Time Management in SAP SuccessFactors [page 19] Get an overview of the absence and attendance management capabilities provided by SAP SuccessFactors Employee Central Time Management and SAP SuccessFactors Time Tracking. Activating Time Management [page 20] Activate Time Management so that employees can manage their absences and attendances in SAP SuccessFactors. 2.1 Basics of Time Management Time Management is about tracking the times when employees are at work (attendance management) and when they aren’t (absence management). Attendance Management Attendances are times when an employee acts on behalf of the employer, independent of where the work takes place physically. This means that not only working time that is performed on site of the employer is considered an attendance. Even if the employee is physically absent from office, for example, in case of home office or business travel, the employee still acts on behalf of the employer. Therefore, they’re considered attendances from time management perspective. Absence Management Absences are times when, according to the work schedule, an employee would be supposed to act on behalf of the employer, but they don’t, for example, in case of vacation, sick leave, or unauthorized leave. 18 PUBLIC Implementing Time Management in SAP SuccessFactors Core Concepts and Activation of Time Management 2.2 Time Management in SAP SuccessFactors Get an overview of the absence and attendance management capabilities provided by SAP SuccessFactors Employee Central Time Management and SAP SuccessFactors Time Tracking. Time Off and Time Sheet are part of Employee Central Time Management. SAP SuccessFactors Time Tracking extends the Employee Central attendance recording capabilities for more complex use cases. Time Tracking requires a separate subscription on top of Employee Central Time Management. Employee Central Time Management is part of the Employee Central subscription. SAP SuccessFactors provides capabilities for recording absences, time off work, and attendances, that is, active working time. Absences are managed in Time Off, while attendances are managed in Time Sheet and SAP SuccessFactors Time Tracking. Implementing Time Management in SAP SuccessFactors Core Concepts and Activation of Time Management PUBLIC 19 2.3 Activating Time Management Activate Time Management so that employees can manage their absences and attendances in SAP SuccessFactors. Prerequisites The system administrator responsible for activating Time Management in SAP SuccessFactors needs the Employee Central Feature Settings permission. You assign it as follows: 1. In the Admin Center Manage Permission Roles , open the system admin role. 2. Choose Permission... 3. Under Administrator Permissions Settings checkbox. Manage System Properties , select the Employee Central Feature Procedure 1. In the Admin Center, choose Manage Employee Central Settings. 2. Here you need to decide how you want to use Time Management at your company: Absence Management ○ If you want to use the full Time Off solution, switch Time Off to On. ○ If you just want to use Time Off to manage long-term leaves of absence, switch both Time Off and Time Off for Leave of Absence Only to On. Attendance Management ○ If you want to use the basis Time Sheet solution included in the Employee Central subscription, switch Time Sheet to On. ○ If you want to use the full Time Tracking solution to cover more complex attendance management use cases, switch both Employee Central Time Sheet and Time Tracking to On. Note You can't change the switch for Time Tracking. Time Tracking is turned on in Provisioning. Note Time Off is a prerequisite for Time Sheet, which means Time Off must be activated for you to activate Time Sheet. It's not possible to just activate Time Off for Leave of Absence Only and Time Sheet together, since Time Sheet can only be activated in conjunction with Time Off. Time Sheet is a prerequisite for Time Tracking, which means you can activate Time Tracking only when Time Sheet is switched on. 20 PUBLIC Implementing Time Management in SAP SuccessFactors Core Concepts and Activation of Time Management When deciding what to activate, please note that you can only choose from the following potential combinations: ○ Activate Time Off on its own. ○ Activate Time Off and Time Off for Leave of Absence Only together. ○ Activate Time Off and Time Sheet together. ○ Activate Time Off, Time Sheet, and Time Tracking together. Implementing Time Management in SAP SuccessFactors Core Concepts and Activation of Time Management PUBLIC 21 3 Implementation of Employee Central Time Management Get an overview of how to implement SAP SuccessFactors Employee Central Time Management. Permissions Required for Time Management in General [page 22] Get an overview of the general permissions you need for time management in SAP SuccessFactors. Time Recording Variants [page 24] Read about the different methods of how your employees record time. Work Schedule [page 25] Here's some general information how work schedules relate to absence and attendance management. Creating a Holiday Calendar [page 42] Create a holiday calendar to reflect public holidays that are established in a country/region. Implementation of Time Off [page 43] Learn how to implement Time Off so that employees can request time off work. Implementation of Time Sheet [page 322] Learn how to implement Time Sheet so that employees can record their working time. 3.1 Permissions Required for Time Management in General Get an overview of the general permissions you need for time management in SAP SuccessFactors. Generic MDF Objects You need permissions to access a number of generic MDF objects to create, edit, and delete configuration and transactional objects in Time Management, including business rules. ● Administrator Permissions Metadata Framework Configure Object Definition ● Administrator Permissions Metadata Framework Manage Data ● Administrator Permissions Metadata Framework Configure Business Rules ● Administrator Permissions Metadata Framework Access to non-secured object ● User Permissions Miscellaneous Permissions Time Management Configuration Search The Time Management Configuration Search is a way you can find out which generic objects in time management are assigned to which other objects in time management, and to which employees. This tool is 22 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management typically used by system and HR admins. To access the Time Management Configuration Search tool, you need to following permission. ● Administrator Permissions Manage Time Access Time Management Configuration Search Time Admin Workbench The Time Admin Workbench is the central workplace for HR and time admins to manage the absences and attendances of the employees they’re responsible for. To access the Time Admin Workbench, you need to following permission: ● Administrator Permissions Manage Time Access Workbench 3.1.1 Activating the Time Management Configuration Search Activate the Time Management Configuration Search by going to Administrator Permissions and selecting Access Time Management Configuration Search. Context The Time Management Configuration Search is a way you can find out which objects are assigned to which other objects, and to which employees. Procedure 1. Go to the Admin Center and choose Manage Permission Roles. 2. Choose Administrator Permissions. 3. Go to Manage Time. 4. Select Access Time Management Configuration Search. Results You can use the Time Management Configuration Search to obtain a better overview of your system configuration by searching for the following: ● Employees with a specific Time Management object in their job information ● Time type by time account type ● Time type and time account type by Time Management retention group Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 23 3.2 Time Recording Variants Read about the different methods of how your employees record time. When you implement Time Management in SAP SuccessFactors, you need to decide how your employees record working time. Employees can either record working time based on duration, or based on clock times. You can decide for each user individually. For example, employee group A, a subgroup, can record working time based on duration. Employee group B, another subgroup, records time based on clock times. If you have both time recording variants represented in your organization, then for each respective time recording variant, you need distinct: ● Work schedules ● Work schedule day models ● Time profiles ● Time recording profiles Duration-Based Time Recording Duration recording is a method of time recording based on duration. That includes recorded absences or attendances. For example, an employee recording working time based on duration only needs to record that they worked 8 hours on a certain day. The start and end time of the recorded time isn't considered. As such, the time when the employee worked the 8 hours is irrelevant, from 9:00 a.m. - 5:00 p.m. or from 11:00 a.m. 7:00 p.m., for example. Note ● Breaks aren't specified in work schedules for duration-based time recording. This means that an employee who records time based on duration can’t record breaks. Duration-based recorded times are always considered as net times, excluding breaks. ● With duration-based time recording, work schedules that cross midnight aren't supported. If employees work on a night shift, they need to use clock time-based time recording. ● With duration-based time recording, you can't combine absences that have different units (days or hours) on the same day. Clock Time-Based Time Recording Clock time recording is based on the entered start and end times of an attendance, or an absence. For example, an employee who records work based on clock time needs to explicitly record that they worked from 9:00 a.m. - 5:00 p.m. Break times can be deducted from entered clock times, depending on legal regulations, collective agreements, contracts, or other provisions in place within an organization. 24 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note ● If you've implemented clock time-based time recording, ensure that the holiday calendar you implemented with it only includes full-day holidays. Half-day holidays aren't supported for clock-timebased time recording. ● If you use clock-time-based time recording, you can't request absences on non-working days. ● To enter midnight as the start or end time, you need to enter the time as 00:00 (24:00 isn't a valid entry). It can mark the start or the end of a working day. For example: ○ If you enter an employee's working time with 16:00 start time and 00:00 end time on a Tuesday, the system interprets 00:00 as the end of that employee's working day on Tuesday. This entry isn't considered as cross-midnight processing. ○ If you enter an employee's working time with 00:00 start time and 06:00 end time on Wednesday, the system interprets 00:00 as the start of that employee's working day on Wednesday. This entry isn't considered as cross-midnight processing. ● If you use clock-time-based time recording, the allowed fractions you specify for an absence time type have no impact on partial day absences. If you select Only full day bookings allowed, only full day absences can be recorded. Allowing employees to record fractions, for example, by selecting Half day bookings allowed for unit Days or Full hour bookings allowed for unit Hours, doesn't have an impact. Absence recording is possible for any fraction of the day. That means you can choose a start time and end time independently of the fractions you've allowed for an absence time type. ● There are collision checks for clock times to prevent overlaps of a period of absence and a period of attendance. The collision checks also prevent overlaps of breaks and on call-periods . 3.3 Work Schedule Here's some general information how work schedules relate to absence and attendance management. A work schedule defines an employee's working pattern, for example, the planned working time of an employee. It captures which days of a week and for how many hours per day the employee is going to work. For example, a work schedule could define that an employee is supposed to work from Monday till Thursday from 8 a.m. till 5 p.m. (including a break from 12 p.m. until 1 p.m.) and on Friday from 8 a.m. util 12 p.m. (without a break) with Saturday and Sunday being non-working days. It's important that you always have the correct planned working time maintained in the system. This is required for both absence and attendance management: Example: Absence Management If an employee has the above mentioned work schedule and an available vacation balance of 200 hours, the work schedule provides the information that 4 hours need to be deducted from that balance if the employee takes a Friday off. Without the information that the employee has a planned working time of 4 hours on Fridays from the work schedule, we wouldn’t know how many hours to deduct from the vacation time account balance. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 25 Example: Attendance Management If a salaried employee has the above mentioned work schedule and records working time on a Friday from 8am till 1pm, the work schedule provides the information that 1 hour out of the 5 hours recorded are to be treated as overtime. This information is important as overtime might need to be paid extra. Related Information Creating a Regular Work Schedule [page 26] Work Schedule Models [page 28] 3.3.1 Creating a Regular Work Schedule Work schedules represent all the available working patterns at your organization. Prerequisites To create work schedules, you need permission to access the following generic objects: ● Work Schedule ● To create a work schedule for simple models: Work Schedule Day. ● To create a work schedule for period models: Work Schedule Day Model Assignment, Work Schedule Day Model Assignment Segment. Context When you have the necessary permissions, you can create a work schedule: Procedure 1. Go to Admin Center Manage Data Create New Work Schedule . 2. Enter a meaningful External Name and a unique External Code, for example DUR Mon-Fri 8hrs and (DUR_8hrs). Note: If you want to integrate with Payroll, the external code must be eight characters long. 3. Enter a starting date for the work schedule. This is the reference point for day 1 of the work schedule. The starting date refers to the starting date of the work schedule, not the starting date of the effective date of the work schedule that is assigned to the employee. Example: If the starting date is set to Wednesday, January 1, 2014, day 1 in the schedule is a Wednesday. Day 2 is a Thursday, and so on. 26 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 4. Select a Model and make at least one Work Schedule Days entry (for simple and period models). The Work Schedule Days entry defines the working hours per day. If you have a weekly pattern, you add 7 days here. To define working patterns that repeat every two weeks, just keep adding days and assign the respective number or hours until 14 days are covered. There are several work schedule models, for more information please refer to Work Schedule Models [page 28]. Note: After the work schedule has been assigned to a user, you can't change the model in a work schedule. 5. If you've selected Clock Times as the Time Recording Variant and you want to allow employees with a period or schedule model to make time recordings crossing midnight, you need to set the field Cross Midnight Allowed on the period or schedule model to Yes. Now you can, for example, create a shift that starts at 18:00 on Tuesday and ends at 02:00 on Wednesday. Cross Midnight time recordings aren't available for the Duration Time Recording variant or the simple model. If you assign a cross-midnight enabled period model to a schedule model, the Cross Midnight Allowed field on the schedule model must also be set. Note: Cross midnight attendance recording is only possible as part of the SAP SuccessFactors Time Tracking [page 404] subscription. Cross midnight absence recording is covered with the Time Off feature. ○ For both the simple and the period model, it's important that you include non-working days. The work schedule day patterns you define repeat without interruption. For example, if you define only five days in the work schedule, and all of them are working days, there isn't a day off work in the working pattern. The pattern starts with day one again, which is a working day. ○ If you need to enter midnight as start or end time, you need to enter the time as 00:00 (24:00 isn’t a valid entry). 00:00 can indicate either the start of a working day or its end. Next Steps ● (Optional) Creating a Work Schedule Day Model ● Creating a Holiday Calendar Related Information Work Schedule [page 25] Work Schedule Models [page 28] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 27 3.3.1.1 Work Schedule Models Read about the different models of work schedules. Work Schedule Model Name Planned Working Time Simple ● Enter the planned work­ ing time for each day di­ Time Recording Method ● Duration-based time re­ cording Support for Cross-Midnight Shifts Cross-midnight shift are not supported. rectly in the Work Only clock time-based time Schedule Days section. recording supports cross- You need to enter the midnight shifts. planned working time for each day separately. ● Tip For time types that must be booked in hours and minutes, we recommend de­ fining the Planned Hours (Decimal) in a way that they can be converted to mi­ nutes without rounding differences. For example, you can enter 7.5 hours for a 7 hours and 30 minutes working day, but don’t enter 7.33 hours for a 7 hours and 20 minutes working day. 28 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Work Schedule Model Name Planned Working Time Period ● You need to define the Time Recording Method ● time recording variant because period models are supported for both Duration-based time re­ cording ● Clock time-based time recording Support for Cross-Midnight Shifts Cross-midnight shift are sup­ ported if the time recording variant is set to clock times. duration-based and clock time-based time recording. ● For each day of a period model, select one of the following categories in the Work Schedule Days section: ○ Day Model. A day model is a separate generic object and defines the planned working time for a day. A period work schedule can be composed of sev­ eral different day models and you can reuse day models across various work schedules. For more information on work schedule day models, refer to Creating a Work Schedule Day Model [page 33]. ○ Planned Hours. As with the simple model, you can en­ ter the planned working time di­ rectly in the work schedule. If the Time Recording Variant is set to Duration, you need to enter only the planned hours. If the Time Recording Variant is set to Clock Times, you need to enter a Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 29 Work Schedule Model Name Planned Working Time Time Recording Method Support for Cross-Midnight Shifts segment of the scheduled working time category that consists of a start and an end time. You can also add a scheduled break to the segment. Alter­ natively, you can configure dynamic breaks. For more in­ formation on breaks, refer to Break Time Record­ ing [page 340]. ○ ● Non-Working Day: This category can be used to repre­ sent non-working days. No further en­ tries are needed for this category. Tip For time types that must be booked in hours and minutes, we recommend de­ fining the Planned Hours (Decimal) in a way that they can be converted to mi­ nutes without rounding differences. For example, you can enter 7.5 hours for a 7 hours and 30 minutes working day, but don’t enter 7.33 hours for a 7 hours and 20 minutes working day. 30 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Work Schedule Model Name Planned Working Time Schedule ● ● With a schedule work schedule, you can or­ ganize your shifts by as­ signing time-shifted starting dates to one and the same period model. Time Recording Method ● Duration-based time re­ cording ● Clock time-based time recording Support for Cross-Midnight Shifts Cross-midnight shift are sup­ ported if the time recording variant is set to clock times. You need to define the time recording variant because schedule mod­ els support both dura­ tion-based and clocktime-based time record­ ing. ● Select a period model. Example: Work Schedule Days for Simple Model The working times in this example are Monday through Friday, from 8 a.m. - 5 p.m. Saturday and Sunday are non-working days. Based on the starting date, the first day in the work schedule is a Sunday. Day Planned Hours and Minutes (hh:mm) Planned Hours (Decimal) 1 00:00 0 2 08:00 8 3 08:00 8 4 08:00 8 5 08:00 8 6 08:00 8 7 00:00 0 Example: Work Schedule Days for Period Model The working times in this example are Monday through Friday, from 8 a.m. - 5 p.m. Saturday and Sunday are non-working days. The starting date here refers to a Monday, so day 1 is a Monday Day Category More 1 Day Model Details 2 Day Model Details Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 31 Day Category More 3 Day Model Details 4 Day Model Details 5 Day Model Details 6 Non-Working Day Details 7 Non-Working Day Details Example: Schedule Model You have a period model consisting of a rotating shift pattern that spans 3 weeks. That means employees with this work schedule work in the early shift during the first week, in the late shift during the second week, and in the night shift during the third week of the period model. The starting date of the work schedule is Monday, January 11, 2021. Your production site needs to run 24/7. This means that from Monday through Friday, each shift has to be covered, and on each day, three different groups of employees must work. For each shift, there's one employee group. You achieve this by assigning a different schedule model with the same period model to each employee group, but with three different starting dates: 32 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.3.1.2 Creating a Work Schedule Day Model Create a work schedule day model for your employees. Prerequisites You need permission to access the following generic objects: ● User Permissions Time Management Object Permissions Work Schedule Day Model ● User Permissions Time Management Object Permissions Work Schedule Day Model Segment Context With a work schedule day model, you can define what the number of hours worked on a particular day should look like. You can then use the day models in your work schedules where the Model field is set to Period. Note ● Each work schedule day model can include no more than one segment with the Scheduled Working Time category. ● You can't select the Scheduled Working Time option in a work schedule day model you’re using for nonworking days. However, you can maintain the Scheduled Unpaid Break category for non-working days. This ensures that employees who are called in to work on days that aren't officially working days for them get their scheduled breaks on such days. Procedure 1. Go to Admin Center Manage Data Create New Work Schedule Day Model . 2. Enter a meaningful External Name and a unique External Code. For example, Early Shift 06:00 14:00 (EarlyShift). 3. Select the Time Recording Variant. 4. For a non-working day model, set Non-Working Day to Yes. 5. If you set the field Non-Working Day to No, you need to enter the planned working time for the day model. If you select Duration as time recording variant, enter the planned hours, for example, 8. If you select Clock Times as time recording variant, you need to enter a start and an end time for a segment. Please refer to the table at the end of the steps to see an example. 6. Like for the work schedule itself, if you have a day model where the time recording variant is clock times and the planned working time crosses midnight (e.g. 22:00 – 06:00), you need to set the field Cross Midnight Allowed to Yes. If this is the case, the day model can only be assigned to work schedules where the Cross Midnight Allowed field is also set to Yes. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 33 Example Table 2: Step 5 Example: Enter Start and End Time for each Segment Start Time End Time Category 08:00 17:00 Scheduled Working Time 12:00 13:00 Scheduled Unpaid Break Next Steps Creating a Holiday Calendar [page 42] Related Information Work Schedule Day Model [page 749] 3.3.2 Individual Work Schedule An individual work schedule is a work schedule that applies only to one employee. You might choose to create an individual work schedule if a particular employee needs a schedule that you don't want to apply generally to other employees. Note ● If you intend to use individual work schedules, you must activate Time Off in full. Time Off For Leave Of Absence Only is not sufficient. ● Individual work schedules are not country/region-specific. ● Individual work schedules are regulated by permissions. If you want to use this feature, you must have the Maintain Individual Work Schedule permission. ● You create individual work schedules from an employee's job information. You can't create other types of work schedule from here. ● When assigning an individual work schedule with cross-midnight processing active, make sure that there is no overlap between shifts in the new individual work schedule and any schedule already assigned to the employee. For detailed information on this, see the Collision Checks for Cross-Midnight Processing documentation. ● Normally, a field that’s configured as a Data Subject Field in the Legislatively Sensitive Data Configuration for Time-Management-related, pre-delivered objects must have the Required property set to Yes. However, for the WorkSchedule object, the required property is pre-delivered as No to support the individual work schedule assignment scenarios. 34 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.3.2.1 Creating an Individual Work Schedule Create an individual work schedule that applies only to one employee. Prerequisites You need permission to access and edit the following generic objects: ● Administrator Permissions ● Under Edit. User Permissions Manage Time Maintain Individual Work Schedule Miscellaneous Permissions , the Work Schedule permission must be set to Context If an employee needs a particular work schedule that you don't want to apply to all other employees, you can create an individual work schedule for the employee. If you want to create an individual work schedule through Admin Center Manage Data , you can do so as outlined in Creating a Regular Work Schedule [page 26]. In addition, you need to set the Is Individual Work Schedule field to Yes. Then, select the respective user. Note Individual work schedules are only supported for period models. You cannot convert an individual work schedule into a general one by, for example, removing the user ID. Individual work schedules are usually created by HR admins, who don’t necessarily have access to Manage Data. Instead, they can create individual work schedules (and only individual work schedules) through an employee’s job information. Procedure 1. Go to an employee's Job Information Create an Individual Work Schedule Time Information Work Schedule Find a Work Schedule . 2. Fill the same fields as outlined under Creating a Regular Work Schedule [page 26] for period model. Some fields don’t need to be filled manually in this case: ○ The External Code is generated automatically. ○ The Time Recording Variant is derived from the selected time recording variant in the respective job information record. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 35 3.3.3 Creating a Temporary Work Schedule Create a temporary work schedule for your employees. Prerequisites You need permission to access and edit the following generic objects: ● Administrator Permissions Manage Time Maintain Temporary Change If the generic object Temporary Time Information is secured, the following permission needs to be granted: ● Under User Permissions must be set to Edit. Miscellaneous Permissions , the Temporary Time Information permission Context A temporary work schedule for an employee is typically created by an HR or time admin through the admin workbench. Procedure Once the necessary permissions are granted, the HR admin can create temporary work schedules through Administer Time Work Schedule Create Temporary Change . For more guidance for HR admins on how to create temporary work schedules through the admin workbench, refer to the Operating Time Management in SAP SuccessFactors guide. Related Information Temporary Time Information API [page 40] 3.3.3.1 Temporary Work Schedule Temporary deviations from the standard working pattern don’t require a job information change. Such deviations can be represented via temporary work schedules that temporarily override the regular working pattern as defined by the work schedule assigned in the job information. Regular work schedules are work schedules that define the standard working pattern of an employee, are assigned to an employee´s job information. If the work schedule of an employee changes permanently, a new 36 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management work schedule needs to be assigned via a job information change. However, temporary deviations from the standard working pattern don’t require a job information change but can be represented via temporary work schedules which temporarily override the regular working pattern as defined by the work schedule assigned in the job information. Temporary work schedules are regular or individual work schedules that are assigned to an employee for a temporary period of time only. The temporary change is stored in the generic object Temporary Time Information. It consists of information about the user, start and end date, and the work schedule to be applied during that period. A temporary work schedule for an employee is typically created by an HR or time admin via the admin workbench. 3.3.3.2 Importing Planned Working Time from External Shift Planning Tools If you use an external system to plan employees' shifts, you can now transfer short-term planned working time to Employee Central Time Off using an OData API (TemporaryTimeInformation). To transfer short-term planned working time to SAP SuccessFactors using an OData API, you need the permission: ● Administrator Permission Metadata Framework Admin access to MDF OData API . Furthermore, if the generic object Temporary Time Information is secured, you must have the following permissions: ● User Permissions Miscellaneous Permissions Temporary Time Information . Eventually, to upload temporary time information using day models as the reference, : ● Admin Center Configure Object Definitions dayModel must be set to Editable. Temporary Time Information , the visibility of the Before you upload of temporary time information, you need to create the work schedule or the day model that you want to reference in SAP SuccessFactors. Refer toCreating a Regular Work Schedule [page 26] and Creating a Work Schedule Day Model [page 33] for more information on how to do this. Then, you can upload temporary time information objects via the TemporaryTimeInformation oData API. Refer to the SAP SuccessFactors HXM Suite OData API: Developer Guide (V2) on how to work with oData APIs in SAP SuccessFactors. Viewing and Updating the Temporary Time Information Once the upload is complete, you can view the newly uploaded temporary time information records on the Work Schedule tab of the Time Workbench. You can see the information for a maximum of one year in the past and one year in the future. If you make any updates to temporary time information, it overwrites the existing data in EC Time. You can make updates either by using the OData API from the shift planning system, or directly in EC Time using the Time Workbench UI. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 37 Note ● When using a day model or an individual work schedule as the reference, you can edit and delete them from the UI. ● When using a work schedule as the reference, you cannot edit or delete it from the UI. Important Things to Keep in Mind ● You need to create the work schedule or the day model in Employee Central Time Off before you carry out the upload. ● The date values need to be passed with time UTC 00:00:00 to the API. The value must be passed in milliseconds; for example, "1581292800000" is the value for Monday, February 10, 2020 12:00:00 AM GMT. You can convert values into the necessary millisecond format at http://www.epochconverter.com . ● Any errors during the upload will be returned in the OData API response. ● If you use daily shift planning, we recommend that you have a dummy work schedule in EC Time that contains the average contractual hours. Any absence deductions for future absences can then be based on the dummy work schedule. Later, when the shift is uploaded, the absence will be recalculated. ● It's also possible to carry out a mass upload of temporary time information using MDF import, but you would need to manually create and upload the Excel file. ● It's important that you always have the correct planned working time maintained in the system. This is required for things like absence recording and the correct calculation of time account deductions, as well as time sheet and time valuation when it comes to overtime calculation, shift premium generation, and input validation. Related Information Temporary Time Information API [page 40] Temporary Time Information API [page 40] 3.3.3.2.1 Main Scenarios for Importing Planned Working Time from External Shift Planning Tools You can transfer short-term planned working time to SAP SuccessFactors as temporary work schedules. Here are the main scenarios in which this can be useful. You can upload shift information for either a single day or for a period, and you can use either a day model or a work schedule as the basis. ● Substitution A shift worker usually works the night shift, but due to some family commitments he'd like to switch to an early shift for a week. You can handle this by uploading temporary time information for that week. 38 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● Shift swapping A shift worker usually has Sunday as a working day and Friday as a non-working day. On one upcoming weekend she needs to swap her working day with her non-working day. You can handle this by uploading temporary time information for Friday (day model assignment of working day) and Sunday (day model assignment of non-working day). ● Daily shift planning with recalculation of absence A shift worker has Thursday as a working day and has an absence on the same day. If Thursday is then changed from a working day to a non-working day, the absence for that day will be automatically recalculated, taking into consideration the updated planned working time information for the day. Here's an example of what using the OData API to upload a temporary time information can look like. In this case, the user is calling the OData API with a 7.5-hour day model as the reference parameter. The day model (CLT-7.5h) already exists in SAP SuccessFactors. Only the reference of the day model is passed to the API. Sample Code https://<hostname>/odata/v2/upsert { } "__metadata": { "uri": "TemporaryTimeInformation('Temporary change Working day')" }, "userIdNav": { "__metadata": { "uri" : "User('0001')" } }, "externalCode": "Temporary change Working day ", "dayModel": "CLT-7.5H", "startDate": "\/Date(1581292800000)\/", "endDate" : "\/Date(1581292800000)\/" Related Information Importing Planned Working Time from External Shift Planning Tools [page 37] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 39 3.3.3.2.2 Temporary Time Information API This object defines deviating time information for period for a user. It is used, for example, if an employee is on vacation and someone else needs to take over their work schedule for the vacation period. Operations Allowed Table 3: Operation Query Get Query a record Create Create a record Update Update a record Upsert Update an existing record or create a new one Delete Delete a record Properties Here you can see the required fields and business keys for this entity. Check the OData API dictionary in your instance to see the complete list of properties, and check your metadata for navigations, and associations. Property Business Key Required Field Description externalCode Yes Yes External Code startDate No Yes This is the date from which the Temporary Time Informa­ tion applies endDate No Yes This is the date from which the Temporary Time Informa­ tion applies comment No No Optional comment field Navigation Properties Navigation Property Related Entity Description workScheduleNav WorkSchedule Navigation to WorkSchedule userIdNav User Navigation to User 40 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Code Examples URI: http://<hostname>/odata/v2/restricted/ TemporaryTimeInformation('d9ad6aea798143d599c63e9f4f251048')?$format=JSON{ Sample Code { "d": { "__metadata": { "uri": "https://<hostname>/odata/v2/restricted/ TemporaryTimeInformation('d9ad6aea798143d599c63e9f4f251048')", "type": "SFOData.TemporaryTimeInformation" } , "externalCode": "d9ad6aea798143d599c63e9f4f251048", "startDate": "/Date(1450569600000)/", "mdfSystemObjectType": "TemporaryTimeInformation", "mdfSystemEffectiveEndDate": "/Date(253402214400000)/", "mdfSystemVersionId": null, "workSchedule": "i90306d711", "endDate": "/Date(1451088000000)/", "effectiveStatus": "A", "lastModifiedDateTime": "/Date(1450424588000+0000)/", "mdfSystemTransactionSequence": "1", "mdfSystemRecordId": "7E23FCD86F7B49568C902989041B1C94", "createdBy": "admin", "mdfSystemEntityId": "552984EB4B424F7481EA66DF3F9C2A7A", "userId": "mhoff", "createdDateTime": "/Date(1450424588000+0000)/", "lastModifiedBy": "admin", "lastModifiedDate": "/Date(1450428188000)/", "mdfSystemEffectiveStartDate": "/Date(-2208988800000)/", "lastModifiedDateWithTZ": "/Date(1450424588000+0000)/", "comment": null, "createdDate": "/Date(1450428188000)/", "mdfSystemRecordStatus": "N", "userIdNav": { "__deferred": { "uri": "https://<hostname>/odata/v2/restricted/ TemporaryTimeInformation('d9ad6aea798143d599c63e9f4f251048')/userIdNav" } }, "workScheduleNav": { "__deferred": { "uri": "https://<hostname>/odata/v2/restricted/ TemporaryTimeInformation('d9ad6aea798143d599c63e9f4f251048')/ workScheduleNav" } }, "dayModelNav": { "__deferred": { "uri": "https://<hostname>/odata/v2/restricted/ TemporaryTimeInformation('d9ad6aea798143d599c63e9f4f251048')/dayModelNav" } }, }, "createdByNav": { "__deferred": { "uri": "https://<hostname>/odata/v2/restricted/ TemporaryTimeInformation('d9ad6aea798143d599c63e9f4f251048')/createdByNav" } }, "wfRequestNav": { "__deferred": { "uri": "https://<hostname>/odata/v2/restricted/ TemporaryTimeInformation('d9ad6aea798143d599c63e9f4f251048')/wfRequestNav" } }, "lastModifiedByNav": { "__deferred": Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 41 { "uri": "https://<hostname>/odata/v2/restricted/ TemporaryTimeInformation('d9ad6aea798143d599c63e9f4f251048')/ lastModifiedByNav" } }, "mdfSystemRecordStatusNav": { "__deferred": { "uri": "https://<hostname>/odata/v2/restricted/ TemporaryTimeInformation('d9ad6aea798143d599c63e9f4f251048')/ mdfSystemRecordStatusNav" } } } } 3.4 Creating a Holiday Calendar Create a holiday calendar to reflect public holidays that are established in a country/region. Prerequisites You need permission to access and edit the following generic objects: ● User Permissions Time Management Object Permissions Holiday Calendar ● User Permissions Time Management Object Permissions Holiday Assignment ● User Permissions Time Management Object Permissions Holiday Context Holiday calendars reflect public holidays that are established within a country/region, for example, Labor Day, which is a public holiday in many countries/regions. Public holidays are considered per default as non-working days and override the work schedule. Procedure 1. Create the holidays you need by choosing Admin Center Manage Data Create New Holiday . 2. Enter a meaningful Name and a unique Holiday Code for each holiday, for example, Labor Day (GERLabourDay). 3. Create the holiday calendar by choosing Admin Center Create New Holiday Calendar . 4. Enter a meaningful External Name and a unique External Code, for example, Germany (GER). 42 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note If public holiday regulations differ within a country/region, you need to create multiple holiday calendars for a country/region. 5. Go to Holiday Assignments and select all applicable holidays for your holiday calendar. 6. For each holiday, enter the date and the holiday class. Holiday Class Description Full The holiday lasts the entire day. Half The holiday lasts only half a day. Note There’s no time reference if the half day is in the morning, evening, or at night. For example, if an em­ ployee has an 8 hour working day according to the work schedule, the resulting working time is 4 hours. As such, half holidays aren’t supported for clock time users. None Employees in your business usually work although it’s a holiday. When an employee requests time off, these days are considered as normal working days. This holiday class is only used for information purposes. Tip Fill the holiday calendar directly for the next several years ahead. Example 1 May 2021, Labor Day, Full 3.5 Implementation of Time Off Learn how to implement Time Off so that employees can request time off work. Time Off is one of the two major modules of Time Management and designed as a paperless tool that tracks when employees aren’t at work. When you implement Time Off, you enable employees to request time off and managers to review these requests. Time Off also supports a number of regional laws and regulations, which you need to consider when you implement Time Off for a specific location. Permissions for User Interfaces in Time Off [page 44] Read about role-based permissions in Time Off. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 43 Basic Setup of Time Off [page 58] There are some basic principles and steps you need to be aware of when setting up Employee Central Time Off. Customization of Absence Recording [page 109] Learn more about how to customize absence recording. Team Absence Calendar [page 147] The Team Absence Calendar helps you plan your time by showing when your colleagues will be absent. The calendar shows absences for your peers, your manager, and, if you're also a manager, your direct and indirect reports. Updates to Time Accounts [page 155] There are several ways to update time accounts after their initial creation. Termination End Handling [page 170] The Termination End Handling process makes it possible to clean up an employee's Time-Off-related data that exists after the termination date. Purchase and Payout of Leave [page 192] Learn more about the purchase and payout of leave. Time Account Snapshots [page 235] Time account snapshots are records of time account data as they existed at a specific point in time. You can use these records in, for example, payroll processing. Country/Region-Specific Features for Time Off [page 236] Learn which aspects of Time Off you can manage on a country/region-specific basis. Integration of Time Off and Payroll [page 305] If you need Time Off data in your payroll system, you can set up either a point-to-point integration or one that uses middleware. Activating Mobile Time Off [page 305] Some of the functions of the Time Off feature are available in a mobile version that you need to switch on. Setting Up Alerts And Notifications [page 308] Ensure that all the relevant people in a Time Off workflow will be reminded of important events, such as an employee returning from extended leave. Handling Global Assignments and Concurrent Employment in Time Off [page 316] These forms of employment are a bit different from the standard. If you use any of them at your company, you'll have to keep this in mind when setting up Time Off. Recommendations and Restrictions for Time Off [page 316] Before you start using Time Off, here are some important things you should keep in mind. Troubleshooting Time Off [page 318] There are some limitations you should be aware of in Employee Central Time Off. 3.5.1 Permissions for User Interfaces in Time Off Read about role-based permissions in Time Off. To access all user interfaces in Time Off, enable Time Off under Manage Employee Central Settings. 44 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management In general if a MDF object is not secured, you need to give the to access a non-secured object Metadata Framework Access permission If the Employee Time object is secured, the permissions for read/write must be given under Time Management Object Permissions. Otherwise, you will not see absence data on other UIs such as My Team, the org chart, or the Employee Profile. 3.5.1.1 Time Off Employee Self-Service User Interface (UI) Here's information about permissions required for the Time Off Employee Self-Service (ESS) user interface (UI). Table 4: Action Permission Creating an absence using the Time Off ESS UI If the Employee Time object is secured: ● Time Management object permissions ○ Employee time: View and Edit Tip If you give the user the Metadata Framework access to MDF OData API Admin , then the field level override permissions and Employee Time object level permis­ sions aren't respected and all data is shown. We recom­ mended not to give this permission to the end user. Viewing available time types in the time type field when re­ questing an absence If the Time Profile is secured: ● Time Management object permissions ○ Time profile: View If the time type and available time type objects are secured: ● Time Management object permissions ○ Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Time type and available time type: View PUBLIC 45 Action Permission Viewing the available balance and balance overview sections on the UI Under Manage Time Off Time AccountTime Account , you have the View permission. In addition, if the time profile is secured: ● Time Management object permissions ○ Time Profile: View If the time account and time account detail object is se­ cured: ● Time Management object permissions ○ Time account: View ○ Time account detail: View In addition, if the Time Account Posting Rule object is se­ cured: ● Time Management Object Permission ○ Creating a recurring absence through the Time Off ESS UI Time Account Posting Rule - View You have the Time Management User Permissions Create Recurring Absence in Employee Self-Service Scenario permission. This enables the recurring absence checkbox on the UI. 3.5.1.1.1 Time Off Employee Self-Service Payout Leave Here's information about necessary permissions for ESS payout leave. Action Permission Creating payouts If the payout object is secured: ● Time Management object permissions ○ Time Account Payout ○ Time Account Type ○ Time Account Payout Profile If the payout object is not secured: ● Meta Data Framework ○ 46 PUBLIC Access to non-secured objects Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.1.1.2 Time Off Employee Self-Service Purchase Leave Here's information about necessary permissions for employee self-service (ESS) purchase leave. If the purchase object is secured: ● Time Management object permissions ○ Time Account Purchase ○ Time Account Type ○ Time Account Purchase Profile If the purchase object isn't secured: ● Meta Data Framework ○ Access to non-secured objects Note In addition to these permissions in Time Management, if the Recurring Deduction object is secured, users require the View permission for that object to be able to use ESS purchase leave. 3.5.1.2 Review Periodic Time Account Updates Here's information about which permissions you need to review periodic time account updates. This user interface (UI) can be accessed using the action search Review Periodic Time Account Updates. To access the UI, you have assigned the Access Periodic Time Account Update permission assigned under Manage Permission Role Manage Time. You can see the time account postings for your employees depending on the target population of this permission role. ● If your target group is empty, you see an empty list. If time account and time account detail object is secured: ● Time Management object permissions ○ Time account and time account detail: View The icon for workbench and Time Sheet UIs is only visible if you have the permission to open these UIs. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 47 3.5.1.3 Team Absence Calendar UI Table 5: Action Permission View absence data in the Team Absence Calendar If the Employee Time object is secured: ● Time Management Object Permissions ○ Employee Time - View If the Time Type is secured: ● Time Management object permissions ○ Time Type - View If Employee Time object is not secured: ● Meta Data Framework ○ Access to non-secured objects Tip To ensure that the target population is respected, we recommend securing the Employee Time object. This means that in the Employee Time object definition, in the Security section, the Secured field must be set to Yes. Otherwise, if the Admin Permissions non-secured objects Manage Permission Roles Metadata Framework Access to permission setting is assigned, but the object is not secured, then the target population is not respected. Enabling the search option on the UI You have the Time Management User Permissions Enable Search Option in Team Absence Calendar Searching an employee 48 PUBLIC . Under General User Permissions User Search. For more information, refer to Searching Users in the Team Ab­ sence Calendar [page 152]. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.1.4 Time Off Workflow User Interface Here's information on permissions you need for the Time Off Workflow user interface (UI). Table 6: Action Permission Viewing the time account balance on the Time OffWorkflow UI. ● ○ ● 3.5.1.5 Under Manage Time Off Time Account - View Under Workflow Configuration ○ the Respect Permission flag is checked ○ the Employee Time permission is assigned to the user who is approving the workflow Manage Time Off Calendars There's information about needed permissions for managing Time Off calendars. You have the 3.5.1.6 Manage Time Off Manage Time Off Calendars permission. Time Account Accrual Simulator Here's information about permissions you need to access the time account accrual simulator. Table 7: Action Permission Accessing the time account accrual simulator UI You have the Manage Time Process Simulator Searching an employee Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management You have the permission. Access Time Account permission. General User Permissions User Search. PUBLIC 49 3.5.1.7 Time Account balance on the Termination User Interface Here's information about permission needed to view the Time Account Balance section on the Termination user interface (UI). Action Permission Viewing the Time Account Balance section on the termina­ tion screen. You have the 3.5.1.8 Manage Time Show Time Account Balance in Termination Screen. Workbench Here's information about actions on the Workbench UI and necessary permission to perform them. Time Records tab Table 8: Action Permission Maintaining and viewing absences under the Time Records tab. You have the permission to edit and view on the Employee Time object. Linking absences. You have the permission to Absences Manage Time Off Link Manage Time Off Time . Time Accounts tab Table 9: Action Permission Viewing data on the Time Accounts tab. You have the permission to Account view . If the time account and time account detail object are se­ cured: ● Time Management Object Permissions ○ Time account and time account detail - view. If the time account and time account detail object is not se­ cured: ● Meta Data Framework ○ Adding postings, such as manual adjustments or periodic update correction. Access to non-secured objects You have the permission to edit the time account and time account detail. Work Schedule tab 50 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Action Permission Maintaining individual work schedules. You have the permission to Individual Work Schedule Maintaining an individual change using the UI. Maintain Manage Time Off Maintain Manage Time Off Access . You have the permission to Temporary Change Manage Time Off . Payout Tab Table 10: Action Permission Reading information on the payout tab. You have the permission to Account Payouts Maintaining payouts. You have the Permission . Manage Time Off Manage Payout . If Time Account Payout object is secured: ● Time Management Object Permissions ○ Time Account Payout ○ Time Account Type ○ Time Account Payout Profile If the Time Account Payout object is not secured: ● Meta Data Framework ○ Access to non-secured objectsAccess to non-se­ cured objects. Purchase Leave tab Table 11: Action Permission Reading information on the purchase tab. You have the permission to Manage Time Off Access Purchase Leave Maintaining purchases. You have the Leave Manage Time Off Manage Purchase . If the purchase object is secured: ● Time Management Object Permissions ○ Time Account Purchase ○ Time Account Type ○ Time Account Purchase Profile If the purchase object is not secured: ● Meta Data Framework ○ Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Access to non-secured objects PUBLIC 51 Action Permission Configure purchase leave ● Time Management Object Permissions (for admin: view and edit) ● ○ Time Account Purchase (view for end user) ○ Time Account Purchase Profile (view for end user) Time Account Purchase Profile.Purchase Leave Valida­ tion Rule Alerts tab Table 12: Action Permission Accessing the Alerts tab. You have the Leave Manage Time Off Manage Purchase . If the Time Management Alert object is secured ● 3.5.1.9 Time Management Alert - view. Permission for Fields on Approval Cards on the Latest Home Page Here's information about how the cards on the Latest Home page respect permissions to display fields. The Payout and Purchase approvals are displayed through the approval cards on the Latest home page, and no specific fields are displayed on the respective cards. The permission, Prevent Quick Approval of Workflow is respected for the to-do approval cards. However, the Time Off and Time Sheet quick approval cards don't respect the permission, Prevent Quick Approval of Workflow. This is because there is enough information displayed on the cards for the approvers to approve or reject the workflows. 52 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.1.10 Permissions in Time Off 3.5.1.10.1 Assigning HR Admin Permissions for Time Off Assign permissions to HR admins so that they can view, approve, or decline their employees' requests for time off. Procedure 1. Go to the Admin Center and choose Manage Permission Roles . 2. Open the relevant HR admin role and choose Permission. 3. Under Employee Views, select the following: ○ Time Off ○ Time This action enables admins to access the Time Off view. 4. Depending on how extensive HR admin tasks at your company are, assign them the following permissions as necessary: To enable an HR admin to View and edit employees' time off data Assign this permission Go to Administrator Permissions Manage Time Off and select one or more of these options depending on your requirements: ○ View Allows admins to see employees' time off data ○ Edit All Lets admins to edit the time off data and create man­ ○ Edit Time Off Allows admins to edit time off data provided they also ual adjustments. have the View permission Create, edit, or delete Time Off-related objects such as time profiles, time accounts, or time types Carry out mass changes to time data by using calendar runs Enter financial payouts on some time accounts Go to Administrator Permissions Manage Time Off and select Manage Time Off Structures. Go to Administrator Permissions Manage Time Off and select Manage Time Off Calendars. Go to Administrator Permissions and select Manage Payout. View, insert, edit, or delete time in an employees' job in­ Go to formation Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management User Permissions Dated Entities Manage Time Off Employee Central Effective and select the relevant checkbox for: ○ Holiday Calendar ○ Work Schedule PUBLIC 53 To enable an HR admin to Assign this permission ○ Open the Time Workbench and manage time tasks for Time Profile Manage Time and Create an individual work schedule for an employee Go to Administrator Permissions Manage Time select Maintain Individual Work Schedule. and Make a temporary change to an employee's work Go to Administrator Permissions select Maintain Temporary Change. Manage Time and Go to Administrator Permissions select Link Absences. Manage Time and Access time alerts in the Time Workbench Go to Administrator Permissions select Access Time Alerts. Manage Time and Simulate time account accruals for a particular em­ Go to Administrator Permissions Manage Time select Access Time Account Process Simulator. and employees schedule Link an employee's absences in case, for example, the employee has been absent with the same sickness Go to Administrator Permissions select Access Workbench. more than once in a given period ployee, date, and time account type Use the search for time management configuration Go to Administrator Permissions Manage Time and select Access Time Management Configuration Search. See the time balance on the screen where termination Go to Administrator Permissions Manage Time and select Show Time Account Balance in Termination Screen. payouts are processed Access the Accounts Payouts tab in the Time Workbench Go to Administrator Permissions select Access Account Payouts. Manage leave of absence Go to Employee Data ○ Manage Leave of Absence ○ returnLeaveOfAbsenceAction and and select: Use reporting for time accounts Go to User Permissions Reports Permission and select the checkboxes depending on the kind of reporting you want to use. Use attachments in mobile Time Off Go to Tools 54 User Permissions Manage Time PUBLIC Administrator Permissions Manage Integration and select: ○ OData API Attachment Import ○ OData API Attachment Export Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.1.10.2 Assigning Employee Permissions for Time Off Allow employee self-service to request time off and view or cancel existing requests. Procedure 1. Go to the Admin Center and choose Manage Permission Roles. The Permission Role List view displays. 2. Under the Permission Roles column, select Employee Self-Service. The Permission Role Detail view displays. 3. Choose the Permission button. A Permission settings dialog box displays 4. Under the User Permission column, select Employee Views, select the following, and save your settings: ○ Time Off ○ Time 5. Choose Done to save your settings and close the dialog box. If your employees need to see Time Off fields in their job information, reopen Permission... and select Employee Central Effective Dated Entities. Ensure that View Current and View History boxes are selected for the following: ○ Holiday Calendar ○ Work Schedule ○ Time Profile ○ Time Recording Variant Results Any employees with the Employee Self-Service role can now submit requests for time off, and can see or delete any existing requests. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 55 3.5.1.10.3 Restricting Access to Time Objects Ensure that employees can't change any time objects that they're not supposed to. For example, employees should not be able to change their own time types. Procedure 1. In the Admin Center, go to Configure Object Definitions. 2. Choose Object Definition and select the time object (for example, a time type) to which you want to restrict access. 3. In the Security section, make these settings: ○ Secured: Yes ○ Permission Category: Time Management Permissions ○ CREATE Respects Target Criteria: No Note If the Time Profile object is set to secured as Yes then you need to set the following permissions for the user for them to view the time types in the Time Off Employee Self-Service (ESS) UI. 1. The view permission on the Time Profile is set under User Permissions Time Management Object Permissions . 2. The view permission on Available Time Types is set under User Permissions Time Management Object Permissions. 3. If the work schedule and holiday calendar are secured, you need to set the view permission on the objects for users to view the work schedule and holiday calendar data. 4. In the Admin Center under Manage Permission Roles, open the employee role and choose Permission. 5. Under User Permissions Time Management Permissions , you'll see that the time type now appears. To ensure that employees can view - but not change - the time types assigned to them, check the View checkbox. Note ○ If you don't assign the View permission for the Time Type object, then users will not be able to see any time off requests. However, they will still be able to see the balances for the time types on the Time Off Employee Self-Service (ESS) UI. ○ In order to view time off balances on the PP3 UI, users need the View permission for all the relevant time profiles, time types, time account types, time accounts, work schedules, and holiday calendars. 6. Repeat this process for any other time objects to which you want to restrict access. 56 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.1.10.4 Restricting Access to Fields in Time Objects Use field-level overrides to control what fields employees can see and edit within a particular time object. Procedure 1. In the Admin Center, go to Manage Permission Roles and open your employee role. 2. Choose Permission. 3. Under User Permissions Miscellaneous Permissions , scroll down until you find the relevant object. For example, Employee Time. 4. Select the Field Level Overrides checkbox, and then assign the permissions to each individual field as necessary. Note ○ You can only apply field-level overrides to the new absence form available in PP3, not to the old one used in the v12 UI. ○ Be careful about which fields you restrict. For example, do not restrict fields such as the time type, the start date/time, or the end date/time, because this will interfere with the simulation function when users enter an absence request. 3.5.1.10.5 Assigning Permissions for Time Account Reports Enable role-based permissions (RBP) for your time accounts so that you can make use of reporting. Procedure 1. In the Admin Center, go to Configure Object Definitions. 2. Open the Time Account object. 3. Choose Take Action Make Correction and apply these changes: ○ Ensure the userId field is required. ○ In the Security section, set Secured to Yes. ○ For the Permission Category, choose Miscellaneous Permissions. ○ For RBP Subject User Field, enter userID. 4. You now need to ensure that the users who will run the reports have permissions that match those you've just made for this object. To do this, go to the Admin Center Manage Permission Roles , and open the role of a user who will be running the reports. For example, a HR admin. 5. Under Permission... Account. Miscellaneous Permissions , scroll down in the list of objects and find Time Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 57 6. If you want to enable the user to generate reports based on time accounts, select View. The most important thing, however, is that whatever you select here has to match the settings you previously made for the object itself. Results You've successfully set up all the necessary permissions that will enable reporting for time accounts. If you want, you can now start assigning more detailed permissions roles and permission groups. 3.5.2 Basic Setup of Time Off There are some basic principles and steps you need to be aware of when setting up Employee Central Time Off. These encompass: ● Creating an Absence Time Type [page 58] ● Creating a Time Account Type [page 65] ● Creating a Time Profile [page 103] ● Enabling the Assignment of Time Off Master Data to Employees [page 106] 3.5.2.1 Creating an Absence Time Type Absence time types represent the different reasons why an employee can be absent from work, such as annual leave, sick leave, or unauthorized leave. Prerequisites You need the following permissions: ● Administrator Permissions ● User Permissions Metadata Framework Manage Data Time Management Object Permissions Time Type Context When recording an absence, employees (or admins on behalf of employees) need to define not only the period when the employees are absent, but also to select the respective time type that is, the background of the absence. So that they can choose from different time types, you first need to create the absence time types that are available at your organization. 58 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management When you have all the necessary permissions, here's how to proceed: Procedure 1. Go to the Admin Center and choose Manage Data Create New Time Type . 2. Enter a unique Name and a unique External Code. For example, enter Annual Leave as the name and AL_USA_TT as the external code. 3. Set the Classification to "Absence", which is the default. 4. Select either "Hour(s)" or "Day(s)" as the Unit. This defines whether the absence is booked in days or hours. For example, if an employee with a planned working time of 8 hours takes a full day off, 1 day would be deducted if the unit is "Day(s)" and 8 hours would be deducted if the unit is "Hour(s)". 5. Depending on whether you have selected "Hour(s)" or "Day(s)" as the unit, you need to make a selection in the Permitted Fractions for Unit Hour or Permitted Fractions for Unit Day field. This defines whether employees can book only full day absences or also partial day absences. Next Steps Your next steps are: ● Creating a Time Account Type [page 65] ● Creating a Time Profile [page 103] Related Information Time Type [page 743] 3.5.2.1.1 Creating a Leave of Absence (LOA) Time Type Enable your employees to request leaves of absence, such as parental leave or sabbaticals, through Time Off. Prerequisites Ensure that you have switched on Employee Central Time Off. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 59 Note If you want to use Time Off to manage LOA but don’t want to use it to manage your vacation, PTO, and other absences, you need to specify this by choosing Time Off for Leave of Absence Only in addition to Time Off. Procedure 1. Go to the Admin Center and choose Manage Organization, Job, and Pay Structures Create New Event Reason . 2. Create the following: ○ An event reason for the start of the LOA, with the relevant employee status (for example, Inactive or Unpaid Leave). ○ An event reason for the end of the LOA, with the employee status Active. 3. Create a time type for each LOA. You do this in the same way as you would create any other time type, but you have to include two events to match the ones you created in step 1. Just go to the Admin Center and choose under Manage Time Off Structures Time Type and make these entries: ○ LOA Event Reason (Plan) ○ LOA Event Reason (Return to Work) 60 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Here's an example: Note ○ Do not assign a time account type to LOA time types. ○ LOA can only be requested in full days. ○ LOA can be displayed based on calendar days or work schedule, depending on the duration display setting on the LOA time type. Displaying according to work schedule is supported only when the full Time Off solution is switched on, whereas calculation based on calendar days is supported both when the full Time Off solution is switched on or only Time Off for LOA is enabled. ○ A leave of absence should have a minimum duration. Employees should not use leave of absence for a period of just a few days. You can enforce a minimum duration using absence validation rules. ○ If the Enable Leave of Absence Editing field in the Time Management Configuration object is set to No, then all the job info fields are editable except for the following, and you cannot delete the Job Info record: ○ Effective start date ○ Event ○ Event reason ○ Expected return date If the Enable Leave of Absence Editing field is set to Yes, then every job info field is editable and you can delete the Job Info record. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 61 3.5.2.1.1.1 Leave of Absence as Part of Time Off Management If you are using the full Time Off function along with the leave of absence (LOA) feature, you need to enter your LOA time types in the relevant time profiles. Users with this time profile can then apply for leave of absence in the same way as they would apply for any other leave. 3.5.2.1.1.2 Time Off for Leave of Absence Only If you are only using Time Off for leave of absence (LOA), you need to create a profile with exactly the external code LEAVE_OF_ABSENCE_PROFILE and then assign your LOA time types to this profile. There’s no need to assign this profile to employees. It will be picked for every employee automatically. A time type is an LOA time type if you choose a Leave of Absence Event Reason (Plan) and Leave of Absence Event Reason (Return to Work). These event reasons decide which event reason is used for the corresponding job information records, which is created based on the leave request. Here's an example of such a profile: You only need to do this if you do not want to assign a specific profile to each user. If you activate LOA only and do not assign a specific profile to each individual user, the system uses this generic one. Note If you are using LOA only, you don't need to fill the work schedule and holiday calendar. However, if you later change from using Time Off only for LOA to using full Time Off, you need to ensure that the holiday calendar and work schedule are filled for all employees using Time Off. 3.5.2.1.1.3 Notes on Different Leave of Absence Scenarios The leave of absence (LOA) feature can be used in different scenarios. Here are some things you need to know when using the various LOA scenarios: ● Using Time Off or Time Off just for LOA 62 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Take a look at the Leave of Absence as Part of Time Off Management [page 62] and Time Off for Leave of Absence Only [page 62] documentation. ● Using LOA only, but with different profiles for different countries. Do not create a generic time profile. Instead, create one profile for each country and assign them to users as appropriate. ● Using LOA only, but only for certain countries Switch on Time Off, not LOA only. Then create time profiles that use only LOA time types and assign the profiles to those users who should be able to take LOA. In such cases, you also need to create a dummy work schedule and a dummy holiday calendar, and assign them to the users with this LOA only time profile. ● Using LOA only for some countries, but full Time Off for other countries Switch on Time Off, not LOA only. Create some time profiles that use only LOA time types and others with full Time Off time types. Then assign the profiles, but be careful - users who should be able to take LOA only should have a time profile that has only LOA time types. In such cases, you also need to create a dummy work schedule and a dummy holiday calendar, and assign them to the users with this LOA only time profile. 3.5.2.1.1.4 Validations for Leave Of Absence (LOA) Read about the validations for leave of absences. This validation has been added because the sequence of the creation of job info records is causing an issue when the actual return date for a previous LOA is maintained. The system creates a new record in the job information with 'return' from leave, although the user is still on LOA (due to consecutive LOAs). Example Here is an example of consecutive LOA records: 1. The first LOA has the following settings: the Start Date is November 1 and the Expected Return Date is November 30. 2. The second, consecutive LOA has these settings: the Start Date is December 1 and the Expected Return Date is December 31. If you enter December 1 for the Actual Return Date of the first LOA, a validation error is raised. That's because December 1 is set as the Start Date of the second LOA. If you want to set the Actual Return Date of the first LOA to December 1 then proceed as follows: 1. Delete the consecutive LOA. 2. Enter December 1 as the Actual Return Date. 3. Re-create the consecutive LOA. Validation related to Employees Returning to Work during LOA A leave of absence can be created or edited irrespective of the change of the time recording variant from ClockTime to Duration or the other way around during a leave of absence. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 63 Additionally, the system allows a Job Information change of the time recording variant from Clock-Time to Duration or the other way around when there is an existing leave of absence for that user at the effective date of change of the time recording variant. 3.5.2.2 Time Account Types For certain absence time types, you might want to restrict the number of days or hours an employee can book as well as the period in which this leave can be taken. For example, the amount of annual leave for which an employee is eligible is typically restricted. In such cases, the absence time types need to be linked to time accounts that regulate the amount of leave at the employee‘s disposal as well as the period in which this leave can be taken. You can compare time accounts to bank accounts. If you only had a debit card without any bank account behind it, you could buy as many things as you want. However, the bank account restricts the money you can spend based on the money available in your account. Time accounts work in a similar way. The table shows the information primarily held in time accounts: Field Notes Account Valid From The validity period defines the period out of which the eligi­ bility for the quota arises. Example: 30 days of vacation for 1 year worked. Account Valid Until Booking Possible From Booking Possible Until Time Account Details The bookable period defines the period during which a time account can be booked. This period is often supposed to be longer than the validity period. For example, if a time ac­ count is valid from January 1 to December 31, 2021, the bookable period might go from January 1, 2021 to March 31, 2022. This means that the leave granted based on the work performed in 2021 can still be booked for leave to be taken until the end of March 2022. The time account details specify all the single postings on a time account (both accruals and deductions). The sum of the postings results in the time account balance. Note The time account balance is not persisted on the time account. It is displayed only on the UI and calculated on the fly. Refer to Time Account [page 711]for full information on the fields in the time account object. To time accounts like this, you need to create time account types. Time account types serve as templates for time accounts.They are not user-based, whereas time accounts are user-based. Shared time accounts are not possible - each time account is tied to only one user. For example, it might be that that your company policy foresees an annual leave quota for each employee of 30 days per calendar year. You have in total 100 employees. Without a time account type, you would need to manually maintain 100 time accounts with this information (30 days of quota per year, validity of January 1 to December 31). This would be very cumbersome. Instead, a time account type needs to be created only once. 64 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management The time account type then automatically and dynamically translates the information to every individual time account that is created based on the time account type. So, you don’t need to create time accounts, the system takes care of this, with the exception of ad hoc time accounts. However, you do need to create time account types. Related Information Creating a Time Account Type [page 65] 3.5.2.2.1 Creating a Time Account Type Create a time account type to act as a template for creating multiple time accounts. Prerequisites You need the following permission to access and edit the time account type object. ● Administrator Permissions ● User Permissions Metadata Framework Manage Data Time Management Object Permissions Time Account Type ● In addition, to be able to link the secured time account type to secured absence time types, set the Time Account Posting Rule to at least Create, also under User Permissions. Context Once you have the necessary permissions and have created an absence time type, you can create a time account type. Here's what to do: Procedure 1. Go to the Admin Center and choose Manage Data Create New Time Account Type . 2. Enter a meaningful Name and External Code. For example, enter Annual Leave as the name and AL_USA_TAT as the external code. 3. Select either "Hour(s)" or "Day(s)" as the Unit. The unit must be the same as the unit in the corresponding absence time type. 4. Select an account creation type. The options are: Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 65 ○ Permanent ○ Recurring ○ Ad Hoc The table shows the effect of the option chosen: Validity Period Permanent Recurring Hire date until high date (December 31, 9999) 1 day in the case of ad hoc 1 year; start and end date depend on the setting in the accounts for purchased Account Creation Start Date leave (validity start date = field. validity end date = Re­ Ad Hoc quested date of the pur­ chased leave). Flexible in the case of man­ ually created time accounts (but we recommend that you use 1 day). Bookable Period Hire date until high date (December 31, 9999) Purpose Regular, predefined time ac­ Regular, predefined time ac­ Non-regular time accounts, counts counts for ad hoc purposes that don’t necessarily apply to all employees, although they are in principle eligible. Example Long service leave 1 year or longer Annual leave Flexible Relocation leave Purchased leave Account Creation Automatic with assignment of the time profile to the employee’s job information. Not created automatically tomatically with assignment with assignment of the time profile to the employee’s job of the time profile to the information. Ad hoc ac­ employee’s job information. counts are created either manually or automatically Creation of subsequent as part of a purchased leave time accounts depends on request. the account creation auto­ First account is created au­ mation setting in the time account type. Postings Regular accrual postings Regular accrual postings Regular accrual postings are not supported because this account is not a regular time account. Use manual adjustments instead. 5. If you select Recurring as the account creation type, you also need to select an account creation start date to define the exact start and end dates for the validity periods of the time accounts. Refer to Time Account Creation Settings [page 68] for detailed information on the options you have here. 6. If you select Recurring as the account creation type, you can choose whether account creation is automated. If you select Automatic Account Creation, time accounts will be created automatically. If you 66 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management select No Automation, you need to run the Account Creation Calendar manually by going to the Admin Center and choosing Manage Time Off Calendars. Note ○ You can't use automatic account creation if the Account Creation Start Date is set to the employee's hire date. ○ The initial time account will always be created automatically with the assignment of the time profile to the employee’s job information whatever selection you make in the Account Creation Automation field. The account creation automation setting only refers to the creation of the subsequent accounts. 7. If the Account Creation Type is Recurring or Permanent, you can define an Accrual Frequency to enable regular accrual postings on the time account. The options are: ○ Once only ○ Daily ○ Weekly ○ Monthly ○ Twice Monthly ○ Annually The accrual frequency defines how often a certain amount of accrual is posted to the time account. For example, if you select ‘Daily’, an accrual is posted to the time account every day (as long as the employee is eligible). If you select ‘Annually’, only one accrual per year is posted to the time account. The amount of accrual that is posted based on that frequency is defined using an accrual rule. You must assign the rule to the time account type in the Accrual Rule field. In the Hire Rule and Termination Rule fields, you can assign a different accrual rule for the hire and termination accrual period, respectively. This is to ensure that you can pro-rate the accrual amount, for example, for hires or terminations during the year in the case of an annual accrual frequency. 8. If you define an accrual frequency along with an accrual rule for your time account type, you can define the Level of Accrual Automation. If you select ‘Automatic Accrual Creation’, accruals are posted automatically. If you select ‘No Automation’, you need to run the Accrual Calendar manually by going to the Admin Center and choosing Manage Time Off Calendars. Note The hire rule will always be executed automatically during a new hire whatever selection you make in the Level of Accrual Automation field. The accrual creation automation setting only refers to the creation of the subsequent accruals. 9. Once you have saved your time account type, you need to assign it to one or more absence time types. To do so, you need to go to the Admin Center and choose Manage Data Time Type . Select the absence time type to which you want to assign your time account type and choose Take Action Make Correction . In the Time Account Posting Rules section, select your time account type from the Time Account Type field and enter an external code. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 67 3.5.2.2.1.1 Time Account Creation Settings Learn more about time account creation settings. Sometimes time accounts are created automatically, for example, for permanent and recurring accounts and ad hoc time accounts in the case of purchased leave. In such cases, the time account type provides the necessary information on how the validity and bookable period of a time account are defined. Defining the Validity Period of Time Accounts [page 68] In the case of recurring time accounts, you can choose between different options for creating time accounts. Defining the Bookable Period of Time Accounts [page 74] 3.5.2.2.1.1.1 Defining the Validity Period of Time Accounts In the case of recurring time accounts, you can choose between different options for creating time accounts. You make the setting at time account type level because time account types are the basis for creating time accounts. Here are the options available: ● Account Valid From (Fixed Date) You can define a fixed start date in the time account type. This then applies to all time accounts and all employees with this time account type assigned. This option is only available if you choose Account Valid From (Day or Month) in the Account Creation Start Date field and fill the Account Valid From [Day]and Account Valid From [Month] fields to determine the day and month when each time account should start. For example, a configuration of January 1 would lead to recurring time accounts starting on January 1st and ending on December 31st. ● Employee’s Hire Date Another option is to define the employee’s hire date as the time account start date. All time accounts of this time account type and employee will start on the employee’s hire date and end after one year (the day before the anniversary of the hire date). For this option, you have to choose Employee Hire Date as the account creation start date in the corresponding time account type. Keep in mind: If an employee with this time account type is rehired, the employment information hire date is changed, which means the time accounts start on the rehire date afterwards. If you want a different behavior, please take a look at the next option, which is a flexible account start date. ● Employee Flexible Date Another option is to define a flexible time account start date for each employee. Typical use cases are time accounts based on the employee’s seniority date or time accounts based on the employee’s hire/rehire date. For this setting you have to choose Employee Flexible Date as the account creation start date in the time account type. Caution Please note we don't support setting the Accrual Frequency Period to Semi Monthly when the Account Creation Start Date is set to Employee Flexible Date. Then select a business rule in the Flexible Account Start Date Rule field. Base the rule on the Flexible Account Start Date scenario. In this rule, define the employee specific flexible account start date. If you 68 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management want to use the seniority date, you navigate from the user to the employment info and choose the corresponding field. If you want to use the employee's hire/rehire date, you navigate from the user to the employment info and choose the hire date. You can also activate automatic account and accrual creation for time account types based on the employee flexible date. Creating and Updating Time Accounts 1. Assign a time account type to the user. ○ Assign time account at hire date If you hire an employee with a time profile and time account types assigned, the system creates the time accounts. All time accounts start at the employee's hire date: time accounts with a fixed start date as well as a flexible start date. Note that a time account never starts earlier than the employee's hire date. Example: You configured a fixed start date of January 1st and the employee is hired on June 1st 2017. This means that the time account is valid from June 1st, 2017 until December 31st, 2017. The subsequent account for 2018 will be valid for the whole of that year. ○ Assign time account after hire date If the hire record does not have a time account type assigned (via time profile) and you assign it to the employee’s job information at any later point in time, the system creates the time account. The time account will be valid from the job information’s effective start date when the time account type is assigned. ○ Example 1: You hire an employee on June 1st, 2017 without a time profile and you assign a time profile on October 1st, 2017 with a time account type with January 1st as the fixed start date. The time account will be valid from October 1st, 2017 to December 31st, 2017. The subsequent account for 2018 will be valid for the whole of that year. ○ Example 2: You hire an employee on June 1st, 2016 without a time profile and you assign a time profile on February 1st, 2017 with a time account type with a flexible account start date set to the employee’s hire date. The time account will be valid from February 1st, 2017 to May 31st, 2017. The time account reference start date in this case is June 1st, but the time account type is not assigned until February 1st, 2017. This means that the first account starts on the assignment date and ends on May 31st each year. The next account will be valid from June 1st, 2018 until May 31st, 2019. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 69 2. Changing the assignment date of a time account type If you change a date, such as the hire date or effective start date, in the job information date where a time profile is assigned, the time account’s validity will be adjusted accordingly. This is only possible if there are no bookings on the time account type except for accrual and recalculation bookings. The system adjusts accrual and recalculation bookings automatically. Here's an example: If you want the employee’s time account to start on the hire date and the employee is hired on February 1st, 2017, the account is created from February 1st, 2017 until January 31st, 2018. If you move the hire date from February 1st, 2017 to March 1st, 2017, the system will try to move the time account’s validity to March 1st, 2017 until February 28th, 2018. If, for example, the employee then tries to submit an absence request in February 2017, an error message is raised, The absence request needs to be canceled, then the effective start date for the job information can be changed. A Detailed Look at the Behavior of the Flexible Account Start Date ● Assigning the Time Account Type If you assign a time account type with flexible account start date, the system creates a Time Account Type Date Reference object for each combination of time account type and employment (user). Example: You configure the employee’s seniority date as the flexible account start date and you hire an employee on January 1st, 2017. The seniority date of the employee is set to January 1st, 2017 as well. The Time Account Type Date Reference is an effective dated object, which will in this case be created with the effective start date the same as the hire date (January 1st, 2017). For this period, the account creation start date is January 1st. 70 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● Termination of the Employment an employment has no impact on the existing time accounts. The validity end date is not adjusted. ● Rehiring an Employee If you rehire an employee, the flexible account start date rule is executed and a new validity slice is created in the Time Account Type Date Reference object. The reference date (start date) is set to the value of the rule. Depending on the rule, the date might differ from the start date of the first record or it can be the same. Seniority Date Example: Their employment, which began on January 1st, 2017 with an account start date the same as the seniority date (January 1st, 2017), was terminated in May 2017. There was a rehire on September 1st, 2017. During the rehire process, the seniority date was changed from January 1st, 2017 to April 1st, 2017 (because the employment was terminated for 3 months). The Time Account Type Date Reference object is updated automatically and looks like this: Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 71 ● Changing the reference date later If you change the seniority date in the employee's employment information not during rehire, but late, the time accounts are not changed automatically. In this case, you have to change the Time Account Type Date Reference object manually (the external code is set to <userid_time account type internal id>) and adjust the start date for the rehire period valid from September 1st, 2017 to the new seniority date - for example, May 1st, 2017. The time accounts are adjusted automatically when you save. Hire/Rehire Date Example The flexible account start date rule sets the employee’s hire date as the account start date. If the employee is hired on January 1st, 2017, the Time Account Type Date Reference object looks like this: 72 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management The time account would be created from January 1st, 2017 until December 31st, 2017: If you terminate the employment and rehire the employee again on September 1st, 2017, a new validity slice is added. It is valid from the employee's rehire date with the rehire date as reference start date: The existing time account is adjusted and the end date is changed to August, 31st, 2017. A new time account is created from September 1st, 2017 to August, 31st, 2018. This is only possible if there are only accrual or recalculation bookings after August 31st, 2017 on the existing time account: ● Accrual Frequency The accrual frequency, such as monthly or weekly, depends on the account reference start date (only called start date in the object). For accrual frequency set to monthly and a reference start date (start date of Time Account Type Date Reference) set to January 15th, the accrual periods are: January 15th to February 14th, February 15th to March 14th, March 15th to April 14th, and so on. ● Accruals Recalculation If an existing time account is shortened at the end (see the Hire/Rehire Date example) and a new time account is created, the accruals are removed and recalculated, then posted on the correct time account. Example: You have monthly accruals and they are posted for January 2017 until December 2017. Now you rehire an employee on September 1st, 2017. What happens? The accruals for September, October, November and December will be removed from the existing account, which gets August 31st, 2017 as new end date. Instead, the accrual rule will be called again for these accrual periods and the result will be booked on the new time account valid from September 1st, 2017 until August 31st, 2018. No further accruals will be created. Only the accruals that have already been posted are recalculated. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 73 3.5.2.2.1.1.2 Defining the Bookable Period of Time Accounts You can use the Time Account Configuration rule scenario to set the Booking Possible From field, Booking Possible Until field, and custom fields on a time account. It's not possible to set the Account Valid From and Account Valid Until fields or the external code via this rule. Restriction You cannot use a Time Account Configuration Rule for recurring time account types with Employee Flexible Date or Employee Hire Date as Account Creation Start Date. Context You can use the Time Account Configuration rule as an alternative to the Account Booking Offset (Months) field if you want to set the Booking Possible Until date more flexibly. For instance, you can define more fine-granular booking offsets, such as in days. Also, you can configure the Booking Possible From date independently from the Account Valid From date. Per default, the Booking Possible From date is set to the Account Valid From date. Note ● The rule is executed during time account creation and whenever the validity period is adjusted automatically, for example, in case of a hire date correction. The rule is not executed when a time account is created or adjusted via Manage Data, Import, and OData, or when the validity period is changed due to an interim update. ● If you change variables based on which your fields on the time account have been set, the fields will not be updated. For example, you set the Booking Possible Until date to the service date plus 12 months. You hire a new employee, the time account is created, and the Booking Possible Until field is set based on your Time Account Configuration rule. Now, you change the service date. Since this change does not update the validity period of a time account, the time account configuration rule will not be called again, which means that the Booking Possible Until date will not be updated based on the new service date. 74 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● For recurring and ad hoc time accounts you also have the possibility to set the Account Booking Offset (Months) field to define the Booking Possible Until date. If you define a different Booking Possible Until date via the rule, the date from the rule will be given priority and overwrite whatever has been defined via the Account Booking Offset (Months). ● Postings outside the bookable period are not allowed. If your validity period is not fully covered by the bookable period, the accrual rule execution will set the posting date to the Booking Possible From date for those postings whose posting dates are determined to lie outside the bookable period – independent from what you have configured to be the posting date in your accrual rule. For example, you have daily accruals, the posting date is defined to be the accruable start date. The Valid From date is set to 01.01.2020 but the Booking Possible From date is set to 01.02.2020. During the first month, the accrual rule creates accruals with posting dates that lie outside the bookable period. That means it automatically sets the posting date to the Booking Possible From date. Please also refer to Shifting the Posting Date. Procedure 1. In the Admin Center, go to Configure Business Rules. 2. Choose Create New Rule and select Time Account Configuration as the scenario. Use the IF condition to specify under which conditions the fields on the time account should be set and in which way. For instance, the booking possible until date could be set differently depending on the employee class. 3. In the Admin Center, go to Manage Data and select the Time Account Type for whose time accounts the settings should be applied. 4. Under the Time Account Configuration Rule field, you can select the rule created under (2). Result During time account creation and whenever the validity period of a time account is adjusted automatically (e.g., in case of a hire date correction), the Time Account Configuration rule will be called and will set the fields on the time account accordingly. The rule will overwrite the default Booking Possible From and Booking Possible Until date if set. 3.5.2.2.1.2 Management of Accruals Learn more about accruals and how you can separate them from entitlements. 3.5.2.2.1.2.1 Accruals An accrual rule is used to define the amount posted and the posting date. The posting date defines the date on which the accrual is available for the employee. The regular accrual booking is done using a change calendar. This calendar can be created automatically or manually. For time account types that are defined for automatic accrual creation, a daily job automatically creates and executes the change calendar when a new accrual period starts. The accrual period start date can be influenced by the first accrual offset of the corresponding time account type. For example, you can post the accrual 1 day before the actual accrual period starts. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 75 Note ● Take a look at the Time Account Type [page 722] documentation for full information on how to set up time account types. ● Accruals are not supported for ad hoc time accounts. In the case of manual accrual creation, you need to create a time account change calendar. You do this by going to the Admin Center and choosing Manage Time Off Calendars for the "Accrual" change scenario. Depending on the period you enter, calendars are created for one or more accrual periods. Calendars with a run date are already scheduled and will be executed automatically at the time the Trigger Tasks Job is scheduled, based on the Tenant Preferred Time Zone. Calendars without a run date need to be started manually. Each time the calendar is executed, you can view the change calendar details and open the log attached to it. In addition, the result log is sent by email to the user who started the job. The log provides information about accruals created and any errors that occurred. You can also simulate a calendar run so that no changes are saved. In this case, the result log is not available in change calendar details view, but you can access it in the Admin Center by choosing Monitor Jobs. Change calendars of type "Accrual" are time-account-type-specific. The calendar picks every employee who has a valid time account for the execution period (example: March 2016). The corresponding rule is then executed for these employees: ● If the employee is hired within this period, the hire rule is executed. ● If the employee is terminated within this period, the termination rule is executed. ● If the employee is hired and terminated within this period, the termination rule is executed. ● If the employee is neither hired nor terminated within this period, the accrual rule is executed. Note By default, changing a time profile will not create accruals automatically. If you want this to happen, switch the setting Level Of Accrual Automation to Automatic Accrual Creation. When this setting is activated, past-dated accruals will be automatically created for a maximum of 2 years only. For example, if you hire someone with a hire date that lies 5 years in the past, accruals will be automatically created for the first 2 years only. You'll have to create the accruals for the other 3 years manually by running a time account change calendar for accruals. If you need to create a lot of accruals manually (for example, in case of daily accruals), you might want to create the time account change calendar in Admin Center Manage Data Create New Time Account Change Calendar instead of on the Manage Time Off Calendars screen. Under Manage Data you can create accruals all at once in chunks of 1-year periods, whereas on the Manage Time Off Calendars you have to run the job for each accrual period separately. Related Information Calendars in Time Off 76 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.2.2.1.2.1.1 Accrual Rule You must create the rule with the time account as the base object. To do this, go to the Admin Center and choose Configure Business Rules. Tip The procedure described here is the conventional approach to defining accrual rules in Employee Central Time Off. You can continue to use this, but we recommend that, for accruals on actual/planned hours or days, you use the new scenarios provided. Look at the Accruals on Planned Working Time [page 87] documentation or the Accruals on Actual Working Time [page 85] documentation for descriptions of what you need to do. Before the recalculation of accruals, the accruals to be recalculated are removed. As such, it isn't possible within an accrual rule to distinguish whether the accrual rule is called due to the initial creation of the accrual posting or due to a recalculation. This table shows the available parameters: Name Object Time Account Time Account Accrual Rule Parameters Accrual Rule Parameters Accrual RuleVariables Accrual Rule Variables Planned Working Time Parameters Planned Working Time Parameters Accrual Calculation Base Parameters Accrual Calculation Base Parameters Here's some information on the individual parameters ● Time Account – The time account is the account the rule is executed for - for example, in a calendar run. For this time account, you should create a time account detail (account posting). Note ○ Only one time account posting (Time Account Detail entry) can be created for each rule execution. ○ Create exactly one time account posting record. If you intend to post the amount zero, please create it with zero. Followup processing, such as recalculation, will not work correctly otherwise. ● Accrual Rule Parameters – This parameter contains information about accrual start date and end date and accruable start date and end date. Take a look at the Accrual Rule Parameters [page 692] object description in the appendix for more information. ● Accrual Rule Variables – This parameter is used to save values during the rule execution to make the rule easy to read. The values need to be set explicitly in the rule before they can be used. Take a look at the Accrual Rule Variables [page 693] object description in the appendix for more information. ● Planned Working Time Parameters – This parameter contains the number of hours and days planned (based on work schedule) for the accruable period. Take a look at the Planned Working Time Parameters [page 708] object description in the appendix for more information. ● Accrual Calculation Base Parameters – This parameter contains information about actual hours and days worked. Take a look at the Accrual Calculation Base Parameters [page 690] object description in the appendix for more information. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 77 Example Now let's take a look at an accrual booking example. ● Amount Posted A fixed amount of 2 is posted, depending on your accrual frequency - for example, each month. ● External Code Choose function “Generate External Code For Time Off()”. This will generate a unique external code automatically. ● Posting Date Enter posting date of the booking. Here, you typically choose the accruable start date. ● Posting Type Choose Accrual as the posting type. ● Posting Unit Enter the posting unit here. It needs to be the same as the one defined for the account type of the time account. 3.5.2.2.1.2.1.1.1 Hire Rule You can enter a hire rule in the corresponding field of the time account type. The hire rule is executed for the hire accrual period of the employee. Execution is triggered during all accrual scenarios: hire process, accrual calendar run, and recalculation. Here are some examples of the hire accrual period: ● You have annual accruals from January 1 until December 31. An employee is hired on July 1, 2017, the hire period is January 1, 2017 until December 31, 2017. ● You have monthly accruals. An employee is hired on July 1, 2017, the hire period is July 1, 2017 until July 31, 2017. If you hire an employee within the current accrual period, the hire accrual is created automatically during hire. If you hire an employee not in the current accrual period - for example, for next year - the time account type setting for automatic accrual creation is considered. If the setting is not active, no accrual is created. The accrual is created during Time Account Change Calendar execution when you trigger the creation of all accruals for the next year for all employees. If automatic accrual creation is used, the accrual creation offset is also considered. If the accrual creation offset has already been reached and for all other employees the accrual has already been created for this upcoming accrual period, it is created for this user as well. If there is no hire rule assigned to the time account type, no posting is made. 78 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management A hire rule might differ from a regular accrual rule like this: ● Because you want to prorate the accrual Example: The employee was hired on July 1, 2017 and your annual accrual period is January 1, 2017 until December 31, 2017. You want to accrue only half of the regular accrual amount. ● Because your employees get an accrual if they are hired before a certain date Example: You have monthly accruals and employees who are hired on or before the 15th of the month get full accrual amount for this month. If they are hired after the 15th, they get nothing for the month. 3.5.2.2.1.2.1.1.2 Termination Rule You can enter a termination rule in the corresponding field of the time account type. The termination rule is executed for the termination accrual period of the employee. Execution is triggered during all accrual scenarios: termination process, accrual calendar run, and recalculation. Here are some examples of the termination accrual period: ● You have annual accruals from January 1 until December 31. An employee is terminated on July 31, 2017. The termination period is January 1, 2017 until December 31, 2017. ● You have monthly accruals. An employee is terminated on July 31, 2017, the termination period is July 1, 2017 until July 31, 2017. If the accrual booking already exists during termination, the accrual booking is recalculated so that the termination rule is executed and the new value posted. If no termination rule is assigned to the time account type, the recalculation sets the accrual for that period to zero. For more information, take a look at Recalculation of Existing Accruals. A termination rule might differ from a regular accrual rule like this: ● Because you want to prorate the accrual Example: The employee was terminated on June 30, 2017 and your annual accrual period is January 1, 2017 until December 31, 2017. You want to accrue only half of the regular accrual amount. ● Because your employees get an accrual if they are terminated before a certain date Example: You have monthly accruals and employees who are terminated on or after the 15th of the month get full accrual amount for this month. If they are terminated before the 15th, they get nothing for the month. Note ● Use accrualRuleParameters.accruableEndDate as the end date in your termination rule. Do not use EmploymentInformation.TerminationDate, because the termination date will not have been set when the rule is executed. ● Do not use a termination rule to close time accounts or set the validity dates of time accounts. This can lead to exceptions in the termination workflow. Please use the interim time account update rule instead. Here are some examples of when the termination rule is triggered and when it is not triggered. It gets called only when the Termination Effective date in Job Information is within the accrual period. And please note that the eligibility status is only set to No if you've configured the Termination Status in the TimeOffConfiguration object. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 79 Example #1: Monthly Accrual ● Termination date on the termination screen: 15.09.2019 ● Termination effective date in Job Information: 16.09.2019 For this accrual period You'll get the following results September (01.09.2019 - 30.09.2019) The accruable period will be 01.09.2019 - 15.09.2019, and the eligibility status will be set to No effective as of 16.09.2019. The termination rule will be called for September, since the first non-working day (16.09.2019) falls within the accrual period. The termination rule can prorate the accrual based on the termination date. October (01.10.2019 - 31.10.2019) Since the eligibility status is set to No as of 16.09.2019, all subsequent accrual periods will be recalculated with the amount set to 0. Example #2: Monthly Accrual ● Termination date on the termination screen: 30.09.2019 ● Termination effective date in Job Information: 01.10.2019 For this accrual period You'll get the following results September (01.09.2019 - 30.09.2019) The accruable period will be 01.09.2019 - 30.09.2019. The employee is active for all of September, so the termina­ tion rule will not be called for this month. October (01.10.2019 - 31.10.2019) The eligibility status will be set to No effective as of 01.10.2019. All accrual periods afterwards will be recalcu­ lated with the amount set to 0. Example #3: Yearly Accrual ● Termination date on the termination screen: 30.06.2019 ● Termination effective date in Job Information: 01.07.2019 80 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management For this accrual period You'll get the following results 2019 (01.01.2019 - 31.12.2019) The accruable period will be 01.01.2019 - 30.06.2019, and the eligibility status will be set to No effective as of 01.07.2019. The termination rule will be called for the year, since the first non-working day (01.07.2019) falls within the accrual period. The termination rule can prorate the accrual based on the termination date. 2020 (01.01.2020 - 31.12.2020) Since the eligibility status is set to No as of 01.07.2019, all subsequent accrual periods will be recalculated with the amount set to 0. Example #4: Yearly Accrual ● Termination date on the termination screen: 31.12.2019 ● Termination effective date in Job Information: 01.01.2020 For this accrual period You'll get the following results 2019 (01.01.2019 - 31.12.2019) The accruable period will be 01.01.2019 - 31.12.2019. Since the employee is active for all of 2019, the termination rule will not be called for this year. 2020 (01.01.2020 - 31.12.2020) The eligibility status is set to No as of 01.01.2020. All subse­ quent accrual periods will be recalculated with the amount set to 0. Example #5: Daily Accrual ● Termination date on the termination screen: 15.09.2019 ● Termination effective date in Job Information: 16.09.2020 For this daily accrual September 15th 2019 You'll get the following results The accruable period will be 15.09.2019 - 15.09.2019. The eligibility status will be set to No effective as of 16.09.2019. The termination rule is not be called on September 15th. Since the eligibility status is set to No as of 16.09.2019, all subsequent accrual periods will be recalculated with the amount set to "0". The termination rule will never be called for daily accruals. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 81 3.5.2.2.1.2.1.2 Simulating Accruals You can switch on the simulation in the time account type. When someone requests an absence in the future, their accruals until that date will then be simulated. For example, if you have monthly accruals and you request leave 4 months in the future, all accruals not yet posted are simulated up to the start date of the leave request and can be used. For daily and weekly accruals, you can distinguish between precise calculation or simple projection. For more details on this, take a look at the Time Account Type object documentation in the appendix. The simulation always uses the corresponding rule for the simulated periods. Let's look at an example. Scenario: ● Accrual period: Monthly ● Employee is hired on January 1, 2017. ● Today is June 1, 2017. ● Accruals are already booked until June 30, 2017. *****An employee then applies for leave starting on December 15, 2017. What happens then? ● Accruals are simulated for the current period (in this case, June) plus the future months affected, so July, August, September, October, November, and December 2017. ● The normal accrual rule is executed to determine the simulation accruals. Note ○ If your calculation is based on recorded times [page 85], you cannot use the normal accrual rule for the simulation, because you do not have actual hours or days available in the future. Therefore, this scenario uses the simulation rule from the time account type. ○ When accrual simulation is switched on, accrual entries will not be detected by Advanced Reporting. As such, if you use Advanced Reporting you might want to consider not using accrual simulation, as it will result in discrepancies in your reporting output (for example, unexpected records and balances). ○ When accrual simulation is switched on, accrual entries will not be displayed in the Time Account postings section of the Time Workbench UI. The simulated accruals will be used for balance calculation, however. 3.5.2.2.1.2.1.3 Accrual Eligibility The employee’s eligibility status, represented by the object Time Account Type Eligibility Status, defines whether the employee is allowed to get an accrual for a specific time account type for a certain period of time. The employee’s eligibility status is created by the system and should never be touched manually. For example, the employee has a vacation account with monthly accruals and is on maternity leave from June 2017 until December 2017. You can configure that the maternity leave leads to eligibility status “no”, meaning that the employee does not get any vacation accrual during the period June 2017 to December 2017. The accrual eligibility is influenced by several factors: ● Employee's job information status. 82 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● Assignment of time account. ● Employee waiting period (time until first accrual based on hire date. The employee’s eligibility status influences his or her accruable period directly. Example: An employee is hired on January 1, 2017 with yearly accruals and is not eligible from July 1, 2017 until December 31, 2017. His or her accruable period for 2015 would be January 1, 2017 until June 30, 2017. To define the accrual eligibility status that meets your needs, you need to map the job information status with the time account eligibility status. You need to find out the job information status you are using. Here's the standard list we deliver. You can add further values to suit your needs: Go to the Admin Center and choose Manage Time Off Structures, then Create New. Select the Time Off Configuration object and enter TLM_CONFIGURATION as the externalCode. Enter a row for each of the employee statuses (as Job Information Status), and decide on the Time Account Eligibility Status: ● Yes Accruals are created for time accounts with this status during this time period. ● No Accruals are not created for time accounts with this status during this time period. The employee is eligible for all employee statuses not included here. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 83 You can differentiate the employee’s eligibility per time account type. As per the example above, you can maintain that if the employee is on unpaid leave, he or she should be eligible for time account type “VACATION”, but not eligible for all other time account types. If you do not choose a specific time account type, the entry is valid for all time account types. Make sure that you either enter all different time account types here for each Job Information Status or enter a generic entry without choosing a specific time account type. Example: Employee is hired on January 1, 2017 with time account type “VACATION” and “SPECIAL_LEAVE”. On July 1, 2017 the employee status changes from A (active) to U (unpaid leave). Result: the eligibility status for time account type VACATION would be January 1, 2017 until December 31, 9999 set to “Yes”. The configuration above says the employee is still eligible, which means he is still allowed to get accruals although he is on unpaid leave. The eligibility status for time account type SPECIAL_LEAVE would be January 1, 2017 until June 30, 2017 set to “Yes” and July 1, 2017 until December 31, 9999 set to “No” because, for all time account types other than “VACATION”, unpaid leave leads to not eligible. The Time Account Eligibility Status is created for each combination of user ID and assigned time account types for this user. The Time Account Types are assigned via Time Type => Time Profile => Job Information. If the Time Account Type is assigned to the user later, the Time Account Eligibility Status for this Time Account Type is set to False first and set to "True" effective on the assignment date. The employee's waiting period is the time from hire to first accrual. For this period, the Time Account Eligibility Status is also set to "No". Triggers for Eligibility Status Changes Example.If the employee is hired on January 1, 2017, but the time profile with time account types is assigned to the employee on July 1, 2017, the eligibility status for those time account types would be “no” from January until end of June, because the time account type is not assigned to the employee. The employee does not get an accrual until the time account type is assigned in the job information. For example, if the employee is hired on January 1, 2017 with a time profile and assigned time account type VACATION and the waiting period defined in the time account type is set to three months. The eligibility status for VACATION would be set to “No” for January 1, 2017 until March 31, 2017 and set to “Yes” for April 1, 2017 until December 31, 9999. The employee does not get an accrual during the waiting period of this time account type. For further information, take a look at the Time Account Type Waiting Period [page 736] object documentation in the appendix. 84 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.2.2.1.2.1.4 Accruals on Actual Working Time In your accrual rules you can use the actual hours or days to calculate an employee’s accrual amount. These hours or days of the employees need to be uploaded into the system beforehand. Settings To create an accrual rule for accruals on actual hours or days, go to the Admin Center and choose Configure Business Rules. Select the Accruals On Actuals scenario and make your selections. Uploading Actual Times Note For updating accruals based on the recorded hours or actual working times, you usually upload accrual calculation base records or have built an integration scenario using the integration center to upload actual recorded times. When uploading accrual calculation base records, it's not mandatory to enter the external code in the format <user>_<date, where the date is in the format YYYY-MM-DD. (If the user name is A.N.Other, then an example of this format is A.N.Other_2014-10-23). You can enter the external code in any format. However, please don't use special characters in external codes. For a list of allowed characters, please refer to the related link. You can also leave the external code blank when uploading the actual times for creating a new record. If you are updating an existing entry, you need to ensure you enter the right external code. ● To upload actual quantities into the system, use the Accrual Calculation Base object with the following quantities: Actual Quantity, Quantity 1, Quantity 2, Quantity 3, Quantity 4, Quantity 5. ● Quantity 1 to Quantity 5 are custom fields that can be filled with, for example, public holidays or planned hours. ● You can upload the data in the Admin Center by choosing or using oData. Employee Fields Import and Export Data ● Note that you can upload only one record per day per employee. ● Data will be used for all time account types that are based on recorded data. ● Take a look at the Accrual Calculation Base [page 689] object information in the appendix for full details of how to use this object. ● By default, you're only allowed to upload data that is a maximum of 12 months old. However, if you want you can increase this limit by entering a new value in the field accrualCalculationBaseProcessingOffsetInMonths in the Time Management Configuration object. This field isn't visible by default, so you first need to set the visibility to Editable in Admin Center Configure Object Definitions . In general, we recommend that you only use such an increased limit for the initial upload of legacy data. ● The difference between the earliest and the latest date of the records should not exceed 12 months. For example, if the earliest record is from 01.01.2018 then the latest record should not be from later than 31.12.2018. This limit applies even if you've made the setting above in the Time Management Configuration Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 85 object. If you have a lot of data, and the difference between the earliest and latest date in one file exceeds 12 months, then you'll have to split the import file into multiple files. ● We recommend that you do not upload future-dated records, as these records might be ignored by the system and not get uploaded. ● If you're using the Integration Center to uploading the Accrual Calculation Base records, make sure that the file doesn't contain more than 1000 records. You can select the page size for SF to SF integration type under the Options tab. Note The DRM purge tool can be used to purge the accrual calculation base and the corresponding accrual calculation account type base records. All records in the selected period are purged. Using The Rule The fields of the Accrual Calculation Base Parameters object are derived from the uploaded actual hours / days. Here's an example: ● Uploaded actual quantities ○ October 4, 2017, Employee = A.N.Other, Actual Quantity = 5, Quantity 1 = 6 ○ October 5, 2017, Employee = A.N.Other, Actual Quantity = 5, Quantity 1 = 6 ○ October 6, 2017, Employee = A.N.Other, Actual Quantity = 5, Quantity 1 = 6 ○ October 7, 2017, Employee = A.N.Other, Actual Quantity = 5, Quantity 1 = 6 ○ October 8, 2017, Employee = A.N.Other, Actual Quantity = 5, Quantity 1 = 6 ● Daily accrual for user A.N.Other on October 5, 2017: Actual Quantity = 5, Quantity 1 = 6 ● Weekly accrual for user A.N.Other from October 4, 2017, until October 10, 2014: Actual Quantity = 25, Quantity 1 = 30 Calendar Run ● If you set the Accruals Based On field in the time account type to “Reported Data”, accruals are calculated automatically. A job runs each night to check whether any new actual hours or days have been uploaded. If new data is available, a Time Account Change Calendar is created; it creates the accruals for each completed accrual period in the past. The result can be checked in Manage Time Off Calendars for Change Scenario “Accruals on Recorded Time”. Note In this scenario, multiple accruals can be created for the same account, which can lead to problems under certain conditions. For example, let's say there are two Accrual Calculation Account Type Base records for the same user: one on 1st December, and another on 2nd December. ○ 1st December accrual calculation: the rule is defined in such a way that Create Time Account Detail is processed, but the booking amount that was calculated previously is invalid. As a result, an invalid time account detail is added to the time account. ○ 2nd December accrual calculation: rule function getBalanceForPostingTypesInPeriod is called for that time account. The rule function needs to add up the time account details of the account, but 86 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management processing fails due to the invalid time account detail (booking amount = null) created on 1st December. As a solution, you need to correct the rule to ensure that accruals are only created with a valid booking amount. For example, you can define additional IF conditions to make sure that the amount is not null. ● If you change records already uploaded (for example, because your employee made a correction) or you upload actual hours / days very late, this is considered during the next nightly job. ● The nightly job creates the Time Account Change Calendar only if something needs to be processed. If no new data has been uploaded, no time account change calendar is created. On the UI (Manage Time Off Calendars) you can see the last execution date and time (“Last completed job run on”). ● Any Accrual Calculation Account Type Base objects with status Error will not be picked up by the job. If you want the record to be picked up by the calendar run, you need to either change the record to To be processed and re-run the calendar, or re-upload the Accrual Calculation Account Type Base records correctly. Note Do not change the Accrual Frequency and the Accruals Based On in the time account type. Related Information Recommendations and Restrictions for Time Off [page 316] 3.5.2.2.1.2.1.5 Accruals on Planned Working Time In your accrual rules, you can use an employee's planned working time to calculate an accrual. Settings To create an accrual rule for accruals on planned hours or days, go to the Admin Center and choose Configure Business Rules. Select the Accruals On Planned Working Times scenario and make your selections. Using The Rule The value of: “Planned Working Days” and “Planned Working Hours” is the sum of all days in the work schedule for the accruable period (the difference between accrual and accruable is explained in the Accrual Rule Parameters [page 692] object in the appendix) of the employee. The parameter is not filled if your work schedule is created for flexible requesting without days. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 87 Example You have set up a work schedule like this: ● Day 1 to day 5 - 8 hours each day ● Days 6 and 7 - 0 hours each day ● Day 1 is Monday. The daily accrual for an employee with this work schedule on a Monday looks like this: ● Planned working days = 1 ● Planned working hours = 8 The weekly accrual for an employee with this work schedule looks like this: ● Planned working days = 5 ● Planned working hours = 40 3.5.2.2.1.2.2 Separation of Accruals and Entitlements Learn more about the difference between accruals and entitlements. Leave accruals are regular postings on a time account. In most cases, when leave is accrued and posted on a time account, the leave is available to employees instantly as leave entitlements. This is the default behavior for time accounts. However, some countries have absence types where leave entitlements are posted at a different frequency at which leave is accrued. This alternative behavior makes it possible to distinguish between accruals and entitlements. In this case, leave is accrued on a regular basis, but not made instantly available to employees as leave entitlements. These entitlements are created on so-called transfer dates. ● Accruals: not available for consumption. ● Entitlements: available for consumption. A common use case for accruals and entitlements is Long Service Leave (LSL) in Australia. LSL is an additional leave entitlement and a benefit for employees who have worked for the same employer for a longer time period. This means that. ● LSL is accrued on a daily basis. ● LSL is entitled to an employee when seniority has been reached, for example after 7 or 10 years. ● When the initial service period has been completed, the transfer frequency is reduced to a yearly, monthly, or daily frequency. However, LSL continues to be accrued on a daily basis even after the employee has reached seniority. Configuration Note To separate accruals and entitlements, you need to change the setting in the Entitlement Method field on the time account type to Entitled as Transferred. 88 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● If you choose Entitled as Accrued, then accruals become usable immediately. This is the default setting. ● If you choose Entitled as Transferred, then accruals become usable only after they've been transferred to entitlements. With this setting, additional configuration options are made available. You can specify rules about how and when accruals are transferred. Note The entitlement method Entitled as Transferred is available for time account types only for which you've selected Permanent as Account Creation Type. Here are the additional configuration options on the time account type: ○ Initial Accrual Transfer Date Rule. You can assign this rule to set the date of the first accrual transfer. ○ Accrual Transfer Date Rule. You can assign this rule to set the subsequent transfer dates after the initial transfer date. ○ Accrual Transfer Rule You can assign this rule to set the amount of entitlements that are generated on a transfer date. This is typically the sum of accruals. Through this rule, you can also determine the posting type and posting date of the entitlement. In case of a regular transfer, the posting type is Entitlement. The posting date is the Next Transfer Date. If there is an ad hoc transfer the posting type is the Ad Hoc Entitlement and the posting date is the Ad Hoc Transfer Date. The optional configuration settings on the time account type are: ○ Advances Allowed ○ Values: Yes or No ○ If you choose Yes, employees can take leave based on the accruals, even if they haven't yet been transferred. If you choose No, they can't take time off based on the accruals until the accruals have been transferred to entitlements. How It Works For each user and time account type combination in which the time account type is set to Entitled as Transferred, a Time Account Type Accrual Transfer object is created. This object stores a Next Transfer Date. Initially, this date is set by the Initial Accrual Transfer Date rule, which is called during account creation. Example An employee is hired on January 1, 2010, and receives daily leave accruals starting from this date on. The Initial Accrual Transfer Date rule defines an initial waiting period of 7 years. When the employee’s time account is created, the Time Account Type Accrual Transfer object is created too. It sets the Next Transfer Date to January 1, 2017. As a result, although the employee accrues leave on a daily basis, these accruals can't be consumed until the date in the Next Transfer Date field is reached. In this case, that's January 1, 2017. The accrual transfer on the Next Transfer Date is performed through an entitlement calendar. You can view or create entitlement calendars through the Admin Center Manage Time Off Calenders UI. An entitlement calendar runs for all users whose Next Transfer Date lies on or before the calendar end date. Depending on the Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 89 setting in the Level of Accrual Automation field on the time account type, the entitlement calendar runs automatically, or must be created manually. As the Next Transfer Date typically differs from employee to employee, the automatic entitlement calendar runs on a daily basis and is executed automatically at the time the Trigger Tasks Job is scheduled, based on the Tenant Preferred Time Zone. If a time account type accrual transfer is selected by an entitlement calendar because its Next Transfer Date lies on or before the calendar end date, the following happens: 1. The accrual transfer rule is executed, generating the entitlement posting as determined by this rule. Additionally, a counter posting called Accrual Reset is created automatically to reset the accrual balance to zero as the accruals have now been transferred to an entitlement. Note If the Next Transfer Date lies outside the bookable period of the time account, the accrual transfer rule execution is skipped. This means that no entitlement posting is generated. In this case, only step 2 applies. 2. The accrual transfer date rule is called setting the new Next Transfer Date as determined by this rule. Each time the calendar is executed, you can view the change calendar details and open the log attached to it. In addition, the result log is sent by email to the user who started the job. The log provides information about accruals transferred as entitlement and any errors that occurred. You can also simulate a calendar run so that no changes are saved. In this case, the result log isn't available in change calendar details view, but you can access it in the Admin Center by entering Monitor Jobs. Example Continued The entitlement calendar run on January 1, 2017 detects that there's one employee for whom the Next Transfer Date shows as January 1, 2017. 1. The accrual transfer rule is executed. According to the rule, the amount of the entitlement is the sum of accruals. The accrual balance as of 31 December 2016 is 63 days. As a result, an entitlement of 63 days with the posting date January 1, 2017 is created. Furthermore, an accrual reset of -63 days with posting date January 1, 2017 is created. This ensures that the accrual balance starts to cumulate from scratch again. Note The Sum of Accruals parameter, which can be used in the accrual transfer rule, subsumes all accrual postings between the day of the last (ad hoc) entitlement (if any) and the Next Transfer Date, not including the accrual on the Next Transfer Date itself. On the contrary, opening accruals on the next transfer date are included in the accrual transfer for that transfer date. 2. The accrual transfer date rule is executed. According to the rule, the subsequent transfer frequency is set to be yearly. As a result, the new Next Transfer Date for the employee is January 1, 2018. Accruals are subject to recalculation. As a result, the sum of accruals can change retroactively. In that case entitlements are also recalculated as part of the accrual recalculation. 90 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Example Continued Let's assume you've an accrual rule in place that creates an accrual posting only when the employee isn't on unpaid leave. If so, no accruals are posted for the duration of the leave. The employee records retroactive, unpaid leave from December 19 to December 23, 2016. This leads the system to recalculate the accrual amount on these days to zero. As a consequence, the entitlement posting on January 1, 2017 is also recalculated since the sum of accruals isn't 63 days anymore, but less. Remember Accrual posting type to make manual accrual adjustments on the time account. For example, if you go live with SAP SuccessFactors Employee Central Time Management, you might need to post an initial accrual and an initial entitlement balance to the time account to reflect an employee’s balance as of the go-live date. If you have daily accruals and recalculation runs over such a manual Accrual posting, it's recalculated to the amount according to the accrual rule. Instead, you can use the Opening Accrual (and Opening Entitlement) posting type, which, isn't subject to recalculation. Sometimes it might be necessary to deviate from the set transfer dates and to transfer accruals to entitlements before the regular Next Transfer Date is reached. This is possible via an ad hoc transfer. There's a separate Ad Hoc Transfer Date field on the Time Account Type Accrual Transfer. This field is filled automatically if you schedule an ad hoc transfer via the Admin Workbench Time Accounts Account Postings Add Accrual Transfer. The accrual transfer for an ad hoc transfer date is treated in the same way as for accrual transfers that happen on the regular Next Transfer Date. This means that if the ad hoc transfer date lies on or before the end date of the entitlement calendar, the accrual transfer rule is called. However, the accrual transfer date rule isn't called if there's an ad hoc transfer. Example The employee's regular Next Transfer Date is on January 1, 2018. However, the HR admin needs to grant an entitlement to the employee before that date. So, the HR admin schedules an ad hoc transfer on July 1, 2017. The entitlement calendar run on July 1, 2017 detects the ad hoc transfer date and generates an ad hoc entitlement of 4.5 days. There's no new next transfer date, the Next Transfer Date stays as January 1, 2018. When the entitlement calendar runs on January 1, 2018, it creates a regular entitlement again. The amount of this entitlement is the sum of accruals between the ad hoc transfer and January 1, 2018. You might also want to allow your employees to book leave already against accruals that haven't yet been transferred to an entitlement. This can be achieved via leave taken from advances. This is only possible if you set Advances Allowed on the time account type to Yes. Bookings for leave that has been taken for accrued leave that has yet to be transferred to an entitlement are marked accordingly. Once an entitlement is generated, the advance leave booking is re-evaluated and the advance label is removed. Example Continued Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 91 Let's consider the employee has already taken most of the available entitlements. Only 2 days of entitled leave are left. The next regular transfer takes only place on January 1, 2018, but the employee wants to take 5 days of leave from December 18-22, 2017. The accrual balance at this point in time amounts to 3 days and advances are allowed. Consequently, the employee can book the 5 days leave (2 days entitlements + 3 days accruals). However, the leave bookings on December 20, 21, and 22 are marked as advances as they're booked against accruals. When the entitlement of 4.5 days on January 1 2018 is generated, enough entitlement balance is available again to cover the leave bookings on December 20, 21, and 22 as well. As a result, the advance flag is removed. Restriction ● Because accruals can be recalculated, don't use theEntitlement creation is possible up to a maximum of 10 years in the future. ● Per entitlement calendar run and user, a maximum of 365 entitlements can be generated. ● There's no role-based permission available to restrict if ad hoc transfers can be scheduled. Refer to Time Account Type [page 722] for information on time account types. Refer to Time Account Type Accrual Transfer [page 732] for information on the Time Account Type Accrual Transfer object. 3.5.2.2.1.2.2.1 Initial Accrual Transfer Date Rule The Initial Accrual Transfer Date rule sets the date for the first accrual transfer. It's assigned to the corresponding field on the time account type. The rule runs when the time account is created for the employee. The rule is triggered whenever a time account is created. This includes the following scenarios: ● The assignment of a time profile with a time account type to which the initial accrual transfer date rule was assigned. The time profile is assigned through the employee's job information, for example: ○ The hiring process ○ The job information ● The account creation calendar run 92 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Here's some information on the available parameters: Name Time Account Type Accrual Transfer Object ● Next transfer date. This is the date of the next accrual transfer. It's the parameter you set with the Initial Ac­ crual Transfer Date rule. The next transfer date is the re­ sult of the Initial Accrual Transfer Date rule. This is the only parameter you can modify with the rule. ● Last transfer date. This is the date of the most recent accrual transfer. It is a read-only parameter, which means that you can't modify the Last Transfer Date with the Initial Accrual Transfer Date rule. ● Ad hoc transfer date. This is the date of the next ad hoc transfer, if scheduled. It is a read-only parameter, which means that you can't set the ad hoc transfer date with the Initial Accrual Transfer Date rule. Refer to the following documentation for more information: Time Account Type Accrual Transfer [page 732] Initial Transfer Date Rule Parameters ● Job Info Effective Start Date. This determines the effective date when the corresponding time account type was assigned to an employee. The time account type is assigned through the time profile assignment. ● Hire Scenario. This is an indicator to show whether the rule is being called as part of a hire scenario or not. You can select Yes or No. It is a read-only parameter, mean­ ing that you cannot modify the value of this indicator with the Initial Accrual Transfer Date rule. Note If you migrate time account data, you have the following options: (1) You can export the time account type accrual transfer history for your employees. You can change the next transfer date accordingly and import the object again. You also need to add the date of the next transfer date in the time account type accrual transfer history. (2) You can let the system determine the next transfer date. However, this can lead to a situation where the result of the Initial Accrual Transfer Date rule lies in the past. In such cases, you first need to run the entitlement calendar to get the current next transfer date. This can be problematic if you have configured daily accrual transfers after the initial transfer. For more information, refer to our best practice tip on daily accrual transfers. Related Information Best Practice Tip: Daily Accrual Transfers [page 97] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 93 3.5.2.2.1.2.2.2 Accrual Transfer Date Rule The Accrual Transfer Date rule sets the date for the subsequent transfers after the initial transfer. The Accrual Transfer Date rule is assigned to the corresponding field on the time account type. The rule is executed at the time of the entitlement calendar run. Here's some information on the available parameters: Time Account Type Accrual Transfer ● Next Transfer Date. This is the date of the next accrual transfer. It's the parameter you set with the Initial Ac­ crual Transfer Date rule.The next transfer date is the re­ sult of the Initial Accrual Transfer Date rule. This is the only parameter you can modify with the rule. ● Last Transfer Date. This is the date of the most recent accrual transfer. It is a read-only parameter, which means that you can't modify the last transfer date with the Initial Accrual Transfer Date rule. Note Don't set the next transfer date based on the last transfer date. The last transfer date field is updated only when the next transfer date has been set. Us­ ing the last transfer date as a base date for the next transfer date leads to an error during the entitle­ ment calendar run. Because of that, you typically set the next transfer date based on the next trans­ fer date parameter. ● Ad Hoc Transfer Date. This is the date of the next ad hoc transfer, if scheduled. It is a read-only parameter, which means that you can't set the ad hoc transfer date with the Initial Accrual Transfer Date rule. Take a look at the documentation of the time account type accrual transfer for more information: Time Account Type Accrual Transfer [page 732] Initial Transfer Date Rule Parameters ● The Job Info Effective Start Date determines the effective date as of which the respective time account type has been assigned to an employee via the time profile assignment. It is a read-only parameter, meaning that you cannot modify the job info effective start date with the Initial Accrual Transfer Date rule. ● The Hire Scenario indicates whether the rule is being called as part of a hire scenario or not. You can select yes or no. It is a read-only parameter, meaning that you can't modify the value of this indicator with the Ini­ tial Accrual Transfer Date rule. Refer to the documentation of the time account type accrual transfer for more information:Time Account Type Accrual Transfer [page 732] 94 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note ● The next transfer date must be after the last transfer date. ● You need to enter something in the Next Transfer Date field because it's a mandatory field on the Time Account Type Accrual Transfer object. Make sure that you add an else statement to your Accrual Transfer Date rule in case none of the if conditions apply. This is the case especially when the user’s job information is read in your if conditions and the next transfer date lies in the past. Make sure that the respective job information is maintained as of that point in time or that you have an else statement in place. ○ Setting the next transfer date in the else statement to the next transfer date without any amendment doesn't work because the next transfer date must be after the last transfer date. Caution This rule isn't designed for running daily accrual transfers, as this can lead to performance issues. If you still want to use the Accrual Transfer Date rule to run a daily accrual transfer, please refer to our best practice tip on daily accrual transfers Best Practice Tip: Daily Accrual Transfers [page 97]. Related Information Best Practice Tip: Daily Accrual Transfers [page 97] 3.5.2.2.1.2.2.3 Accrual Transfer Rule The Accrual Transfer rule is used to create the entitlement and ad hoc entitlement posting on the time account. It's assigned to the corresponding field on the time account type. The rule is executed at the time of the entitlement calendar run. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 95 Here's some information on the available parameters: Parameter Time Account A Time Account Detail represents a posting on the time ac­ count. This is the parameter you create with the Accrual Transfer rule. The Time Account Detail is the result of the ap­ plication of this rule. You need to specify the following: ● Amount Posted: This is typically the sum of accruals (see Accrual Transfer Rule Parameters). ● Posting Type: You need to select Entitlement or Ad Hoc Entitlement depending on the scenario code (see Ac­ crual Transfer Rule Parameters). ● Posting Date. Here you need to select Next Transfer Date or Ad Hoc Transfer Date depending on the scenario code (see Accrual Transfer Rule Parameters). ● External Code: Here you typically select Generate External Code for Time Off(). ● Posting Unit: Here you must select the unit of the re­ spective time account type. Refer to the Time Account [page 711] documentation for more information. Note If the accrual transfer rule execution can't determine any time account detail postings, the rule posts only a zero booking. This typically happens when none of the If conditions in the accrual transfer rule are met and, at the same time, the rule doesn't contain any Else state­ ments. The posting type is Entitlement and the posting date Next Transfer Date for regular transfers. For ad hoc transfers the posting type is Ad Hoc Entitlement and the posting date Ad Hoc Transfer Date. In both cases the Amount Posted is 0. If you want to correct the postings afterwards you need to modify the accrual transfer rule. Then, run an entitlement calendar with recalculation. 96 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Parameter Accrual Transfer Rule Parameters The following parameters are read-only, so you can't modify them with the Accrual Transfer rule. ● Scenario Code: This parameter contains information about the scenario in which the rule is called (ad hoc or regular accrual transfer). Caution You should always make use of the scenario code and distinguish the time account posting based on it. Not doing so can lead to several issues. In case of a regular transfer, the posting type should set to be Entitlement. The posting date should be set to the Next Transfer Date. In case of an ad hoc transfer, the posting type should be Ad Hoc Entitlement and the posting date should be the Ad Hoc Transfer Date. ● Sum of Accruals: This parameter represents the sum of accruals since the date of the last (ad hoc) entitlement. Time Account Type Accrual Transfer ● Sum of Ad Hoc Transfers: This parameter represents the sum of all posted ad hoc transfers since the last regular accrual transfer. ● Sum of Total Accruals: This parameter represents the sum of accruals from the date of the last entitlement until now. Ad hoc transfers are not considered. The following parameters are read-only, so you can't modify them with the Accrual Transfer rule. ● The Next Transfer Date is the date on which the next ac­ crual transfer happens. ● The Last Transfer Date is the date on which the previous accrual transfer has happened. ● The Ad Hoc Transfer Date is the date on which the next ad hoc transfer takes place, if scheduled. Refer to Time Account Type Accrual Transfer [page 732] for further information. 3.5.2.2.1.2.2.4 Best Practice Tip: Daily Accrual Transfers Here's information about how to separate accruals and entitlements for the initial waiting period only, but not going forward. Your accrual transfer date rule then looks like the following: ● In the If section, the rule is set to be Always True. This setting can differ based on your needs. ● In the Then section, Time Account Type Accrual Transfer. Next Transfer is equal to Date Plus(). Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 97 Here are more entries you've to set in the Then section: Value Entry Base Date Time Account Type Accrual Transfer.Next Transfer Date (Optional) Number of Months 0 (Optional) Number of Days 1 Caution This setup can lead to performance issues, especially when you're migrating your data. Let’s look at an example. Example One of your employees started to work for your company on January 1, 1992. Now, you migrate to SAP SuccessFactors Employee Central Time Management on October 1, 2020. You assign the time information to the employee and the initial accrual transfer date rule is called. The initial accrual transfer date rule looks as follows: ● In the If section, the rule is set to be Always True. ● In the Then section, Time Account Type Accrual Transfer. Next Transfer Date is equal to Date Plus(). Here are more entries you've to set in the Then section. Value Entry Base Date Time Account Type Accrual Transfer.User.Employment Details. Original Start Date (Optional) Number of Months 120 (Optional) Number of Days 0 The rule sets the next transfer date to January 1, 2002. This means that the next transfer date lies in the past and isn't up to date. Now, you need to run the entitlement calendar, which generates (unnecessary) entitlements from January 1, 2002 for every day until today. Note These entitlements are created unnecessarily if your time account has been bookable from the original start date of the employee. If the time account is bookable only from the Go live date onwards, entitlement creation will be skipped and the next transfer date is moved to a later date. Eventually, the next transfer date will be October 1, 2020. As a by-product, you start off with 6848 entitlements on the time account. However, there's a restriction that only 365 entitlements per entitlement calendar run and time account can be created. If there are daily entitlements, you need to run multiple entitlements calendars until all your employees' next transfer dates are up to date. This can be time-consuming. 98 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Tip To avoid this issue, you can set up your initial accrual transfer date rule for the time of the migration as follows. This way, you can separate accruals and entitlements for the initial waiting period, but grant entitlements on a daily basis immediatley afterwards. ● In the Variables section ○ var_ITD must be set equal to Date Plus (). Here are more entries you must set in the Variables section: Value Entry Base Date Time Account Type Accrual Transfer.User.Employ­ ment Details. Original Start Date (Optional) Number of Months 120 (Optional) Number of Days 0 ● In the If section, the var_ITD is before 10/01/2020. ● In the Then section, set Time Account Type Accrual Transfer. Next Transfer Date to be equal to 10/01/2020. ● In the Else section, set Time Account Type Accrual Transfer. Next Transfer Date to be equal to var_ITD. This way, you make sure that you don't start off with next transfer dates that lie before the Go live date. Instead of entering a fixed date (here: 10/01/2020, which is the Go live date), you can also refer to some custom date field or use the today() rule function. It depends on what fits your needs best. After the migration process has been completed, you can change the initial accrual transfer date rule. 3.5.2.2.1.2.2.5 Automatic Adjustment of Accrual Transfer Dates The transfer dates determined by the (Initial) Accrual Transfer Date rule have to be adjusted in case an employee takes a certain type of leave, such as leave without pay. For example, an employee can be eligible for long service leave after completing seven years of seniority. However, if that employee takes leave without pay, or unauthorized leave, the time they're away on leave doesn't count towards their seniority. Let’s say the employee is hired on January 1, 2010. The Initial Accrual Transfer Date rule is set to the next transfer date to January 1, 2017. However, the employee takes leave without pay on June 15, 2016 (one day). This day doesn't count towards the employee’s seniority. As such, the next transfer date (and all subsequent transfer dates) must be adjusted by one day to January 2, 2017. Configuration To ensure that transfer dates are always automatically recalculated like this, make the following configuration settings: Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 99 ● In the Time Management Configuration object, set Enable Recalculation to Yes. ● In the time types that you want to trigger the adjustment of transfer dates (for example, leave without pay or unauthorized leave), set the Not to count as time in service field to Yes. Note This field isn't visible by default. You need to make it editable in the object definition. ● In the time account type for which the transfer dates must be adjusted: ○ Select an Effect on Transfer Date rule that determines how the transfer dates are adjusted. Note This field isn't visible by default. You need to make it editable in the object definition. ○ Under recalculation fields, select Absences not to count as time in service. How It Works If you record, edit, delete, or decline an absence request that has a time type marked as Not to count as time in service, a Time Management Recalculation Event for Recalculate Transfer Dates is automatically created. It adjusts all transfer dates that fall after the absence start date. Note The adjustment takes place regardless of the current approval status of the absence. That means that even when an absence marked as Not to count as time in service hasn't been approved, transfer dates are immediately adjusted. However, if the absence is subsequently declined, the transfer dates are adjusted back. For the cancellation workflow, it works differently. There the transfer date is only adjusted back once approved. Some other points to keep in mind: ● If the adjusted transfer dates are in the past, and entitlements have already been created for them, the posting dates and the amounts of the entitlements are also recalculated automatically. ● Ad hoc transfer dates are never adjusted, since they're ignored by the Effect on Transfer Date rule. However, the ad hoc entitlement amount can get recalculated due to the adjustment of other transfer dates. ● Transfer dates aren't adjusted for closed time accounts. ● If the start date of a Not to count as time in service leave request falls on a transfer date, this transfer date is not adjusted, but the subsequent dates are. For example, if the previous transfer date was on January 1, 2020, the next transfer date will be on January 1, 2021. You then retroactively record a Not to count as time in service absence from January 1, 2020 until January 10, .2020. The transfer date on January 1, 2020, won't be adjusted, but the next transfer date on January 1, 2021 will be adjusted. ● If you've configured a leave of absence time type as Not to count as time in service, the transfer dates will first be adjusted based on the expected return date. Once the actual return date is entered, transfer dates are adjusted based on the actual return date. 100 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Additional Configuration Options Let's say an employee gets daily accruals of 0.1 days, the sum of which is to be transferred on January 1, 2017. However, due to the fact that the employee has taken leave without pay, the transfer date is adjusted to January 2, 2017. This means that the entitlement the employee gets on January 2, 2017, will be 0.1 days more than they would have received if the transfer had happened on January 1, 2017. As such, you might want to also assign an accrual rule that posts 0 accruals for days on which an employee is on the relevant types of leave. This ensures that the transferred entitlement remains the same even if the transfer date is shifted. In order to enable that kind of recalculation, make the following additional configuration settings: ● In the time type that is marked as Not to count as time in service, set Accrual Recalculation Relevance to Full. ● In the time account type for which accruals should stop during Not to count as time in service leave, select Absence change as a recalculation field and assign an accrual rule. Here's an example rule: Restrictions ● Simulations don't take the Effect on Transfer Date rule into account. Entitlements are simulated solely based on the results of the Initial Accrual Transfer Date rule, and as such the simulation doesn't recognize if Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 101 an entitlement is supposed to happen at a later point in time. Keep this in mind, especially when making termination payouts based on simulated entitlements. ● If you use a posting date in the Accrual Transfer rule that is different from the Next Transfer Date, it isn't possible to recalculate transfer dates and entitlements. For this reason, we recommend that you always use the Next Transfer Date as the posting date for the entitlement. ● Deleting absences that are marked as Not to count as time in service prevents the transfer dates from being adjusted back correctly. Don't permanently delete such absences. Instead, just cancel them. 3.5.2.2.1.2.2.5.1 Effect on Transfer Date Rule You can enter an Effect on Transfer Date Rule in the corresponding field of the time account type. This rule is executed during the recalculation of transfer dates. Transfer date recalculation selects any time account types for which Absence not to count as time in service have been set as a recalculation field. For these time account types, the respective Effect on Transfer Date rule is executed. The rule picks the Time Account Type Accrual Transfer object associated with a particular user and time account type, and adjusts all transfer dates (except for ad hoc transfer dates) from the Time Account Type Accrual Transfer History after the start date of the leave request which initiated the transfer date recalculation. Note Transfer date recalculation is always triggered by leave requests which are marked as Not to count as time in service. Here are the parameters for the rule: Name More Info Original Transfer Date This refers to the original date or, if a previous adjustment has already taken place, the adjusted date as specified by the Time Account Type Accrual Transfer History. It is a readonly parameter, meaning that you cannot modify an original transfer date with the Effect on Transfer Date rule. Adjusted Transfer Date This is the parameter you set with the Effect on Transfer Date rule. As such, the adjusted transfer date is the result of the Effect on Transfer Date rule. This is the only parameter you can modify with the rule. The adjusted transfer date appears in the Time Account Type Accrual Transfer object. Period Start Date and Period End Date 102 PUBLIC “Period” in this context always refers to the period between two transfer dates or, in case of the period before the initial transfer, between the start date of the time account and the initial transfer date. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management And here's how a typical rule setup would look: With this rule, you adjust an original transfer date by the sum of leave without pay (LWOP) and unauthorized leave (UNAL) days. For example: Note For performance reasons, we recommend that you use a variable in the rule to get the absence days. Related Information Automatic Adjustment of Accrual Transfer Dates [page 99] 3.5.2.3 Creating a Time Profile Time profiles primarily define which time types an employee is eligible for. As such, they represent bundles of time types. Prerequisites You need the following permissions: ● Administrator Permissions Metadata Framework Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Manage Data PUBLIC 103 ● User Permissions Miscellaneaous Permission Time Profile permission must be set to Edit. ● You also need permission to access the generic Time Profile object. Context Different employee groups, for example depending on the country/region, usually have different absence types they can take. Hence, you typically create multiple time profiles to reflect such differences. For example, you might have employees located in the U.S. who are eligible for Jury Duty leave, but this kind of leave doesn’t exist in Germany. Consequently, you would need two different time profiles: one that includes Jury Duty leave and can be assigned to your employees located in the U.S., and one that doesn’t include Jury Duty leave and can be assigned to your employees located in Germany. Procedure 1. Go to the Admin Center and choose Manage Data Create New Time Profile . 2. Enter a meaningful name and a unique external code. For example, Time Profile Germany (Duration) (DUR_TP_GER). 3. Select a time recording variant. Duration is the default value. 4. In the Available Time Type section, select the absence time types from the Time Type field and enter an External Code for each of the time types. For additional configuration options for time types, refer to Configuration Options for Available Time Types in the Time Profile [page 105]. 5. Select the main absence time type. Next Steps Your next step is: ● Enabling the Assignment of Time Off Master Data to Employees [page 106] Related Information Time Profile [page 741] 104 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.2.3.1 Configuration Options for Available Time Types in the Time Profile Get an overview of the time type configuration options. Enabled in Employee Self-Service Scenario Field Value Description Typical Use Case Yes Employees can record this absence time type themselves from the Time Off Employee Self-Service (ESS) UI and in the mobile app. The same holds true for absences that are requested from the time sheet UI if the time sheet is active. You want employees to record their an­ nual leave on their own to minimize the administrative burden on your HR de­ partment. No This is the default value. The absence time type can only be recorded from the Time Admin Workbench UI or in an on behalf scenario in the time sheet UI if time sheet is active. In case of unauthorized leave, you only want HR administrators to record the leave. Favorite Time Type The setting is only effective for absence time types that are linked to a time account type. You can select up to maximum three different favorite time types. Note Make sure that your favorite time types don’t have external names that exceed 20 characters. Field Value Description Yes This time type is the absence time type that is shown in the Balance section at the top right on the Time Off Employee Self-Service (ESS) UI. No Employees need to choose Show All to see the balance asso­ ciated with this absence time type. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 105 Hide Account Balance Field Value Description Yes The account balance for this time type (if associated to any time account type) doesn’t appear in the Time Off Employee Self-Service (ESS) UI from where employees can request ab­ sences. Furthermore, the balance will not be shown on the people profile if the employee accesses his or her own peo­ ple profile nor will it be shown when accessing his or her own time sheet if time sheet is active. However, the system still checks whether the employee has sufficient balance on the relevant time account to cover the absence being requested. No This is the default value. Employees have full insight into their available balance. 3.5.2.3.2 Main Absence Time Type The main absence time type is the absence time is pre-selected when employees request an absence. The main absence time type is the time type for which the available balance is displayed on the Time Off home page tile in case the main absence time type is associated to a time account type. On the New home page the main absence time type is the one for which the engagement card is generated. The absence time type that you select here must be among the list of time types assigned to the time profile. 3.5.2.4 Enabling the Assignment of Time Off Master Data to Employees For employees to manage their absences using Employee Central Time Off, they need to have certain time off master data assigned to their job information. This encompasses a time recording variant, work schedule, holiday calendar, and a time profile. Prerequisites You need permission to access the HRIS Element. ● Administrator Permissions Metadata Framework ● Administrator Permissions Manage Business Configuration 106 PUBLIC Manage Data HRIS Element . Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Context Time Off master data is typically assigned by HR administrators, either during a hire or during a job info change. To assign time off master data to an employee’s job information, you first need to enable the time management fields in the job information and grant the necessary permission to those who are supposed to assign time off master data to employees. Procedure 1. Go to the Admin Center and choose Manage Business Configuration. 2. Choose HRIS Element jobInfo . 3. Select Yes in the Enabled field for Time Recording Variant, Work Schedule, Holiday Calendar, and Time Profile. 4. Open the permission roles of those who should assign time off master data to an employee’s job information. 5. Grant these users edit and correct permissions for the fields Time Recording Variant, Work Schedule, Holiday Calendar, and Time Profile. 6. If the Work Schedule, Holiday Calendar, or Time Profile object is secured, you need to give permission to view those objects. Otherwise, the dropdown list of the Work Schedule, Holiday Calendar, and Time Profile fields on the Job Information are empty. You grant the permissions as follows: User Permissions Miscellaneous Permissions , select at least the View permission for Work Schedule and Time Profile. Under User Permissions for Holiday Calendar. Time Management Object Permissions , select at least the View permission Results HR admins can now assign time off master data to an employee’s job information such that employees can manage their absences using Employee Central Time Off. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 107 3.5.2.4.1 Automating the Assignment of Time Information to Employees Create a rule that automatically assigns job information - including time objects - to new employees, or employees that switch to a new role or location within your company so that time objects are assigned automatically. Procedure 1. Create the rule. 2. Set the parameters for the rule. Set the parameter name of Context to System Context and Job Information Model to Job Information Model. 3. To create a rule that assigns a time profile based on the legal entity, you can create this rule:Set the rules that assign the time object. ○ If Company.Value.Legal Entity ID is equal to [the legal entity] ○ Then Set Time Profile.value to be equal to [the profile] Figure 1: Propagation Rule 4. Save the rule in your Data Model as an OnInitSet the or OnChange event. 108 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 5. Import the Data Model. The new rule will then be immediately available for use. Results Using the rule above as an example, any employee that transfers from another company in the ACE group to ACE Australia will automatically be assigned the time profile shown in the THEN statements of the rule. 3.5.3 Customization of Absence Recording Learn more about how to customize absence recording. 1. Configuring Workflows for Absence Recording [page 110] Set up workflows for each time type so that all leave requests can be processed correctly. 2. Time Account Balance Calculation [page 112] You have a number of options that affect how balances are calculated. 3. Time Account Deduction Sequence [page 116] If employees can have several time accounts, you need to specify the order in which absences should be deducted from the accounts. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 109 4. Adding Additional Validation Checks for Leave Requests [page 120] When you create, cancel, or edit a leave request, the system performs certain checks. For example, an error comes up when the time account balance is not sufficient to book leave. Sometimes might you want to add further validation checks. This can be done using what we call "take rules". 5. Collisions Between Absences [page 122] Sometimes absences can collide due to unexpected circumstances. For example, an employee who is on an approved vacation might fall sick and need to create a new sick leave request. As an admin or manager, you need to decide how collisions like this will be handled. 6. Concurrent Absences [page 127] The concurrent absences feature allows you to record an absence that overlaps, either fully or partially, with another absence. 7. Enabling Recurring Absences [page 136] Employees who need to take regular time off (for example, for childcare) can request 2 hours of leave each day for a period of 6 months. Admins can also set up such a recurring absence on their behalf. 8. Enabling Flexible Absence Requesting [page 137] If your employees' working time models often vary, you need to be able to manage this in the system. 9. Allowing Absences with Undetermined End Dates [page 140] In some circumstances, employees might need to enter absences with a start date but no fixed end date. For example, if they fall ill and are unable to say when they will return. In order to support this, you need to allow absences with undetermined end dates in Time Off. 10. Half Pay Leave and Double Pay Leave [page 141] In case standard leave doesn't meet an employee's needs, they can now officially request half pay leave or double pay leave instead. 11. Custom Fields in Time Off [page 143] If the standard fields in Employee Central Time Off don't cover the unique requirements at your company, you can create your own custom fields. You can do this for all time off requests or just for specific time types. 3.5.3.1 Configuring Workflows for Absence Recording Set up workflows for each time type so that all leave requests can be processed correctly. Context When approving leave requests, the approval process can vary depending on the type of leave. For example, a vacation request could just require a manager's approval whereas an unpaid leave request needs to be approved by that manager's manager as well. In order to ensure that all leave requests are reviewed correctly, you need to set up workflows for each different time type. 110 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Procedure 1. Maintain the employeeTime object. Go to Configure Object Definitions, call up the Employee Time object definition, and make these settings: ○ Employee Time is the default label. Change the label if it better suits your requirements. ○ For ToDo Category, select Time Off Requests. ○ Ensure that the labels for employee times all have meaningful names. The texts appear in notification emails, for example, so they need to be clear. Ensure that you change the text in all the languages your company uses. ○ Ensure that Pending Data option is set to No. Caution Setting the Pending Data option to Yes isn’t supported and causes inconsistencies in your data. Inflight changes are therefore not supported. 2. In the Admin Center individual time types. Configure Business Rules , create a rule that uses the workflow settings for the Note If you're setting up the admin workflow with approval steps, or the collision management feature, please use the adapted rule. 3. Assign the rule to the Employee Time object. a. In the Admin Center, go to Configure Object Definitions. b. Open the Employee Time object definition and choose Take Action Make Correction . c. Go to the Rules section, add your newly created rule under Save Rules, and save. 4. Create individual workflows for each time type by going to Admin Center Manage Organization, Pay, and Job Structures . For example, for time type Vacation that only needs the employee's manager approval, use Manager as the Approver Role. Note It's possible to configure a workflow in such a way that the approver role is a position rather than an individual employee. Workflows like this can be approved by any employee that holds the relevant position. In cases like this, there will be no specific employee name listed in the To be approved by field. Once someone approves the absence request, however, their name is displayed in the Approved by field. 5. Add the workflow configuration to the time type. a. In the Admin Center, choose Manage Time Off Structures. b. Open the time type for which you want to add a workflow. c. Choose Take Action Make Correction , enter the workflow configuration, and save. Caution Don't add your own default screen under the object definition of the Employee Time object because it overrides the default implementation. As a result, the approver can see technical fields or is able to Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 111 view the Time Type object details by clicking on the quick card, even without having been assigned the necessary Time Type object permissions. Results The approval workflow is now active for all the time types you configured. Note ● The workflow affects an employee's ability to cancel their leave requests. When the request is still in the Pending status, the employee is able to cancel the request directly. However, if the request has already been approved, then any cancellations go through the necessary workflow. ● If you want, you can use the auto-approval feature for workflows. Auto-approved workflows are displayed with status Approved, just like standard manual workflows. For more information, see Automatic Approval for Stalled Workflows. On the Time Off employee self-service (ESS) screen, the Approver Name for any auto-approved workflows shows the name of the job owner, and Approved On shows the date on which the job approved the workflow. ● The comment field on the Time Off ESS user interface can only be entered by the employee if the employee requests an absence. However, if an admin creates an absence on behalf of an employee, the employee isn't allowed to enter the comment. Similarly, if an employee creates an absence that has to be approved by their manager, and if an admin enters a comment using the Time Admin Workbench UI, the system raises an error. This is expected behavior because the workflow comment can only be entered by the workflow participants (the one who initiated the workflow, and the approver). Task overview: Customization of Absence Recording [page 109] Next: Time Account Balance Calculation [page 112] 3.5.3.2 Time Account Balance Calculation You have a number of options that affect how balances are calculated. Time Account Type In the time account type, you can choose whether the simulation should take place or not. ● If the simulation is not active, you can only use the accrual balance, which is already posted to a time account. ● If the simulation is active, the accruals from the current accrual period until the start date of the leave request will be simulated and can already be used even though the accrual is not yet posted to the corresponding time account. 112 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note If you use time account types "entitled as transferred", the system behaves differently. Time Type In the time type, you can choose the balance calculation setting. Either only the postings until the calculation date are considered or the postings after this date as well. If you want postings after the calculation date to be considered, this means that future negative postings are considered, if they cannot be offset against other positive future postings before the negative ones. If they can be offset against other positive bookings, they do not influence the balance calculated until the calculation date. The examples below illustrate this. This calculation date depends on the screen. If you request leave, this date is the start date of the leave request. If you look at the balances of the time types in the ESS UI, it is the “as of date”. This setting is not considered on UIs that show the time account balances (such as the Time Accounts tab in the workbench). In these UIs, only postings until the calculation date are considered, regardless of the setting in the time type. If you create or update a leave request, postings after the calculation date are always considered, to check whether you are allowed to book this leave request, regardless of what's entered in the time type setting. Examples Now let's look at some examples. Example 1 Scenario 1 Balance Calculation Setting = Consider Bookings Until Calculation Date Calculation Date = Feb 1, 2017 Result: Balance = 10 days, because the booking on May 1, 2017 is a future booking. Scenario 2 Balance Calculation Setting = Consider Bookings Until Calculation Date Calculation Date = May 1, 2017 Result: Balance = 10 – 2 = 8 days, because the date of the booking on May 1, 2017 is the date until when the bookings are considered. Scenario 3 Balance Calculation Setting = Consider Bookings After Calculation Date Calculation Date = Feb 1, 2017 Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 113 Result: Balance = 10 – 2 = 8 days, because a negative booking in the future will be considered if it would lead to a reduction of the balance. Scenario 4 Balance Calculation Setting = Consider Bookings After Calculation Date Calculation Date = May 1, 2017 Result: Balance = 10 – 2 = 8 days, because the date of the booking on May 1, 2017 is the date until when the bookings are considered. Example 2 Scenario 1 Balance Calculation Setting = Consider Bookings Until Calculation Date Calculation Date = Feb 1, 2017 Result: Balance = 10 days, because the other bookings are booked in the future. Scenario 2 Balance Calculation Setting = Consider Bookings Until Calculation Date Calculation Date = May 1, 2017 Result: Balance = 10 + 4 – 2 = 12 days, because all bookings are made on or before May 1, 2017. Scenario 3 Balance Calculation Setting = Consider Bookings After Calculation Date Calculation Date = Feb 1, 2017 Result: Balance = 10 + 2 – 2 = 10 days, because the negative future booking is covered by a positive future booking, means the negative booking is offset against the positive booking and on February 1, 2017 still 10 days can be taken. Scenario 4 Balance Calculation Setting = Consider Bookings After Calculation Date Calculation Date = May 1, 2017 Result: Balance = 10 + 4 – 2 = 12 days, because the date of the booking on May 1, 2017 is the date until when the bookings are considered. Example 3 Scenario 1 Balance Calculation Setting = Consider Bookings Until Calculation Date Calculation Date = Feb 1, 2017 114 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Result: Balance = 10 days, because the other bookings are in the future. Scenario 2 Balance Calculation Setting = Consider Bookings Until Calculation Date Calculation Date = July 1, 2017 Result: Balance = 10 + 4 – 6 + 4 = 12 days, because all bookings booked on or before July 1, 2017 are considered. Scenario 3 Balance Calculation Setting = Consider Bookings After Calculation Date Calculation Date = Feb 1, 2017 Result: Balance = 10 + 4 – 6 = 8 days, because the negative future booking can only be offset against positive bookings on the same date or earlier. It cannot be offset against the future positive booking in July, because the posting is not yet available at May 1, 2017. Scenario 4 Balance Calculation Setting = Consider Bookings After Calculation Date Calculation Date = July 1, 2017 Result: Balance = 10 + 4 – 6 + 4 = 12 days, because all bookings booked on or before July 1, 2017 are considered and there is no future booking after this date, which would have been deducted. Example 4 Scenario 1 The accrual bookings in green are not yet posted. Simulation is set to “No” at Time Account Type. Balance Calculation Setting = Consider Bookings Until Calculation Date Calculation Date = March 1, 2017 Result: Balance = 2 + 2 = 4 days, because the existing bookings until March 1, 2017 are considered. The simulation of accruals is not switched on and future bookings should not be considered per the time type setting. Scenario 2 The accrual bookings in green are not yet posted. Simulation is set to “Yes” at Time Account Type. Balance Calculation Setting = Consider Bookings Until Calculation Date Calculation Date = March 1, 2017 Result: Balance = 2 + 2 + 2 = 6 days, because the existing bookings until March 1, 2017 are considered and the accrual of the current accrual period (March 1, 2017 until March 31, 2017) is not yet booked. It will be simulated Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 115 because of the corresponding Time Account Type setting. The future bookings are not simulated and existing ones are not considered at all. Scenario 3 The accrual bookings in green are not yet posted. Simulation is set to “No” at Time Account Type. Balance Calculation Setting = Consider Bookings After Calculation Date Calculation Date = March 1, 2017 Result: Balance = 2 + 2 - 4 = 0 days, because the simulation is not active and the negative future booking has to be considered. Scenario 4 The accrual bookings in green are not yet posted. Simulation is set to “Yes” at Time Account Type. Balance Calculation Setting = Consider Bookings After Calculation Date Calculation Date = March 1, 2017 Result: Balance = 2 + 2 + 2 + 2 + 2 - 4 = 6 days. The accruals for January, February, and March are already available on the calculation date, March 1, 2017. The accruals for April and May are only used to compensate for the absence request with 4 days on July 5. This calculation is necessary to ensure the correct available balance on March 1. Parent topic: Customization of Absence Recording [page 109] Previous task: Configuring Workflows for Absence Recording [page 110] Next: Time Account Deduction Sequence [page 116] 3.5.3.3 Time Account Deduction Sequence If employees can have several time accounts, you need to specify the order in which absences should be deducted from the accounts. For example, an employee might have a current time account for the time type Vacation, and another older time account from a previous year. As an admin, you can determine whether absence requests will be posted against the newer account or the older account first (by either validity period or bookable period). If several time account types are assigned to a single time type, you can also determine the order in which deductions are made from the different time account types. Parent topic: Customization of Absence Recording [page 109] Previous: Time Account Balance Calculation [page 112] 116 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Next task: Adding Additional Validation Checks for Leave Requests [page 120] 3.5.3.3.1 Methods for Specifying Deduction Sequence If employees can have several time accounts of the same type (for example, vacation accounts from previous years), and if multiple time accounts types are attached to a time type, you need to specify the sequence in which absences should be deducted from the accounts. You do this in the Posting Priority field of the time type. In the Posting Priority field for a time type, you can select either of these options: ● Post to time accounts by posting rules only ● Post to time accounts by defined time account period Let’s have a look at how both of them work. Post to Time Accounts by Posting Rules Only This is the default option. If you select it, you can specify the posting order for time accounts in the time account type as follows: 1. In the Admin Center, go to Manage Time Off Structures Time Account Type . 2. In the Posting Order field, select one of these options: ○ No Selection If you select this, the system automatically defaults to Oldest First by Validity Period. ○ Newest First by Validity Period If you select this option, any time off requests will be posted against the newest account available according to its validity period. When the newest account is empty, requests will then be taken from any available older accounts. ○ Oldest First by Validity Period If you select this option, any time off requests will be posted against the oldest account available according to its validity period. When the oldest account is empty, requests will then be taken from the newer accounts. ○ Newest First by Bookable Period If you select this option, any time off requests will be posted against the newest account according to its booking period (in other words, the time account that will expire last). When the newest account is empty, requests will then be taken from any available older accounts. ○ Oldest First by Bookable Period If you select this option, any time off requests will be posted against the oldest account according to its bookable period (in other words, the time account that will expire first). When the oldest account is empty, requests will then be taken from the newer accounts. Deductions will be taken from time accounts according to the following priorities: 1. The order of the time account types listed under the time type’s posting rules. 2. The posting order for time accounts specified in each time account type. As such, it makes sense to use this option if you want deductions to only be taken from a single time account type, or to be taken from one time account type first before being taken from another time account type. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 117 Example: An employee has two time account types assigned to the time type “Vacation”: ● Time Account Type A ● Time Account Type B You select Post to time accounts by posting rules only for the time type, and specify this posting order in the time account type: ● Time Account Type A: Newest First By Validity Period ● Time Account Type B: Oldest First By Bookable Period The employee submits a booking for the time type “Vacation”. Based on the settings you’ve made, the posting priority will be as follows: 1. Time Account Type A with validity period 01.01.2018 to 31.12.2018 2. Time Account Type A with validity period 01.01.2017 to 31.12.2017 3. Time Account Type B with bookable period 01.03.2015 to 28.02.2018 4. Time Account Type B with bookable period 01.03.2016 to 31.03.2019 Post to Time Accounts by Defined Time Account Period Selecting this option makes sense if you want deductions to be taken from multiple time account types. It doesn’t consider the type of the time accounts; rather it uses the posting order specified in the time type. As such, if you select this option you also need to specify the posting order for time accounts in the time type. Deductions will be taken from time accounts according to the following priorities: 1. The posting order for time accounts specified in the time type. 2. The order of the time account types listed under the time type’s posting rules. Example: An employee has two time account types assigned to the time type “Vacation”: ● Time Account Type A ● Time Account Type B 118 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management You select make the following settings for the time type: ● Posting Priority: Post to time accounts by defined time account type period ● Posting Order: Oldest First By Bookable Period The employee submits a booking for the time type “Vacation”. Based on the settings you’ve made, the posting priority will be as follows: 1. Time Account Type B – No. 3 with bookable period 01.03.2015 to 28.02.2018 2. Time Account Type A – No. 1 with bookable period 01.01.2017 to 31.03.2018 3. Time Account Type A – No. 2 with bookable period 01.01.2018 to 31.03.2019 4. Time Account Type B – No. 4 with bookable period 01.03.2016 to 31.03.2019 Note ● You need to specify the posting order in the time type, not the time account type. If it is specified in the time account type as well, the setting in the time account type will be ignored ● It might happen that two time accounts for the same time account type have the same bookable end date. As a result, the posting order Oldest First By Bookable Period would be inconclusive. In situations like that, the validity period of the time accounts will be considered. So in our example above, the third factor that would be considered for the deduction sequence would be Oldest First By Validity Period. Related Information Time Account Deduction Sequence [page 116] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 119 3.5.3.4 Adding Additional Validation Checks for Leave Requests When you create, cancel, or edit a leave request, the system performs certain checks. For example, an error comes up when the time account balance is not sufficient to book leave. Sometimes might you want to add further validation checks. This can be done using what we call "take rules". Context You can use take rules to generate a warning message, an error message, or an info message. The relevant message will then be triggered whenever you, as the admin, make changes, and also when employees enter data. Here are some important restrictions to keep in mind: ● We strongly recommend that you do not use the ApprovalStatus field in take rules because the final approval status is not definitively determined when validation rules are processed. ● Please do not raise messages in Initialize, Validate, Save, Post save or Delete rules attached to the EmployeeTime object definition. Do not raise messages using the OnChange rule on any Employee Time object field definition. ○ If you raise an error message in the above cases, the system will give a validation error. ● For validations, we strongly recommend you use Take rules for raising messages. ● Only the following fields are available in take rules: ○ User ID ○ Time Type ○ Start Date ○ End Date ○ Fraction Quantity (for one day absences and flexible requesting) ○ Leave Of Absence Expected Return Date (for leave of absence time types) ○ Leave Of Absence Actual Return Date (for leave of absence time types) ○ Custom fields defined for the Employee Time object. ● Note that only the following custom fields are available when requesting time off using the SuccessFactors BizX mobile application. ○ Attachment ○ Boolean ○ String ○ Number ○ Decimal ○ PickList ○ Date ○ Time ● Note The system doesn't support HTML tags in message definitions. 120 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Procedure 1. In the Admin Center, go to Manage Data and create the messages you want to use. Here's an example: If you want to format the text of the message, you can use any of these BB codes: Use this BB code For this effect [b]...[/b] Bold [i]...[/i] Italics [u]...[/u] Underline [s]...[/s] Strike through [size]...[/size] Font size [color]...[/color] Font color [center]...[/center] Center text [quote]...[/quote] Quote [url]...[/url] Link/Link name [img]...[/img] Image [code]...[/code] Code [table]...[/table] Tables [br]...[/br] Line break 2. In the Admin Center, go to Configure Business Rules. 3. Choose Create New Rule, select Absence Validation as the scenario, and create the rule that will be used to trigger the message. ○ You're free to add further ELSE conditions to the rule if you want to trigger different messages under different conditions. a. Use the IF condition of the rule to specify the conditions under which the message should be raised. For example, you might want the rule to check if there are more than 2 days between the start date and the end date of the absence. The rule function Get Number of Calendar Days() can be used for that calculation. If you only want ro raise the message for employees but not for admins, add User is equal to Login User() as an IF condition. The check will then only be carried out in the Employee Self-Service scenario. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 121 b. For the THEN condition, add a Raise Message expression. Choose the relevant message and the level of severity (Error, Warning, or Info). Here's another example: c. You're free to add further ELSE conditions to the rule if you want to trigger different messages under different conditions. Results Task overview: Customization of Absence Recording [page 109] Previous: Time Account Deduction Sequence [page 116] Next: Collisions Between Absences [page 122] 3.5.3.5 Collisions Between Absences Sometimes absences can collide due to unexpected circumstances. For example, an employee who is on an approved vacation might fall sick and need to create a new sick leave request. As an admin or manager, you need to decide how collisions like this will be handled. By setting up collision checks, you can control exactly how the system deals with absences with overlapping dates. Sticking with our example of an employee who falls sick while on vacation, you can specify that a new absence will be created without a collision error, and the existing absence will be canceled automatically. If the new absence doesn't completely cover the one that has been canceled, then another absence will created for the remaining time. The collision check works regardless of whether the new absence is imported into the system or created from the Time Workbench screen. If there's no collision check in place, the HR department or the manager would have to manually cancel the existing leave and then create a new one. Restriction There are some restrictions on the use of collision checks: ● Collision Resolution isn't triggered in the Mobile user interface. ● You cannot split existing absences with flexible requesting by means of a new absence request. However, you can replace existing absences with flexible requesting if they are fully covered by the new absence request, which may be flexible or not. A new absence with flexible requesting can also split an existing absence request that is not flexible. ● New absences can be leaves of absence (LOA). If an existing absence is LOA, you see an error message. 122 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● When importing, you cannot combine updates to existing absences and creation of new absences by using the same Import file. Import the existing absences first, then you can import the incoming absences to trigger collision checks. ● You cannot split partial day absences by creating new partial day absences. However, you can replace partial day absences with new full day absences. ● You cannot split an absence that is no longer editable, as is the case, for example, after period-end processing has run for the relevant time account. What About Workflow? When new absences are created as a result of collisions, they are automatically assigned "Collision Resolution" as an origin. The Time Off workflow rule ensures that the normal workflow is triggered for these absences, and that they're given the same status as the original absence they replaced. As such, you need to make sure that the Time Record Origin field is visible. 1. In the Admin Center, go to Configure Object Definitions. 2. Open the Employee Time object, and choose Take Action Make Correction . 3. Set the Time Record Origin field to Read Only. Parent topic: Customization of Absence Recording [page 109] Previous task: Adding Additional Validation Checks for Leave Requests [page 120] Next: Concurrent Absences [page 127] Related Information Setting Up Collision Checks for Absences [page 123] 3.5.3.5.1 Setting Up Collision Checks for Absences Set up collison checks so that absences with overlapping dates can be automatically managed. Procedure 1. Create a time type collision grouping and assign it to the relevant time type. For example, if you want to ensure that any sickness absences will replace existing absences of any other type in your system, you'd create a grouping called SICKNESS and assign it to the SICKNESS time type. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 123 2. Create a time management collision resolution object, and use it to configure how you want the actual check to work. Sticking with our example, these would be the specifications for the object: ○ Incoming Grouping: SICKNESS ○ Existing Grouping: All Others ○ Collision Resolution Action: By default, this is set to Split and Delimit and the field is hidden in the Time Management Collision Resolution Items object definition. If you need to enable Concurrent Absences, this field must be made Editable in the object definition. For information on how to configure it for concurrent absences, please refer to Time Management Collision Resolution [page 124]. Results Let's say an employee creates a new sickness absence for the period August 24 to August 31.The system checks to see if there are any clashes between the sickness absence and any absences already in the system. It finds that the employee has a vacation request, with status Pending, for the period August 24 to September 9. What happens then? ● A new absence of type Sickness is created for the period August 24 to August 31. ● The existing vacation request is canceled and a new one is created for the period September 1 to September 9, with the same Pending status as the original request. Related Information Time Type Collision Grouping [page 127] Time Management Collision Resolution [page 124] Configuring Concurrent Absences [page 129] 3.5.3.5.2 Time Management Collision Resolution The system needs to check whether a new leave request clashes with one already entered. You can use this object to determine what happens in cases where such collisions occur. Note You can create only one Time Management Collision Resolution object. You can amend it as required later. Here's some information on how to use the fields in the object: ● Control Absence Take Rule Execution You can specify whether take rules are invoked for all absences processed during collision resolution or only for an incoming leave request. ○ Values: Execute All or Skip for Existing Records. ○ If you choose Execute All, the check takes place for all absences involved in the split and delimit process - that is, the newly created ones, the original ones, which are canceled, and the new absences that are created to cover the remaining absence periods from the original absences. 124 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ○ If you choose Skip for Existing Records, the check takes place only for the newly created ones. The rule isn’t executed for the original records, which are canceled, or the new absences that are created to cover the remaining absence periods from the original absences. Collision Resolution Items ● Incoming Grouping ○ Values: Enter the time type collision grouping where there are collisions you want the system to resolve using the split and delimit process. ● Existing Grouping Selection Method ○ Values: All Others or Specific Grouping ○ If you select All Others, the system applies the split and delimit process when new absences with time types of the group you specified under Incoming Grouping collide with existing absences with time types from any other group. You then don't need to make any entry in the Existing Grouping field in this line. ○ If you select Specific Grouping, you then need to specify a group in the Existing Grouping field in this line. The system then applies the split and delimit process when new absences with time types of the group you specified under Incoming Grouping collide with existing absences with time types from the group you enter under Existing Grouping to detect any collisions. ● More Details Collision Resolution Action ○ If you select Allow concurrent records, an incoming absence of this grouping is created concurrent to existing absences. ○ If you select Split and delimit, an incoming absence of this grouping is created, but the existing absence will be changed so that there's no concurrent record. The existing absence is either split into two absences, and the incoming absence is inserted in between, or the existing absence is delimited so that no concurrence exists. If the incoming absence is fully concurrent with the existing absence, the existing absence is cancelled. Example Let's look at some examples: Table 13: Split and Delimit Incoming Grouping Existing Grouping Sickness All Others Collision Resolution Behavior If you create an absence for a time type with collision grouping “Sickness” as­ signed, split and delimit takes place au­ tomatically if existing absences have a different collision grouping assigned or no collision grouping at all. Sickness Vacation If you create an absence for a time type with collision grouping “Sickness” as­ signed, split and delimit takes place au­ tomatically if existing absences have collision group “Vacation” assigned. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 125 If there's no entry for a collision grouping assigned to a time type, no automated split and delimit is triggered. If you want to define that split and delimit is always triggered when an absence for a time type with collision grouping “Sickness” assigned is created, you make two entries for Incoming Grouping “Sickness”: one entry with existing grouping “All Others” and another one with existing grouping “Sickness". Table 14: Allow Concurrent Records Collision Resolution Behav­ Incoming Grouping Existing Grouping Collision Resolution Action ior Illness (with undetermined All Others Allow concurrent records. If you create an absence for a end date) time type which has the Illness (with undetermined end date) collision grouping assigned, the absence is cre­ ated as concurrent absence. The absence is created con­ current to the existing absen­ ces that have a different or no collision grouping as­ signed. Illness (with undetermined Vacation end date) Allow concurrent records If you create an absence for a time type that has the Illness (with undetermined end date) collision grouping assigned, the absence is created as concurrent absence. The concurrent absence is con­ current to the existing absen­ ces that have a different or no collision grouping as­ signed. The absence is cre­ ated concurrent to an exist­ ing absence that have the va­ cation collision grouping as­ signed. ● If you want that an absence of the type Vacation can be created over an existing absence with the collision grouping Illness (with undetermined end date), then you can choose the incoming grouping as Vacation and the existing grouping as Illness (with undetermined end date). Related Information Setting Up Collision Checks for Absences [page 123] 126 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.3.5.3 Time Type Collision Grouping Use this object to group the objects you want to use in collision resolution as described in the Handling Collisions Between Absences documentation. Use the same collision grouping for all time types that should be treated in the same way for collision handling purposes. Here's some information on how to use the fields in the object: ● External Name Enter a meaningful name for the group you want to create. ● External Code Enter an external code for the group you want to create. ● Country/region Please enter a country/region for your time type collision grouping. You don't need to enter a country/ region for the Split and Delimit collision grouping, but you must enter a country/region for the Concurrent Absence collision grouping. When you have created your groupings, you need to enter them in the time types you want to group together for the purpose of handling collisions between absences. You also need to enter them in the relevant Time Management Collision Resolution object. Take a look at the Time Management Collision Resolution [page 124] documentation for details. 3.5.3.6 Concurrent Absences The concurrent absences feature allows you to record an absence that overlaps, either fully or partially, with another absence. Note This feature is currently in the Early Adoption phase. If you’re interested in enabling this feature as an Early Adoption feature in your instance, reach out to the Time Management Forum of the Customer Community. The current collision resolution Split and Delimit in Time Off prevents absences from colliding or fully overlapping with each other. However, there are country/region-specific sickness processes in some countries (such as the Netherlands, UK, or Spain) that require concurrent absence records in the system. The concurrent absence records are also required to be processed in Payroll, Legal Reporting and other downstream processes. Concurrent absence management is a process to record, manage, integrate and allow payroll processing of time records, which exist in parallel to one another at same time. In technical terms, Concurrent absences are absences that either partially or full overlap with one another. As part of the Early Adoption Program, the concurrent absences feature is enabled only for the following countries: ● Netherlands (NLD) ● United Kingdom (GBR) ● Spain (ESP) Examples Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 127 Here are examples for use cases from different countries/regions: ● Netherlands. If an employee falls sick, they should report their sickness to the employer within 24 hours. Any existing absences shall remain unchanged until further action is taken by the employee or their manager. There is also reintegration process in Netherlands to help with the recovery in case of long-term illnesses. ● United Kingdom. An employee in the UK is allowed to adopt another child while already in adoption leave from the same family. The employee receives two lots of entitlement for the overlapping period. One adoption leave can be taken for 39 + 13 weeks in total and between two adoptions there can be overlap. For the overlapping period, both the absence should be paid as per the statutory payment rules. Similar to Spain, in the UK there is also the legal requirement that sick leave is entered with an Undetermined End Date and any future absences remains unchanged in the system. ● Spain. If an employee falls sick, their sickness is recorded with an "Undetermined end date", and any existing future leaves musn't be cancelled when the illness is recorded. Parent topic: Customization of Absence Recording [page 109] Previous: Collisions Between Absences [page 122] Next task: Enabling Recurring Absences [page 136] 3.5.3.6.1 Concurrent Absences Restrictions Here's information about the restrictions of the concurrent absences feature. Restrictions ● The system doesn't allow you to create an absence with flexible requesting as a concurrent absence. The incoming grouping under Time Management Collision Resolution Items can't have a time type with flexible requesting when the collision resolution action is Concurrent Absence. However, it's possible to have an existing absences with flexible requesting. ● If you assign a country which doesn't belong to the list of allowed countries for concurrent absences, such as Germany, then a validation error is raised. The list of allowed countries is NLD, ESP and GBR. ● A user can't create two or more overlapping absences with Undetermined end date in the system. The system raises an error in this case. ● A user can't create two or more overlapping "Leave of Absence" records in the system. The system raises an error in this case ● When importing concurrent absences, you can't combine uploading an existing absence and creating a new absence in one import file. Import the existing absences first, then import the incoming absences. As a result, you're able to create a concurrent absence. ● The existing rule functions can return more hours than the planned hours if there's a concurrent absence in the period which the rule function is called for. For example: the rule function Get Absence In Days For Period() can return the double amount of hours for the period where there is a concurrent absence. We 128 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management recommend to check, during implementation, if your rules can lead to incorrect results. These are the affected rule functions: ○ Get Absence In Hours For Period() ○ Get Absence In Days For Period() ○ Get Absence In Days For Period Based On Calendar Days() ○ Get Absence In Days For Period Based On Working Days For Time Types() ○ Get Absence In Days For Period Based On Working Days For Time Types Excluding Weekdays() ○ Get Absence in Days For Period with Threshold() ○ Get Absence In Hours For Period For Time Types() ○ Get Completed Months Of Time Types In Period() ○ Get Cumulated Absence Days For Current Year() ● Concurrent absences isn't supported on the mobile user interface. 3.5.3.6.1.1 Configuring Concurrent Absences Use the concurrent absences feature so that absences can be created in parallel. Context The concurrent absence configuration is similar to the Split and Delimit configuration of absences. For example, you can configure whether an incoming "Sickness" absence should split and delimit an existing absence "Annual Leave". Table 15: Incoming Grouping Existing Grouping Collision Resolution Behavior Sickness All Others If you create an absence for a time type with collision grouping “Sickness” as­ signed, split and delimit takes place au­ tomatically if existing absences have a different collision grouping assigned or no collision grouping at all. Remember When you use the Split and Delimit configuration, the system doesn't allow the user to record concurrent absences in the system. In some countries/regions, it's a requirement that the existing absence isn't cancelled due to the Split and Delimit process, but remains active in the system. In Split and Delimit, you need to specify the collision behavior of incoming absences in relation to the existing absences. For example, you can configure whether an incoming "Sickness" absence splits and delimits an existing absence "Annual Leave". Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 129 Procedure 1. Go to Configure Object Definitions, select the Object Time Management Collision Resolution Item and set the Collision Resolution Action field to Editable. 2. Go to Manage Data Time Management Collision Resolution object. Under the Time Management Collision Resolution Items, the field "Collision Resolution Action" should be specified to Allow concurrent records. It is defaulted to Split and Delimit for all existing configuration entries. 3. Go to Manage Data Time Type Collision Grouping and create a collision group for incoming absences. Let's say an incoming grouping is called "Illness (with undetermined end date)". Assign a country/region field in the time type collision grouping as this is required for the configuration of concurrent absences. It's important to assign the country/region in the time type collision grouping to an allowed country (NLD, ESP, or GBR) to be able to allow concurrent absences. 4. Assign the collision grouping for incoming absences and existing absences to the respective time types. 5. Once you have set up the time type collision groupings, you can define the collision rules in the Time Management Collision Resolution object with collision resolution action as Allow concurrent records. 3.5.3.6.1.1.1 Examples of Concurrent Absences Configuration Here are some examples of how concurrent absences can be configured. Table 16: Examples of Concurrent Absences Configuration Collision Resolution Behav­ ior Incoming Grouping Existing Grouping Collision resolution Action Illness(with undetermined end date) Existing absences Allow Concurrent records If you create an absence for a time type with collision grouping Illness (with undetermined end date) as­ signed, a concurrent absence is created to existing absen­ ces that have the collision grouping Existing Absences assigned. Existing absences Illness (with undetermined end date) Allow Concurrent records If you create an absence for a time type with collision grouping Existing Absences assigned, a concurrent ab­ sence is created to an exist­ ing absence with collision grouping assigned as Illness (with undetermined end date). 130 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Collision Resolution Behav­ ior Incoming Grouping Existing Grouping Collision resolution Action Illness(with undetermined end date) Vacation Allow Concurrent records If you create an absence for a time type with collision grouping Illness(with undetermined end date as­ signed, a concurrent absence is created to an existing ab­ sence with collision grouping assigned as Vacation. Adoption Adoption Allow Concurrent records If you create an absence for a time type with collision grouping Adoption leave, a concurrent absence is cre­ ated to another adoption leave. Note If you only configure the first row, which means an incoming Illness (with undetermined end date) absence can overlap with all other existing absences, then it's not possible to edit any existing absences. If you want to allow users to also edit the existing absences, then you need to configure to allow all existing absences to be created as concurrent with Illness(with undetermined end date). ● If you want users to be able to create/edit Existing absences when there is an Illness(with undetermined end date), then you can choose the Incoming grouping as Existing Absences and the existing grouping as Illness(with undetermined end date). Note You can also choose the existing grouping as a predefined grouping "All Others". In this case, all existing absences are considered and you don't need to assign the collision grouping to the time type. ● If you want existing absences not to overlap with each other, then put them all in one group. ● If you want absences from the same time type to be created as concurrent absences, for example, adoption leave, then you can add a "Adoption" time type in the collision grouping and maintain this group in both the incoming grouping and the existing Grouping. You can see this shown in the table before. Table 17: Example of Groupings in Different Units on the Same Day Incoming Grouping Existing Grouping Collision Resolution Action Training (in hours) Vacation (in days) Allow Concurrent records Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Collision Resolution Behav­ ior If you create an absence for a time type with collision grouping Training (in hours) assigned, a concurrent ab­ sence is created to an exist­ ing absence of time type Vacation (in days) on same day. PUBLIC 131 Incoming Grouping Existing Grouping Collision Resolution Action Vacation (in days) Training (in hours) Allow Concurrent records Collision Resolution Behav­ ior If you create an absence for a time type with collision grouping Vacation (in days) assigned, a concurrent ab­ sence is created to an exist­ ing absence of time type Training (in hours) on same day ● If there's an absence with time type Vacation recorded in hours and an absence with time type Training recorded in days, then you can configure the system to allows the creation of an absence with different units on the same day. The collision resolution action must be set to Allow Concurrent records. Table 18: Example of Split and Delimit Taking Precedence over Concurrent Absences Incoming Grouping Existing Grouping Collision Resolution Action Illness All Others Allow Concurrent records Illness Vacation Split and Delimit In this example, you've configured the same incoming grouping Illness as shown in the table above and the existing grouping includes a common time type, Vacation. In this case, the second row with Split and Delimit takes precedence and concurrent absence aren't considered. If you want to allow concurrent absences, please remove the Split and Delimit configuration. 3.5.3.6.2 Absence Processing Here's information about how absences are processed. ● Concurrent absences can be recorded for both duration-based and clock-time-based recorders. ● On creation of an absence that's concurrent to another absence in the same period, the system raises a warning message that you're about to create a concurrent absence. ● On editing an absence which is concurrent to another absence, the system also raises a warning message that you're editing an absence which is concurrent to another absence. ● If there are two concurrent absences then both the absences can't deduct balances from time accounts at the same time. For example, the time type Illness (with undetermined end date) doesn't have a time account posting rule linked to it, but Vacation is linked to a time account. Therefore, usually only one of the concurrent absences can make deductions from a time account. However, if you set up the collision rules such that both the concurrent absence records deduct balances from the same time account, this can result in duplicate deductions. For example, if you configure Vacation to overlap with Vacation. We don't recommend this configuration. ● Absence workflow is initiated for all absences which have time types with workflow configured. The concurrent absence creation does not depend on the workflow status. Cancelled/declined absence statuses are not considered for collision determination. ● When there are concurrent absences, each absence is recalculated if there are recalculation-relevant changes in the holiday calendar, work schedule or a temporary change of work schedule. 132 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● The collision resolution configuration isn't effective-dated. If there's a change in the collision resolution configuration and the system no longer allows a concurrent absence for the incoming time type or time type grouping, the recalculation of existing concurrent absences fails. An error message is given that there are existing absences in the period which the absence is being recalculated in. Recalculation Examples Example 1. Absence with Undetermined End Date Concurrent to a Multi-Day Vacation in the Future. In this example, the work schedule changes from 8 to 4 hours starting 1 September, 2021. The absence from 20 September, 2021 to 24 September 2021 is recalculated to 36 hours and the absence with Undetermined End Date isn't change by the recalculation. Time Type Start Date End Date Quantity in Days Quantity in Hours Vacation 20 September, 2021 24 September, 2021 5 days 40 hours Sickness 3 August, 2021 Undetermined End Date 0 0 This is how it looks after recalculation. Table 19: Time Type Start Date End Date Quantity in Days Quantity in Hours Vacation 20 September, 2021 24 September, 2021 5 days 36 hours Sickness 3 August, 2021 Undetermined End Date 0 0 Example 2. Partial Day Absence Concurrent to a Full-day Absence. Table 20: Time Type Start Date End Date Quantity in Days Quantity in Hours Vacation (in days) 3 August, 2021 3 August, 2021 0.5 4 Illness (in days) 3 August, 2021 3 August, 2021 1 8 There is a temporary change in work schedule on 3 August, 2021, from 8 hours to 4 hours. Both absences are recalculated as per the new planned hours for that day. Only the Quantity in Hours is changed. Table 21: Time Type Start Date End Date Quantity in Days Quantity in Hours Vacation (in days) 3 August, 2021 3 August, 2021 0.5 2 Illness (in days) 3 August, 2021 3 August, 2021 1 4 Example 3. Partial day absence overlapping with another partial day absence. Table 22: Time Type Start Date End Date Quantity in Days Quantity in Hours Vacation (in days) 23 August, 2021 23 August, 2021 0.5 4 Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 133 Time Type Start Date End Date Quantity in Days Quantity in Hours Time Off in Lieu (in hours) 23 August, 2021 23 August, 2021 0.75 6 The system can't recalculate these absences and raises an error: Booking quantity 6.0 hour(s) not allowed for time type TOIL. In this case, the user has to manually update the quantity. 3.5.3.6.3 Validations of Concurrent Absences Here's information about the validation of concurrent absences. 1. You can't create two or more concurrent absences with Undetermined End Date in the system. 2. You can't create two or more concurrent Leave of Absence (LOA) records in the system. 3. If you assign a country which doesn't belong to the list of allowed countries for concurrent absences, then the system raises a validation error. The list of allowed countries is the Netherlands (NLD), Spain (ESP), and the United Kingdom (GBR). 4. The country/region field of the time type collision grouping country/region must be the as same as the country/region field of the time type. 1. The system doesn't allow maintaining a different country/region than what is maintained in the time type collision grouping. For example, if the country/region field of the time type collision grouping is set to NLD, then the time type must also have NLD as entry of the country/region field. 2. The system doesn't allow a blank value in the country/region field of the time type when a time type is assigned with a collision grouping which has a country/region entry. For example, if the country/region entry in the time type collision grouping is DEU, then the time type country/region field musn't be left blank. 5. The system doesn't allow a concurrent absence if an incoming time type collision grouping doesn't have a country/region assigned. 6. The system allows a concurrent absence if the incoming grouping has a country/region assigned and existing grouping has no country/region assignment. 7. The system doesn't allow duplicate entries in the time management collision resolution items. You can configure either Concurrent Absences or Split and delimit for the same collision grouping. 8. If both the country/region fields for time type and time type collision grouping are left blank, then the sytem allows the Split and Delimit configuration, but Concurrent Absence isn't allowed. 9. If the time type country/region field is filled, but the country/region field of the incoming time type collision grouping is left blank, the system only allows the split and delimit configuration. 3.5.3.6.4 Import of Concurrent Absences You can import concurrent absences records into the EC Time system from your legacy system when performing an initial data load. Here are some points to note while importing concurrent absences: ● Ensure that the configuration for allowing concurrent absences is maintained correctly in the EC Time system. 134 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● When importing concurrent absences, it depends on the configuration of your collision rules if you can import all the absences together or you need to split the import files. Table 23: Example 1 Incoming Grouping Existing Grouping Collision Resolution Be­ Collision Resolution Action havior Illness (with undetermined end date) All others Allow concurrent records If you create an absence for a time type with collision grouping “Illness(with unde­ termined end date)” as­ signed, a concurrent ab­ sence is created to "all other" existing absences that have a different colli­ sion grouping assigned or no collision grouping at all. In this example, it is not allowed to import the existing absences and incoming absences(Illness (with undetermined end date) all in one import file. You would need to import the existing absences first and then import the incoming absences. Table 24: Example 2 Incoming Grouping Existing Grouping Collision Resolution Be­ Collision Resolution Action havior Illness (with undetermined end date) Other absences Allow concurrent records If you create an absence for a time type with collision grouping “Illness (with un­ determined end date” as­ signed, a concurrent ab­ sence is created to existing absences that are in the time type "Other absences" collision grouping. Other absences Illness (with undetermined end date) Allow concurrent records If you create an absence for a time type with collision grouping “Other absences” assigned, a concurrent ab­ sence is created to an ab­ sence with time type "Ill­ ness (with undetermined end date) collision grouping. In this example, the system allows combining all the absences in one import file when importing absences. ● When you import an absence with undetermined end date, make sure you set the column Undetermined End Date to TRUE in the import file. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 135 3.5.3.6.5 Integration with Employee Central Payroll Here's information about the integration of the concurrent absences feature with Employee Central Payroll. Like other absences, the system replicates concurrent absences from Employee Central SuccessFactors Time Off to the infotype 2001 in Employee Central Payroll with the standard point-to-point replication. As a prerequisite, disable the collision checks for the Time Constraint Classes in the Employee Central Payroll system. 3.5.3.6.6 Behavior with Time Sheet Here's information about how the behavior of the concurrent absences features in relation to Time Sheet. ● The concurrent absences is displayed on the Time Sheet user interface as multiple absences on the same day. The absence hours for each time type are displayed as a separate row in the Time Sheet Summary section. ● It's possible to handle the valuation of concurrent absences in the Time Sheet valuation rules. For example, a new time recording profile could be assigned to an employee who has sickness with undetermined end date recorded in the system. You can either cap the absence hours to planned hours or disregard the absence hours of one time type completely in the time valuation rule. Tip Use valuation type Aggregate Input Group and Split. For details on setting up time valuation rules, please refer to: Valuation Types [page 350] ● We recommended using the new Time Sheet user interface when you use the concurrent absences feature. However, the feature also works with the legacy Time Sheet UI Related Information Valuation Types [page 350] 3.5.3.7 Enabling Recurring Absences Employees who need to take regular time off (for example, for childcare) can request 2 hours of leave each day for a period of 6 months. Admins can also set up such a recurring absence on their behalf. Context The recurring absence feature is available by default in the Time Administrator Workbench. However, you need to enable it for employees. 136 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Once you've done this, employees can request recurring absences from the Employee Self Service (ESS) Time Off UI. They can specify whether the absence recurs daily, weekly, or biweekly, and can set the end date of the recurring absence. All such absences are then shown in the Absence Management Workbench under the Time Records tab. Procedure 1. In the Admin Center, go to Manage Permission Roles. 2. Select the Employee Self Service role, and then choose Time Management User Permissions. 3. Select the checkbox Create recurring absence in Employee Self Service scenario. Results Employees can now request recurring absences on the ESS Time Off UI. Here are some points to keep in mind: ● It is possible to create and edit recurring absences with start and end dates in the past. ● Employees can't request more than 53 recurring absences at a time. ● If employees attach a file while creating a recurring absence request, only the first absence will contain the attachment. ● Leave of absence (LOA) time types are not supported for recurring absences. ● Recurring absences are not supported for time types where flexible requesting is enabled. ● Full-day absences with a daily recurrence are not supported. ● Mandatory custom attachment fields are not supported for recurring absences. Task overview: Customization of Absence Recording [page 109] Previous: Concurrent Absences [page 127] Next: Enabling Flexible Absence Requesting [page 137] 3.5.3.8 Enabling Flexible Absence Requesting If your employees' working time models often vary, you need to be able to manage this in the system. In a fixed working time model, the work schedule specifies the exact working hours an employee has to work. For example, you can define that an employee works Monday to Friday 8 hours per day and doesn't work on Saturday and Sunday. So if this employee requests vacation for one week and there is no holiday in that week, 40 hours are deducted from his or her time account. This is the behavior if flexible requesting is not active. In contrast to this, in a flexible working time model, working times might vary frequently. An employee can work 35 hours one week, and 45 hours the next. Or 6 hours one day, and 9 hours the next. To support this scenario, you activate flexible requesting. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 137 Note ● Flexible requesting can only be used in business scenarios where employees do not have a fixed work schedule that reflects their actual planned working time. ● If you're using flexible requesting in conjunction with time accounts, the amount requested is not distributed over the period of the absence. Instead, the whole amount is deducted as of the start date. ● Once flexible requesting is active, users will not be able to request recurring absences in Time Off. ● You can't use flexible requesting in conjunction with Time Sheet. ● Flexible requesting isn't available in individual work schedules. ● Flexible Requesting should only be used for pure absence-only scenarios. There should be no replication to payroll systems. ● It is recommended to assign a workflow to the time types which are marked for flexible requesting, as otherwise employees can request whatever value they want. ● Any recalculations of the time account calculation will not consider changes in the flexible requesting record. ● Flexible requesting cannot be used for Time Types with the setting Duration Display According To set to Calendar Days. ● You can't edit the <requesting> field in the Time Off UI for a combination of calendar days and flexible requesting when requesting a multiple-day absence. The system displays a warning on the time type saying that we don't recommend this configuration. Also note that the <requesting> field in the Time OFF UI won't be defaulted if the user requests leave on a public holiday, or if the work schedule has no days defined. To use flexible requesting, you normally need to activate it for the time type and for the work schedule. If only one of the objects is activated for flexible requesting, the system behaves as in the non-flexible requesting case and the employee can't enter the booking amount manually. Time Type Configuration Activating flexible requesting at time type level allows you to define that employees can only request certain time types flexibly. For example, you can assign a time profile that has a time type "Vacation" set up for flexible requesting and a time type for sick leave where the absence duration is still derived automatically from the work schedule. For a time type in unit hours, you can combine flexible requesting with requesting in hours and minutes (setting Permitted Fractions for Unit Hour). In this case, employees enter booking amounts in hours and minutes format (for example, 7 hours 30 minutes) instead of decimal hour format (such as 7.5 hours). Caution For time types where flexible requesting is allowed in hours, you can only enter up to a maximum of 23 hours and 59 minutes when requesting absences in the Time Workbench. 138 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Work Schedule Configuration By assigning different work schedules to different employees, you can restrict flexible requesting to a certain group of employees. If flexible requesting is not active for an employee´s work schedule, he or she cannot request vacation flexibly even if it´s activated for that time type. Note that you cannot change this setting for existing work schedules, but you can create and assign a different work schedule. It is not possible to create a flexible work schedule without defined working hours. In a situation like this, you can use the flexible work schedule and add at least one day, which then acts as the default for each calendar day. Note Flexible requesting is only available in work schedules with the Simple model. You can't use it in the Period or Schedule models. Parent topic: Customization of Absence Recording [page 109] Previous task: Enabling Recurring Absences [page 136] Next task: Allowing Absences with Undetermined End Dates [page 140] 3.5.3.8.1 Flexible Absence Requesting Validations For flexible requesting validations, the work schedule is not considered. There are only upper limits depending on the number of days of the absence. For multiple-day, flexible leave requests: ● The limit of the number of calendar days cannot be exceeded. ● For example, if the Time Type is based on days, and you request an absence from Monday to Friday, that's 5 calendar days. You can enter up to 5 days in the requesting field. ● To give another example, for a Time Type based on hours, if you request an absence from Monday to Friday, that's a total of 120 hours (5 days, 24 hours each). You can enter up to 120 hours in the requesting field. For one-day, flexible leave requests, or multiple part-day flexible leave requests on the same day: ● The sum of the absences cannot exceed the limit of 1 day, or 24 hours. ● For example, if the Time Type is based on days, and you request an absence for Monday, you can enter up to 1 day in the requesting field. ● If the Time Type is based on hours, and you request for Monday, you can enter up to 24 hours in the requesting field. For part-day, flexible leave requests in combination with a part-day, non-flexible leave request: ● The sum of the non-flexible leave requests cannot exceed the duration of the work schedule for this day. ● The sum of non-flexible leave requests and flexible leave requests cannot exceed the limit of 24 hours. ● For example, if the Time Type is based on days, and you request a part-day, non-flexible absence for 0.25 days, you are allowed to request a part-day, flexible absence up to 0.75 days. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 139 ● In another example, the Time Type is based on hours, and your work schedule shows 8 hours of working time for Monday. If you request a part-day, non-flexible absence for 6 hours, it cannot exceed the limit of 8 hours. In this case, you're allowed to request a part-day, flexible absence for up to 18 hours. (24 hours minus 6 hours already requestested, which makes 18). 3.5.3.9 Allowing Absences with Undetermined End Dates In some circumstances, employees might need to enter absences with a start date but no fixed end date. For example, if they fall ill and are unable to say when they will return. In order to support this, you need to allow absences with undetermined end dates in Time Off. Context ● When you enable undetermined end dates for a time type, employees can still create absences with specific end dates for that time type if they want. ● Absences with undetermined end dates require a start date just like any other absence would. ● The lack of an end date means that the system cannot calculate the duration of the absence. ● Any future absences, such as vacation, already entered for the relevant employee in that period have to be canceled in the system before the new absence with the undetermined end date can be entered. ● When the employee returns from this absence, you can enter the date of their return in the system as the end date. If any vacation or other absence already entered for that employee had to be canceled as described above, the employee has to apply for it again. ● In Reporting, December 31, 9999 is shown as the end date for absences with an undetermined end date. Procedure 1. In the Admin Center, go to Manage Time Off Structures. 2. Open the relevant time type and choose Take Action Make Correction . 3. In the Undetermined End Dates Allowed field, choose Yes. Note Here are some important restrictions for undetermined end dates you need to keep in mind: ○ You cannot use them in leave of absence scenarios. ○ You cannot use them in combination with time account types. ○ You cannot use them in combination with flexible requesting. Task overview: Customization of Absence Recording [page 109] Previous: Enabling Flexible Absence Requesting [page 137] 140 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Next: Half Pay Leave and Double Pay Leave [page 141] 3.5.3.10 Half Pay Leave and Double Pay Leave In case standard leave doesn't meet an employee's needs, they can now officially request half pay leave or double pay leave instead. If an employee has insufficient balance left in their time account, they can take half pay leave, meaning only half the usual balance will be deducted while they receive half their usual salary when on leave. Or if an employee needs more money for vacation, they can request double pay leave, meaning double the number of leave days will be deducted but they will receive double their usual salary. Basically, let's say an employee requests 10 days (80 hours) of leave. ● Normal pay: $2000 (80 hours deducted from time account) ● Half pay: $1000 (40 hours deducted from time account) ● Double pay: $4000 (160 hours deducted from time account) How It Works The Absence Counting Method object has a field called Deduction Factor. In that field, you specify the relevant deduction factor (0.5 for half pay leave, 2 for double pay leave), and then employees can request the accompanying type of leave in Time Off. Note ● You can specify different deduction factors for each individual time type. ● The deduction factor can be a number ranging from 0 to 10, with 10 decimal places. 1. Setting Up Half Pay Leave and Double Pay Leave [page 142] Create time types with the relevant deduction factors in EC Time, and make the accompanying configuration setttings in Payroll. Parent topic: Customization of Absence Recording [page 109] Previous task: Allowing Absences with Undetermined End Dates [page 140] Next: Custom Fields in Time Off [page 143] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 141 3.5.3.10.1 Setting Up Half Pay Leave and Double Pay Leave Create time types with the relevant deduction factors in EC Time, and make the accompanying configuration setttings in Payroll. The half pay leave and double pay leave options provide employees with more flexibility when requesting leave. If an employee has insufficient balance left in their time account, they can take half pay leave, meaning only half the usual balance will be deducted while they receive half their usual salary when on leave. Or if an employee needs more money for vacation, they can request double pay leave, meaning double the number of leave days will be deducted but they will receive double their usual salary. Prerequisites ● Your EC Time system has been integrated with EC Payroll. ● You've set up the replication of absences from Time to Payroll. Configuration in EC Time 1. In Configure Object Definitions field to Editable. Absence Counting Method , set the visibility of the deductionFactor 2. Create three time types with unit Days, and assign each one a separate absence counting method with the relevant deduction factor: ○ Full pay leave: deduction factor = 1 ○ Half pay leave: deduction factor = 0.5 ○ Double pay leave: deduction factor = 2 Note The final deduction quantity for an absence is calculated by first applying the other parameters and then multiplying the quantity by the deduction factor. 3. For each time type, set the calculation method for the absence counting method as Work Schedule. 4. For each time type, set the duration display to Deduction Quantity in the object definition. 5. Assign the time types to a time profile, and make them available in Employee Self-Service (ESS) in EC Time. Configuration in EC Payroll 1. In SM31, enter <T554S>. 2. Double-click every Payroll-relevant entry in the table, and make the following settings for each one: ○ In the Input Checks section, ensure the fields are either blank or unchecked. For minimum duration, enter 001, and for maximum duration enter 999. 142 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ○ In the Counting and Quota Deduction section, uncheck everything except Grpg att./abs. for counting (01). Enter a counting rule. ○ In the Payment Data section, enter an <Absence Valuation Rule> and <Abs./Att cat.> for Payroll. This depends on the business demands of the absence valuation in Payroll. 3. Create absence counting rules for the three time types. Use View Cluster(sm34) : VC_T556C and set the quota multiplier as 50% for half pay leave, 100% for full pay leave, and 200% for double pay leave. Note Ensure there's also a rule that will valuate the absences in Payroll. You can use view V_T554C for this. Parent topic: Half Pay Leave and Double Pay Leave [page 141] 3.5.3.11 Custom Fields in Time Off If the standard fields in Employee Central Time Off don't cover the unique requirements at your company, you can create your own custom fields. You can do this for all time off requests or just for specific time types. Restriction Here are some important things to keep in mind when creating custom fields: ● Don't give your custom fields the same name as any of the existing standard fields. This can cause data to be displayed incorrectly. For example, there's a standard field called endDate, so don't create another field with that name. ● Don't use more than 5 decimal fields, 5 string fields, 10 number fields, and 5 date fields in your time account. ● Don't use the Translatable data type for any custom fields you create for Employee Time objects. ● We strongly recommend that you don't use custom fields for time account details. If you do use them, do not use more than 5 decimal fields, 5 string fields, 5 number fields, and 5 date fields. ● Custom fields are not supported for temporary time information. Creating Custom Fields For All Time Off Requests [page 144] When employees request time off, they have to fill out a number of standard fields. If these standard fields don't cover the unique requirements at your company, you can create custom fields. For example, you could specify that employees have to enter a Reason when requesting their time off. Creating Custom Fields For Specific Time Types [page 145] Use custom fields to display additional information or specify that employees should enter additional information when requesting time off. You can set up different custom fields for specific time types. Parent topic: Customization of Absence Recording [page 109] Previous: Half Pay Leave and Double Pay Leave [page 141] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 143 Related Information Creating Custom Fields For All Time Off Requests [page 144] Creating Custom Fields For Specific Time Types [page 145] 3.5.3.11.1 Creating Custom Fields For All Time Off Requests When employees request time off, they have to fill out a number of standard fields. If these standard fields don't cover the unique requirements at your company, you can create custom fields. For example, you could specify that employees have to enter a Reason when requesting their time off. Procedure 1. In the Admin Center, go to Configure Object Definitions. 2. Open the Employee Time object and add the new custom fields. When deciding which custom fields to add, please keep in mind the restrictions listed under Related Links below. 3. Save your entries. Related Information Custom Fields in Time Off [page 143] 144 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.3.11.2 Creating Custom Fields For Specific Time Types Use custom fields to display additional information or specify that employees should enter additional information when requesting time off. You can set up different custom fields for specific time types. Procedure 1. First you need to create the relevant time types. You do this in the Admin Center under Manage Time Off Structures. Here's an example: 2. Include your new time types in the relevant time profiles. You do this in Manage Time Off Structures as well. 3. In the Admin Center under Configure Object Definitions, open the Employee Time object. 4. Choose Take Action Make Correction . Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 145 5. Choose Details and enter the field ID for time types (timeType.externalCode), as well as the value for the time type you want use here. In our example, this is called HA_SICKNESS. Results Here’s our sample time off request again, now with the new custom field. 146 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Related Information Custom Fields in Time Off [page 143] Creating Custom Fields For All Time Off Requests [page 144] 3.5.4 Team Absence Calendar The Team Absence Calendar helps you plan your time by showing when your colleagues will be absent. The calendar shows absences for your peers, your manager, and, if you're also a manager, your direct and indirect reports. In addition, your manager can all the same information as it relates to you. You can access it from the following places: Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 147 ● View Team Absence Calendar on the Employee Self-Service (ESS) user interface. Employees can also view team absences when they’re requesting an absence of their own. In that case, they’ll only see the people who have absences at the same time as they do. ● The Team Absences tile on the Employee Central homepage (managers only). ● The Workflow screen (managers only). Active and approved absences are displayed in green in the calendar. Absences that are Pending Approval or Pending Cancellation are displayed in orange. Grey squares represent non-working days, which are defined by the user’s work schedule, holiday calendar (holidays with class Full), and temporary changes. Please note that these colors aren't configurable. Note ● Click an absence to see the details for it. You can always see the details of your own absences, but you need permissions to view details for your peers or direct reports. ● Cancelled absences are not displayed at all. ● Contingent workers are not displayed. ● Events that belong to the Attendance time type, such as training courses and business trips, are not displayed. ● In the case of global assignment, only active assignments are displayed in Team Absence Calendar. So, only one assignment will be displayed for the manager if both assignments have the same manager. ● In the case of concurrent employment, the search feature in the Team Absence Calendar returns only the primary employment. ● If an employee is on concurrent employment, and if they have the same manager for both jobs, then the manager will see the employee as two separate users under their direct reports in the Team Absence Calendar. The employee will view the peers depending on the user with which they log in. ● The yearly view is not enabled by default. Please create a ticket for enabling the yearly view. Once you enable the yearly view, the half-yearly view is displayed, based on your screen size. Related Information Setting Up the Team Absence Calendar [page 148] 3.5.4.1 Setting Up the Team Absence Calendar Assign permissions to users so they can use the Team Absence Calendar to view their absences, as well as those of their peers and direct and indirect reports. Prerequisites In Provisioning, ensure that the switches People Profile and Enable Homepage v3 have been selected. 148 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note Previously these switches were optional, but after you upgrade to the Fiori User Experience they both become mandatory. They enable you to view the newest design of the calendar. Procedure 1. In the Admin Center, go to Configure Object Definitions and open the Employee Time object. 2. Check if the Security field is set to either Yes or No. If you've already implemented Time Off, this field will most likely be Yes. Ultimately it doesn't matter too much - you simply need to remember the setting, since that will dictate the permissions you have to set. 3. Back in the Admin Center, go to Manage Permission Roles. Open the relevant role and choose Permission.... 4. Assign the relevant permissions depending on the security setting of the Employee Time object (see step 2): If the security setting is Then you need to assign these permissions Time Management Permissions Yes Visibility View Metadata Framework No Employee Time Access to non-secured objects Tip To ensure that the target population is respected, we recommend securing the Employee Time object. This means that in the Employee Time object definition, in the Security section, the Secured field must be set to Yes. Otherwise, if the Admin Permissions Manage Permission Roles Metadata Framework to non-secured objects Access permission setting is as­ signed, but the Employee Time object is not secured, then the target population is not respected. Note If you want to allow users to view absence details, then you also need to assign the permission under Manage time Access Workbench . Note Please ensure that the following fields in the Time Type and Employee Time objects are set to Visible. If they are set to Not Visible, nothing will be displayed in the Team Absences Calendar. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 149 Time Type field: ○ Unit Employee Time fields: ○ externalCode ○ startTime ○ startDate ○ endDate ○ endTime ○ undeterminedEndDate ○ displayQuantity ○ quantityInDays ○ quantityInHours ○ deductionQuantity ○ editable ○ userId ○ flexibleRequesting ○ timeTypeNav ○ physicalStartDate ○ physicalEndDate ○ loaStartJobInfoId Results All the employees to whom you assigned the permissions can now view absences in the Team Absence Calendar. It's not possible to hide certain users from being displayed in the calendar. However, if you want to restrict the visibility for certain roles or departments, you can do so in Manage Permission Roles Edit Granting . Here you can designate a target population, and then specify that only that target population should appear in the direct and indirect reports view for managers. Note that this setting does not hide users from being displayed it simply doesn't display absences for any users that you haven't included in the target population. Note ● The target population setting only affects the absences displayed in the direct and indirect reports view. 150 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.4.1.1 Restricting the Target Population to Peers It's possible to restrict the target population to peers for a permission role, using the Granted Users' Peers rolebased permission. Procedure 1. Go to the Admin Center. 2. In the Tools Search, search for Manage Permission Roles. 3. On the Permission Role Detail screen, under the Grant this role to section, select Edit Granting for one of the permission roles you've created. 4. Choose Target population of and select Granted Users' Peers from the dropdown menu. 5. Click Done to assign this role to the defined users. If you want the manager's absences to show on the peers tab of the team absence calendar, add the manager to the target population. Under Target population of, select Granted Users' Manager. If you want your employees to be able to view absences of their peers group only, under Manage Permission Roles groups or users: Admin Center Permission Role Detail , grant the permission to view absences to these Permission Groups or Users Target Population Everyone (All Employees) everyone in Peers Everyone (All Employees) everyone in Manager Results Only the absences of the users' peers show on the peers tab of team absence calendar. Note Make sure you assign the Employee Time view permission for the permission role to which you are granting the Target Population on Peers permission. 3.5.4.1.2 Permission to Access Team Absence Calendar Here's information about controlling access to the Team Absence Calendar. To set the Access Team Absence Calendar permission, go to Admin Center Manage Permission Roles Time Management User Permissions . Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 151 With this permission, you can control access to the Team Absence Calendar for certain user groups. This permission isn't target-population based, but a user-based permission. For example, you can decide to only allow managers to access the team absence calendar, and not employees. This permission is also respected on the latest home page, which has a View Team Absences quick card to access the Team Absence Calendar. With the latest home page, the Team Absence Calendar is also accessible to employees directly from the home page, and not only managers. If you'd like to hide the Show Team Absences button on the Time Off ESS UI for all employees, do the following: 1. Uncheck the permission Access Team Absence Calendar under Roles Time Management User Permissions Admin Center Manage Permission for the employee role. 2. Go to Time Management Configuration object under Manage Data and set the flag, Check the page permission in the team absence calendar to Yes. Make sure the flag is visible under Configure object definitions. As a result, the Show Team Absences button and the link are hidden on the Time Off ESS UI. 3.5.4.2 Searching Users in the Team Absence Calendar Assign permissions to users so they can search for users outside the reporting hierarchy of a manager, or outside the peers group for an employee. Procedure 1. In the admin center, go to Manage Permission Roles. Open the relevant role and choose Permission... 2. Under User Permissions, select Time Management User Permissions. Select the switch Enable Search Option in Team Absence Calendar. Note The Enable Search Option in Team Absence Calendar permission only allows for enabling and disabling the search field on the UI. 152 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 153 3. Under General User Permissions, User Search has to be enabled. Note If you assign the User Search permission to a user, then the user accessing the search through the team absence calendar UI will be able to search all employees who are in the target population of the permission role where the User Search permission is assigned. The absences will only be displayed if the user has the EmployeeTime view permission for the target/searched user. Results All the users to whom you assigned this permission can now search users outside their reporting hierarchy or peers group in the Team Absence Calendar. The target population defined under this permission is considered for the search in the Team Absence Calendar. Note The Time Type name is shown as Time Off if you search for users outside your reporting line. 154 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.5 Updates to Time Accounts There are several ways to update time accounts after their initial creation. The following table outlines the various options along with further information to differentiate them. Type of Up­ date When does the time ac­ count up­ date take place? How is the time account update initi­ ated? Update to Bookable Pe­ riod possi­ ble? Update to Validity Pe­ riod possi­ ble? Update to Time Ac­ count Status (Open/ Closed) pos­ sible? Update to Time Ac­ count bal­ ance possi­ ble? Supported for… Manual Ad­ justments Ad hoc Manually via No Time Admin Workbench, Manage Data, Import, or oData API No No Yes All time ac­ counts Period-End Processing At the end of the bookable period of a time account Manually or No automatically via Time Off Calendar No Yes Yes Recurring and ad hoc time ac­ counts Interim Time Account Up­ dates Manually via Ad hoc, dur­ ing the valid­ Time Off Cal­ ity period of a endar time account Yes Yes Yes Yes All time ac­ counts No Periodic Time Periodically, Manually or Account Up­ depending on automatically dates the frequency via Time Off Calendar No No Yes Permanent time ac­ counts 3.5.5.1 Enabling Manual Adjustments to Time Accounts If you need to correct any manual adjustments or periodic update corrections that have been made to time accounts, you can do it directly in the Time Workbench with the Edit and Delete icons. In order for these icons to appear, you need to assign certain permissions. Firstly, you'll need the View and Edit permissions for the Time Account object. In addition to that, if the Time Account Detail object is set to Secured, you also need to make the following settings: ● Assign the Create and Correct permissions for Editing a Time Account Detail ● Assign the Create, Correct, and Delete permissions for Deleting a Time Account Detail And if the Time Account Detail object is set to Not Secured, then you need to assign yourself the metadata permission Access to non-secured objects. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 155 3.5.5.2 Period-End Processing Period-end processing is usually performed when the financial year ends and follow-up actions on time accounts should take place. When the end of the bookable period of an account is reached you typically want to close that account so that it cannot be used for further bookings. In addition to that, you decide how to deal with a remaining balance on that account, for example: ● The balance is set to zero so that the employee cannot use it anymore. ● The remaining balance is carried forward from the old account to the new one. ● The remaining balance is carried forward, but only up to a certain limit. For example, if an employee has 8 days of vacation remaining, but the carryforward limit is 5 days, only those 5 days are carried forward. The other 3 are lost. ● The remaining balance is paid out to the employee and the account is set to closed. Period-end processing is done using a Time Off calendar for the Period-End Processing scenario. Period-end processing is only required for recurring and ad hoc time accounts, since the end of the bookable period for permanent accounts is a high date. You access the calendars in the Admin Center by choosing Manage Time Off Calendars. You can run the calendar either immediately or schedule it to run on a specified date. There is also an automated period-end processing option. See the time account type [page 722] documentation for information on how to set this up. Once you have done so, you don't have to do anything in Manage Time Off Calendars. The job runs automatically per the criteria you enter in the time account type. Note, however, that it does not run for all time account types. It runs only for those where you have set up period-end processing. You define your period-end processing logic in a business rule. Here, you can set the account to closed and also create time account bookings of type period-end processing to adjust or to move the open balance. For time account types with a period-end processing rule assigned, you can create and run a calendar by going to the Admin Center and choosing Manage Time Off Calendars. A time account is selected if the bookable until date is in the past and falls in the calendar period. After the calendar run, you can view the change calendar details and open the log file attached to it. In the log file, you find information about period-end processing bookings and errors that occurred. In addition to that, the result log will be sent by email to the user who started the job. You can also simulate a calendar run so that no changes are saved. In this case, the result log is not available in change calendar details view, but you can access it by going to the Admin Center and choosing Monitor Job. If you use a scenario to carry balances forward to the follow-up account, run an account creation calendar run before you start the period-end processing calendar run to make sure that all needed time accounts are created. As such, we don't recommend carrying over balances for ad hoc time accounts, because there is usually no follow-up account available. If your business scenario requires you to do period-end processing before the bookable until date is reached, use an interim account update run and define the rule in a way similar to that described below (see the Interim Time Account Updates [page 166]) documentation). Note The Period-End Processing rule usually closes the old time account. When an old time account is closed, the Editable field for all its employee times is set to No in order to prevent any further modifications. This changes the date of the last update for these records. This doesn't have any impact on payroll 156 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.5.2.1 Period-End Processing Rule Learn more about the rule based on the Period-End Processing rule scenario. This table shows which parameters are available: Name Object Time Account Time Account New Account Time Account Period-End Processing Rule Parameters Period-End Processing Rule Parameters ● Period End Processing Rule Parameters You have to assign this parameter. It contains information about the remaining balance and if a follow-up account exists. For more details, see the Period-End Processing Rule Parameters [page 706] object description in the appendix. ● New Time Account This parameter is optional. It is filled with the follow-up account if applicable. You need to add this parameter if you want to carry forward any remaining balance. For more details, see the Time Account [page 711] object description in the appendix. When defining the parameters, use the exact name and object mentioned in the table above. You can choose any parameter name you like. In a simple scenario you just want to set the balance to zero and close the old account so that it is not considered for further time off bookings. So you set the IF-condition to “Always True” and you have to define two THEN-expressions, one to set Closed to Yes and another one to create the account booking (Time Account Detail) with these parameters: ● Amount Posted Enter the booking amount. To set the balance of the time account to zero, the amount needs to be the remaining balance with an opposite sign. Parameter pepParams contains the remaining balance and with function Opposite Sign() you can change the sign. ● External Code Choose function “Generate External Code For Time Off()”. This generates a unique external code automatically. ● Posting Date Enter the posting date of the booking. Here, you typically choose the end date of the time account (bookable until). Note that the date must fall in the bookable period of the time account. ● Posting Type Choose the Period-End Processing posting type. ● Posting Unit The posting unit needs to be the same as the unit defined for the account type of the time account. So here you assign field “Time Account Type -> Unit”. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 157 If you want to carry forward balance to the follow-up account, you add another THEN expression to create a time account detail for that account (choose newAccount.Time Account Details). External Code, Posting Type and Posting Unit and assign it in the same way as for the other booking. You define the amount posted and the posting date like this: ● Amount Posted If you want to carry forward the remaining balance from the old account, just assign Remaining Balance Old Account of parameter pepParam. ● Posting Date Typically, you want to transfer the balance on the same date as used for the reverse booking on the old account. However, if the new account is not valid on that date, you use the start date of the account instead. By using the Latest Date() function you can determine that date. For example, if you have accounts with a bookable period according to calendar years, the posting on the old account is on December 31 while the posting on the new account is on January 1. Alternatively, if you only want to carry forward balance up to a certain limit, you can use the Minimum() function to determine the Amount posted. For example, if you want to carry forward a balance up to 5, you assign the minimum of that value and the remaining balance of parameter pepParams. Note It might happen that no follow-up account exists, for example if an employee was terminated or the time profile is no longer valid. Where this happens, you cannot create a time account detail for that account, so we recommend that you define the logic for both cases separately. To do that, you uncheck “Always True” but create separate IF and ELSE blocks to define the logic. For example, you can define that changes on the old account should only be done if there is no follow-up account. 158 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management If "No" is entered for pepParams.New Account Exists, you can enter "Yes" needs to entered for "Closed" in Create Time Account Detail. Alternatively, in an ELSE statement you can enter "Yes" for the "Closed" in Create Time Account Detail, in which case you need to specify Create newAccount.Time Account Detail here too. Note Period-end processing cannot take place for accounts that still have bookings with status PENDING or CANCELLATION PENDING. In such cases, processing waits until the bookings achieve another status, such as APPROVED or CANCELED. 3.5.5.2.2 Period-End Processing with Payout Rule If you want to automatically make a payout to your employees as part of period-end processing, you can use the rule scenario Period-End Processing With Payout. In addition to the parameters required for Period-End Processing, you'll also need to set the parameters required for payout. Name Object Time Account Time Account New Account Time Account Period-End Processing Rule Parameters Period-End Processing Rule Parameters Time Account Payout Rule Parameters Time Account Payout Rule Parameters And as well as the parameters described in the Rule Definition: Period-End Processing (see above), for this rule scenario you'll need to set up the rule parameter Time Account Payout Rule Parameters. ● Posting Date Enter the posting date of the booking. Here you typically choose the end date of the time account (Bookable until). Note that the date must fall within the bookable period of the time account. ● Posting Unit The posting unit needs to be the same as the unit you specified in Time Account Type Unit . ● Quantity Enter the payout amount. To pay out the entire remaining balance for the time account, you can use the parameter Period-End Processing Rule Parameters. Here's an example. At the end of the business year, you want to pay out the remaining vacation balance of your employees' time accounts, and set their old time accounts to closed. To achieve this, you can use the rule scenario Period-End Processing with Payout and fill out the Time Account Payout Rule Parameters as follows: Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 159 Note E-mail notifications will not be sent out to employees if you use Period-End Processing with Payout. Also, please note that it isn't possible to make multiple payouts on the same date. 3.5.5.2.3 Period-End Processing for Time Accounts According to Employee Hire Date For time account types whose Account Creation Start Date is the Employee Hire Date, yearly time accounts are valid from the anniversary of the day the employee was recruited. As a consequence, an employee’s time accounts have different validity periods. When the bookable period is reached, a period-end processing run is typically started to close the old account and to transfer remaining balances to the follow-up account. At this time, no automation is available for this scenario. So you need to create and run period-end processing calendars manually. If you need to make sure that a period-end processing run is triggered the day after the Booking Possible Until date in the time account, there is a lot of effort involved in creating and running these calendars manually each day. For example, if there are 10 time types that refer to a time account type according to employee's hire date, you have to create and run 10 calendars each day (which you do in the Admin Center by choosing Manage Time Off Calendars). This documentation tells you how you can reduce this manual effort by using MDF import and the schedule date within a calendar. There are actually 2 possible solutions. Option 1: Manually Create Calendars Using Run Date When you assign a schedule date, you don´t need to start the calendar run manually. It is automatically started when the run date is reached. For example, when you create a calendar to perform period-end processing for time accounts with July 25, 2015, as the bookable end date, you assign the next day as run date. Keep in mind that the run date needs to be in the future. 160 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management The calendar is then created with status Scheduled and, in our example, period-end processing starts automatically on July 26, 2015. Option 2: Import Scheduled Calendars Instead of creating scheduled calendars manually, as described under Option 1 above, you can use an MDF import to create them, singly or many at a time. To access the feature, go to the Admin Center and choose Import and Export Data. Then maintain the screen as shown here. You can use the job monitor to check whether your import has run successfully. You can also check the status of your calendar. To do this, go to the Admin Center and choose Manage Time Off Calendars. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 161 3.5.5.2.4 Best Practice Tip: Period-End Processing Transferring Balances Between Accounts With period-end-processing for recurring accounts, we provide a mechanism for transferring (remaining) balances from a time account to a succession time account of the same time account type. The Challenge However, you might need to transfer balances from one time account to another time account of a different time account type. At this time, there is no way to do such transfers automatically, but we do offer a workaround that enables you to reflect such transfers in the system. The Solution You can use an interim account update to create the transfer booking to the new time account. But how do you get the balance for a specific user for the base account? This could be achieved in several ways. In the example we'll consider here, a custom field has been added at time account level. We run an interim account update for the base time account, persist the balance before transfer using our custom field, create a counter entry to set the account balance to zero, and close the account. In a second step, we'll run an interim account update on the transfer account. We search for the base time account for a specific user and create a new posting on the transfer account based on the value of our custom field (balance as of the transfer date) on the base time account. Configuration 1. Add a new custom field to persist the balance of the base account. 162 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 2. In the time account type, add an interim account update rule. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 163 The rule looks like this: 3. In the transfer time account type, add an interim account update rule. Tip It's a good idea to remove the interim rule assignment later, for both time account types. 164 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management The rule looks like this (remember that you need to adjust the lookup criteria to get the right time account). Make sure that exactly one result is returned, otherwise the rule will not work: Note Also This scenario could also be achieved using one interim update. The benefit of the solution described here is that the base account will be closed so no further bookings are allowed. The transfer account does not need to be a permanent account. It can be a recurring account. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 165 3.5.5.3 Interim Time Account Updates While manual adjustments are usually created manually by an HR admin, the interim account calendar run enables you to do mass data updates for time accounts based on a business rule. This means that you are free to adjust your time accounts at any time, unlike in the accrual scenario, where you create accruals for clearly defined periods. Example Your business year ends on December 31, but you allow employees to carry forward up to 5 days of leave into the new year, which they must use by March 31. So your time accounts have an extended booking period of 3 months. You can then run an interim account update on December 31 with a rule that checks the balance and creates an adjustment booking if needed. For time account types with an interim account update rule assigned, you can create and run a calendar of scenario Interim Account Update by going to the Admin Center and choosing Manage Time Off Calendars. You can either run the calendar now or schedule it to run as of a specified date. A time account is considered if the validity period intersects the calendar period. After the calendar run, you can view the change calendar details and open the log file attached to it. This contains information about time account changes and errors or information messages that occurred. In addition to that, the result log is sent by email to the user who started the job. You can also simulate a calendar run so that no changes are saved. In this case, the result log is not available in the change calendar details view, but can be accessed in the Admin Center by choosing Monitor Job. Defining Rules Choose Configure Business Rules you can create the rule with time account as base object. The following optional parameters are available. You only need to assign them if you need them for your business rule. Code Name Object params params Interim Account Update Rule Parame­ ters newAccount newAccount Time Account variables variables Time Off Rule Variables timeAccount timeAccount Time Account ● params - You add this parameter if you need to check whether a follow-up account is available (parameter newAccount is filled). ● newAccount - This object contains the next recurring account of the base object account. If there is no follow-up account, this parameter is null. The information as to whether there is a follow-up account is available via parameter params appears here. If you have a scenario that should create bookings not only for the base object account but also for the follow-up account, you add this parameter. 166 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● variables - This parameter is a helper object. If you have a more complex rule and want to store temporary results of rule function calls in a variable, you can use this parameter. Please add the necessary fields to the Time Off Rule Variables object definition. ● timeAccount - This is the same object as the one in the base object time account. It is necessary if you want to use a rule function that needs this object as input. An example would be the rule function balance calculation. You can only add this parameter until b1411. As of b1502, it is provided automatically and cannot be added again. You can continue to use the parameter for rules added before b1502. When defining the parameters, please use the exact code and object mentioned in the table above. You can choose any parameter name you like. The goal of the interim update rule is to create interim update bookings. For that, you choose the Createstatement in the Then-condition of the rule to create a booking (Time Account Detail) with the following parameters: ● Amount Posted Enter the booking amount. In a very simple rule, you just enter a fixed quantity here. If you need a more flexible amount determination per employee, you can use a rule function or lookup table calls to determine that amount. ● External Code Choose function “Generate External Code For Time Off()”. This will generate a unique external code automatically. ● Posting Date Enter the posting date for the booking. In a very simple rule, you just enter a date here or assign “Today()”, but you can also use a rule function to determine the date. The date must fall in the bookable period of the time account. ● Posting Type The only permitted posting types are Interim Update and Period-End Processing. ● Posting Unit The posting unit needs to be the same as the one defined for the time account type for this time account. If you want to restrict the time accounts an interim update booking should be created for, you can enter an IFcondition according to your needs. Otherwise, just choose “Always True”. 3.5.5.4 Periodic Time Account Updates It’s possible to schedule an automated periodic update of time accounts. The update carries out a specific predefined action without you having to do it manually. Here are some use cases for which you might find this helpful: ● Automatically processing flextime accounts (working time accounts) at the end of each flextime cycle. The balances on such time accounts cannot grow indefinitely. You can handle this by capping the balances so that no more than the average contractual weekly hours are transferred to the next flextime cycle. For example, you can cap the balance so that a maximum of -10 hours is forwarded to the next flextime cycle. Capping the balance on vacation accounts For example, you can cap the balance so that only 10 days can be carried forward into the following year. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 167 How It Works You schedule an update for a time account, and specify that the update should carry out a predetermined action, such as capping the balance at a certain limit. You have complete freedom to specify the frequency of the updates for each time account type (for example, at the end of every week or month, at the end of a quarter, at the end of a year, and so on). You can rerun and recalculate any periodic update. Note ● If there are no postings of type Periodic Update for the period for which the run has taken place, then those employees will be selected for rerun. ● There is no automatic recalculation. You need to create a calendar run manually in order to trigger the recalculation of existing periodic update bookings. ● Any errors that occur during a periodic update run can be viewed on the Admin Alerts tile on the homepage. There's also a new screen, Review Periodic Time Account Updates, on which managers and administrators can check the balances for all employees for whom the periodic update has been performed. If necessary, they can also make corrections. For example, they can update the employee's timesheet or report an unpaid absence in order to trigger a salary recalculation. Important Things to Keep in Mind ● The posting date cannot be any date other than the period end date. ● The posting type needs to be Periodic Update. ● If there is a periodic update correction posting, recalculation is not possible. In cases like this, you'll have to delete the correction posting and trigger the recalculation again. ● There can be only one periodic update correction posting for each periodic update period. ● You can create a periodic update correction posting on the Time Accounts tab on the workbench of the employee in case the Periodic Update posting is not correct. Limitations This function is not supported for recurring time accounts. In addition, you cannot use automated periodic updates to do any of the following: ● Pay out the remaining balance at the end of a period ● Transfer the balance to a different time account - for example, to a time off in lieu account ● Simulate future periodic updates ● Close time accounts Note If you want to close a time account, you can use Interim Updates instead. 168 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Related Information Setting Up Automated Processing of Flextime Accounts at the End of Each Flextime Cycle [page 169] Manually Adjusting Time Accounts 3.5.5.4.1 Setting Up Automated Processing of Flextime Accounts at the End of Each Flextime Cycle Make the necessary settings to enable the regular automatic processing of flextime accounts (working time accounts). Prerequisites ● You have been assigned all the necessary administrator permissions to run Time Off calendars. ● You have been assigned the permission Access Periodic Time Account Update. ● The time recording method has been set to Clock Time and the unit of the time account has been set to Hours. Note This is required when you use the working time account to post the plus/minus hours compared to your planned working time into the time account. ● Recalculation has been switched on. This is to ensure that all changes will be reflected in the time account if you add an absence or attendance later after the periodic update has run. Procedure 1. Create a work schedule with flextime bandwidth. 2. Create a time account type, and configure the Periodic Time Account Update Profile object as follows: ○ Update Frequency Unit You can set the update frequency unit as either weeks or months, and the periodic update can run in weekly, monthly, quarterly, half yearly, or yearly cycles. For example, if you set the update frequency unit as months and the update frequency quantity as 6, then your periodic update would run every 6 months. ○ Update Frequency Quantity Specify how often the periodic account update should run. For example, if you select weeks as the update frequency unit and enter "4" here, the periodic account update will run every 4 weeks. ○ Reference Date This is the root date from which all the update periods both past and future will be determined. For example, if you enter January 1st 2020 in combination with a unit of time/frequency of 4 weeks, then the update periods would be Jan 1st to 28th 2020, Dec 4th to 31st 2019, and so on. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 169 ○ Level of Automation Specify whether periodic account updates should be done automatically or manually. If you choose No Automation, you need to go to Manage Time Off Calendars and create a time account change calendar for each periodic account update run. If you choose Automatic Periodic Updates, the time account change calendars are created and executed automatically. ○ Offset in Days This offset determines when the time account change calendar for automatic periodic updates will be created and executed. For example, if you enter "3", then the account change calendar will be created and executed three days after each periodic update cycle. Please note that you have to enter at least a value of 1 here (no 0 or minus values). ○ Update Rule Enter the rule to be applied to the rule scenario for the periodic time account update. 3. Mark the time profile as Update working time account upon approval only. Note This setting is only required if you want to post the plus/minus hours to working time accounts after the time sheets have been approved. 4. Create a time recording profile with a time valuation rule that will post the hours worked more/less than your planned working times as credits/debits to your working time account. This is required for flextime scenarios in which working time accounts are used. For more information, see Setting Up Working Time Accounts [page 385]. Results Time accounts will now be updated automatically based on the period you specified in the Periodic Time Account Update Profile object. Related Information Periodic Time Account Updates [page 167] Periodic Time Account Update Profile [page 707] 3.5.6 Termination End Handling The Termination End Handling process makes it possible to clean up an employee's Time-Off-related data that exists after the termination date. Note This feature is currently in the Early Adoption phase. If you're interested in enabling the feature in your instance, please reach out to the Time Management Forum of the Customer Community . 170 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management A typical use case for terminating the employment and rehiring of a user with the same time profiles is a shortterm contract with a fixed hire and termination date. As part of the current termination process, the system calculates the simulated balance as of the termination date. You can create a payout at the time of termination and prorate the leave accruals as defined by your "Termination rule". Note The termination date refers to the last working day of the employee, not the job information effective date. If the employment of an employee is terminated and the emplyoee is rehired in the same accrual period, the Termination End Handling process ensures that the employee receives the correct amount of leave accruals upon rehire. The system cleans up Time-Off-related data like absences, accruals, time accounts, and time account postings. The Termination End Handling process performs the following clean-up activities: 1. Cancellation of approved absences that start after the termination date. 2. Delimitation of approved absences that overlap with the termination date. The end date of the absence is set to the termination date of the employee. 3. Deletion of time accounts starting after the termination date. 4. Delimitation of time accounts that overlap with the termination date. The validity end date and bookable end date are set to the termination date of the employee. 5. Closure of the time accounts. 3.5.6.1 Reduced Scope and Restrictions Find out more about the reduced scope and restrictions of the Automated Termination End Handling feature. 1. Customers who use the "Entitled as Transferred" time account type cannot use this feature. A user with this time account type is excluded from the Termination End Handling process. 2. The Termination End Handling process is not supported for the recurring time account type with the "Employee Hire Date" as these accounts will not be supported in future. We recommended using flexible date accounts instead. 3. If a time account type has the "Employee Flexible Date" as start date, if you terminate and rehire a user, the old account, which overlaps with the rehire and termination date, will be reopened due to current system behavior 4. Note If you have errors from Termination End Handling execution, or it is hasn’t been executed and an employee is rehired in the meantime, you might run into issues. Here's an example. Example 1: If there is a termination event, a later rehire event, and an accrual recalculation during the rehiring process, you might still run into this error: "The user is being terminated and rehired in the accrual period. This scenario is not supported. Please create an accrual manually". Due to this error, the Termination End Handling process cannot be executed. As a workaround, you can delete the Time Management Recalculation Event manually from Manage Data . Example 2: If the termination process is executed after the rehire, the time accounts that lie after the termination date can be deleted. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 171 Tip We recommend that the Termination End Handling process is executed successfully before you do a rehire. 5. If you don't choose to close old time accounts as part of Termination End Handling process, accruals for past periods can be created or recalculated. Here's an example: In 2021, an Employee is hired, terminated, and rehired in the same year. The accrual frequency is annual. If you now create a time account change calendar manually for the accrual creation of 2021, you can't restrict the recalculation. Accruals that lie before the termination date can be created or recalculated. 6. If you have configured the time account type accrual frequency to "Once" for permanent time accounts and if you terminate and rehire an employee, you will get accruals for each time account. 7. There is no rollback functionality for this process. This means you need to restore the data to the original state manually. Note If you accidentally or intentionally delete a past-dated termination and the Termination End Handling process has been executed, there is no restore option for absences or time accounts. Due to this, we recommended that you provide an offset of a few some days (for example, 15 days) which delays the Termination End Handling process. This grace period gives you enough time to ensure that you can avoid issues like this. 8. If you trigger an alert or notification using a post save rule in the Employee Time object, then the alert or notification isn't deleted when the absence is cancelled. 9. Alerts are only displayed on the Admin Alerts UI and not in the Time Workbench Alerts tab. 3.5.6.2 New Objects in Termination End Handling Read about the objects that let you configure the Termination End Handling process. These objects are Inactive by default when the feature is activated. Please go to Configure Object Definition and select Include Inactives as Yes. Then activate the following objects by setting the status from Inactive to Active. 3.5.6.2.1 Time Management Termination End Handling Configuration The Termination End Handling Coniguration object contains attributes that regulate if, when, and for which employees the termination end handling process is applied. Field Description External Code The external code is generated automatically. 172 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Field Description Activation Status Enter the setting for the activation status. ● Active: The Termination End Handling process is gener­ ally applied. ● Inactive: The Termination End Handling process is gen­ erally not applied. ● Active for Configured Legal Entities Only: The Termina­ tion End Handling Configuration object is active only for certain legal entities. Specify these entities with the fol­ lowing attribute. Note Both the Termination End Handling Configuration object and the legal entity configuration object for termination end handling have a setting for the activation status. De­ pending on the settings for the activation status on these two levels, there are different scenarios for how termination end handling is applied. If there is a legal en­ tity configuration for a legal entity, then the attributes of the termination end handling configuration get overrid­ den by the legal entity configuration, which is more spe­ cific. If this activation status is set to active for configured legal entities only, then the legal entity configuration needs to be configured for the legal entities for which termination end handling should be triggered. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 173 Field Description Legal entity configuration for termination end handling Choose the legal entity for which this termination end han­ dling configuration should be valid. ● Legal Entity: Choose the legal entity for which this termi­ nation end handling configuration should be valid. ● Offset in Days: This offset determines when the termi­ nation end handling will be processed. ● Level of Automation of Absence Request Processing: You can set the level to either No Automation or Full Automation. ○ If you choose Full Automation, during termination end handling, all absence requests overlapping with the termination date are delimited. Absence requests starting after the termination date will be cancelled. If you choose no automation, an alert will be raised for each absence request that over­ laps with or starts after the termination date. ○ If you choose No Automation, an alert will be raised for each absence request that overlaps with or starts after the termination date. Click Details to display more fields: ● Level of Automation of Time Account Closure: You can set the level to either No Automation or No Automation. ○ If you choose Full Automation, all open time ac­ counts are closed during termination end handling. ○ If you choose No Automation, no time account is closed during termination end handling. ● Configuration Excluded from Termination End Handling: Configure time account types and event reasons for which the termination end handling isn't executed. ● Activation Status: This activation status has the follow­ ing settings: Active and Excluded. If this activation sta­ tus is set to Active, then the termination end handling configuration for that legal entity is overridden. If the ac­ tivation status is set to Excluded, then the employees contained in that legal entity are excluded from termina­ tion end handling. Remember The Termination End Handling Configuration object and the object for the legal entity configuration for termination end handling have settings for the Activation Status. 174 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.6.2.2 Time Management Termination End Handling Alert A termination end handling alert draws your attention to something you need to take care of in Time Management termination end handling. Field Description User Values: User ID User for which the Time Management Termination End Han­ dling Alert object is valid. Time Account External Code An external code for the time account appears here. Employee Time External Code An external code for the employee time appears here. Termination End Handling Processing Step ● Pending Recalculation ● Read Employee Job Information ● Read Termination End Handling Configuration ● Employee Time Processing ● Recalculation Processing ● Time Account Processing Message Key The technical name of the error message that is displayed localized in the alert tab. Message Variable 1-4 If the message key contains parameters, they are dynami­ cally integrated into the error message. External Code An external code for the message appears here. Alert Type ID The system enters the unique identifier of the alert type. Status Choose New, In Process or Acknowledged. Assignee User ID Enter a user ID for the assignee. 3.5.6.2.3 Time Management Termination End Handling Exclusion The Termination End Handling Exclusion object contains attributes that regulate which events are excluded from the termination end handling process. Field Description External Code The external code is generated automatically. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 175 Field Description Excluded Time Account Types Please enter the time account type that you want to exclude from the termination end handling process. Excluded Event Reasons ● Time Account Type: Enter a time account type object. ● External Code: Enter a meaningful external code here for the individual entries. Please enter the event reason that you want to exclude from the termination end handling process. ● Event Reason: Enter the event reason you want to ex­ clude. ● 3.5.6.3 External Code: Enter an external code for this excluded event reason. Configuration of the Termination End Handling Process To configure the Termination End Handling process for Time Off, you must create the Time Management Termination End Handling Configuration object. The following fields need to be set to activate Termination End Handling for all scenarios: ● Activation Status = Active ● Offset in Days = Define how many days after the employee's termination date the Termination End Handling should be executed. ● Level of Automation of Absence Request Processing = Full Automation ● Level of Automation of Time Account Closure = Full Automation Note The external code is set automatically because only one Time Management Termination End Handling Configuration object can exist. The following chapters explain how you can configure the Termination End Handling process. 3.5.6.3.1 Level of Automation of Absence Request Processing Here's information about this Termination End Handling object. If you don't want absences to be processed at all, set this field to "No Automation" (Instead of "Full Automation", which is the default). If absences overlap with the termination date, they're not delimited. If they start after the termination date, they're not cancelled. 176 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note If you set it as “No Automation”, you need to manually cancel the absences because otherwise the time accounts can't be delimited. 3.5.6.3.2 Level of Automation of Time Account Closure Here's information about the Termination End Handling object. If you only want the time accounts to be delimited, then set the level to No Automation. In this case, the time accounts are delimited but not closed by the Termination End Handling process. The time accounts are delimited even if they overlap with the termination date but overlapping time accounts aren't closed by the Termination End Handling process. Note This setting is relevant only if you want to close the time accounts automatically as part of the Termination End Handling process. 3.5.6.3.3 Configuration for Exclusions from the Termination End Handling Process Here's information about the configuration of exclusions from the termination end handling process. If you want to exclude certain time account types and certain termination event reasons from the Termination End Handling process, then you can define them in the Time Management Termination End Handling Exclusion object. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 177 3.5.6.3.3.1 Excluding Time Account Types With the Time Management Termination End Handling Exclusion object, you can specify a list of time account types for which the Termination End Handling process isn't applied. You can either specify a list of excluded time account types and assign the Termination End Handling Exclusion object to a specific legal entity, or assign it to the global Time Management Termination End Handling Configuration. For more information, please refer to chapter 4.5, Options for the Termination End Handling Activation Status [page 178]. 3.5.6.3.3.2 Excluding Event Reasons With the Time Management Termination End Handling Exclusion object, you can specify a list of termination event reasons for which the Termination End Handling isn't applied. You can either specify a list of excluded event reasons and assign the Termination End Handling Exclusion object to a specific legal entity or assign it to the global Time Management Termination End Handling Configuration. For more information, please refer to chapter 4.5, Options for the Termination End Handling Activation Status [page 178]. 3.5.6.3.4 Legal Entity Specific Configuration You can configure the Termination End Handling process for a legal entity, such as a country/region, with the legal entity configuration of the Termination End Handling Configuration object. As a rule, the more specific legal entity configuration overwrites the more general Termination End Handling configuration. 3.5.6.3.5 Options for the Termination End Handling Activation Status There are several options for the Termination End Handling activation status. ● Option 1: Activation Status Set to Active [page 179] ● Option 2: Activation Status of the Termination End Handling Configuration set to Inactive [page 181] ● Option 3: Activation Status of the Termination End Handling Configuration set to "Active for configured legal entities only" [page 182] 178 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.6.3.5.1 Option 1: Activation Status Set to Active The Termination End Handling configuration is used for all legal entities except when the user defines a configuration for the legal entity. If you need to define a specific Termination End Handling configuration for a legal entity, you can set the legal entity configuration to "Active" or "Excluded". In this case, a more specific Termination End Handling configuration is applied. When you set the activation status of the legal entity to "Active", then the offset in days and the exclusions made in the more specific Termination End Handling configuration apply. The offset in days and exclusions from the Termination End Handling process apply to all employees in that legal entity. When you set the activation status of the legal entity to "Excluded", then all employees in that legal entity are excluded from the Termination End Handling process. Excluding certain entities: Activating the Termination End Handling process for most legal entities is the default. If you don't want the Termination End Handling process enabled for certain legal entities, then you can deactivate it for those entities. Applying different configuration for a legal entity: You can have different configurations for different legal entities by specifying a Termination End Handling legal entity configuration. Example Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 179 Let's say the system is configured as above: 1. The legal entity ACE Netherlands is excluded from the configuration. 2. The legal entity ACE Australia is active. With this configuration, the Termination End Handling process is executed for all employees, except for employees in the legal entity "ACE Netherlands". The activation status of this legal entity is set to “Excluded”. For all other employees, the Termination End Handling process is triggered with an offset of 1 day, except for employees in the legal entity "ACE Australia". For that legal entity, an offset of 5 days is specified in the legal entity configuration. The Termination End Handling process is triggered accordingly, with an offset of 5 days. 180 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.6.3.5.2 Option 2: Activation Status of the Termination End Handling Configuration set to Inactive When the activation status of the general Termination End Handling configuration is set to "Inactive", then the whole Termination End Handling process is deactivated without exception. Example Here, the Termination End Handling process is never triggered for any employees, even if a legal entity configuration is set to "Active". Use Case: If there are general issues with the Termination End Handling process, then you can disable it through the configuration object. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 181 3.5.6.3.5.3 Option 3: Activation Status of the Termination End Handling Configuration set to "Active for configured legal entities only" When the activation level of the general Termination End Handling Configuration object is set to "Active for configured legal entities only", then the Termination End Handling process is inactive by default. However, this does not apply to legal entities where the activation status is set to "Active" in the legal entity configuration. Example When you configure the system as shown in the example, then the Termination End Handling process is only executed for employees in the legal entity "ACE Australia". For this legal entity, the configuration of the legal entity is set to “Active”. Use Case: You can use this configuration if the Termination End Handling process should only be enabled for certain legal entities. 182 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.6.4 Role-Based Permissions Required for Termination End Handling You need to assign the permissions for the MDF objects related to Termination End Handling for your admin users. The following objects require read and write permissions for admin users. Otherwise, admins won't be able to configure the feature. ● Time Management Termination End Handling Configuration ● Time Management Termination End Handling Alert ● Time Management Termination End Handling Legal Entity Configuration ● Time Management Termination End Handling Exclusion ● Time Management Termination End Handling Excluded Time Account Type ● Time Management Termination End Handling Excluded Event Reason To access Admin Alerts on the Admin Alerts UI, you need to assign the edit/view permission to the Time Management Termination End Handling Alert under Permission Time Management Object Permission Admin Center Permission Role Detail Administrator Time Management Termination End Handling Alert . The same procedure applies to all the objects listed previously in this section. 3.5.6.5 Steps in Termination End Handling Execution Find out more about the steps in the termination end handling execution. ● Absence Request Processing [page 183] ● Accrual Recalculation [page 184] ● Time Account Processing [page 185] ● Accrual Processing [page 185] 3.5.6.5.1 Absence Request Processing Prerequisites The “Level of automation of absence request processing“ configuration switch is set to “Full automation“. If this configuration switch isn't set to "Full Automation", then the Termination End Handling process does not cancel or delimited any absences. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 183 Context Absence request processing is the first step in the execution of the Termination End Handling process. Note If you set the switch to "No automation", no absences are processed by the Termination End Handling process. However, these absences are processed anyway in the Time Account Processing [page 185] step and raise an alert. We recommend choosing the option "Full Automation". When an employee is rehired, you can activate the cancelled absences manually using Manage Data from the Admin Center, and change the status of the absence to “Approved”. The Termination End Handling process cancels absences which lie after the termination date. Absences which overlap with the termination date are delimited, with the end date set to the termination date. Note When an absence is delimited, the parts of an absence that cross the termination date will be deleted. The following rules and restrictions apply to the Termination End Handling processing of absences: ● Absences with the "Pending" and "Pending cancellation" workflow approval status aren’t processed. In that case an admin alert is created. The admin must approve the absence and retrigger the Termination End Handling process. ● If you have a take rule assigned to the time type for which the absence is being cancelled or delimited, then this take rule execution is ignored during the Termination End Handling process. ● Absences with the "Editable" flag set to false are not processed by the Termination End Handling process. ● Absences with flexible requesting that overlap with the termination date are not delimited. We don't delimit the absence because the quantity of an absence is free input and we don't know how many hours must be allocated to the delimited absence. An admin alert is created in this case. The admin needs to manually delimit this absence. However, if the absence with flexible requesting lies after the termination date without overlap, then the absence is be cancelled. ● A leave of absence is cancelled if it lies after the termination date without overlap. But if the leave of absence overlaps with the termination date, it isn’t delimited by the Termination End Handling process. An admin alert is created, and an admin needs to delimit that absence manually. ● If there are country/region-specific fields entered for an absence, then the absence isn’t delimited if it overlaps with the termination date. An admin alert is created and the admin must update the country/ region-specific fields and delimit the absence manually. 3.5.6.5.2 Accrual Recalculation If absence processing is skipped because the ”Level of automation of absence request processing” switch isn’t set to ”Full automation", then the accrual recalculation step is also skipped. Accrual recalculation is triggered immediately after the absence processing step if there are any absences which affect accrual recalculation. Typically, the recalculation of accruals and absences is done before the Termination End Handling processing, immediately after the termination is entered. However, there are absences which are delimited as part of the Termination End Handling process. The Termination End Handling process then needs to recalculate the accruals. This is the case when the time type is flagged as "Accrual 184 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management recalculation relevance". For these absence changes, an accrual recalculation is triggered. In addition, all the other time account types that have "absence change" as the recalculation relevant field are also picked for accrual recalculation. 3.5.6.5.3 Time Account Processing If a time account type is excluded from the Time Management Termination End Handling Exclusion configuration, then that time account type is not included in the processing. To close the time accounts automatically, you need to set the “Level of Automation of Account Closure“ configuration switch to “Full Automation“. Time accounts whose validity or bookable period overlap with the termination date are delimited first. The validity end date and the bookable end date of the time account are set as the termination date and then the time account is closed. If a time account was already closed before termination, it will also be included in the processing and delimited if needed. Time accounts whose validity and bookable period lie after the termination date without overlap are deleted. Upon rehire, new time accounts are created, and new accruals are created from the rehire date onwards. Note Time accounts whose validity and bookable period lie before the termination date without overlap are not closed. In this case, we assume that accounts are already closed through period end processing or past terminations. Time account postings other than accrual and recalculation postings are not deleted by the Termination End Handling process. An admin alert is then created for these postings and the administrator needs to clean up the postings manually. These postings can be leave bookings, manual adjustments, payouts, purchase leave, period end processing, and so on. The clean up of Time account postings applies to: ● Postings for to-be-deleted time accounts which lie after the termination date. ● Time accounts with a shortened bookable period whose postings lie after the termination date. 3.5.6.5.4 Accrual Processing As part of the accrual processing, all accrual and recalculation postings after the termination date are deleted. The accrual deletion doesn’t depend on the posting date, but on the accrual period. Example You have time account types with monthly accruals and used an accrual rule with an account start date (for example, January 1, 2021) as the posting date for all accruals. Let's say there are 10 accrual postings from Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 185 January to October on that date (January 1, 2021). If the employee is terminated in August 2021, accruals for September and October are removed, regardless of the posting date. If the accruable period overlaps with the termination date, then the accrual posting date is adjusted to the termination date. For this to happen, the posting date must be outside the new bookable period of the time account. Example Let's say you have a monthly accrual frequency and you post accruals on the accruable end date, for example, when the posting date is the accruable end date. The accruable period is from January 1 to January 31, 2021. The accrual posting date is January 31, 2021. Now, you terminate a user on January 14, 2021. Your termination date is 14/01/2021. In this case the accrual posting date is adjusted to the new accruable end date. As a result, you see that the accrual posting date is changed to January 14, 2021, and all accruals after this date are deleted. Note If a time account type is excluded from the "Time Management Termination End Handling Exclusion" configuration, then that time account type isn't included in accrual processing. 3.5.6.6 Time Management Task Handling on Termination The Time Management Task object is used for the lifecycle of the execution of the Termination End Handling Process. The task type is "Termination End Handling". The Time Management Task can have different statuses: ● Scheduled - The status of the task is set to scheduled when the termination process is set to be executed on a future date (for example: When you terminate a user with a future termination date). In this case the task will be picked up by the nightly scheduled "TLMTriggerTask" job when the scheduled date has reached the current date. ● To be Processed - The Termination End Handling process is ready to be processed. ● Completed Successfully - The Termination End Handling process has been executed successfully. ● Completed with Errors - The Termination End Handling process is completed with errors. ● When there is a termination-relevant Job Information change, the system creates, updates, or deletes the Termination End Handling Time Management Task for the affected user and their Job Information record. The termination date is the last working day of the employee. This is the date entered in the terminate action in the People Profile. The effective start date of the termination record will be one day after the termination date. This means the Termination End Handling process can be executed earliest on the effective start date of the termination record, given an offset of 1 day. If you need to do a rehire on the same date as the termination effective date, then please wait for the Termination End Handling process to be executed successfully. Then proceed with the rehire step. 186 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management The following changes are termination relevant Job Information changes in Time Off (for a more detailed overview of the process, please refer to the following details on Job Info Terminations changes: Table 25: Operation Create Examples of Termination relevant Job Info changes ● ● ● System Behavior The system creates a new Time Man­ agement Task of the Termination End through the terminate action in the Handling type when there is a new ter­ People Profile. mination record in the Job Information. A termination record is created via This can happen either by creation or the Job Information history by in­ an update of an already existing Job In­ formation record to a termination rele­ serting a new record. vant record. Another Job Information record is A termination record is created updated. It is changed to a termi­ nation record by changing the event to "termination" (for exam­ ple, the event gets changed from "data change" to "termination.") Update ● An existing termination record is ● updated ○ ○ ment Task of the Termination End The termination date is Handling type and it's in the changed to a past or a future "Scheduled" status, the task is up­ date. dated to the new scheduled date if The termination event reason the termination date is changed to a past or a future date. is changed to another termi­ nation event reason, which is ○ If there's an existing Time Manage­ ● If there is already an existing Time excluded by the Time Manage­ Management Task of the Termina­ ment Termination End Han­ tion End Handling type and it’s in dling Configuration. the "Scheduled" status, the task is The termination event reason deleted if the termination event is changed to another termi­ reason is changed to a value, which nation event reason, which is is excluded by the Time Manage­ not excluded by the Time ment Termination End Handling Management Termination End Exclusion configuration. Handling configuration. A new task is created if: ● There is no existing Time Manage­ ment Task of the Termination End Handling type. ● The event reason is changed to a Termination event reason. ● The event reason is not excluded by the Time Management Termina­ tion End Handling Exclusion configuration. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 187 Operation Examples of Termination relevant Job Info changes Delete ● ● System Behavior A termination record gets deleted If there is an existing Time Management from the Job Information history. Task of the Termination End Handling A termination record is updated, so type in the "Scheduled" status, the task is deleted. This happens because the it becomes another record by changing the event away from Ter­ termination record was removed from mination, for example, the event the Job Information if the Termination gets changed from "termination" event is deleted or the termination to "data change". event is updated to another event. Note If the task was already executed and the termination record is de­ leted afterwards, the task isn't de­ leted, and the Termination End Handling process takes place. Please crosscheck before deleting a termination event. 3.5.6.7 Error Handling for the Termination End Handling Process Find out more about error handling for the Termination End Handling Process. ● Alerts and Retriggering the Termination Process [page 188] ● Troubleshooting Errors [page 190] 3.5.6.7.1 Alerts and Retriggering the Termination Process The alerts from the Termination End Handling process execution are displayed on the Admin Alerts UI under the "Termination End Handling Alerts" category. The Time Management Termination End Handling Alert object is shipped as "Secured" by default. As a result, you must maintain the view permissions for this object for admin users who need access to the alerts. 188 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management You can perform two actions from the Alerts UI. ● You can "Acknowledge" the alert. In this case, the alert is deleted from the system and there is no correction to the Termination End Handling process. ● You can retrigger the Termination End Handling process by selecting an alert and choosing Action Retrigger Termination End Handling Process . You should retrigger the process after correcting the error situation. In this case, you need to clean up the existing time account detail booking manually, for example, a manual adjustment or a payout which resulted in an error. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 189 Note When there are multiple Time Management Tasks of the Termination End Handling type for the same user, the latest Time Management Task for this user is picked and processed when you retrigger the process from the Admin Alert UI. 3.5.6.7.2 Troubleshooting Errors Find out more about troubleshooting different errors. Technical Errors Any technical errors like issues with the event subscribers will be logged under Admin Center Execution Manager Dashboard . Please create a support ticket if you face such issues. These issues can also result in the Time Management Task status to be "Completed with Errors". Configuration Changes Before the Execution of the Termination End Handling Task If a Time Management Task has been created with an existing configuration, is still in the "Scheduled" status, and you now change the configuration, you might get an error. This is due to changes in configuration when the task is picked up for processing. The following error cases can happen, and an admin alert is created: Case 1: Exclusion of event reason from the global configuration Case 2: Global configuration is changed from "Active" to "Inactive" 190 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Case 3: Legal entity configuration is changed from "Active" to "Excluded" Case 4: Change of legal entity from one legal entity to another Case 5: Exclusion of event reason from legal entity configuration Case 6: Removal of the configuration completely We recommended that you don't change the configuration whenever there is an open task that's not yet processed and in the "Scheduled" status. Job Information Read Error Cases When the Termination End Handling Task is executed, the system reads the job information again. The system retrieves the termination-related information from the termination Job Information record for further validation and processing. The following error can occur and an alert is created in this case: Example: The referenceCode field in the Time Management Task object doesn't point to a valid termination record in job Information for the terminated user. This can happen when the referenceCode has been manipulated in the task or if the job information has been modified after the Termination End Handling Task was scheduled. 3.5.6.8 Support for Termination Triggers Find out more about support for termination triggers. Supported Termination Triggers ● Fixed Term Hire. If you use the action search "Add New Employee for Fixed Term", you can enter both the hire and the termination date when you hire the user for a fixed term. In this case, the Time Management Termination End Handling process is supported. ● Terminate action. If you go to the people profile and select "Take Action" ➔ Terminate, the Time Management Termination End Handling process is supported. ● Job Information History change from the UI. If you insert a Job Information history record with Termination event from the Job Information History UI, the Time Management Termination End Handling process is supported. ● Terminate OData API: EmpEmploymentTermination. If you use an external system to terminate the employee, and replicated to SAP SuccessFactors Employee Central through the OData API, the Termination End Handling process is supported. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 191 Unsupported Termination Triggers ● Terminations done through the Termination Import aren‘t supported. ● Terminations done through Job Information Imports with a termination event reason aren’t supported. ● The no-show event type isn't supported. 3.5.7 Purchase and Payout of Leave Learn more about the purchase and payout of leave. 3.5.7.1 Leave Payout Learn more about the different leave payout scenarios: the admin scenario and the self-service scenario. 3.5.7.1.1 Leave Payout (Admin Scenario Only) It’s now possible for employees to request a payout for accrued time. HR administrators can make financial payouts on time accounts. Configuration settings are applied to allow for payouts. Note You cannot assign rules to time account payouts. There's some configuration work to do before this feature can be used: Permissions ● The Manage Payout permission must be active. To activate it, go to the Admin Center and choose Manage Permission Roles, scroll down to Manage Time Off, and check the Manage Payout permission. ● To view and use the Accounts Payout tab in the Time Workbench, you also need the Access Account Payouts permission. To activate it, go to the Admin Center and choose Manage Permission Roles, scroll down to Manage Time, and check the Access Account Payouts permission. ● For calculating the standard payout rate, ensure that the base pay component (for example, base or hourly salary), maintained in employee compensation, is assigned to the pay component group (PCG) of the time account types that are enabled for payouts. Time Account Types Use the Payout Eligibility field in the time account type to determine whether payouts can be made from time accounts with this time account type. If you select Eligible, you must enter a pay component group and pay component. Work Schedule You must make an entry in the all of the following fields of the work schedule assigned to any employee for whom you want to make time account payouts: 192 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● Average Hours Per Day ● Average Hours Per Week ● Average Hours Per Month ● Average Hours Per Year ● Average Working Days Per Week The fields are used, along with the pay component group, to determine the standard hourly or daily rate. Note It’s possible that, having maintained these values, you still don't see a standard rate for an employee and no warning is displayed. If this happens, check that the pay component group selected under the time account type is used for the employee's compensation information. Related Information Time Account Types (more information about Time Accounts and payout eligibility, pay component, and pay component group fields) [page 722] 3.5.7.1.2 Leave Payout (Including Self-Service) The self-service scenario is an enhancement for time account payouts. When Eligible for Self-Service is enabled, employees and their managers can request payouts. Prerequisites Self-service for time account payout is an enhancement of the existing payout functionality. This scenario assumes that you have an installed and configured Time Off. The following conditions are assumed: ● Time types are created for each type of leave. ● Time accounts, for example, for vacation or leave, have been created. ● Accrual rules for time off have been created and applied to time accounts. ● Base pay components, for example base salary or hourly salary, are maintained and assigned to a pay component group of the time account types that are enabled for payouts. ● A standard workflow for the approval processes is created. Self-Service Time Account Payout A payout occurs, for example, when an employee receives payment instead of taking leave or time off. Previously, time account payout was available in an administrator scenario, created in the Time Workbench. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 193 Now, an enhancement is provided to add a self-service scenario functionality. With this enhancement, employees or their managers can request for payouts on earned time account balances in Time Off. Implementing Self-Service Payout The high-level steps for implementing the Time Account Payout for self-service scenario include creating the following: ● Assigning permissions for Self-Service Time Account Payout. ● Enabling Time Account Types to be Eligible for Self-Service. ● Creating validation business rules and error messages for self-service. ● Enable a workflow to be associated with the self-service payout process. ● Create a Time Account Payout Profile object. 1. Assigning Administrator Permissions for Time Account Payout [page 195] Allowing administrators to create, edit, and delete payout requests. 2. Assigning User Permissions for Self-Service Time Account Payout [page 198] For employees or their managers to access the self-service dashboard to view balances and request payouts from eligible time accounts. 3. Enabling Time Account Type as Eligible for Self-Service [page 200] Allow employees to request for time account payout for each time account type. 4. Creating Time Account Payout Validation Rules [page 201] You define your company-specific validation rules to apply to payout requests. 5. Creating Error Messages for Time Account Payout [page 203] You create the error or warning messages that display when an employee requests a payout. 6. Creating a Business Rule to Trigger a Workflow for Payout [page 205] A business rule is required to trigger the approval process for a payout request. 7. Creating a Time Account Payout Profile [page 206] A payout profile defines the configuration elements that determine how your payout policy is implemented. 8. Enabling Attachments for Time Account Payout Requests [page 209] Changing the default to enable attachments for self-service payout requests. 9. Enabling Requester Visibility in Time Account Payout [page 210] Additional configuration is required for requester information to display in the self-service and administrator dashboards for payouts. 194 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.7.1.2.1 Assigning Administrator Permissions for Time Account Payout Allowing administrators to create, edit, and delete payout requests. Context To enable eligibility for payout functionality, you assign permissions to administrators. The administrators can then create, edit, and delete time account payouts. Note All of the time objects are delivered as unsecured. We recommend that you secure them. Use Configure Object Definition to change security settings. Tip We recommend using the Time Management Object Permissions category for securing all of the time objects. Legacy systems might have the permissions currently located in Miscellaneous Permissions. Procedure 1. Sign on to Employee Central as an administrator. 2. Go to the Admin Center Manage Permission Roles . 3. On the Permission Roles list, select the administrator role to assign the permissions. Note The role, or roles, depends on how your company defines administrator tasks and responsibilities. The Permission Role Detail view for the selected role displays 4. Choose Permission… A Permissions setting dialog box displays. 5. The following permissions depend on how your company defines administrator tasks and responsibilities, Assign your administrators the following permissions, as necessary: To Enable the Administrator to: Assign this Permission To view and edit Time Accounts. Go to A Time Account is assigned to an employee and con­ tains the accrued balance of the various time types. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management User Permissions Miscellaneous Permissions . For Time Accounts, select one or more of these options depending on your requirements: ○ Visibility select View Allows the administrator to see time accounts. PUBLIC 195 To Enable the Administrator to: Assign this Permission ○ Actions select Edit Allows the administrator to edit the time accounts for payouts. To view and edit Time Account Types. A Time Account Type is, for example, vacation, sick leave, or other paid time-off categories, for which an employee is eligible. These types are associated with the Time Account. Go to User Permissions Miscellaneous Permissions . For Time Account Types, select one or more of these options depending on your requirements: ○ Visibility select View Allows the administrator to see time account types. ○ Actions select Edit Allows the administrator to edit the time accounts types for payouts. To view and edit the Time Account Payout Profile. To allow self-service for payout, a Time Account Payout Profile object must be created and maintained. Go to User Permissions Miscellaneous Permissions and for Time Account Payout Profile. Select one or more of these options depending on your requirements: ○ Visibility select View Allows the administrator to see the Time Account Payout Profile. ○ Actions select Edit Allows the administrator to edit the Time Account Payout Profile. To Create Payout in Self Service. Go to User Permissions Time Management User Permissions . Select the Create Payouts in Self-Service checkbox. The permission allows the employee, or by their manager, access to the payout dashboard to request a payout on the time balance of an eligible time account. To view Time Types. Go to User Permissions Permissions Time Management Object select one or more of these options for Time Types depending on your requirements: ○ Visibility select View Allows the administrator to see time types when re­ questing time account payout. ○ To view and maintain Time Account Payout object. Actions select Edit Allows the administrator to edit the time types. Go to User Permissions Time Management Object This permission is for editing the delivered object defi- Permissions nitions for time objects, for example, to enable custom Time Account Payout depending on your requirements: fields, or add business rules, specific to your business select one or more of these options for ○ Visibility select View Allows the administrator to view time account payout. ○ Actions select Edit Allows the administrator to edit the object definition logic. for time account payout. To configure the Time Account Payout Profile. Go to Administrator Permissions Metadata Framework select the following options depending on your requirements: 196 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management To Enable the Administrator to: Assign this Permission ○ Configure Object Definitions Allows the administrator to manage Metadata Frame­ work (MDF) object definitions, for example, Time Ac­ count Payout Profile. Remember All of the time objects are delivered as unsecured. Se­ cure the Time Account Payout Profile object using Configure Object Definition to make it available with role-based permissions. To provide access to the Pay Out Time tab on Time Administrator Workbench. Go to Administrator Permissions Manage Time se­ lect one or more of these options depending on your re­ quirements: ○ Access Workbench Allows the user to access the Time Workbench in or­ der to maintain time-related objects. ○ Access Accounts Payouts Users with this permission can access the Account Payouts tab in the Time Workbench. To provide access to create, edit, and delete a payout request. Go to Administrator Permissions Manage Time Off select the option depending on your requirements: ○ Manage Payout Allows the administrator to create payouts for em­ ployees. 6. Choose Done to close the dialog box. 7. Choose Save Settings. Results The permissions are successfully saved. Task overview: Leave Payout (Including Self-Service) [page 193] Next task: Assigning User Permissions for Self-Service Time Account Payout [page 198] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 197 3.5.7.1.2.2 Assigning User Permissions for Self-Service Time Account Payout For employees or their managers to access the self-service dashboard to view balances and request payouts from eligible time accounts. Context To enable access to the self-service feature for payout, you assign permissions to users to view information about available time accounts and to allow them to create requests. Note All of the time objects are delivered as unsecured. We recommend that you secure them. Use Configure Object Definition to change security settings. Tip We recommend using the Time Management Object Permissions category for securing all of the time objects. Legacy systems might have the permissions currently located in Miscellaneous Permissions. Procedure 1. Sign on to Employee Central as an administrator. 2. Go to the Admin Center Manage Permission Roles . 3. Under the Permission Roles list, select the role, or create a new role, to assign the self-service permissions. The Permission Role Detail view for the selected role displays 4. Choose Permission… A Permissions setting dialog box displays. 5. The following permissions are provided to users to view and request self-service payouts for eligible time accounts. Assign your users the following permissions, as necessary: To Enable the User to: Assign this Permission To view Time Accounts. Go to A Time Account is assigned to an employee and con­ tains the accrued balance of the various time types. To view Time Account Types. User Permissions Miscellaneous Permissions . For Time Accounts choose: ○ Visibility select View Allows the user to see eligible time accounts. Go to User Permissions Miscellaneous Permissions , For Time Account Types choose: ○ Visibility select View 198 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management To Enable the User to: Assign this Permission Allows the user to see eligible time account types. A Time Account Type is, for example, vacation, sick leave, or other paid off categories, for which an em­ ployee is eligible. These types are associated with the Time Account. To view the Time Account Payout object. Go to This object provides, for example, the associated ap­ Permissions proval workflow to be applied to self-service requests. To view Time Types. ○ User Permissions . For Time Account Payout: Visibility select View Go to User Permissions Permissions ○ Time Management Object Time Management Object . For Time Types: Visibility select View Allows the user to see the eligible time types when re­ questing time account payout. To Create Payout in Self Service. Go to User Permissions Time Management User Permissions . Select the Create Payouts in Self-Service checkbox to allow access to the payout dashboard for re­ questing a payout, by the employee or by their manager, for the time balance on an eligible time account. Addition­ ally, if the Time Account Payout Object in your system is secured, users need the Edit permission on that object. To view the requester name and photo when the re­ quest for payout isn’t made by the user. To view the requester in the self-service dashboard. Go to ○ ○ ○ ○ Employee Data . First Name select View Middle Name select View Last Name select View Photo select View Go to ○ ○ User Permissions User Permissions General User Permissions . Select the Company Info Access checkbox. Select the User Search checkbox Allows the user to see the requester name and photo in the self-service dashboard when the request for the payout isn’t made by the user 6. Choose Done to close the dialog box. 7. Choose Save Settings. Results The permissions are successfully saved. Task overview: Leave Payout (Including Self-Service) [page 193] Previous task: Assigning Administrator Permissions for Time Account Payout [page 195] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 199 Next task: Enabling Time Account Type as Eligible for Self-Service [page 200] 3.5.7.1.2.3 Enabling Time Account Type as Eligible for SelfService Allow employees to request for time account payout for each time account type. Prerequisites Time Account Types are created and available to your role to edit. A Payout Profile to associate with the time account type is created. Context Any Time Account Type that is allowed to accept employee self-service requests must be designated as eligible for self-service. Procedure 1. Sign on to Employee Central as an administrator. 2. Go to the Admin Center Tools Manage Data . 3. Enter Time Account Type in Search and in the next field select a previously created time account type, for example TA_VACATION. The details for Time Account Type : <account name, for example, TA_VACATION> display. 4. Go to the Take Action button and select Make Correction. 5. Under Payroll Eligibility select Eligible for Self Service. 6. For the Payout Profile, select a previously created Time Account Payroll Profile to associate with this type. 7. (Optional) To verify the profile information, next to the Payout Profile, choose View Time Account Payout Profile to display a dialog box with the profile information. Close the dialog box when you've completed your review. 8. Choose Save. 200 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Results The Time Account Type is enabled for employee self-service. Next Steps User permissions are required to allow employees to create payout requests. Refer to Assigning Permissions for Time Account Payout for both administrators and employees for more information. Task overview: Leave Payout (Including Self-Service) [page 193] Previous task: Assigning User Permissions for Self-Service Time Account Payout [page 198] Next task: Creating Time Account Payout Validation Rules [page 201] 3.5.7.1.2.4 Creating Time Account Payout Validation Rules You define your company-specific validation rules to apply to payout requests. Prerequisites You’ve created the warning or error messages for Time Account Payouts in the Message Definition area of Manage Data. Context You use this rule scenario for payout validation to generate a warning or error message. The relevant message is triggered whenever the administrator makes changes or when an employee enters data. When you create, cancel, or edit a payout, the system performs certain checks. For example, an error displays when the requested quantity is greater than time account balance. You also have the option to add more validation checks. You add validation checks using the rule scenario for payout validation in the Time Account Payout Profile object. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 201 Procedure 1. Sign on as an administrator to Employee Central. 2. Go to Admin Center Tools Configure Business Rules . 3. On the Business Rules Admin. view, choose + (Add). 4. On the Configure Business Rules view, expand Time Management. 5. From the expanded list, select Time Account Payout Validation. A Time Account Payout Validation dialog box displays. 6. Enter the following: Field Entry Rule Name <name> An unique, understandable name to identify the rule. Rule ID <ID name> An unique technical name to identify the rule. Start Date <date> When the rule is activated. Description <description> Though optional, we recommend that you describe the purpose of this rule. 7. Choose Continue. A new view with the rule you created displays. 8. Use the IF condition of the rule to specify the conditions under which the message is raised. For example, you want the rule to check if the self-service request is for more days than your policy allows for payout. The rule functions listed in the IF conditions can be used for that calculation. 9. For the THEN condition, add a Raise Message expression. Choose the relevant message and the level of severity (Error, Warning, or Info). If you want to format the text of the message, you can use any of these BBcodes: 202 Use this BB code For this effect [b]...[/b] Bold [i]...[/i] Italics [u]...[/u] Underline [s]...[/s] Strike through [size]...[/size] Font size [color]...[/color] Font color [center]...[/center] Center text [quote]...[/quote] Quote [url]...[/url] Link/Link name PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Use this BB code For this effect [xurl]...[/xurl] Link that opens in a new window/Link name [img]...[/img] Image [code]...[/code] Code [table]...[/table] Tables 10. You're free to add further ELSE conditions to the rule to trigger different messages under different conditions. 11. When you've completed your IF/THEN statement, choose Save from the bottom of the view. A Successfully Saved message displays at the top of the view. Task overview: Leave Payout (Including Self-Service) [page 193] Previous task: Enabling Time Account Type as Eligible for Self-Service [page 200] Next task: Creating Error Messages for Time Account Payout [page 203] 3.5.7.1.2.5 Creating Error Messages for Time Account Payout You create the error or warning messages that display when an employee requests a payout. Context When employees enter their payout request, validation business rules are executed. These rules enforce your organization's policy guidelines by displaying warnings or error messages. For example, your policy restricts employees to creating five payout requests a year. Another example is that employees are limited to request a payout for a maximum of 10 days, even if their balance is more than 10 days. The steps for creating validation rules are provided in Creating Time Account Payout Validation Rules. In these steps, you create the message that displays when the validation rules for time account payout are executed. Use the Message Definition to create messages that appear when these requests are created or edited. You create messages to meet your requirements. Use the following steps as an example to create error messages. The two sample scenarios are 10 days as the payout limit and the request exceeds the number of payout requests allowed for a time period. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 203 Procedure 1. Sign on to Employee Central as an administrator. 2. Go to the Admin Center Tools Manage Data . 3. On Create New, select Message Definition. 4. In the Message Definition view, enter the text for the error message in the Text field. Note To format the text of the error message or include an https: URL link, use standard BB Code (Bulletin Board Code) markup language. See the table of supported BB Codes in the previous Creating Time Account Payout Validation Rules. For this Example Scenario Enter this Text When employee entry exceeds available time for payout. For example, Selected balance must be less than or equal to [b]10[/b]. [xurl]https://mycompany.com/HRpolicy[/ xurl], When employee request exceeds the number of requests For example, You have [i]exceeded[/i] your allowed for a time period. payout request limit for this period. [xurl]https://mycompany.com/HRpolicy[/ xurl] 5. Enter an External Code to describe the message definition. Remember The External Code must be unique and not used by any other Message Definitions or an errorCode Already Exists displays. For this Example Scenario External Code Example When employee entry exceeds available time for payout. payout_error_exceeds_balance When employee request exceeds the number of requests payout_error_exceeds_requests allowed for a time period. 6. Either copy and paste the code text in the Name field, or create a meaningful name to describe the error message. 7. For Status, use the default, Active. 8. For these scenarios, you don't enter Parameters. 9. Choose Save. A Successfully Created message displays. Task overview: Leave Payout (Including Self-Service) [page 193] Previous task: Creating Time Account Payout Validation Rules [page 201] Next task: Creating a Business Rule to Trigger a Workflow for Payout [page 205] 204 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Related Information Creating Time Account Payout Validation Rules (for table of supported BB Codes) [page 201] 3.5.7.1.2.6 Creating a Business Rule to Trigger a Workflow for Payout A business rule is required to trigger the approval process for a payout request. Context When making time account payout eligible for self-service, often an approval process is required to accept or decline the request. You create a business rule to trigger the workflow. Note These steps trigger a workflow, they don't create a workflow. You create the workflow by following the procedures in Setting Up Workflows in the Employee Central Workflows: Implementation and Administration guide. Your created workflow is added to the Time Account Payout of the time account type. Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and choose Tools Configure Business Rules . The Business Rules Admin view displays. 3. Choose + (Create New Rule). Configure Business Rules view displays 4. From the list, expand Metadata Framework and choose Rules for MDF Based Objects. 5. In the Rules for MDF Based Objects dialog box, enter the following: Field Entry Rule Name <meaningful display name> Rule ID <meaningful technical name> Start Date <date> Date when rule is enabled. Description <meaningful description> Base Object Time Account Payout Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 205 Field Entry Purpose Workflow 6. And choose Continue. The details view for the business rule displays. 7. Choose the If row and select the Always True checkbox. 8. Under Then, choose the Pencil icon (Edit Expression). 9. Select Set from the dropdown. 10. In the Select Left Expression field, expand Workflow Context and choose Workflow Configuration. 11. Retain to be equal to and from the Value field, expand Payout Profile Time Account Payout Time Account Type and select Workflow Configuration. 12. Choose Save. Results A Successfully Save message displays and the rule is created. Next Steps Go to the Admin Center and choose Tool Search Configure Object Definition and open the Time Account Payout object in correction mode. Assign the rule you've created to onSave of the Time Account Payout object. Task overview: Leave Payout (Including Self-Service) [page 193] Previous task: Creating Error Messages for Time Account Payout [page 203] Next task: Creating a Time Account Payout Profile [page 206] 3.5.7.1.2.7 Creating a Time Account Payout Profile A payout profile defines the configuration elements that determine how your payout policy is implemented. Prerequisites The following are needed to create a payout profile: 206 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● You must be assigned permission to create or edit a time account payout profile ● Pay components and pay component groups ● Payout Validation Rules ● Workflow for the approval process Context You create a time account payout profile to define the elements needed to implement your payout policy. These elements include: ● Pay components ● Pay component groups ● Workflows ● Instructional texts ● Validation rules Procedure 1. Sign on to Employee Central as an administrator. 2. Go to the Admin Center and choose Tools Manage Data . 3. On the Create New field, select Time Account Payout Profile. A Time Account Payout Profile view displays. 4. What you enter for the following depends upon your requirements: Field Name Entry External Name (Mandatory)<meaningful name to describe the profile> Enter a name that is meaningful for all relevant languages, typically the language that applies to your selection of Country/Region. Country/Region <Country/Region> Adding Country/Region restricts use to only those specified countries/regions. Pay Component Group <pay component group ID> This field is required to calcu­ late the standard rate for payout. Maintain this field when the pay component used for payout is of Amount type. To calculate the standard rate, maintain the appropriate val­ ues in the average field included in the work schedules. Only active pay component groups are used, not an inac­ tive group. Pay Component <component ID> You must maintain this field to use the payout function. The pay component can be either an amount type or number type. When the pay component is an amount type, it's required to maintain the previous en­ try, Pay Component Group, for the profile. The pay com­ ponent must be nonrecurring. This component is used to Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 207 Field Name Entry create a spot bonus when the payout request is approved or saved. Separate Pay Component for Accrual on Termination <component ID> To make an accrual pay out when termi­ nating, you must maintain this field. When using Amount type pay components, maintain the pay component group and entry in average fields included in the work schedule. Only use active pay components, not an inactive compo­ nent. The pay component must be an Amount or Number type. The pay component must be nonrecurring. This component is considered when the payout is being made from the termination view in Time Off. This field is only rel­ evant for time account types with the Entitled as Transferred entitlement method. Pay Component on Termination <component ID>To make termination entitlement pay­ outs, you must maintain this field. When using Amount type pay components, maintain the pay component group and entry in average fields included in the work schedule. Only use active pay components, not an inactive compo­ nent. The pay component must be an Amount or Number type. The pay component must be nonrecurring. This component is considered when the payout is being made from the termination view in Time Off. Instructional Text <text> This field can be used to enter instructional text and guidelines for your employees that display on the UI of self-service payout request. Use standard BB Code (Bulle­ tin Board Code) to format text or add an https URL link. For example, Some [b]limitations[/b] apply. Review the payout policies at [xurl]https:/mycompany.com/HRpayout[/ xurl] Information about the supported BB Codes is included in Creating Time Account Validation Rules. External Code (Mandatory)<meaningful code name of the profile>Enter an external code for your time account payout profile. Workflow Configuration <workflow ID> Use this field to trigger a workflow for a time account payout. The workflow conditions are based on the business rule added to the Time Account Payout object. When a workflow is only required for a self-service payout request, add an If condition to execute this rule only when Scenario is equal to Self-Service. 5. Under Validation Rules select the Time Account Payout Validation Rule you created previously. 6. On external code view, 7. Choose Save. Next Steps To allow employee self-service, administrator must select Eligible for Self Service on the Payout Eligibility field for the Time Account Type that is selected for the Time Account Payout Profile. 208 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note The Time Account Payout Profile defines the pay components and pay component groups included for payout for the Time Account Type. Task overview: Leave Payout (Including Self-Service) [page 193] Previous task: Creating a Business Rule to Trigger a Workflow for Payout [page 205] Next task: Enabling Attachments for Time Account Payout Requests [page 209] Related Information Creating Time Account Payout Validation Rules (for table of supported BB Codes) [page 201] 3.5.7.1.2.8 Enabling Attachments for Time Account Payout Requests Changing the default to enable attachments for self-service payout requests. Prerequisites Before starting, you must have a Time Account Type that is enabled as Eligible or Eligible for Self Service for payouts. You have permissions to Configure Object Definitions and Time Account Payout objects. Context By default, adding attachments isn't enabled for a Time Account Payout Request. To allow attachments on your payout request, you must do it by adding a custom field of type attachment. Restriction Only one custom field of the type, attachment, is allowed with Time Account Payout. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 209 Procedure 1. Sign on to Employee Central as an administrator 2. Go to the Admin Center and choose Tools Configure Object Definitions . 3. Select Object Definition in the first field and enter Time Account Payout in the second field. The Object Definition: Time Account Payout details view displays. 4. From Take Action, select Make Corrections. 5. Scroll down to the Database Field Name of customFields.customField1 and enter the following: Field Entry Field Name <meaningful name> For example, Attachment Maximum Length For example, 38. Data Type Attachment 6. Choose Save. Results An attachment area is available when a time account payout is requested. When a payout request includes an attachment, the payout dashboard displays an attachment icon. Task overview: Leave Payout (Including Self-Service) [page 193] Previous task: Creating a Time Account Payout Profile [page 206] Next task: Enabling Requester Visibility in Time Account Payout [page 210] 3.5.7.1.2.9 Enabling Requester Visibility in Time Account Payout Additional configuration is required for requester information to display in the self-service and administrator dashboards for payouts. Context You make the following configuration changes to the Visibility field in the time account payout generic object. You manually enable the following fields, so that information about the requester of a time account payout appears in the self-service and administrator dashboards for payouts. 210 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Remember Permissions for time account payout must be granted for administrators and users. Procedure 1. Sign in to Employee Central as an administrator. 2. Go to the Admin Center and choose Tools Configure Object Definitions . 3. On the Search field, select Object Definition, and in the next field, enter Time Account Payout. 4. Choose Take Action Make Correction . 5. Go to the createdBy field and choose Details. A Details dialog box displays. 6. Scroll down to the Visibility field and select Read Only 7. Choose Done to save and close the dialog box. 8. Now, go to the createdDate field and choose Details. 9. Repeat the steps for changing Visibility to Read Only and choose Done. 10. Choose Save. Note To make the changes effective in the system, you must refresh the metadata. The next steps show you how. 11. Go back to the Admin Center and choose Tools OData API Metadata Refresh and Export . 12. Choose Refresh. Results When a payout request is made, the requester information is visible on the self-service and administrator dashboards for payouts. Task overview: Leave Payout (Including Self-Service) [page 193] Previous task: Enabling Attachments for Time Account Payout Requests [page 209] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 211 3.5.7.2 Leave Purchase Employees can ask to purchase additional leave by having deductions made to their pay. Configuration work is necessary to enable purchase leave. Restriction At this time, this feature is only available for Public Sector Australia. Purchased Leave Purchased leave allows employees to fund an additional period of leave through payroll deductions. In the setup, you designate the conditions for a purchase leave request, for example, how much or how often the employee can request to purchase leave. A deduction pay component is created for each request. The deduction can be a one-time deduction or a recurring deduction over a defined time period. Implementing and Configuring Deductions in Employee Central For information on how to make deductions from to an employee's salary, referer to the Implementing and Managing Deductions in Employee Central guide. Business Rules As part of the setup, you need to create business rules. See the Get Purchased Leave Quantity or Equivalent Quantity(in weeks) for Period procedure in the Implementing Business Rules in SAP SuccessFactors guide. Permissions Certain administrator and user permissions are necessary to purchase leave. Refer to the Permissions in Time Off section in this guide for information on setting up the necessary permissions. Note Pay particular attention to the permissions for recurring deductions. If recurring deductions are secured in your system, the person responsible for approving leave purchases must have the Create permission for recurring deductions. Refer to the Implementing and Managing Deductions in Employee Central guide for full information on deductions. 212 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Related Information Get Purchased Leave Quantity or Equivalent Quantity (in Weeks) for Period [page 625] 3.5.7.2.1 Creating Deduction Pay Components for Leave Purchase You create the means to deduct pay for leave purchase requests. Prerequisites You have permission to create pay components. Context Before a request can be made to purchase leave, you must create the pay component used to deduct from the employee’s payroll. This deduction pay component is added to the Time Account Purchase Profile settings. If your organization allows for multiple leave requests by employees in the same deduction period, you create multiple deduction pay components. Only one pay component can be used per deduction period. When you have another purchase with an overlapping deduction period, a new pay component is needed. If you allow different units of time to be purchased, for example hours and days, you create separate deduction pay components for each unit of time. If an employee makes multiple purchase requests having overlapping deduction periods, separate deduction pay components are used. Multiple deduction pay components are added to the purchase profile. For example: The first leave purchase request has the Purchase Deduction Period as June 1, 2020 to December 31, 2020. The second leave purchase has the deduction period as September 1 2020 to March 2021. Since these deduction period overlap, separate deduction pay components must be created and added to the purchase profile to save the purchased leave request for September 1 2020. Note For recurring deduction, the setting for the pay component has Is Earning set to No, Recurring set to Yes, and Pay Component Type set to Number. Restriction The unit of measure is populated according to the United Nations Centre for Trade Facilitation and Electronic Business (UN/CEFACT) Recommendations. When choosing hours as the Unit of Measure, the selection must be Hours (HUR). Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 213 Remember A currency value must be selected for pay components. For Purchase Leave, the frequency is required and should be populated with a new, delivered frequency value of TDP or Total Deduction Period. Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and select Manage Organization, Pay and Job Structures. 3. On the Create New field, enter Pay Component. 4. Make the following entries: Field Name Entry Effective as of <date> Purchase leave request can only be made after ef­ fective date. Pay Component ID <meaningful technical ID name> Name <meaningful name> Because this name will be shown when adding to the Time Account Purchase Profile, we rec­ ommend including Deduction Pay Component in the name. Description <meaningful description of the component> Status Active or Inactive Note that a purchase leave request can only be made of Active pay components. Pay Component Type Number Use Number as the type for deduction pay components. Units of Measure Days (DAY) or Hours (HUR) Caution When choosing Hours as the measure, ONLY HUR is used. Don’t use HRS or Hours. Is Earnings No No must be selected for deduction pay components. Currency <currency> A currency is required for deduction pay components. Frequency TDP - Total Deduction Period. This selection allows deductions to be evenly spread through the deduction period requested. 214 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Field Name Entry Recurring Select Yes The payroll deductions are made across the en­ tire time period selected in the request. Even when the deductions are taken out in one pay period you also select Yes. Purchase leave uses only the Recur­ ring Deduction portlet for integration Remember NOTE: For recurring deduction, the required setting of the pay component for Is Earning is set to No, Recurring set to Yes, and Pay Component Type set to Number. Display on Self-Service Yes or No When self-service is enabled for leave purchase, Yes allows the self-service user to view on the Recurring Deduction portlet. 5. Choose Save. Next Steps After the Deduction Pay Component is created, permissions must be granted to view or edit the pay component. See Assigning Administrator Permissions for Deduction Pay Components. Related Information Assigning Administrator Permissions for Deduction Pay Components [page 225] 3.5.7.2.1.1 Adding User Permissions for Deduction Pay Components Allow users to see their leave purchase deductions by adding permissions. Prerequisites A deduction pay component has been created. You have administrator access to manage permissions. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 215 Context Deduction Pay Components are used for leave purchase requests. The pay components are used to deduct from the employee pay. To allow employees to see their leave purchase deductions on the recurring deduction portlet, you must provide view permissions. Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and select Manage Permission Roles. 3. Select the employee role that is given the permission. The Permission Role Detail view is shown. 4. Choose Permission.... A Permission settings dialog box is shown. 5. Under User Permissions, select Employee Data. 6. Under the Pay Components category, locate the pay components created for the Purchase Leave entries. Remember A deduction pay component is created for each new purchase leave request. 7. Select the View checkbox to allow the permission for the role. 8. Choose Done. 3.5.7.2.2 Creating a Time Account Purchase Profile The profile defines the configuration elements that determine how your leave purchase policy is implemented. Prerequisites The following are needed to create a purchase profile: ● You must be assigned permission to create or edit a time account purchase profile ● Deduction Pay Components ● Purchase Validation Rules ● Workflow for the approval process (if necessary) 216 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Context You create a time account purchase profile that determines the attributes impacting the purchase leave request created by your users. These attributes reflect your organization’s policies for requests. For example, the purchase profile determines whether your users are allowed to select the deduction start date. It determines whether the deduction for purchased leave is one-time or prorated. You specify the number of pay components assigned to a profile to determine how many requests a user can make in a deduction period. The profile can be set up to only apply to a specific country/region. If an approval process for the request is needed, you assign the workflow to this profile. Procedure 1. Sign on to Employee Central as an administrator. 2. Go to the Admin Center and select Manage Data. 3. On the Create New field, enter Time Account Purchase Profile. A Time Account Purchase Profile view shows. 4. Make entries for the following depending on your requirements: Field Name Entry External Name (Mandatory) <meaningful name to describe the profile> Enter a name that is meaningful for all relevant languages; typically the language that applies to your selection of Country/Region. Country/Region (Optional) <Country/Region> Adding Country/Region restricts use to only those specified countries/regions. Workflow Configuration When a workflow approval is required for the profile, you select the workflow ID from the picklist. If no approval is required for this profile, leave No Selection. Equivalent Units Select the particular time interval that applies to the profile: None allows this profile to request a purchase of leave for time in time account units, for example, hours or days. Weeks allow this profile to purchase leave in multiples of the user’s typical work week. Note The unit of measure of the pay component associated to this purchase profile must match the unit of time account type that is assigned to this purchase profile. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 217 Field Name Entry Deduction Type (Mandatory) Assign how the deductions are assessed for this profile: One-time - When the total purchase amount is a single deduction. Prorated - When the total deduction amount of the purchased leave is distributed as equal amounts over all pay periods between the start and end dates of the deduction. Instructional Text This field can be used to enter instructional text and guidelines for your employees. That text shows on the UI of self-service leave purchase request. Use standard BB Code (Bulletin Board Code) to format text or add an https URL link. For example, Some [b]limitations[/b] apply. Review the purchase leave policies at [xurl]https:/mycompany.com/ HRpurchaseleave[/xurl] Information about the supported BB Codes is included in Creating Purchase Validation Rules. Allow users to select the Deduction Start Date Yes allows users to select a deduction start date at the time of submitting the request. No to set the Deduction Start Date equal to the Approval Date. External Code (Mandatory) <meaningful code name of the profile> The name is used as an external code for your time account purchase profile. Deduction Pay Components (Mandatory) Select deduction pay components previously created to assign to this profile. Note If you allow multiple leave purchases for an employee during the same deduction period, please specify more than one deduction code for the profile. The number of Deduction Pay Components assigned determines the number of requests allowed in a deduction period. 5. Choose Save. 218 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Next Steps To allow employee self-service, administrator must select Self- Service on the Eligibility field for the Time Account Type selected for the Time Account Purchase Profile. 3.5.7.2.2.1 Creating Error Messages for Time Account Purchase You create the error or warning messages that display when an employee requests a leave purchase. Context When employees enter their purchase leave request, validation business rules are executed. These rules enforce your organization's policy guidelines by displaying warnings or error messages. For example, your policy limits employees to creating a certain number requests a year. Another example is that employees are limited from purchasing more that certain amount during a time period. The steps for creating validation rules are provided in Creating Time Account Purchase Validation Rules. In that procedure, you create the rules that provide the message to be shown for invalid requests. Use the Message Definition to create messages that appear when these requests are created or edited. You create messages to meet your requirements. Use the following steps as an example to create error messages. Procedure 1. Sign on to Employee Central as an administrator. 2. Go to the Admin Center and choose Manage Data. 3. On Create New, select Message Definition. 4. In the Message Definition view, enter the text for the error message in the Text field. Note To format the text of the error message or include an https: URL link, use standard BB Code (Bulletin Board Code) markup language. See the table of supported BB Codes in the Adding Additional Validation Checks for Leave Requests topic. For this Example Scenario Enter this Text When employee entry exceeds time amount allowed for purchase. For example, Requested purchase must be less than or equal to [b]5[/b]. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 219 For this Example Scenario Enter this Text [xurl]https://mycompany.com/HRpolicy[/ xurl], When employee request exceeds the number of requests For example, You have [i]exceeded[/i] your allowed for a time period. purchase request limit for this period. [xurl]https://mycompany.com/HRpolicy[/ xurl] 5. Enter an External Code to describe the message definition. Remember The External Code must be unique and not used by any other message definitions. Otherwise, an error Code Already Exists displays. For this Example Scenario External Code Example When employee entry exceeds available time for payout. purchase_error_exceeds_limit When employee request exceeds the number of requests payout_error_exceeds_requests allowed for a time period. 6. Either copy and paste the code text in the Name field, or create a meaningful name to describe the error message. 7. For Status, use the default, Active. 8. For these scenarios, you don't enter Parameters. 9. Choose Save. A success message displays. Related Information Adding Additional Validation Checks for Leave Requests (for table of supported BB Codes) [page 120] 3.5.7.2.2.2 Creating Time Account Purchase Leave Validation Rules You define your company-specific validation rules to apply to leave purchase requests. Prerequisites You’ve created the warning or error messages for Time Account Leave Purchase in the Message Definition area of Manage Data. 220 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Context You use this rule scenario for purchase validation to generate a warning or error message. The relevant message is triggered whenever the administrator makes changes or when an employee enters data. When you create, cancel, or edit a leave request, the system performs certain checks. For example, an error displays when the request exceeds the number allowed for a time period. You also have the option to add more validation checks. You add validation checks using the rule scenario for leave purchase validation in the Time Account Purchase Profile object. Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and choose Configure Business Rules. 3. On the Business Rules Admin. view, choose + (Add). 4. On the Configure Business Rules view, expand Time Management. 5. From the expanded list, select Time Account Purchase Leave Validation. A Time Account Purchase Leave Validation dialog box is shown. 6. Enter the following: Field Entry Rule Name <name> An unique, understandable name to identify the rule. Rule ID <ID name> An unique technical name to identify the rule. Start Date <date> When the rule is activated. Description <description> Though optional, we recommend that you describe the purpose of this rule. 7. Choose Continue. A new view with the rule you created displays. 8. Use the IF condition of the rule to specify the conditions under which the message is raised. For example, you want the rule to check if the request is to purchase more leave than your policy allows for time period. The rule functions listed in the IF conditions can be used for that calculation. 9. For the THEN condition, add a Raise Message expression. Choose the relevant message and the level of severity (Error, Warning, or Info). If you want to format the text of the message, you can use any of these BBcodes: Use this BB code For this effect [b]...[/b] Bold [i]...[/i] Italics Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 221 Use this BB code For this effect [u]...[/u] Underline [s]...[/s] Strike through [size]...[/size] Font size [color]...[/color] Font color [center]...[/center] Center text [quote]...[/quote] Quote [url]...[/url] Link/Link name [xurl]...[/xurl] Link that opens in a new window/Link name [img]...[/img] Image [code]...[/code] Code [table]...[/table] Tables 10. You're free to add further ELSE conditions to the rule to trigger different messages under different conditions. 11. When you've completed your IF/THEN statement, choose Save from the bottom of the view. A success message displays at the top of the view. Next Steps Add the newly created rule to the purchase profile of the Time Account Type. Posting Instructions It is also necessary to create a business rule for leave quantity or equivalent period quantity. See the Related Links for you next step. Related Information Get Purchased Leave Quantity or Equivalent Quantity (in Weeks) for Period 222 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.7.2.2.3 Creating Time Account Leave Purchase Rules for Setting Dates and Quantities You define your company-specific business rules to set dates or quantities for leave purchase requests. Context When you create, cancel, or edit a leave purchase, the system performs certain checks. You use this rule scenario to set the quantities or dates for leave purchase according to your company-specific purchase leave policy. For example, creating a rule to specify the deduction start and end dates or setting specific quantities for leave purchase. You add the business rules to set certain values on Time Account Purchase Profile object. Procedure 1. Log on to Employee Central.as an administrator. 2. Go to the Admin Center and select Configure Business Rules. 3. On the Business Rules Admin. view, choose + (Add). 4. On the Configure Business Rules view, expand the Time Management rules scenario category. 5. From the expanded list, select the Time Account Purchase Leave Validation rules scenario. A Time Account Purchase Leave Validation dialog box shows at the top of the view. 6. Enter the following: Field Name Entry Rule Name <name> An unique, understandable name to identify the rule. Rule ID <ID name> An unique technical name to identify the rule. Start Date <date> When the rule is activated. Description <description> Though optional, we recommend that you describe the purpose of this rule. 7. Choose Continue. A <Rule Name> (<Rule ID>) view is shown. 8. Use the IF expression box to define the conditions of the rule. For example, the conditions of the start date for the deduction period. 9. From the Then expression box, select Set. Where you select Set, the second expression box field provides five options for Time Account Purchase: ○ Comment ○ Deduction Start Date ○ Deduction End Date Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 223 ○ Equivalent Unit Quantity ○ Quantity Create your Then condition using one of those selections. For example, the conditions of the end date for the deduction period. 10. When you've completed your IF/THEN statement, choose Save from the bottom of the view. Next Steps Add the newly created business rule to the Purchase Profile of Time Account Type. 3.5.7.2.2.4 Creating a Business Rule to Trigger a Workflow for Leave Purchase A business rule is required to trigger the approval process for a leave purchase request. Context When making time account purchase eligible for self-service, an approval process may be necessary to accept or decline the request. You create a business rule to prompt the workflow. Note These steps enable a workflow. These steps don't create a workflow. You create the workflow by following the procedures in Setting Up Workflows in the Employee Central Workflows: Implementation and Administration guide. Your created workflow is added to the purchase profile of the Time Account Type. Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and choose Configure Business Rules. The Business Rules Admin view shows. 3. Choose + (Create New Rule). Configure Business Rules view displays 4. From the list, expand Metadata Framework and choose Rules for MDF Based Objects. 5. In the Rules for MDF-Based Objects dialog box, enter the following: 224 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Field Entry Rule Name <meaningful display name> Rule ID <meaningful technical name> Start Date <date> Date when rule is enabled. Description <meaningful description> Base Object Time Account Purchase Purpose Workflow 6. And choose Continue. The details view for the business rule displays. 7. Choose the If row and select the Always True checkbox. 8. Under Then, choose the Pencil icon (Edit Expression). 9. Select Set from the dropdown. 10. In the Select Left Expression field, expand Workflow Context and choose Workflow Configuration. 11. Retain to be equal to and from the Value field, expand Leave Purchase Profile Time Account Purchase Time Account Type and select Workflow Configuration. 12. Choose Save. Results A success message displays and the rule is created. Next Steps Go to the Admin Center and choose Configure Object Definition. Open the Time Account Purchase object in correction mode. Assign the rule you've created to Save Rules. 3.5.7.2.3 Assigning Administrator Permissions for Deduction Pay Components A deduction pay component is created for each leave purchase request. For an administrator to view and edit these deduction pay components, additional permissions are necessary. Prerequisites A deduction pay component has been created. You have administrator access to manage permissions. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 225 Context When a leave purchase request is approved, a recurring deduction is created using the pay component to deduct an employee's pay. For each deduction pay component that is created, permissions are necessary for administrators to view and edit those components on the recurring deduction portlet. Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and select Manage Permission Roles. 3. Select the role that is given the permission. The Permission Role Detail view is shown. 4. Choose Permission.... A Permission settings dialog box is shown. 5. Under User Permissions, select Employee Data. 6. Under the Pay Components category, locate the pay components created for the Purchase Leave entries. Remember A deduction pay component is created for each new purchase leave request. 7. Select View and Edit checkboxes to allow those permissions to the role. 8. Choose Done. 3.5.7.2.3.1 Assigning Administrator Permissions for Leave Purchase Allowing administrators to create, edit, or cancel requests to purchase additional time off. Context To enable eligibility for the leave purchase function, you assign permissions to administrators. The administrators can then create, edit, or cancel leave purchase requests. Note All of the time objects are delivered as unsecured. We recommend that you secure them. Use Configure Object Definition to change security settings. 226 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Tip We recommend using the Time Management Object Permissions category for securing all of the time objects. Legacy systems might have the permissions currently located in Miscellaneous Permissions. Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and then select Manage Permission Roles. 3. On the Permission Roles list, select the administrator role to assign the permissions. Note The role, or roles, depends on how your company defines administrator tasks and responsibilities. The Permission Role Detail view for the selected role displays 4. Choose Permission… A Permissions setting dialog box is shown. 5. The following permissions depend on how your company defines administrator tasks and responsibilities, Assign your administrators the following permissions, as necessary: To Enable the Administrator to: Assign this Permission To view and edit Time Accounts. Go to A Time Account is created for an employee when the purchase leave is approved. The account contains the accrued balance of the deduction. User Permissions Miscellaneous Permissions . For Time Accounts, select one or more of these options depending on your requirements: ○ Visibility select View Allows the administrator to see time accounts. ○ Actions select Edit Allows the administrator to edit the time accounts for purchase leave. To view and edit Time Account Types. A Time Account Type is associated with the Time Ac­ count. Go to User Permissions Miscellaneous Permissions . For Time Account Types, select one or more of these options depending on your requirements: ○ Visibility select View Allows the administrator to see time account types. ○ Actions select Edit Allows the administrator to edit the time accounts types for leave purchase. To view and edit the Time Account Purchase Profile. Go to User Permissions Time Management Object Permissions and for Time Account Purchase Profile. Se­ To allow self-service for leave purchase, a Time Account lect one or more of these options depending on your re­ Purchase Profile object must be created and main­ quirements: tained. ○ Visibility select View Allows the administrator to see the Time Account Purchase Profile. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 227 To Enable the Administrator to: Assign this Permission ○ Actions select Edit Allows the administrator to edit the Time Account Purchase Profile. To Create Purchase in Self Service. Go to User Permissions Time Management User Permissions . Select the Create Purchases in Self-Service checkbox. The permission allows the employee, or by their manager, access to the Purchase dashboard to request a Purchase on the time balance of an eligible time account. To view Time Types. Go to User Permissions Permissions Time Management Object select one or more of these options for Time Types depending on your requirements: ○ Visibility select View Allows the administrator to see time types when re­ ○ Actions select Edit Allows the administrator to edit the time types. questing time account Purchase. To view and edit the Time Account Purchase Profile ob­ Go to User Permissions Time Management Object ject. Permissions To allow for leave purchase, a Time Account Purchase Time Account Purchase Profile depending on your require­ Profile object must be created and maintained. ments: select one or more of these options for ○ Visibility select View Allows the administrator to view time account Pur­ ○ Actions select Edit Allows the administrator to edit the object definition chase. for time account Purchase. To view and maintain Time Account Purchase Profile Go to User Permissions Time Management Object Leave Validation Rules object. Permissions This permission is for editing the delivered object defi- Time Account Purchase Profile Leave Validation Rules de­ nitions for time objects, for example, to enable custom pending on your requirements: fields, or add business rules, specific to your business logic. To manage the metadata framework object definitions for the Time Account Purchase Profile. ○ ○ ○ ○ ○ select one or more of these options for View Correct Create Adjust Order Delete Go to Administrator Permissions Metadata Framework select the following options depending on your requirements: ○ Configure Object Definitions Allows the administrator to manage Metadata Frame­ work (MDF) object definitions, for example, Time Ac­ count Purchase Profile. 228 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management To Enable the Administrator to: Assign this Permission Remember All of the time objects are delivered as unsecured. Se­ cure the Time Account Purchase Profile object using Configure Object Definition to make it available with role-based permissions. To provide access to the Purchase tab on Time Administrator Workbench. Go to Administrator Permissions Manage Time se­ lect one or more of these options depending on your re­ quirements: ○ Access Workbench Allows the user to access the Time Workbench in or­ der to maintain time-related objects. ○ Access Accounts Purchases Users with this permission can access the Account Purchases tab in the Time Workbench " To provide access to create, edit, and delete a Purchase request. Go to Administrator Permissions Manage Time Off select the option depending on your requirements: ○ Manage Purchase Leave Allows the administrator to create leave purchases for employees. 6. Choose Done to close the dialog box. 7. Choose Save Changes. Results The permissions are successfully saved. 3.5.7.2.3.2 Assigning User Permissions for Self-Service Leave Purchase Permissions are necessary for employees to access the self-service dashboard to view or request to purchase additional time off . Context There’s a self-service feature that allows employees to purchase additional time off through deduction to their pay. You assign permissions to users to allow creating leave purchase requests and to view information about the requests. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 229 Note All of the time objects are delivered as unsecured. We recommend that you secure them. Use Configure Object Definition to change security settings. Tip We recommend using the Time Management Object Permissions category for securing all of the time objects. Legacy systems might have the permissions currently located in Miscellaneous Permissions. Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and choose Manage Permission Roles. 3. Under the Permission Roles list, select the role, or create a new role, to assign the self-service permissions. The Permission Role Detail view for the selected role displays 4. Choose Permission… A Permissions setting dialog box is shown. 5. The following permissions are provided to users to view and request self-service leave purchase. Assign your users the following permissions, as necessary: To Enable the User to: Assign this Permission To view Time Accounts. Go to A Time Account is assigned to an employee and con­ tains the accrued balance of the various time types. To view Time Account Types. A Time Account Type are associated with the Time Ac­ count. User Permissions Permissions . For Time Accounts choose: ○ Visibility select View Allows the user to see eligible time accounts. Go to User Permissions Go to This object provides, for example, the associated ap­ Permissions To view Time Types. ○ User Permissions Go to ○ Time Management Object . For Time Account Purchase Leave: Visibility select View User Permissions Permissions To Create Leave Purchase in Self-Service. Miscellaneous Permissions , For Time Account Types choose: ○ Visibility select View Allows the user to see time account types. To view the Time Account Purchase Leave object. proval workflow to be applied to self-service requests. Miscellaneous Time Management Object . For Time Types: Visibility select View Allows the user to see the eligible time types. Go to User Permissions Time Management User Permissions . Select the Create Purchase Leave in SelfService checkbox to allow access to the dashboard for re­ 230 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management To Enable the User to: Assign this Permission questing a leave purchase. Additionally, if the Time Ac­ count Purchase object in your system is secured, users need the Edit permission for that object. To view the requester name and photo when the re­ quest for purchase leave isn’t made by the user. To view the requester in the self-service dashboard. Go to ○ ○ ○ ○ Go to ○ ○ User Permissions Employee Data . First Name select View Middle Name select View Last Name select View Photo select View User Permissions General User Permissions . Select the Company Info Access checkbox. Select the User Search checkbox Allows the user to see the requester name and photo in the self-service dashboard when the request for the leave purchase isn’t made by the user 6. Choose Done to close the dialog box. 7. Choose Save Changes. Results The permissions are successfully saved. 3.5.7.2.3.3 Enabling Requester Visibility in Time Account Leave Purchase Additional configuration is required for requester information to be shown in the self-service and administrator dashboards for leave purchase. Context You make the following configuration changes to the Visibility field in the time account purchase generic object. You manually enable the following fields, so that information about the requester of a time account purchase appears in the self-service and administrator dashboards for leave purchase. Remember Permissions for time account purchase must be granted for administrators and users. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 231 Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and choose Configure Object Definitions 3. On the Search field, select Object Definition, and in the next field, enter Time Account Purchase. 4. Choose Take Action Make Correction . 5. Go to the createdBy field and choose Details. A Details dialog box shows. 6. Scroll down to the Visibility field and select Read Only 7. Choose Done to save and close the dialog box. 8. Now, go to the createdDate field and choose Details. 9. Repeat the steps for changing Visibility to Read Only and choose Done. 10. Choose Save. Note To make the changes effective in the system, you must refresh the metadata. The next steps show you how. 11. Go back to the Admin Center and choose OData API Metadata Refresh and Export. 12. Choose Refresh. Results When a leave purchase request is made, the requester information is visible on the self-service and administrator dashboards for payouts. Related Information Assigning User Permissions for Self-Service Leave Purchase [page 229] 232 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.7.2.4 Allowing Attachments for Time Account Leave Purchase Requests Allow attachments to be included with leave purchase requests. Context When a request for leave purchase is made, by default, it isn't possible to add an attachment. To allow attachments to be submitted with a leave purchase request, you add a custom field and settings to the object definition. Note You’re only allowed to add one custom field to the object definition. Procedure 1. Log on to Employee Central as an administrator 2. Go to the Admin Center and choose Configure Object Definitions. 3. Enter Object Definition in the first field and enter Time Account Purchase in the second field. The Object Definition: Time Account Purchase view shows. 4. On Take Action, select Make Corrections. 5. Scroll down to the Database Field Name of customFields.customField1 and enter the following: Field Name Entry Name <meaningful name> For example, Attachment Maximum Length For example, 38 Data Type Attachment Visibility Select Editable to allow users to add attachments. Label <meaningful name that shows on the UI> For example, Supporting Document 6. Choose Save. Results An attachments area is visible in the time account leave purchase request area. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 233 3.5.7.2.5 Adding Consent Acknowledgment for Purchase Leave Deductions Settings enabling the acknowledgment process for purchased leave when employees must give consent before pay deductions are made. Context Some organizations are required to get the consent of an employee before making pay deductions. For purchase leave, requiring acknowledgment of consent is available in Time Account Purchase object definition as a delivered field. By default, the field isn’t activated. The following steps activate the acknowledgment field to record employee consent. Procedure 1. Log on to Employee Central as an administrator. 2. Go to the Admin Center and choose Configure Object Definitions. 3. Enter Object Definition in Search field and then enter Time Account purchase in the next field. The Object Definition: Time Account Purchase Leave view shows. 4. On Take Actions, select Make Corrections. 5. Under the Fields section, go to acknowledgment field and choose Details. A Details dialog box shows. 6. Go to the Visibility field and make a choice: Selection Comment Not Visible Default, as delivered, consent acknowledgment isn’t shown.E Editable Consent acknowledgment is shown, and the employee must give their consent on the UI to submit a request. Read Only Not recommended. If you choose this, the acknowledg­ ment field is available in the self service UI and is shown as read only in the Manage Data UI, so serves no purpose.. Note Acknowledgment should be enabled only if tracking employee consent to Yes is needed per your business requirements. 7. Go to the Label field and enter your text for the consent acknowledgment that employees are shown when making a leave purchase request. For example, I agree that this purchase results in deductions to my pay. 234 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note This field has character count limits of 255 characters. The label text is what is shown on the Purchase Request UI for the users. 8. Choose Save. Results Once the field is visible, your acknowledgment text shows when employees create a request to purchase time. If you’ve enabled this field, the employee must check an acknowledgment box to submit a request. 3.5.8 Time Account Snapshots Time account snapshots are records of time account data as they existed at a specific point in time. You can use these records in, for example, payroll processing. Snapshots are based on time account and compensation information. Here's how it works: 1. The snapshot calendar compiles all the time accounts that are open and bookable on balanceEffectiveDate (that is, the end date of the snapshot calendar), and then filters the employees using the compensation information. 2. A snapshot is generated of any employees with the pay group specified in the snapshot calendar. Based on the above logic, if pay group field is not enabled and/or if field is enabled but not maintained in Compensation Information of the employee, snapshot generation would not work. Enabling The Snapshot Feature Set the Snapshots Allowed field of the time account type to Yes. You can then create snapshots for any time accounts assigned to this time account type. Creating Time Account Snapshots You create the actual snapshot by using a time off calendar. To access the calendar function, go to the Admin Center and choose Manage Time Off Calendars. You then choose New Calendar and, having selected the snapshot option, enter the following information: ● A Name for the calendar run. ● Time Account Type Snapshots are aggregated per time account type. The time account type entered here must be one where you have set the Snapshots Allowed field to Yes. ● Start Date This is used to select the employees. Employees must have been active for at least one day, or assigned to this time account type for at least one day. ● End Date This is the date for which the snapshot is created. ● Run Date This is the date you want the calendar run to be executed. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 235 ● Pay Group The target group of users is selected according to the pay group you enter here. ● With Recalculation If you select this flag, the calendar run recalculates existing snapshots and adds missing snapshots. If you do not select this flag, the calendar run only adds the missing snapshots. ● Snapshot Flags ○ Snapshots As Of Pay Period End Select this if you want to have the relevant balance displayed on employee payslips. You can select both this and Snapshots As Of Accounting Period End. The field disappears if you select Outdated Only. ○ Snapshots As Of Accounting Period End Select this if you want to have your business's leave liability towards the employee calculated. You can select both this and Snapshots As Of Pay Period End. ○ Outdated Only If you select this, the other snapshot flags disappear and the calendar run is used only to update existing snapshots marked as outdated by payroll integration as of the given date and the given pay group. In such cases, no selection by means of job info can take place. Look at the Calendars in Time Off documentation for full information on how to use Time Off calendars. And take a look at the Integrating Time Off and Employee Central Payroll guide for full information on the integration process. Related Information Time Account Type [page 722] Time Account Snapshot [page 721] 3.5.9 Country/Region-Specific Features for Time Off Learn which aspects of Time Off you can manage on a country/region-specific basis. You configure your individual time objects in the Admin Center under Configure Object Definition. Certain time objects have a Country/Region field, and by entering a country/region here you make the object specific to that country/region. If you leave the field blank, then the object is automatically valid for all countries/regions. Here are all the time objects you can designate as country/region-specific: ● Absence Counting Method ● Holiday ● Holiday Calendar ● Time Account Type ● Time Type ● Work Schedule ● Work Schedule Day Model Please keep the relationships between certain time objects in mind when doing this, as otherwise you might not be able to assign them to each other afterwards. For example, let's say you create a holiday calendar for the U.S. To this calendar, you can assign: 236 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● Holidays that are valid for all countries/regions (for example, Christmas Day) ● Holidays that are valid for the U.S. only (for example, Independence Day) However, you can't assign a holiday that is specific to Australia. Likewise, if you create a holiday calendar that is valid for all countries, you can only assign holidays that are also valid for all countries/regions. You couldn't, for instance, assign "Independence Day" to such a holiday calendar, since this holiday is U.S.-only. Note The objects Holiday Calendar, Time Profile, Work Schedule, and Work Schedule Day Model can be assigned to an employee's job information. If you designate any of these objects as country/region-specific, then you can only assign them to employees whose company (legal entity) is also set as that country/region. 3.5.9.1 Australia For Australia, the Time Off solution has been enhanced to use the Advance Leave Payment, and Leave Loading. It is possible to configure and use the Advance Leave Payment option for Australia. Advance Leave Payment refers to advancing one or more periods of the net pay to the employee, when the employee is going to be absent in the subsequent pay day(s). It is possible to configure and use the Leave Loading option for Australia. Leave Loading is an extra payment that employees are entitled on top of the annual leave pay. Leave Loading payments are paid to provide monetary assistance when employees go on vacation. Configuration ● Take a look at Creating Time Type for Advance Leave Payment [page 249] for information on creating the Time Type specific to Australia. ● Take a look at Create a Business Rule for Pay Date validation [page 250] for information on creating a business rule for pay date validation. ● Take a look at Create a Business Rule for Fiscal Year Validation [page 252] for information on creating a business rule for fiscal year validation. ● Take a look at Creating Time Account Type for Leave Loading [page 243] for information on creating the Time Account Type specific to Australia. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 237 3.5.9.1.1 Requesting for Advance Leave Payment as an Employee(ESS) Request for the Advance Leave Payment from the Time Off tile in the Home page. Context An employee wants to request for advance payment for the leave in the upcoming days. If the leave spans across the change in the financial year, the employee can also split this payment across the financial year, due to changing tax implications in the new financial year. Procedure 1. Go to the Time Off tile in the Home Page. 2. Click on New Absence. 3. Select the Time Type from the drop down. 4. Enter the <Start Date> and the <End Date> of the absence. 5. Under the Additional Leave Information for Australia select the Request Advance Pay as Yes to request for the advance leave payment and Split Pay Across Financial Year as Yes if you would want to split the advance payment across the financial year due to changing tax implications. In the case of integration of the Time Off solution to Employee Central Payroll, the <Request Advance Pay> and <Split Pay Across Financial Year> under the Additional Leave Information for Australia are replicated to the Employee Central Payroll. Note The option to Split Pay Across Financial Year is applicable only for public sector employees in Australian payroll. For more information on what happens in Australia payroll in case of replication to Employee Central Payroll , see SAP Note 2882536 6. Click on Submit button. 238 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.9.1.2 Requesting for Advance Leave Payment on behalf of an Employee(MSS) Request for the Advance Leave Payment on behalf of the employee from the employee'sPeople Profile . Context An admin can request for the advance leave payment on behalf of the employee and also request to spilt this payment across the financial year, due to changing tax implications in the new financial year, if the leave spans across the financial year. Procedure 1. Go to Administer Time in the Time management of the employee's People Profile. 2. Click on New Absence. 3. Select the Time Typefrom the drop down. 4. Enter the <Start Date> and the <End Date> of the absence. 5. Under the Additional Leave Information for Australia select the Request Advance Pay as Yes to request for the advance leave payment and Split Pay Across Financial Year as Yes if you would want to split the advance payment across the financial year due to changing tax implications. In the case of integration of the Time Off solution to Employee Central Payroll, the <Request Advance Pay> and <Split Pay Across Financial Year> under the Additional Leave Information for Australia are replicated to the Employee Central Payroll. Note The option to Split Pay Across Financial Year is applicable only for public sector employees in Australian payroll. For more information on what happens in Australia payroll in case of replication to Employee Central Payroll , see SAP Note 2882536 6. Click on Submit button. Tip In the employee's Time Off overview screen, the admin can also view the requests that are already submitted and edit the requets. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 239 3.5.9.1.3 Leave Loading Leave Loading is an extra payment that employees are entitled on top of the annual leave pay. Leave Loading payments are paid to provide monetary assistance when employees go on vacation. Restriction At this moment, this feature is available only for Public Sector Australia. The Leave Loading scenarios are only relevant for public sectors in Australia, and the payout is calculated as a percentage, usually 17.5%, of an employee’s salary. Take a look at Leave Loading [page 240]. 3.5.9.1.4 Leave Loading You can now provide an extra payment for eligible employees on top of their annual leave pay. Restriction At this moment, this feature is available only for Public Sector Australia. You can use the Leave Loading functionality to: ● Configure request periods that let employees and managers create stand-alone payout requests through Employee Self-Service and Manager Self-Service respectively. ● Set the calculation periods that calculates the entitlement hours within the defined period. ● Define the pay component type for Leave Loading requests and reconciliation jobs. ● Configure and run year-end jobs to process payment requests that aren’t manually created through standalone requests from ESS or MSS pages. ● Configure and run year-end reconciliation jobs who aren’t eligible for Leave Loading. Leave Loading requests can be created on the occurrence of two situations: ● When eligible employees manually request payments during the Leave Loading year from Employee SelfService or Manager Self-Service. ● Automatically at the end of each Leave Loading year for the entitled leave from the current or previous year without requests. Note Employees who are leaving the company can request their Leave Loading payout manually from the Employee Self-Service or their managers can request it from the Manager Self-Service . The Leave Loading business scenario requires the following modules to be set up and running in your landscape: ● Employee Central to enable and configure Leave Loading. ● Employee Central Time Management to calculate entitlement hours. ● Employee Central Payroll to process payment requests. However, the actual payment processing is based on the Australian taxation or other laws that occur in the payroll system. 240 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 1. Enabling Leave Loading [page 241] To be able to configure leave loading payments for your employees, you need to first enable system settings for your organization from Admin Center. 2. Creating Pay Component for Leave Loading [page 242] Configure a pay component in Employee Central system that is used to pay Leave Loading in an employee's compensation package. 3. Creating Time Account Type for Leave Loading [page 243] Enable Time Account Type(s) for the Time Account Type to be included in the leave loading calculations for Australia. 4. Setting Up Country-Specific Fields in BCUI to Determine Eligible Employees for Leave Loading [page 244] Set the is-eligible-for-leave-loading field from BCUI, and then set field-level permissions to indicate if the employee is eligible to request Leave Loading payments. 5. Configuring Leave Loading Periods [page 245] Configure leave loading to define payout year, calculation periods, and request periods for entitled employees to raise their Leave Loading payment requests. 6. Configuring Year-End Processing Jobs for Leave Loading [page 247] HR admins can schedule a job that automatically creates Leave Loading requests for eligible employees who haven’t requested their payouts for the Leave Loading year. 3.5.9.1.4.1 Enabling Leave Loading To be able to configure leave loading payments for your employees, you need to first enable system settings for your organization from Admin Center. Procedure 1. Go to Company System and Logo Settings from Admin Center. 2. In the Company System Setting section, enable Leave Loading. 3. Save your changes. Task overview: Leave Loading [page 240] Next task: Creating Pay Component for Leave Loading [page 242] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 241 3.5.9.1.4.2 Creating Pay Component for Leave Loading Configure a pay component in Employee Central system that is used to pay Leave Loading in an employee's compensation package. Prerequisites You've configured the required fields in the Corporate Data Model for pay components. Remember As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your implementation partner. If you're no longer working with an implementation partner, contact Product Support. Context Choose to create a new pay component for Leave Loading, or adjust an existing data to meet the requirements. Note You can't adjust an existing pay component if it’s already assigned to a Leave Loading configuration. A separate pay component is required for Leave Loading requests and reconciliation jobs to ensure that different payroll processing are followed in the system. Procedure 1. Go to Manage Organization, Pay and Job Structures from Admin Center. 2. If you want to create a new pay component, choose Pay Component from the Create New dropdown. 3. Enter a date from which the pay component to be valid. 4. Enter a name for the pay component. 5. Set the availability to Active from the Status dropdown. 6. Choose Use for Leave Loading Only as the pay component type. 7. Choose Hours (HR) as the Unit of Measure. 8. Choose Yes for the Is Earning and Can Override fields. 9. Choose AUD as the Currency. 10. Choose Annual (ANN) as the Frequency. 11. Choose No for Recurring as it's a one-time payment. 12. Optional: Set other pay component attributes depending on your business needs. 242 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 13. Save your changes. 14. Follow the same procedure and create a pay component to use for reconciliation jobs. Task overview: Leave Loading [page 240] Previous task: Enabling Leave Loading [page 241] Next task: Creating Time Account Type for Leave Loading [page 243] Related Information Set Up Additional Pay Component Attributes Field Configuration in Data Model 3.5.9.1.4.3 Creating Time Account Type for Leave Loading Enable Time Account Type(s) for the Time Account Type to be included in the leave loading calculations for Australia. Context The user will be eligible for leave loading if the Time Account Type created or modified here is assigned to the Time Profile of the user. Procedure 1. Go to Admin Center and choose Manage Time Off Structures under Time Management. 2. Select the Time Account Type option from the Create New drop down. 3. Select the <Country/Region> as Australia. The Time Account Type Settings for Australia section is dispalyed. 4. Select the <Include in Leave Loading Calculations> to Yes. 5. Enter all the other mandatory and relevant fields and save the Time Account Type. Task overview: Leave Loading [page 240] Previous task: Creating Pay Component for Leave Loading [page 242] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 243 Next task: Setting Up Country-Specific Fields in BCUI to Determine Eligible Employees for Leave Loading [page 244] Related Information Time Account Type [page 722] 3.5.9.1.4.4 Setting Up Country-Specific Fields in BCUI to Determine Eligible Employees for Leave Loading Set the is-eligible-for-leave-loading field from BCUI, and then set field-level permissions to indicate if the employee is eligible to request Leave Loading payments. Context If you want to run Leave Loading jobs for shift employees, you need to set is-shift-employee from BCUI. Procedure 1. Go to Manage Business Configuration from Admin Center. 2. Expand Employee Central HRIS Elements , and choose compInfo. 3. In the HRIS fields section, click the dropdown of any textbox, and locate is-eligible-for-leave-loading. 4. Optional: Change the label name. 5. Choose Yes from the Enabled dropdown. 6. Fill out additional optional fields based on your business requirements. 7. To indicate if the employee works in shift, expand jobInfo for the country/region Australia. Note If an HRIS element specific to Australia isn’t configured, use Configure New Country option in BCUI to define a set of fields specific to Australia. 8. In the HRIS fields section, click the dropdown of any textbox, and locate is-shift-employee. 9. Optional: Change the label name. 10. Choose Yes from the Enabled dropdown. 11. Fill out additional optional fields based on your business requirements. 244 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 12. Save your changes. Next Steps Set the view, edit, and insert permissions for the Is Eligible for Leave Loading item from the Employee Central Effective Dated Entities permission category. Task overview: Leave Loading [page 240] Previous task: Creating Time Account Type for Leave Loading [page 243] Next task: Configuring Leave Loading Periods [page 245] Related Information Set Field-Level Permissions Additional Field-Level Configuration Options Using BCUI Country-Specific Fields in BCUI 3.5.9.1.4.5 Configuring Leave Loading Periods Configure leave loading to define payout year, calculation periods, and request periods for entitled employees to raise their Leave Loading payment requests. Prerequisites ● You've enabled Manage Leave Loading from Metadata Framework permission. ● You've enabled edit and view permissions for Leave Loading Configuration from Miscellaneous Permissions. ● You've created pay component of type Use for Leave Loading Only for Leave Loading requests and reconciliation jobs. Context Choose to create a new configuration for Leave Loading, or adjust an existing configuration. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 245 Note You can't adjust or delete an existing configuration if Leave Loading requests have been already created. While configuring Leave Loading for different year periods, the leading practice is to maintain a chronological order of years in the system. For example, configuration for the year 2019 to be created before the year 2020. Procedure 1. Go to Manage Leave Loading from Admin Center. 2. If you want to create a new leave loading object definition, choose Leave Loading Configuration from Create New dropdown. 3. If you want to adjust an existing object definition to meet your business needs, perform the following steps. Otherwise, skip this step. a. Choose Leave Loading Configuration object definition from the first Search text box, and then choose the object instance that you want to modify. b. Choose Take Action Make Correction . c. Adjust the pay component with all the required inputs. 4. Enter a unique business key for the Leave Loading object in External Code. 5. Enter the Leave Loading period year. 6. Enter the calculation periods (start and end dates) for Leave Loading requests. Note You can also set the calculation periods with a future end date. 7. Enter start and end request periods. The End Date must be set before the year-end processing jobs. Note Users can submit their requests on Employee Self-Service and Manager Self-Service pages within the given request periods. 8. From Leave Loading Pay Component, choose a pay component created for Leave Loading requests. 9. Choose an appropriate Reconciliation Pay Component for reconciliation job. Note This pay component is used if you have configured reconciliation jobs. 10. Save your changes. Results Employees can use the Request Leave Loading option from People Profile to submit Leave Loading payout requests within the configured request periods. 246 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● Users can submit their Leave Loading payout requests from Employee Self-Service page (ESS). ● Managers can submit requests for their direct reports from Manager Self-Service page (MSS). Note Users can create only one Leave Loading request per configured period. Once a request is submitted, it can't be changed or deleted. Next Steps Verify the details of an employee's request during a Leave Loading period from Manage Leave Loading Employee Leave Loading Period . You can check the requested date, hours entitled, source of request and other details for the user. Task overview: Leave Loading [page 240] Previous task: Setting Up Country-Specific Fields in BCUI to Determine Eligible Employees for Leave Loading [page 244] Next task: Configuring Year-End Processing Jobs for Leave Loading [page 247] 3.5.9.1.4.6 Configuring Year-End Processing Jobs for Leave Loading HR admins can schedule a job that automatically creates Leave Loading requests for eligible employees who haven’t requested their payouts for the Leave Loading year. Prerequisites ● You have edit/view permissions for Leave Loading Year-End Job Configuration item in Miscellaneous Permissions category. ● A dynamic group is created from Manage Employee Groups page. It is required if you want to run year-end jobs for a specific group of employees. Context You can choose to create multiple jobs with the same year-end job configurations. You can execute year-end jobs for the following scenarios: Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 247 ● Shift and nonshift employees together ● Nonshift employees only ● All eligible employees without manual requests ● Reconciliation jobs ● Dynamic groups of employees ● Terminated employees Procedure 1. Go to Admin Center Manage Leave Loading . 2. Choose one of the following options based on your requirements. ○ To create a new year-end job, choose Leave Loading Year-End Job Configuration from Create New dropdown. ○ To adjust an existing job configuration, or to add additional jobs to an existing year-end configuration job, choose Leave Loading Year-End Job Configuration from the first Search text box, and then choose the job name that you want to modify. 3. If you choose to create a new job, enter a name for the configuration job. Job configuration ID is an auto-generated ID created by the system. 4. From Execution Type drop down, choose the type of employees you want to run the job. 5. Optional: If you choose Dynamic Group, enter the unique ID of the user group. 6. In the Year-End Jobs section, create multiple jobs for different Leave Loading years. 7. Save your changes. 8. If you want to adjust an existing job configuration, perform the following steps. Otherwise, skip the step. a. Choose Take Action Make Correction . b. Make all the changes as required. c. Save your changes. Results The year-end job is immediately submitted. Next Steps Verify the status of each job in complete detail by using the Details link corresponding to each job on the Leave Loading Year-End Job Configuration page. Task overview: Leave Loading [page 240] 248 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Previous task: Configuring Leave Loading Periods [page 245] 3.5.9.1.5 Advance Leave Payment Advance Leave Payment refers to advancing one or more periods of the net pay to the employee, when the employee is going to be absent in the subsequent pay day(s). The request for an advance payment for the absence can be requested by the employee themselves or even by HR admins. In the current release, the advance leave payment can be requested based on the configuration. However, typically it is applicable for the below leave types: ● Recreational/Annual Leave. ● Long Service Leave. When requesting for the advance payment, there is an option to allow the split of the advance payment across the financial year. This is essential in case the absence requested by the employee is spanning across the financial year change. In the new financial year, the employee may have different tax implications and hence the option is available to split the advance payment across the financial year. 1. Creating Time Type for Advance Leave Payment [page 249] Create a Time Type for the Advance Leave Payment for the country Australia, so that the employees or the HR admins will be allowed to request for it. 2. Create a Business Rule for Pay Date validation [page 250] A business rule can be created to check if the pay date falls outside the start date and the end date of the leave for which the advance leave payment is being requested. 3. Create a Business Rule for Fiscal Year Validation [page 252] A business rule can be created to check if the start date and the end date of the leave for which the advance leave payment is being requested falls in the same fiscal year or across two fiscal years. 3.5.9.1.5.1 Creating Time Type for Advance Leave Payment Create a Time Type for the Advance Leave Payment for the country Australia, so that the employees or the HR admins will be allowed to request for it. Context When requesting for Time Off, if the Time Type selected is the one we are creating here, the option to request for the advance leave payment will be shown to the users. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 249 Procedure 1. Go to Admin Center and choose Manage Time Off Structures under Time Management. 2. Select the Time Type option from the Create New drop down. 3. Enter a meaningful <External Name> and select the <Country/Region> as Australia. The Time Type Information for Australia section is dispalyed. 4. Select the <Advance Leave Payment Allowed> to Yes. The <Split Across Financial Year Allowed> should appear. 5. Optionally, if applicable, select the <Split Across Financial Year Allowed> to Yes to allow the employees to select this option when requesting for the advance leave payment. 6. Enter all the other mandatory and relevant fields and save the Time Type. Note Country/Region specific localization for Time Type is supported only with Unspecified as the Absence Class. Next Steps For more information on the Absences Infotype, see Absences (Infotype 2001) - Australia For more information regarding the payroll processing, please refer to the Advance Payment Reporting section in the Payroll Australia guide. Task overview: Advance Leave Payment [page 249] Next task: Create a Business Rule for Pay Date validation [page 250] 3.5.9.1.5.2 Create a Business Rule for Pay Date validation A business rule can be created to check if the pay date falls outside the start date and the end date of the leave for which the advance leave payment is being requested. Context When requesting for an advance leave payment, there may be a need of the pay date being within the start date and end date of the leave. You can create a business rule to display a message if the pay date falls outside the start date and end date of the absence. 250 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note This is an optional configuration to be done based on the requirement of the customers. Procedure 1. Log on to Employee Central as an administrator. 2. Go to Admin Center and then to Configure Business Rules. The Business Rules Admin view displays. 3. Choose + (Create New Rule). Configure Business Rules view displays 4. From the list, expand Time Management and choose Absence Validation. 5. In the Absence Validation dialog box, enter the following: Field Entry Rule Name <meaningful display name> Rule ID <meaningful technical name> Start Date <date> Date when rule is enabled. Description <meaningful description> 6. And choose Continue. The detailed view for the business rule displays. 7. In the Variables and the If blocks enter the details as shown in the image below. 8. In the Then block, select the output type as Raise Message and choose the Message created as per your requirement. Select the Severity of the message as per your requirement. 9. Click on Save. A Successfully Saved message displays and the rule is created. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 251 Next Steps The rule created needs to be selected in the Take Rules section of the Time Type. Task overview: Advance Leave Payment [page 249] Previous task: Creating Time Type for Advance Leave Payment [page 249] Next task: Create a Business Rule for Fiscal Year Validation [page 252] Related Information Creating a Rule That Raises a Message Creating a MessageDefinition Object 3.5.9.1.5.3 Create a Business Rule for Fiscal Year Validation A business rule can be created to check if the start date and the end date of the leave for which the advance leave payment is being requested falls in the same fiscal year or across two fiscal years. Context When requesting for advance leave payment, there may be a need to display a message to the user if the payment will be split across fiscal years or not, depending on the start date and end date for which the absence is being requested and if these dates fall within the same fiscal year or across two fiscal years. Note This is an optional configuration to be done based on the requirement of the customers. Procedure 1. Log on to Employee Central as an administrator. 2. Go to Admin Center and then to Configure Business Rules. The Business Rules Admin view displays. 3. Choose + (Create New Rule). Configure Business Rules view displays 252 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 4. From the list, expand Time Management and choose Absence Validation. 5. In the Absence Validation dialog box, enter the following: Field Entry Rule Name <meaningful display name> Rule ID <meaningful technical name> Start Date <date> Date when rule is enabled. Description <meaningful description> 6. And choose Continue. The detailed view for the business rule displays. 7. In the Variables and the If blocks enter the details as shown in the images below. Sample Rule for checking when the start date and end date of absence is within the same fiscal year. Sample Rule for checking when the start date and end date of the absence is across two different fiscal years. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 253 8. In the Then block, select the output type as Raise Message and choose the Message created as per your requirement. Select the Severity of the message as per your requirement. 9. Click on Save. A Successfully Saved message displays and the rule is created. Next Steps The rule created needs to be selected in the Take Rules section of the Time Type. Task overview: Advance Leave Payment [page 249] Previous task: Create a Business Rule for Pay Date validation [page 250] Related Information Get Fiscal Year Start or End Date Creating a Rule That Raises a Message Creating a MessageDefinition Object 254 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.9.2 Canada For the country/region Canada, the Time Off solution has been enhanced with the feature to request sick leave absence for employees with short-term disability. Configuration Requirements You need the Employee Central Time Off Solution. 3.5.9.2.1 Short-Term Disability Absence in Canada Short-term disability absence is a sick leave that employees are entitled to when they're unable to report to work for a relatively long duration due to an illness or a disability. When an employee is unable to report to work for a relatively long duration as compared to a normal sick leave due to an illness or disability, the admin can create a policy-based short-term disability absence for the employee. The process of a short-term disability absence works as follows: ● There is a policy set in the organization for the absence of type short-term disability. ● An employee reports that he or she will be absent from work due to an illness or disability for a relatively long duration. ● The HR administrator creates a policy-based short-term disability absence on behalf of the employee in the system. Remember Typically, there may also be a scenario where the first few days of the absence can be recorded as normal sickness leave and subsequently upon receipt of the doctor's certificate, the short-term disability absence can be created from the next day onwards. In such a scenario, there are two absences. The first one is a normal sickness leave and the second is the short-term disability absence. ● When requesting the absence, apart from the start and end dates of the absence, the admin can record up to three additional dates to capture the end dates of the respective disability periods, from the start date of the absence that is of the short-term disability type. Note The admin has the option to default these dates based on the policy set in the company for the shortterm disability absence or enter the dates manually. Restriction A Short-term disability absence is for a relatively long duration as compared to the normal sick leave absence. Recurring absences on the other hand are for shorter durations and recurring in nature with multiple occurances. It is recommended that the functionality of short-term disability absence is not used together with the functionality of recurring absence. The occurance of more than one short-term disability absence, when used together with the recurring absence functionality, will result in quite a long period of Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 255 absence. The system will propose incorrect disability period end dates for the recurring absence of shortterm disability and this will need manual correction of dates by the HR administrator. In order to request the short-term disability absence, the employee's time profile must have a Time Type associated to it, which is relevant for the short-term disability absence. Take a look at Time Type [page 743] for information about what you need to do in the objects. 3.5.9.2.1.1 Creating a Time Type for Short-Term Disability Absence in Canada Create a Time Type that is relevant for the short-term disability absence in Canada, so that it can be associated with the Time Profile assigned to the employees who want to request this absence. Context Each organization can have its own policy for the short-term disability absence and based on that policy you can configure the duration of the disability periods for the short-term disability absence of the employee. Based on the duration of these disability periods, the admin is allowed to record up to three additional dates indicating the end of the disability periods from the start date of the absence. Procedure 1. Go to Admin Center and under Time Management choose Manage Time Off Structures. 2. From the Create New dropdown list, select the Time Type option. 3. Enter a meaningful <External Name> and select Canada in the <Country/Region> field. The Time Type Information for Canada section is displayed. 4. Select Short-term disability as the <Sickness Variant>. The fields to capture the duration of disability periods based on your organization's policy for the shortterm disability absence of the employees appear. 5. Enter values in the <Duration of Disability Period One (in days)>, <Duration of Disability Period Two (in days)> and <Duration of Disability Period Three (in days)> fields that are based on the policy for short-term disability absence in your organization. Note These fields are not mandatory. The values in these fields can be configured if you want to create short-term disability absences that have the end dates for the disability periods in accordance with the company's policy. However, ○ If you choose to enter values in these fields, it is mandatory to follow the sequence. For example, you cannot configure <Duration of Disability Period Two (in days)> without entering a value in <Duration of Disability Period One (in days)>. 256 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ○ If you leave these fields empty, the system will not propose the end dates for the disability periods when requesting short-term disability absence for this Time Type. 6. Select Absence as the <Classification>. 7. Select Sickness as the <Absence Class>. 8. Enter all the other mandatory and relevant fields and save the Time Type. Next Steps The Time Type created must be associated with the Time Profile of the user for the user to be eligible for the short-term disability absence. Note Set the Enabled in employee self-service scenario to No for the time type created, as only HR administrators must request for this absence. 3.5.9.2.1.2 Requesting an Absence for Short-Term Disability The HR administrator can request the short-term disability absence for the employee by following the below steps. Prerequisites ● You’ve familiarized yourself with the Assigning Time Objects to Employees Manually documentation. ● The Time Type relevant for the short-term disability absence exists and is associated to the Time Profile of the employee. ● You’ve familiarized yourself with the Employee Time [page 694] documentation for information about the objects. Context When an employee reports that he or she won’t be able to come to work for a relatively long duration due to an illness or a disability that may have occurred as a result of an accident, you can create an absence for shortterm disability on behalf of the employee. This absence is based on a policy defined by your organization. Based on this policy, the duration of the disability periods must be configured in your system. Restriction At this moment, only the HR administrator should request for the short-term disability absence. The ESS option for requesting this absence is not supported. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 257 Procedure 1. Go to the employee's People Profile and under Time Management choose Administer Time. 2. You then see the employee's Time Off overview. Choose Create Absence. This brings up the New Absence window for the employee. Note The fields under Additional Leave Information for Canada only appear when the Time Type is country/ region-specific to Canada and the Absence Class in the Time Type is Sickness. 3. Now, make these entries: ○ <Time Type> for short-term disability. ○ <Start Date> and <End Date> for the absence being requested. ○ For the fields under the Additional Leave Information for USA, you can set the end dates of the disability periods based on the policy configured in the Time Type, by choosing the Set Disability Period Policy Dates button. ○ Alternatively, you can also choose to enter these end dates manually depending on the situation of the employee. Note The dates that are manually entered here can also be before the start date of the absence. However, it’s important that the <Disability Period Two End Date> is after the <Disability Period One Date> and the <Disability Period Three End Date> is after the <Disability Period Two Date.> 4. Once all the entries are made, submit the entries on this page. Tip In the employee's Time Off overview screen, the admin can also view the requests that are already submitted and edit the requests. 3.5.9.3 Colombia It is possible to configure and use a continued pay feature specific to Colombia. Configuration ● The Assigning Time Objects to Employees Manually documentation describes the process. ● Take a look at the Time Type documentation for information on what you need to do in the objects. ● Employee time objects Take a look at the Employee Time Time Off Data Object documentation for information on the objects. 258 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ● Employee time groups Use this to group the sicknesses you want to treat as identical. Take a look at the Employee Time Group Time Off Data Object documentation for information on what you need to do in the objects. What You Need To Do 1. First, you create a country/region-specific time type for Colombia. To do this, go to the Admin Center and choose Manage Time Off Structures 2. Create a country/region-specific time type for Colombia, with Sickness as the Absence Class. 3. With your configuration done, you can now create absence requests based on this object. To do this, go the employee's People Profile and choose Administer Time. 4. You then see the employee's Time Off Overview. Choose New Absence. This brings up the New Absence window for the employee. 5. With your entries made, choose Link additional absence. 6. In the resulting screen, make the following entries: ○ Reason At this time, only Identical is available. ○ Absence Use the dropdown to display absences with type Sickness and choose the one you require. 7. When you're done, save your entries. You can then see the new absences under Time Record with a linking icon. Click that icon to view the linked absences. Notes on Absence Linking Scenarios Scenario 1: I have 3 or 4 absences in my system, but only 2 are linked. What happens if I link another absence? The additional absence appears as a linked absence also. Scenario 2: What happens if I unlink or cancel an absence in a group of linked absences? The absence so removed no longer appears as a linked absence. Scenario 3: What happens if I have two linked absences and unlink or cancel one of them? The group to which it belongs is dissolved. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 259 3.5.9.4 Germany It is possible to configure and use a continued pay feature specific to Germany. Configuration ● The Assigning Time Objects to Employees Manually documentation describes the process. ● Take a look at the Time Type documentation for information on what you need to do in the objects. ● Employee time objects Take a look at the Employee Time Time Off Data Object documentation for more information. ● Employee time groups Use this to group the sicknesses you want to treat as identical. Take a look at the Employee Time Group Time Off Data Object documentation for more information. Using Continued Pay 1. First, you create a country/region-specific time type for Germany. To do this, go to the Admin Center and choose Manage Time Off Structures 2. Create a country/region-specific time type with Sickness as the Absence Class. 3. With your configuration done, you can now create absence requests based on this object. To do this, go the employee's People Profile and choose Administer Time. 4. You then see the employee's Time Off Overview. Choose New Absence. This brings up the New Absence window for the employee. The fields under Continued Pay Information only appear when the time type is country/region-specific to Germany and the absence class in the time type is Sickness. 5. Now make these entries: ○ Time type with absence class Sickness and country Germany ○ Start date and end date for the absence being requested ○ Appropriate continued pay information ○ Days Credited for Continued Pay ○ End of Continued Pay ○ Start Date of Sick Pay Supplement ○ End Date of Sick Pay Supplement ○ Certified Start Date of Sickness 6. With your entries made, choose Link additional absence button. 7. In the resulting screen, make the following entries: ○ Reason Choose between Overlapping and Identical. ○ Absence Use the dropdown to display absences with type Sickness and choose the one you require. 8. When you're done, save your entries. 260 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management You can then see the new absences under Time Record with a linking icon. Click that icon to view the linked absences. 3.5.9.4.1 Creating a Time Type for Calculating Sick Pay Dates You can create a time type for sick leave that allows the system to propose dates for continued sick pay and the sick pay supplement when requesting sick leave for an employee. Prerequisites Before you can configure your system to propose dates for continued sick pay and the sick pay supplement, your account executive must have enabled this feature in your instance. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Select the Time Type option from the Create New dropdown list. 3. Enter a meaningful External Name and select Germany (DEU) as the Country/Region. The Time Type Information for Germany section is displayed. 4. Choose the relevant Sickness Variant from the dropdown list depending on whether or not you would like the system to propose dates for continued pay and the sick pay supplement. Sickness Variant Use With Manual Entry of Sick Pay Dates The system can't propose dates for continued pay or the sick pay supplement. With Sick Pay Dates Calculation The system can propose dates for continued pay or the sick pay supplement. Without Sick Pay Dates The user is forced to leave these dates blank and the sys­ tem does not send the continued pay or sick pay supple­ ment periods to payroll. You can select this option for a new employee who isn't yet entitled to continued pay, for example. If you choose With Sick Pay Dates Calculation, you can configure the duration for continued pay and the sick pay supplement based on the company policy, allowing the system to propose sick pay dates. Steps 5 to 8 only apply if you have chosen this option. 5. Choose the relevant Unit for Duration of Continued Sick Pay and/or Unit for Duration of Sick Pay Supplement from the dropdown list. 6. Enter a Duration of Sick Pay Supplement that is greater than the period of continued pay. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 261 7. Choose Sickness as the Absence Class. 8. Enter a meaningful External Code for the time type you've created and choose Save. Next Steps You can now associate the Time Type you've created with the Time Profile of the relevant users. 3.5.9.4.2 Requesting an Absence with Calculation of Sick Pay Dates As an administrator, you can request an absence for an employee who is on sick leave and receive a proposal for the continued pay and sick pay supplement dates. Prerequisites ● You've contacted your account executive to activate this Early Adoption feature. Note The system can't propose sick pay dates for linked absences. ● You're familiar with the Assigning Time Objects to Employees Manually documentation. ● You've created a Time Type for continued sick pay dates and added it to the employee's Time Profile. ● You're familiar with the objects described in the Employee Time [page 694] documentation. ● Your role has been granted the Time Management Object Permissions. Context In Germany, if an employee is on sick leave, the employer continues to pay the employee's wage for a fixed period based on legal regulations. After this period, the health insurance company takes over and pays part of the employee's remuneration. Based on the company policy, the employer can choose to pay a sick pay supplement for a specific length of time. This ensures that the employee continues to receive an amount equal to the full remuneration. The HR administrator can configure the duration of these periods when creating the time type for continued pay. 262 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Procedure 1. Go to the employee's People Profile and under Time Management choose Administer Time. 2. Choose Create Absence to display the New Absence window for the employee. You then see an overview of the employee's absences. 3. Choose Create Absence. 4. Choose the Time Type you created for calculating sick pay dates. 5. Choose the Start Date and End Date of the sick leave. 6. Choose Set Sick Pay Dates. The system now proposes the end date of continued pay, and the start and end dates of the sick pay supplement based on your company policy. By default, the start date is set to today's date. ○ If you choose Link Additional Absence, the option to receive a proposal for sick pay dates is automatically switched off and the Set Sick Pay Dates button is no longer available. ○ If you choose Set Sick Pay Dates without entering a Certified Start Date of Absence, the system uses the date entered in the Start Date field to calculate the proposals for the End of Continued Pay, the Start Date of Sick Pay Supplement, and the End of Sick Pay Supplement. ○ If you enter a Certified Start Date of Sickness that is after the Start Date of the absence and then choose Set Sick Pay Dates, the system recalculates all three dates based on the Certified Start Date of Sickness. If the Certified Start Date of Sickness is before the start date of the sickness, the system uses the Start Date for the calculation, that is, the later of the two dates. 7. Choose Submit. 3.5.9.5 3.5.9.5.1 Hong Kong Setting Up Sick Leave Categories for Hong Kong Use time account types and accrual rules to set up the legally required sick leave categories for Hong Kong. Context Hong Kong has two categories of paid sick leave: ● Category 1 Sick leave supported by a medical certificate from a registered medical practitioner. Employees can take up to 36 paid sick days from category 1 each year. ● Category 2 Once an employee takes more than 36 paid sick days a year, any subsequent paid sick days move from category 1 to category 2. When this happens, an employer can request that additional forms of medical Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 263 certificates (for example, a certificate from a hospital) and a record of the prescribed treatment be produced. Sick leave balance can be carried forward to subsequent years, but employees can only have a maximum of 120 days at any point in time (36 from category 1 and 84 from category 2). Time Off does not support automatic balance synchronization of accruals between different time accounts. However, you can still fulfil the legal requirements for Hong Kong by using the following method. Procedure 1. Create a time type (called, for example, HK Sick Leave). 2. Assign two time account types to the time type - one for category 1 (for example, HK Sick Leave Cat 1) and one for category 2 (HK Sick Leave Cat 2). These should be set up as permanent time accounts with the following attributes: ○ Accrual Frequency Period: Monthly ○ Start Day of Accrual Period: 1 ○ Start Month of Accrual Period: 1 ○ Level of Accrual Automation: No Automation ○ Entitlement Method: Entitled as Accrued 264 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3. Create an accrual rule using the Cap Accrual () rule function for HK Sick Leave Cat 1 as follows: Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 265 4. Create an accrual rule using the Cap Accrual () rule function for HK Sick Leave Cat 2 as follows: 5. Assign time type HK Sick Leave to the time profile for the relevant employees. Results The accrual rule for HK Sick Leave Cat 2 will determine the cap accrual for HK Sick Leave Cat 1 as of the posting date. Then it will use Add () and Opposite Sign () to subtract the cap accrual for HK Sick Leave Cat 1 from the max. accrual for HK Sick Leave Cat 2, which will determine the leftover accrual (if any) for category 2. Finally, it will post the cap accrual to the category 2 account as of the posting date. Once this is complete, the accrual rule for HK Sick Leave Cat 1 will determine its own cap accrual. Note This process can only work if the accrual rule for category 2 is run first. 3.5.9.6 266 PUBLIC Japan Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.9.6.1 Checking Compulsory Paid Leave for Japan Use your Team Off solution to verify that employees in Japan have taken the legally required amount of paid leave for a particular year. Prerequisites You have familiarised yourself with the process for using time collectors, as described inSet Up Time Collectors. Context If employees are entitled to annual leave of more than 10 or more days, they must take at least 5 days of those days off each year. In turn, employers have to create an Annual Leave Ledger - which includes things like the number of assigned annual leave days and the dates on which the leave was taken - and store it for 3 years. Procedure 1. Run the Time Account Snapshot report. 2. Enter the date range for the time period you want to look at. For example, the current year. 3. Choose Time Account Type, and select your annual leave time account type as the report value. 4. Choose OK. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 267 Results On the first page, you can see the annual leave entitlement. And under Time Account Snapshot Time Account Snapshot Details ; you can see the individual leave bookings that the employee has made. Related Information Checking Annual Overtime for Japan [page 268] Checking Monthly Overtime for Japan [page 274] 3.5.9.6.2 Checking Annual Overtime for Japan Use your Time Off solution to ensure that employees in Japan are not regularly working more than the legally specified amount of annual overtime (720 hours of overtime in a given year). Prerequisites You have familiarised yourself with the process for using time collectors, as described inSet Up Time Collectors. Procedure 1. Open the Time Collector Template report. 2. Enter the date range for the year you want to check. 3. Add timeCollectorType(Label) Monthly Overtime Time Collector . The employee’s overtime hours are displayed in minutes. 268 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 4. Click this icon to download the results to Excel. 5. In Excel, you can customize the sheet so that the results are easier to analyze. To do this, select the employee’s name. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 269 6. Then choose Data Subtotal , set these parameters, and click OK. A new Total row appears for the employee. 7. Shrink the list and select the cells under Time. 8. Then choose 270 PUBLIC Home Conditional Formatting New Rule . Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 9. In the New Formatting Rule dialog box, set these parameters. 10. When you click OK, you’ll get an immediate color-coded overview of the employees’ annual overtime totals. Related Information Checking Monthly Overtime for Japan [page 274] Checking Compulsory Paid Leave for Japan [page 267] 3.5.9.6.3 Checking Average Overtime for Japan Use your Time Off solution to ensure that employees in Japan are not regularly working more than the legally specified amount of average overtime hours within a given period. Specifically, when you look at a period of Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 271 two, three, four, five, or six months, employees should not have worked more than an average of 80 overtime hours each month. Prerequisites You have familiarised yourself with the process for using time collectors, as described inSet Up Time Collectors. Procedure 1. Open the Time Collector Template report. 2. Enter the date range for the time period you want to check – anywhere between 2 to 6 months. 3. Add timeCollectorType(Label) Monthly Overtime Time Collector . The employee’s average overtime is displayed in minutes. In this case, the average of the period from April to May. 4. Select an employee’s name, and choose Data Subtotal . 5. In the Subtotal dialog box, set these parameters. 272 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 6. When you click OK, a new row appears showing the average for each employee. 7. Shrink the list and select the cells under Time. 8. Then choose Home Conditional Formatting New Rule . 9. In the New Formatting Rule dialog box, set these parameters. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 273 10. When you click OK, an immediate color-coded overview of the employees’ monthly averages for the periods appears. Related Information Checking Compulsory Paid Leave for Japan [page 267] Checking Annual Overtime for Japan [page 268] Checking Monthly Overtime for Japan [page 274] 3.5.9.6.4 Checking Monthly Overtime for Japan Use your Time Off solution to ensure that employees in Japan are not regularly working more than the legally specified amount of monthly overtime (100 hours of overtime in a given month). Prerequisites You have familiarised yourself with the process for using time collectors, as described inSet Up Time Collectors. Procedure 1. Open the Time Collector Template report. 2. Enter the date range for the month you want to check. 3. Add timeCollectorType(Label) Monthly Overtime Time Collector as a runtime filter. The employee’s overtime hours are displayed in minutes. 274 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 4. Click this icon to download the results to Excel. 5. In Excel, you can customize the sheet so that the results are easier to analyze. To do this, select the cells in the Time column. 6. Then choose Home Conditional Formatting Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management New Rule . PUBLIC 275 7. In the New Formatting Rule dialog box, set the necessary parameters. In this example, you want to see if the employee has worked her normal monthly hours (4800 mins), overtime up to the legal limit (6000 mins), or above the legal limit (over 6000 mins). 8. When you click OK, the different values will be color-coded like this to make them easier to see at a glance. Related Information Checking Compulsory Paid Leave for Japan [page 267] 276 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.9.7 Mexico It is possible to configure and use a continued pay feature specific to Mexico. Configuration ● The Assigning Time Objects to Employees Manually documentation describes the process. ● Take a look at the Time Type documentation for information on what you need to do in the objects. ● Employee time objects Take a look at the Employee Time Time Off Data Object documentation for information on what you need to do in the objects. ● Employee time groups Use this to group the sicknesses you want to treat as identical. Take a look at the Employee Time Group Time Off Data Object documentation in for information on what you need to do in the objects. Additional Leave Information 1. First, you create a country/region-specific time type for Mexico. To do this, go to the Admin Center and choose Manage Time Off Structures 2. Create a country/region-specific time type for Mexico, with Sickness as the Absence Class. 3. With your configuration done, you can now create absence requests based on this object. To do this, go the employee's People Profile and choose Administer Time. 4. You then see the employee's Time Off Overview. Choose New Absence. This brings up the New Absence window for the employee. The fields under Additional Leave Information only appear when the time type is country/region-specific to Mexico and the absence class in the time type is Sickness. 5. Now make these entries: ○ Time type ○ Start date and end date for the absence being requested ○ Make an entry in the Reference Number field. This should be the reference number you've received from the Social Insurance Authority. ○ Make an entry in the Days Already Cumulated For Same Sickness field. 6. If you want to link this absence to others, choose Link additional absence. 7. Now you need to choose the absences to which you want to link this one. To do this, use the Reason field to indicate why you want to link these absences (at this time, the only reason available is Identical), then use the dropdown list in the Absences to be Linked field to select the absences you want to link to. The list shows all the Mexico-specific absences of time type Sickness where a reference number has been entered. 8. When you're done, save your entries. You can then see the new absences under Time Record with a linking icon. Click that icon to view the linked absences. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 277 3.5.9.7.1 Automatic Payout During Period-End Processing (Prima Vacacional) There is a legal requirement in Mexico that specifies that employees must receive an annual entitlement ("prima vacacional") in addition to their normal annual leave entitlement. At the end of the employee’s year, the prima vacacional entitlement must be paid out. Here's how you set that up in Time Off. Procedure 1. In Admin Center Manage Data Structures , create a new Vacation time type. 2. Create a recurring Time Account Type with annual accruals on the employee's anniversary date. (Note: you can use the account creation start date as Employee Flexible Date). Assign this time account type to the Vacation time type you just created. 3. Create a flexible account Start Date Rule based on the employee anniversary date. 4. Assign the Vacation time type to your time profile and mark it as ESS-enabled. 5. Now create another time type (called, for example, Vacation Premium or Prima Vacacional ) which is not marked as ESS-enabled in your time profile. 6. Create a recurring Time Account Type which accrues 25% of the balance from the Vacation time account. Mark this time account type as Eligible for Payout. 7. Configure a Period-End Processing with Payout rule which pays out the remaining balance at the end of the bookable period and then closes the time account. Assign this rule to the time account. 8. In the time account type, set the flag Automatic Period-End Processing. Calendars will be automatically created for this time account type. 9. Check the logs and verify that the payouts have been created. 3.5.9.8 3.5.9.8.1 Netherlands Setting Up Statutory Leave for the Netherlands Configure your Time Off solution so that it can calculate the necessary amount of legally required statutory leave for users in the Netherlands. Context Statutory leave is the minimum holiday requirement, calculated at 4 times the hours in a normal working week. For a full-time employee, this amounts to 20 days (160 hours). If someone is only employed for a certain period 278 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management of the year (for example, 45 weeks instead of the full 52) or reduces their working hours, then their statutory leave entitlement would be accordingly smaller. For example, if an employee is hired on 12.02.2018 for 40 hours a week, reduces their hours to 36 hours a week as of 01.07.2018, and is terminated on 31.10.2018, their entitlement would be as follows: ● Period 1 (12.02.2018 – 30.06.2018) is 20 weeks at 40 hours a week = ((4 * 40) * (20 / 52)) = 61.54 hours of statutory leave ● Period 2 (01.07.2018 - 31.10.2018) is 25 weeks at 36 hours a week = ((4 * 36) * (25 / 52))) = 69.23 hours of statutory leave ● • Total: 61.54 + 69.23 = 130.77 hours of statutory leave for that year Time Off needs to be able to calculate this. Procedure 1. Go to Manage Business Configuration and, under the country/region-specific fields for the Netherlands, create a new custom field like the one shown here. Give it the label Accrual Entitlement. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 279 2. Create an onSave rule like this one. This rule will run every time the Job Information record is saved. It will fill the accrual field you just created, and ensure that any new job information fields are updated if any changes are made to employee’s standard weekly hours. 3. In the job information, there are fields relevant for calculating accruals. Add these fields to the Time Account Type as recalculation fields. This ensures the recalculation will be triggered automatically in case the value in the field is changed. 4. Create an accrual rule like this, and assign it to the Time Account Type as a hire and termination rule. 280 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management This rule calculates the average accrual amount based on the job information field you created in step 1. Next Steps Create a time profile and assign the relevant Time Type and Time Account Type. Finally, schedule time account calendar runs to accrue the time account balances. 3.5.9.8.2 Setting Up Non-Statutory Leave for the Netherlands In addition to the legally required minimum leave (statutory leave), employees in the Netherlands can also be granted additional non-statutory leave. Context This is leave over and above the minimum required amount of leave. For instance, at some companies employees might be granted extra vacation days once they’ve worked there for a certain number of years. Here’s an example of how that could look: Employment Duration in Years Annual Non-Statutory Leave Quota in Hours <2 64 2 64 3 64 4 72 5 72 6 72 7 80 8 80 9 80 10 88 11 88 12 88 13 96 14 96 15 96 16 104 Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 281 Employment Duration in Years Annual Non-Statutory Leave Quota in Hours >17 104 Time Off needs to be able to calculate this. Procedure 1. Create a Lookup table that contains all the necessary information about the annual accrual and level of seniority. Here’s an example: The table will be used to fill the job information fields. 2. Go to Manage Business Configuration and, under the country/region-specific fields for the Netherlands, create a new custom field for each seniority level. For example: 282 For this seniority level Create this field 0-3 years custom-double1 4-6 years custom-double2 7-9 years custom-double3 10-12 years custom-double4 13-15 years custom-double5 16-99 years custom-double6 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3. Create an onSave rule like this one. In this example the seniority range only goes up to 7-9 years, but you can always extend the rule to cover higher values too. The rule will run automatically every time the job information record is saved. This will ensure that the new job information fields are always updated accordingly if any changes are made to the employee’s FTE and standard weekly hours. 4. In the job information of the Time Account Type, add the fields you created in step 2 as recalulation fields. This ensures that the recalculation will be triggered automatically in case any of the values in the fields are changed. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 283 5. Create an accrual rule like this, and assign it to the Time Account Type as a hire and termination rule. Next Steps Create a time profile and assign the relevant Time Type and Time Account Type. Finally, schedule time account calendar runs to accrue the time account balances. 3.5.9.8.3 Setting Up Concurrent Absences in The Netherlands Your Time Off solution has been enhanced with the feature to allow concurrent absences. For the Netherlands, this applies to illness and vacation absences being concurrent to one another as per legal requirements. Prerequisites The concurrent absences feature is in the Early Adoption phase. For activation of the feature, please reach out to your account executive. 284 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Take a look at the Time Management Collision Resolution [page 124] documentation. Take a look at the Time Type Collision Grouping [page 127] documentation. The Time Type (NLD) object is delivered as InActive by default. Activate the Time Type (NLD) object definition under Configure Object Definitions in Admin Center. Context In the Netherlands, when an employee is ill, it can be recorded in the system as an illness absence with an undetermined end date. This illness absence can be concurrent with a future vacation absence that is already recorded in the system for this employee. You can then decide on what needs to be done with the vacation absence which is effected by the illness absence that becomes concurrent to it. If an employee has an existing illness absence in the system with an undetermined end date, there can be a phase wise re-integration of the employee returning to work. This means that the employee starts working for a couple of hours (per day/week/month) and slowly adjusts the number of hours based on the recovery from illness. The employer and employee must take measures to re-integrate the employee back to work as the employee recovers from the illness. In such a scenario, the employee can choose to take a vacation absence from his available working capacity that can be created in the system in concurrent to the existing illness absence. Note A new field Illness Recovery Tracking is introduced at the Time Type level for the Netherlands to track the employee's re-integration to the job. For Example: 1. An employee requests for an absence from the annual leave entitlement for a future vacation from December 10th to December 20th. During the first week of December, the employee falls ill, and now needs to request for an illness absence from December 7th to an undetermined end date. The system allows the creation of this illness absence starting from December 7th till an undetermined end date in concurrent with the existing absence for vacation from December 10th to December 20th. 2. An employee falls ill on September 25th and has a continuous illness absence in the system created by an admin with an undetermined end date. On October 1st, the employee feels better and is advised by the doctor to resume work partially by working for 50% of the working capacity. The admin creates a new illness record with undetermined end date and an option to track the recovery of illness by recording the working capacity percentage of the employee during the re-integration phase. The employee now decides to take a vacation absence from October 15th to November 1st based on the available work capacity percentage. The system allows the creation of this vacation absence starting from October 15th to November 1st in concurrent with the existing illness absence. Follow the below steps to record concurrent absences in the Netherlands: Procedure 1. Go to Manage Data from Admin Center. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 285 2. From the Create New drop down list, select the Time Type Collision Grouping option. 3. Enter all the mandatory fields and select Netherlands (NLD) as the Country/Region and choose Save. Note You can repeat the above three steps to create another Time Type Collision Grouping for the vacation time types in your instance. You have created a collision grouping that can be assigned to time types relevant for illness or vacation absences in the Netherlands. 4. In Manage Data, search for the Time Management Collision Resolution object in your instance. 5. Add a record in the Collision Resolution Items for the collision grouping created for type of the new absence you are requesting in the Netherlands. Select the Incoming Grouping as the grouping created for time type specific to the new absence you are requesting. Select the Existing Grouping Selection Method as Specific Grouping and the Existing Grouping as the grouping created for time type specific to existing absence in the system. Set the Collision Resolution Action to Allow concurrent records for this record. 6. In Manage Data, from the Create New drop down list, select the Time Type option. 7. Select Netherlands (NLD) as the Country/Region and under the Time Type Information for the Netherlands select Sickness as the Absence Class and the grouping created in Step 2 and 3 as the Collision Grouping. Additionally, select a value in the Illness Recovery Tracking field. Enter all the other mandatory fields and save the Time Type. Note ○ If you select With Manual Entry of Available Work Capacity (%) in the Illness Recovery Tracking field, you can enter the working capacity percentage of the employee in the absence form during the reintegration phase. ○ If you select None in the Illness Recovery Tracking field, you must not enter the working capacity percentage of the employee in the absence form during the re-integration phase. You have created a time type for illness leave in your system. 8. Assign the Time Type created in Step 7 to the Time Profile of an employee requesting for an illness leave. 9. Go to the employee's People Profile and under Time Management choose Administer Time. 10. You then see the employee's Time Off overview. Choose Create Absence. This brings up the New Absence window for the employee. 11. To create concurrent absences for scenarios described in first example above, select the Time Type created for illness leave in Step 7. Enter the Start Date and select the check box for Undetermined End Date for the illness absence and it overlaps with an existing future vacation absence. Choose Submit after entering all the information for the absence. Note A warning message is displayed if there is an already existing absence during the time frame of the start and end dates of the new absence. System creates an illness absence in concurrent to the existing future vacation absence, which can be seen in the employee's Time Off overview. 12. To create concurrent absences for scenarios described in the second example above: 286 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management ○ Delimit the existing illness absence record and create a new one by selecting the Time Type created for illness leave in Step 7. Enter the Start Date and select the check box for Undetermined End Date of the new illness absence. Record the Available Work Capacity (%) under the Additional Leave Information for The Netherlands section. Choose Submit after entering all the information for the absence ○ Create a new absence for the vacation by selecting the Time Type for vacation and entering the Start Date and End Date of the vacation absence. Note A warning message is displayed if there is an already existing absence during the time frame of the start and end dates of the new absence. System creates a vacation absence in concurrent to an existing illness absence with undetermined end date, which can be seen in the employee's Time Off overview. 13. Go to the employee's Time Off overview. You can see that the system is now capable of creating concurrent absences. If your Time Off solution is integrated to Employee Central Payroll, the field under Additional Leave Information for The Netherlands is replicated to the Absences (Infotype 2001) for the Netherlands. For further information, please refer to the Netherlands documentation in the Country/Region Specifics for Employee Central Payroll guide. Related Information Concurrent Absences [page 127] 3.5.9.9 Poland Find out the configuration for the Time Off solution to support the sick leave process for Poland. This process is essential to ensure that the Time Off solution for your employees is legally compliant. 3.5.9.9.1 Sickness Follow the below steps to set up sick leave for an employee in Poland. Prerequisites ● You have familiarised yourself with the Assigning Time Objects to Employees Manually documentation. ● Take a look at the Time Type documentation for information on what you need to do in the objects. ● Take a look at the Employee Time Time Off Data Object documentation for information on the objects. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 287 Context When an employee is sick or needs to take care of a family member, the employee would approach the health care service and a sickness certificate (ZLA) is issued by the health care services. The admin uses this certificate to record the absence in the system. A Time Type specific for Poland needs to be created. To do this, go to Admin Center and choose Manage Time Off Structures. Create a country/region-specific Time Type for Poland with Sickness as the Absence Class. Procedure 1. With this configuration, you can now create absence requests based on this object. To do this, go to the employee's People Profile and choose Administer Time in Time Management. 2. You then see the employee's Time Off overview. Choose New Absence. This brings up the New Absence window for the employee. Note The fields under Additional Leave Information for Poland only appear when the Time Type is country/ region-specific to Poland and the Absence Class in the Time Type is Sickness. 3. Now make these entries: ○ Time Type. ○ Start Date and End Date for the absence being requested. Under Additional Leave Information for Poland ○ Make an entry in the ZLA Code field. This is the reference code related to the absence. ○ Make an entry in the ZLA Document Number field. This is the document number from the ZLA sickness certificate. ○ Make an entry in the ZLA Issue Date field. This is the date on which the illness was reported and the sickness certificate was issued by the ZLA authority. ○ Make an entry in the ZLA Delivery Date field. This is the start date of the sick pay supplement (The date on which the ZLA was delivered by the employee to the employer). 4. Once all the entries are made, Submit the entries on this page. Tip In the employee's Time Off overview screen, the admin can also view the requests that are already submitted and edit the requets. In the case of integration of the Time Off solution to Employee Central Payroll, the four fields under the Additional Leave Information for Poland are replicated to the Absences(Infotype 2001) for Poland. For further information please refer to Absences (Infotype 2001) - Poland in the Country/Region Specifics for Employee Central Payroll guide. 288 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.9.10 South Africa Configure your Time Off solution to support the 3-year sick leave cycles required under South African law. In South Africa, the law requires that sick leave requirements are handled in cycles of 3 years. Over the course of 3 years, employees are allowed to take paid sick leave for whatever number of days they usually work within a 6-week period. For example, if an employee has a normal 5-day working week, this means that they would be allowed to take 30 paid sick leave days over the course of 3 years. At the end of the 3 years, their sick leave entitlement is renewed. If you use Time Off for South Africa, you need to support this legal requirement. Unfortunately, true 3-year cycles for time account validity and accruals are not possible. However, you can still cover the requirement by setting up flexible date accounts for Sick Leave so that three annual accounts are combined across three years, with the first account starting on the employee’s hire date. Use a time account type based on Employee Flexible Date (instead Employee Hire Date) so that features such as automatic account creation, accrual, and period-end processing can be applied. Note During an employee’s first year of employment, they are only entitled to take one sick day for every 21 days worked. As such, be sure to set the accrual frequency of the Sick Leave time accounts to Monthly in order to fulfil the legal requirements for this first year. Related Information Setting Up Sick Leave for South Africa [page 289] Important Notes & Recommendations for Sick Leave in South Africa [page 293] 3.5.9.10.1 Setting Up Sick Leave for South Africa Here are the settings we recommend you make in order to set up sick leave for South Africa. This will ensure that Time Off can manage sick leave in a way that is compliant with South African law, under which sick leave is handled in cycles of 3 years. Context Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 289 Procedure 1. Set up a time account for sick leave with the following settings: 2. Then set up an accrual rule to handle the first three-year cycle and all subsequent cycles. Here's an example of how such a rule could function, assuming that the employees are working a standard 5-day week and as such are entitled to 30 days of paid sick leave. 290 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Check #1: If it’s currently the first through sixth month of the first 3-year cycle then the rule will create an accrual posting of 1 day. Check #2: If it’s currently the seventh month of the first 3-year cycle then the rule will create an accrual posting of 24 days for the remainder of the first cycle. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 291 Check #3: If it’s currently the first month of the second, third, or subsequent 3-year cycle, then the rule will create an accrual posting of a full 30 days for that cycle. Check #4: If it’s currently any other month then the rule will create an accrual posting of 0 days. Results The combination of the time account and the accrual rule will ensure that employees are assigned the correct number of sick days based on their position in the current three-year cycle. Related Information South Africa [page 289] Important Notes & Recommendations for Sick Leave in South Africa [page 293] 292 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.9.10.2 Important Notes & Recommendations for Sick Leave in South Africa Here are some things you should keep in mind when setting up sick leave for South Africa. ● Assign an account booking offset of at least 24 months to the sick leave time account This ensures that the annual time account for the first year of the 3-year cycle will only be valid (that is, accruable) during that first year, but bookable for the entire cycle. However, if you regularly have to retroactively add paid sick leave into previous 3-year cycles, then it could make sense to assign an even larger booking offset. For example, a booking offset of 30 months will ensure you have six months to make retroactive changes before the system closes the corresponding time accounts. Note If you do assign a larger booking offset like this, make sure that you set the posting order of the sick leave time account to Newest First. This will prevent any available balance from the old cycle from being used accidentally. As an additional safeguard, you can also set up a take rule for the sick leave time type that specifies that the total sick leave deduction for the current cycle cannot exceed 30 days. ● Use save rules to adjust the bookable end dates of unnecessary time accounts Time Off will automatically create annual time accounts for the second and third years of the cycle as well, even though these accounts actually aren’t necessary (since the annual account for the first year will cover all sick leave bookings for the entire 3-year cycle). Unfortunately, this automatic creation is unavoidable from a technical point of view. As such, we recommend that you assign a Save rule to the Time Account object to adjust their bookable end dates so that they’re the same as the bookable end date of the first annual account. This will ensure that the system runs period-end processing for all three accounts at the same time. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 293 Here’s an example of what such a save rule could look like: Related Information South Africa [page 289] Setting Up Sick Leave for South Africa [page 289] 294 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.9.11 Spain Take a look at the features in Time Off for Spain. 3.5.9.11.1 Setting Up Continued Pay Feature in Spain It is possible to configure and use a continued pay feature specific to Spain. Configuration ● The Assigning Time Objects to Employees Manually documentation describes the process. ● Take a look at the Time Type documentation for information on what you need to do in the objects. ● Employee time objects Take a look at the Employee Time Time Off Data Object documentation for information on the objects. ● Employee time groups Use this to group the sicknesses you want to treat as identical. Take a look at the Employee Time Group Time Off Data Object documentation for information on what you need to do in the objects. What You Need To Do 1. First, you create a country/region-specific time type for Spain. To do this, go to the Admin Center and choose Manage Time Off Structures 2. Create a country/region-specific time type for Spain, with Sickness as the Absence Class. 3. With your configuration done, you can now create absence requests based on this object. To do this, go the employee's People Profile and choose Administer Time. 4. You then see the employee's Time Off Overview. Choose New Absence. This brings up the New Absence window for the employee. The fields under Linking Absence only appear when the time type is country/region-specific to Spain and the absence class in the time type is Sickness. 5. Now make these entries: ○ Time type ○ Start date and end date for the absence being requested 6. With your entries made, choose Link additional absence. 7. In the resulting screen, make the following entries: ○ Reason At this time, only Identical is available. ○ Absence Use the dropdown to display absences with type Sickness and choose the one you require. 8. When you're done, save your entries. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 295 You can then see the new absences under Time Record with a linking icon. Click that icon to view the linked absences. 9. In the resulting popup, you can see the linked absences. For one of them, Yes appears in the Is Original column. You can change which absence is treated as the original. To do this, click the Change Original Absence button. 10. In the resulting popup, select the absence you want to treat as the original and click Save. 296 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Notes on Absence Linking Scenarios Restriction You can't link two absences that have been created using the Employee Self Service (ESS). Scenario 1: I have 3 or 4 absences in my system, but only 2 are linked. What happens if I link another absence? Nothing. The absence already flagged as the original remains flagged this way, even if the absence you add to the link is older. However, you can change this using the Change Original Absence feature. Scenario 2: What happens if I unlink or cancel an absence in a group of linked absences? This makes no difference if the absence you unlink or cancel is not the absence flagged as the original absence. If it is the absence flagged as the original, the oldest of the remaining absences automatically becomes the original absence. Scenario 3: What happens if I have two linked absences and unlink or cancel one of them? The Is Original flag for the remaining absence is set to No. The group to which it belongs is dissolved. 3.5.9.11.2 Setting Up Concurrent Absences in Spain Your Time Off solution has been enhanced with the feature to allow concurrent absences. For Spain, this applies to Sick Leave and ERTE (Expediente de Regulación de Empleo Temporal) absences as per legal requirements. All other absence types should be ended if a new one is created, and the new absence should be started. However, from a business perspective you may choose to handle this differently. Prerequisites The concurrent absences feature is in the Early Adoption phase. For activation of the feature, please reach out to your account executive. Take a look at the Time Management Collision Resolution [page 124] documentation. Take a look at the Time Type Collision Grouping [page 127] documentation. Context In Spain, when an employee requests for a sick leave, it is recorded in the system with an undetermined end date and this sick leave can be concurrent with any other leave, such as a leave for vacation which is already entered in the system. For Example, an employee requests for an absence from the annual leave entitlement for a future vacation from December 10th to December 20th. During the first week of December, the employee falls ill, and now needs to Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 297 request for sick leave from December 7th to an undetermined end date. The system allows the creation of this sick leave absence starting from December 7th till an undetermined end date in concurrent with the existing absence for vacation from December 10th to December 20th. Note Another use case for concurrent absences in Spain is the existence of a partial paternity absence in concurrent with an absence due to ERTE . When your organization applies for ERTE and decides to temporarily suspend or reduce the working hours of employees, the ERTE specific absence can exist in concurrent with the partial paternity absence in the system. To create the sick leave absence in concurrent with any other leave, follow these steps: Procedure 1. Go to Manage Data from Admin Center. 2. From the Create New dropdown list, select the Time Type Collision Grouping option. 3. Enter all the mandatory fields and select Spain (ESP) as the Country/Region and choose Save. Note You can repeat the above three steps to create another Time Type Collision Grouping for the vacation time types in your instance. You have created a collision grouping that can be assigned to time types relevant for sick leaves in Spain. 4. In Manage Data, search for the Time Management Collision Resolution object in your instance. 5. Add a record in the Collision Resolution Items for the collision grouping created for sick leave in Spain. Select the Incoming Grouping as the grouping created for time type specific to sick leave. Select the Existing Grouping Selection Method as Specific Grouping and the Existing Grouping as the grouping created for time type specific to vacation. Set the Collision Resolution Action to Allow concurrent records for this record. 6. Assign the collision grouping created for sick leave to the Time Type for sick leave in your instance. 7. Assign the collision grouping created for vacation to the Time Type for vacation in your instance. 8. Go to the employee's People Profile and under Time Management choose Administer Time. 9. You then see the employee's Time Off overview. Choose Create Absence. This brings up the New Absence window for the employee. 10. Select the Time Type for sick leave. Enter the Start Date and End Date of the absence such that it overlaps with an existing absence for vacation or any other leave in the system and click on Save. Note A warning message is displayed if there is an already existing absence during the timeframe of the start and end dates of the new sick leave absence. 11. Go to the employee's Time Off overview. You can see that the absence created in the previous step is concurrent to the existing leave in the system. If your Time Off solution is integrated to Employee Central Payroll, these absence records are replicated and processed in Employee Central Payroll. 298 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Related Information Concurrent Absences [page 127] 3.5.9.12 United Kingdom For the country/region United Kingdom, the Time Off solution has been enhanced to request for concurrent absences in case of Adoption Leave for the employees. Configuration Requirements ● You need the Time Off Solution. ● The feature to request concurrent absences must be enabled in the system. 3.5.9.12.1 Setting Up Concurrent Absences in the United Kingdom Your Time Off solution has the feature to allow concurrent absences. For United Kingdom, the only absence this applies to is Adoption Leave as per government guidance. For all other absence types, if you create a new absence you should end all other absences before starting the new one. However, you may choose to handle this differently from a business perspective. Prerequisites The concurrent absences feature is in the Early Adoption phase. For activation of the feature, please reach out to your account executive. Take a look at the Time Management Collision Resolution [page 124] documentation. Take a look at the Time Type Collision Grouping [page 127] documentation. Context Employees already on adoption leave could enter into another adoption arrangement and be entitled to a second period of adoption leave that could overlap with the first. The system must allow the concurrent creation of the second adoption leave when the first one is still in progress. For example, an employee is off work on adoption leave for the first child over a period of 39 weeks from January to September. In May, the employee enters into another adoption arrangement. The system allows the Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 299 creation of a second adoption leave over a period of 39 weeks from May to January in the next year. In this scenario, the first absence is concurrent with the second absence from May to September. For the overlapping period from May to September, the employee is paid for the first adoption leave as well as the second adoption leave as per the statutory payment rules. To create concurrent absences for adoption leave, follow these steps: Procedure 1. Go to Manage Data from the Admin Center. 2. From the Create New dropdown list, select the Time Type Collision Grouping option. 3. Enter all the mandatory fields and select United Kingdom(GBR) as the Country/Region and choose Save. You have created a collision grouping that can be assigned to time types relevant for adoption leaves in the United Kingdom. 4. In Manage Data, search for the Time Management Collision Resolution object in your instance. 5. Add a record in the Collision Resolution Items for the collision grouping created for adoption leave in the United Kingdom. Select the Incoming Grouping as the grouping created for the time type specific to adoption leave. Select the Existing Grouping Selection Method as Specific Grouping. Select the Existing Grouping as the grouping created for the time type specific to adoption leave and set the Collision Resolution Action to Allow concurrent records for this record. 6. In Manage Data, from the Create New dropdown list, select the Time Type option. 7. Select United Kingdom (GBR) as the Country/Region, Unspecified as the Absence Class and the grouping created in Step 2 and 3 as the Collision Grouping. Enter all the other mandatory fields and save the time type. You have created a time type for adoption leave in your system. 8. Assign the time type created in Step 7 to the Time Profile of an employee requesting for an adoption leave. 9. Go to the employee's People Profile and under Time Management choose Administer Time. 10. You then see the employee's Time Off overview. Choose Create Absence. This brings up the New Absence window for the employee. 11. Select the Time Type created for adoption leave in Step 7. Enter the Start Date and End Date of the absence so that it overlaps with an existing adoption leave and choose Save. Note A warning message is displayed if there is an already existing absence during the timeframe of the start and end dates of the new absence. 12. Go to the employee's Time Off overview. You can see that the absence created in the previous step is concurrent to the existing adoption leave in the system. Restriction The processing of Concurrent Absences is NOT supported by Employee Central Payroll or SAP On Premise Payroll and will cause errors in the payroll processing. It is recommended that concurrent absences is only used by customers who do not use SAP Payroll. 300 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Related Information Concurrent Absences [page 127] 3.5.9.13 USA For United States(USA), the Time Off solution has been enhanced with the feature to request sick leave absence for employees with short-term disability. Configuration Requirements You need the Employee Central Time Off Solution. 3.5.9.13.1 Short-Term Disability Absence in USA Short-term disability absence is a sick leave that employees are entitled to when they're unable to report to work for a relatively long duration due to an illness or a disability. When an employee is unable to report to work for a relatively long duration as compared to a normal sick leave due to an illness or disability, the admin can create a policy-based short-term disability absence for the employee. The process of a short-term disability absence works as follows: ● There is a policy set in the organization for the absence of type short-term disability. ● An employee reports that he or she will be absent from work due to an illness or disability for a relatively long duration. ● The HR administrator creates a policy-based short-term disability absence on behalf of the employee in the system. Remember Typically, there may also be a scenario where the first few days of the absence can be recorded as normal sickness leave and subsequently upon receipt of the doctor's certificate, the short-term disability absence can be created from the next day onwards. In such a scenario, there are two absences. The first one is a normal sickness leave and the second is the short-term disability absence. ● When requesting the absence, apart from the start and end dates of the absence, the admin can record up to three additional dates to capture the end dates of the respective disability periods, from the start date of the absence that is of the short-term disability type. Note The admin has the option to default these dates based on the policy set in the company for the shortterm disability absence or enter the dates manually. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 301 Restriction A Short-term disability absence is for a relatively long duration as compared to the normal sick leave absence. Recurring absences on the other hand are for shorter durations and recurring in nature with multiple occurances. It is recommended that the functionality of short-term disability absence is not used together with the functionality of recurring absence. The occurance of more than one short-term disability absence, when used together with the recurring absence functionality, will result in quite a long period of absence. The system will propose incorrect disability period end dates for the recurring absence of shortterm disability and this will need manual correction of dates by the HR administrator. In order to request the short-term disability absence, the employee's time profile must have a Time Type associated to it, which is relevant for the short-term disability absence. Take a look at Time Type [page 743] for information about what you need to do in the objects. 3.5.9.13.1.1 Creating a Time Type for Short-Term Disability Absence in USA Create a Time Type that is relevant for the short-term disability absence in United States, so that it can be associated with the Time Profile assigned to the employees who want to request this absence. Context Each organization can have its own policy for the short-term disability absence and based on that policy you can configure the duration of the disability periods for the short-term disability absence of the employee. Based on the duration of these disability periods, the admin is allowed to record up to three additional dates indicating the end of the disability periods from the start date of the absence. Procedure 1. Go to Admin Center and under Time Management choose Manage Time Off Structures. 2. From the Create New dropdown list, select the Time Type option. 3. Enter a meaningful <External Name> and select United States(USA) in the <Country/Region> field. The Time Type Information for USA section is displayed. 4. Select Short-term disability as the <Sickness Variant>. The fields to capture the duration of disability periods based on your organization's policy for the shortterm disability absence of the employees appear. 5. Enter values in the <Duration of Disability Period One (in days)>, <Duration of Disability Period Two (in days)> and <Duration of Disability Period Three (in days)> fields that are based on the policy for short-term disability absence in your organization. 302 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note These fields are not mandatory. The values in these fields can be configured if you want to create short-term disability absences that have the end dates for the disability periods in accordance with the company's policy. However, ○ If you choose to enter values in these fields, it is mandatory to follow the sequence. For example, you cannot configure <Duration of Disability Period Two (in days)> without entering a value in <Duration of Disability Period One (in days)>. ○ If you leave these fields empty, the system will not propose the end dates for the disability periods when requesting short-term disability absence for this Time Type. 6. Select Absence as the <Classification>. 7. Select Sickness as the <Absence Class>. 8. Enter all the other mandatory and relevant fields and save the Time Type. Next Steps The Time Type created should be associated with the Time Profile of the user, for the user to be eligible for the short term disability absence. Note Set the Enabled in employee self-service scenario to No for the time type created, as only HR administrators must request for this absence. 3.5.9.13.1.2 Requesting an Absence for Short-Term Disability The HR administrator can request the short-term disability absence for the employee by following the below steps. Prerequisites ● You’ve familiarized yourself with the Assigning Time Objects to Employees Manually documentation. ● The Time Type relevant for the short-term disability absence exists and is associated to the Time Profile of the employee. ● You’ve familiarized yourself with the Employee Time [page 694] documentation for information about the objects. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 303 Context When an employee reports that he or she won’t be able to come to work for a relatively long duration due to an illness or a disability that may have occurred as a result of an accident, you can create an absence for shortterm disability on behalf of the employee. This absence is based on a policy defined by your organization. Based on this policy, the duration of the disability periods must be configured in your system. Restriction At this moment, only the HR administrator should request for the short-term disability absence. The ESS option for requesting this absence is not supported. Procedure 1. Go to the employee's People Profile and under Time Management choose Administer Time. 2. You then see the employee's Time Off overview. Choose Create Absence. This brings up the New Absence window for the employee. Note The fields under Additional Leave Information for USA only appear when the Time Type is country/ region-specific to United States and the Absence Class in the Time Type is Sickness. 3. Now, make these entries: ○ <Time Type> for short-term disability. ○ <Start Date> and <End Date> for the absence being requested. ○ For the fields under the Additional Leave Information for USA, you can set the end dates of the disability periods based on the policy configured in the Time Type, by choosing the Set Disability Period Policy Dates button. ○ Alternatively, you can also choose to enter these end dates manually depending on the situation of the employee. Note The dates that are manually entered here can also be before the start date of the absence. However, it’s important that the <Disability Period Two End Date> is after the <Disability Period One Date> and the <Disability Period Three End Date> is after the <Disability Period Two Date.> 4. Once all the entries are made, submit the entries on this page. Tip In the employee's Time Off overview screen, the admin can also view the requests that are already submitted and edit the requests. 304 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.10 Integration of Time Off and Payroll If you need Time Off data in your payroll system, you can set up either a point-to-point integration or one that uses middleware. The integration processes are described in detail in the following guides on SAP Help Portal: ● Integrating Time Off and Employee Central Payroll ● Integrating Payroll Time Sheet with Employee Central Payroll ● Replicating Employee Time Data from Employee Central to SAP ERP HCM Using SAP Cloud Platform Integration as the Middleware ● Replicating Employee Time Data from Employee Central to SAP ERP HCM Using Dell Boomi AtomSphere as the Middleware Limitations and Restrictions ● When absence data is replicated from Time Off to Employee Central Payroll, the fact that an employee is inactive or active is not taken into account for the creation of infotype 2001. ● Absences for periods when the status of an employee is set to Inactive in the Actions (0000) infotype are not allowed for most countries. This means that the payroll run will fail for the corresponding employee each time a leave of absence (LOA) is replicated to Employee Central Payroll. Tip If you want to prevent LOAs from being replicated to Employee Central Payroll for these countries, go to the Data Replication Configuration and make sure that you don't include any leave of absence time type in the Time Type Filter. ● In Employee Central, the external code of a time object can be up to 128 characters. However, in Employee Central Payroll it can only be up to 32 characters. As such, when setting up external codes for any time objects that will be used for replicating data to Employee Central Payroll, ensure that they don't exceed 32 characters. Otherwise the replication will fail and you'll get an error message. 3.5.11 Activating Mobile Time Off Some of the functions of the Time Off feature are available in a mobile version that you need to switch on. Context You can: ● Submit a request for some time off, such as sick leave, vacation, or paid time off (PTO). Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 305 ● Look at your team's calendar to see who else is absent when you want to be. ● Cancel any time off requests you submitted that haven't been approved yet. ● Handle other things you need to do as part of taking time off, such as canceling meetings planned for the relevant period and telling colleagues you are going to be away. Procedure 1. Register and activate your mobile device as described in Employee Central and Your Mobile Device in the Implementing Employee Central Core guide. 2. Before you can use mobile Time Off, you need to activate and set up the Time Off feature as described in the other chapters of this documentation. 3. The mobile feature also includes a function enabling you to send emails to people, telling them you are going to be absent. Before you can use this, the relevant field, shown below, needs to be in your Succession Data Model. Make sure it is there and, if it is not, insert it. <standard-element id="email" required="false" matrix-filter="false"> <label>Email</label> </standard-element> 4. Finally, create the permissions users will require so that they can use the new email function. Go to the Admin Center and choose Set User Permissions function and proceed as follows: Manage Permission Roles . Enter the Create New a. Create a permission role as shown below, containing the permission Employee Data — Email, Email Info, View. 306 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management b. Grant the role to those you want to be able to view the email. This can be a group, individuals, or everyone in the company. c. Log off and log on again. The created permission is now effective and you're ready to go with all aspects of the mobile Time Off app. Use the Related Links to access information about them. Related Information Mobile Time Off for iPhone Users Mobile Time Off for Android Users 3.5.11.1 Mobile Time Off Features Here's information about the features supported by Mobile Time Off. Supported Features of Mobile Time Off Only the following custom fields supported in Mobile Time Off: ● Attachment ● Boolean ● String ● Number ● Decimal ● Picklist ● Date ● You can restrict access to certain fields using field level overrides permission (for example, setting a custom field to "Read Only" or "No Access"). This is respected on the Mobile Time Off user interface. Note The field level override is only supported for the custom fields mentioned above. ● Cross-Midnight absences are supported in Mobile Time Off UI. ● Option to Block calendar - iOS only ● Option to notify people via email - iOS only Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 307 ● Option to pick schedule suggestion while creating absences ● Custom conditional field on fractionQuantity for AmPm is supported if you create the field with a predefined name: cust_AmPmForFractionLeave. ● Absences with Flexible Requesting are supported in Mobile Time Off. ● Upcoming Time Off section in Mobile UI also displays holidays and absences like in Web UI. There is also a possibility to filter past/future events. ● The balance section displays the balance of all the time types and not only the favorite time types. Unupported Features of Mobile Time Off ● Absences with Undetermined End Date aren't supported on the Time Off Mobile UI ● Absences of Leave of Absence (LOA) time types aren't supported ● the recurring absences feature isn't supported ● Conditional custom fields aren't displayed on the Mobile Time Off UI ● Split and delimit of absences isn't supported on the Mobile Time Off UI ● Concurrent absences isn't supported on the Mobile Time Off UI ● The Return to Work On field isn't available on the Mobile Time Off UI ● The absences of "Indirect" reports aren't visible on the Mobile Team Absences UI. ● The leave "balance" isn'tshown when approving an absence on the Mobile UI. ● The Time accounts overview like display of Time account bookable dates and balances isn't available on mobile. ● Comments from "Declined" time off requests aren't visible on Mobile UI. ● The Payout and Purchase Self-Services UIs aren't available on Mobile as own Apps ● Error or Warning messages aren't classified or differentiated on the Mobile UI with an error/warning icon. ● The full-day flag on the Mobile Time Off UI isn't hidden based on the time type settings Permitted Fractions for Unit Day or Permitted Fractions for Unit Hour. Note All of the above features can be supported in mobile if accessed using responsive web browser URL. 3.5.12 Setting Up Alerts And Notifications Ensure that all the relevant people in a Time Off workflow will be reminded of important events, such as an employee returning from extended leave. Context If managers are responsible for a lot of employees, it can be hard for them to keep track of all leave requests and absences. Alerts and notifications can make this task much easier, by pointing out when an important date is approaching or when a particular absence requires more attention. 308 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management For example, you can specify that managers will get a reminder when: ● An employee will return from leave in a given number of days. This is relevant for long periods of leave, such as 2 years parental leave, to ensure that the manager has done everything in the system so that it is ready for the employee's return. ● A certain absence will be longer than a given number of days, so that additional action can be taken. For example, if an employee is on sick leave for more than 15 consecutive days, HR might need to be informed. ● The amount of days taken for a certain time type is above a defined maximum. For example, if an employee accidentally books more than the annual allowance of vacation leave. Procedure 1. In the Admin Center Manage Organization, Pay and Job Structures , create the relevant workflow. In this example, we're creating a 20-day reminder for any employees that will be returning from parental leave. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 309 2. In the Admin Center Manage Data , specify what the alert message should be. Note that you can use variables in the message and header text. 3.5.12.1 Example Context Let's look at an example, where the system is being configured to remind a manager that an employee is returning from maternity leave in 20 days' time. Procedure 1. The first step is to define the relevant workflow. You do this in the Manage Organization, Pay and Job Structures. 310 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 2. Next, we define an alert message. To do this from the Admin Center, choose Message Manage Data Alert and specify the alert header and text. Note that you can use variables as you would use them anywhere in the system. 3. Now go to Configure Business Rules and assign the workflow and alert message you have just created. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 311 As you can see from the IF statement, this rule is only relevant for leaves of type Maternity. Note ○ The effective date determines the date on which the alert is created. In our case, this is 20 days before the end date for the leave. ○ You don't need to specify any parameters. 4. Now, assign the postSaveRule to employeeTimes. You do this in the Admin Center by choosing Configure Object Definitions: 312 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management a. Choose Rules Details . b. Select the rule as postSaveRules Note ○ You can assign more than one postSaveRule to employeeTimes, but at this time only one alert can be generated per employeeTimes object. So, if the first assigned rule is relevant for the Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 313 time off request, the relevant alert is generated and the other rules are not considered. So, you might want to have rules per time type. ○ For the alerts to run, you need to schedule an "EC Alerts and Notifications" job in Provisioning. Assign EC Alerts and Notifications as the Job Type. Take a look at the Scheduling A Job section of the Employee Central Workflows implementation guide for full information on running jobs. 5. Now, the users defined in the workflow receive appropriate alerts shown in their To Dos. 3.5.12.2 Setting Up E-Mail Notifications for Time Account Payouts Set up and configure e-mail notifications so that your employees are alerted when certain activities occur in relation to time account payouts requested for them. Context Employees will receive e-mail notifications whenever an admin creates, edits, or deletes a time account payout. You use templates to ensure that these e-mail notifications contain the correct information, and as such you need to set up the templates for each type of notification (create, edit, and delete). Procedure 1. In the Admin Center, go to E-Mail Notification Templates Settings. 2. Here you'll find the following templates: ○ Notification With Payout Rate Details ○ Notification (without payout rate details) “Payout rate details” here refers to the monetary value of the hours or days which are deducted from the time account for payout. 3. Configure either or both of these templates for the Create, Edit, and Delete notifications, and save. Whether you need to configure either or both templates depends on the settings of the pay component used for the time account payout. If the pay component allows monetary valuation then the payout rate details can be calculated directly in Employee Central, and you need to configure the Notification With Payout Rate Details template. If the pay compontent doesn’t allow monetary valuation, then you only need to configure the Notification template because the payout rate details will be calculated later in Payroll. 314 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Results Employees are notified by e-mail when time account payouts are created for them and when those payouts are edited or deleted. 3.5.12.3 Setting Up E-Mail Notifications for Leave Purchases Set up and configure e-mail notifications so that your employees are alerted when certain activities occur in relation to time purchases requested for them. Context Employees will receive e-mail notifications whenever an admin creates, edits, approves, or deletes a time purchase. You use templates to ensure that these e-mail notifications contain the correct information, so you need to set up the templates for each type of notification (create, edit, approve, and delete). Procedure 1. In the Admin Center, go to E-Mail Notification Templates Settings. 2. Here you'll find the following templates: ○ Time Off Purchase Leave Request Created Notification ○ Time Off Purchase Leave Request Edited Notification ○ Time Off Purchase Leave Request Approved Notification ○ Time Off Purchase Leave Request Deleted Notification 3. Configure and activate the templates you want to use and choose Save Notification Settings. Results Employees are notified by e-mail when a leave purchase is created for them and when it is edited, approved, or deleted. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 315 3.5.13 Handling Global Assignments and Concurrent Employment in Time Off These forms of employment are a bit different from the standard. If you use any of them at your company, you'll have to keep this in mind when setting up Time Off. Global Assignment If an employee leaves the country where they're normally based to work in another country, you need to set up Time Off in both countries. This means, for example, that you have to assign a time profile to that employee in each country. If you don't yet use Time Off in one of the countries, you can only set up time profiles and other objects for the country in which you do use Time Off. Unfortunately, there is currently no consolidated time management available. Note Assigning a time profile while adding a global assignment does not trigger the automatic creation of time accounts and accruals. You need to run the account creation calendar manually in such cases. Concurrent Employment When someone simultaneously holds two or more employments, you need to up Time Off for both employments. This means, for example, that you must assign a time profile to that employee for each employment. Note Assigning a time profile while adding a concurrent employment does not trigger the automatic creation of time accounts and accruals. You need to run the account creation calendar manually in such cases. 3.5.14 Recommendations and Restrictions for Time Off Before you start using Time Off, here are some important things you should keep in mind. Recommendations ● Plan plenty of time for migration. 316 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management If you use Time Off in a test instance and then decide to migrate to a productive instance, keep in mind that the migration can take a while – especially if you have a lot of data to migrate. ● Use flexible date accounts instead of hire date accounts. Flexible date accounts offer the same features as hire date accounts, but with improvements. For example, you can manually specify the exact hire date that will be used as the basis for the annual time account. However, with hire date accounts, you have to use the system-defined date. ● We recommend using "No Recalculation Postings" as the Accrual Recalculation Posting Method in the Time Account Type due to following advantages over Classic: ○ Less data volume, especially for daily accruals. ○ If there are duplicate accruals, you don't run into an error but calendars with recalculation can clean up that data. ○ If the accrual date changed during recalculation then that date change is considered as well. Classic only considers quantity changes. ● If you record your absences in EC Time Management, we recommended that you also manage your time accounts and accruals in EC Time Management. Restrictions ● Do not use Time Off to record attendances such as training courses, travel time, or working from home. Time Off is intended to be used to record absences only. It is not designed for the volume of data that arises from recording attendances, and using it in this manner would lead to extensive performance problems. ● Do not import absences with an undefined “high date” (for example, 31.12.9999) This slows down the import considerably, since Time Off has to calculate the entire absence duration. As such, always enter a specific return date when possible. ● Do not load temporary work schedules on a daily basis This will also severely impact performance, since Time Off is simply not designed to read work schedules for thousands of employees every day. ● Contingent workers are not supported Please note that you cannot use Time Off to manage absences for contingent workers - only for permanent employees. ● Only letters (A-Z), numbers (0-9), dashes (-), and underscores (_) are allowed when setting up your external codes. Any other special characters like +, /, ?, &, %, and # are not supported and will cause errors. ● You cannot add any custom join-by-column associations, composites, or valid-when associations to EC Time Management MDF objects. ● The system doesn't allow users to save fields on the cancellation of an absence." If you want to edit the attachment field during cancellation, you should first edit the absence, add the attachment and save it. Afterwards cancel the absence request. ● Users aren't allowed to save fields at the time an absence is cancelled. If you want to edit the attachment field during the cancellation of an absence, you must first edit the absence, add the attachment, and save it. Then, cancel the absence request. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 317 3.5.15 Troubleshooting Time Off There are some limitations you should be aware of in Employee Central Time Off. Known Issue: Time Type Changes Without Permission [page 318] If you follow our recommendation and do not secure the time type object with RBP permissions, users, especially managers, might be able to change the time type from the Workflow UI, by way of the quick card, by choosing View Edit . Known Issue: MDF Field Property “Private or Sensitive Information” [page 319] The field property Private or Sensitive Information is not respected in Employee Central Time Off. The value is rendered as before without masking. Known Issue: Custom Fields [page 320] At this time, custom fields are not supported for time accounts and time account details in Manage Time Off or the Time Workbench. Known Issue: Team Absence Calendar [page 320] In the Team Absence Calendar, you can't view information beyond a certain point in the future. Known Issue: Field-Level Overrides for Time Off [page 321] We recommend that you do not use field-level overrides in Time Off. Known Issue: Work Schedule Finder [page 321] The Work Schedule Finder cannot find work schedules with custom Valid When associations. Known Issue: Expected Return Date [page 321] When maintaining expected return dates for consecutive leave of absences, you have to follow a number of steps. Accrual Troubleshooting [page 321] Here are some tips on various problems that can arise with accruals in Time Off. 3.5.15.1 Known Issue: Time Type Changes Without Permission If you follow our recommendation and do not secure the time type object with RBP permissions, users, especially managers, might be able to change the time type from the Workflow UI, by way of the quick card, by choosing View Edit . Tip To ensure that this doesn't happen, we suggest that you set RBP permissions for the time type object. 318 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.15.2 Known Issue: MDF Field Property “Private or Sensitive Information” The field property Private or Sensitive Information is not respected in Employee Central Time Off. The value is rendered as before without masking. So, if you enter Yes for that property, as shown here: Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 319 The result looks like this: 3.5.15.3 Known Issue: Custom Fields At this time, custom fields are not supported for time accounts and time account details in Manage Time Off or the Time Workbench. 3.5.15.4 Known Issue: Team Absence Calendar In the Team Absence Calendar, you can't view information beyond a certain point in the future. ● You can use the Team Absence Calendar to view upcoming absences for your peers and direct reports. Please note, however, that you cannot view this data beyond 31st December of the subsequent year. For example, if the current date is 15th August 2018, then in the Team Absence Calendar you can only view data until 31st December 2019. If you try to view data beyond that, you'll get an error message. ● If an employee is on global assignment with the same manager for both employments (home and host), the Team Absence Calendar for the home employment will show both home and host absences, but the calendar for the host employment will only show the host absences. 320 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.5.15.5 Known Issue: Field-Level Overrides for Time Off We recommend that you do not use field-level overrides in Time Off. Since field-level overrides are not supported on the vast majority of Time Off screens, and can cause performance drawbacks, we recommend that you do not use them for Time Off. 3.5.15.6 Known Issue: Work Schedule Finder The Work Schedule Finder cannot find work schedules with custom Valid When associations. 3.5.15.7 Known Issue: Expected Return Date When maintaining expected return dates for consecutive leave of absences, you have to follow a number of steps. Related Information Validations for Leave Of Absence (LOA) [page 63] 3.5.15.8 Accrual Troubleshooting Here are some tips on various problems that can arise with accruals in Time Off. Overview When problems occur while accruals are being generated, the log file you receive contains details of the errors so that you can put them right. Problem: Employee was not selected during accrual run. ● Check whether the employee is eligible for accruals ○ What is the job information status of the employee as of the calendar start date? Is the job info status mapped to Yes as Time Account Eligibility Status. For more information, take a look at the accrual eligibility documentation. ○ If the employee in question is newly hired, check whether he or she was not selected because of the defined waiting period for the time account type (Time from Hire to First Accrual). ○ If the employee in question is newly hired, check his or her hire date. If it is after the calendar start date, the employee will not be selected. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 321 Other Problems In the event of other problems, the log file, which gives information on successfully created accrual runs as well as those where there are problems, is communicated in any of the following ways: ● By email to the person who started the job. With this option, you can also receive log files for simulated calendar runs. ● In the Time Off calendars view, by clicking View in the display. You can then download the file if you want. ● In the EC Job Monitor. You can download the file if you want. With this option, you can also receive log files for simulated calendar runs. Features The log file gives detailed information about the reason for errors – for example, if there is an error in the rule definition. Let’s look at an example of a log file. The important points to note here are: ● The status column. There are three possible statuses: ○ CREATED: The accrual was created successfully. ○ ERROR: No accrual was created because something went wrong. The Error Reason column provides information on what this was and tells you what to do to correct the error. ○ UNCHANGED: No accrual was created because no accrual rule is assigned, as the Error Reason column confirms. 3.6 Implementation of Time Sheet Learn how to implement Time Sheet so that employees can record their working time. Employees record their working time in a time sheet and submit their recorded time to an approver, either a manager or an HR administrator. After approval, the recorded working time is sent for further processing, typically to payroll or to a type of time account. 322 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management The implementation of time recording includes a basic setup and the implementation of the time recording scenarios that are required by your organization. 3.6.1 Basic Setup of Time Sheet SAP SuccessFactors supports a number of different time recording scenarios. Before you can implement the specific time recording scenarios that are required by your organization, you need to go through some basic implementation steps. The basic implementation steps of time recording are based on the core time recording scenario. All specific time recording scenarios build on this core time recording scenario. Core Time Recording Scenario Employees typically use a time sheet to record their working time. This time sheet includes all days of their working week. Employees record their working time daily, but typically send the time sheet for review on a weekly basis. An approver, usually a manager or an HR admin, reviews the time and, if there are no issues, approves the time sheet. The approved time sheet is then processed by payroll. Implementation Steps of the Core Time Recording Scenario You activate the time sheet that employees use to record their time. Because the first day of a working week can differ, you also define the first day of their working week. The approval of time sheets includes workflows that you configure. Because the recorded working time is typically sent to Employee Central Payroll, you set up the connection between the time sheet and Employee Central Payroll. Further Mandatory Implementation Steps Apart from the core implementation scenario there are some other mandatory implementation steps on which all time recording scenarios depend. You define time recording profiles, which you later on use to configure time recording settings for groups of employees. You also need to define the different roles and permissions that control how the time sheet is used. Optional Implementation Steps There are also some general optional settings. You can activate the Time Management Configuration Search, set up email notifications, and enable time sheet fields in the employee job information. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 323 1. Defining the First Day of the Time Sheet Week [page 324] Not all working weeks start on the same day. Define the first day of the week so that the time sheet accurately reflects the working week of your employees. 2. Creating an Attendance Time Type [page 326] Create time types and classify them as Attendance. Assign these time types to a time profile. 3. Creating a Break Time Type (Clock Time-Based Recording Only) [page 327] Enable deductions for unpaid breaks. Create time types and classify them as breaks. Assign these time types to the time profiles of all relevant employees. 4. Assigning Time Types to Time Profiles [page 328] Assign time types, break types, and on-call time types to existing employee time profiles. 5. Creating a Time Recording Profile [page 329] Define time recording profiles so that you can determine time recording settings for employees. 6. Enabling the Assignment of Time Sheet Master Data to Employees [page 332] Enable fields in Manage Business Configuration under jobInfo. 3.6.1.1 Defining the First Day of the Time Sheet Week Not all working weeks start on the same day. Define the first day of the week so that the time sheet accurately reflects the working week of your employees. Procedure 1. Go to the Admin Center and choose Manage Data and Time Valuation Period. 2. Define a unique external code and external name. 3. Set Length to One Week. 4. Specify the first day of the time sheet week in the First Day of Week field. Note If employee groups in your organization have different first days of the week, create multiple Time Valuation Period objects with different first days of the week. 5. Create a time recording profile. 6. Assign a time valuation period to the time recording profile. 7. Assign the time recording profile to the employees in their job information. Caution Retroactive assignments aren’t possible. 324 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Results The first day of week is the start day of the weekly calendar in the time sheet and the start day for weekly time valuations. Task overview: Basic Setup of Time Sheet [page 323] Next task: Creating an Attendance Time Type [page 326] 3.6.1.1.1 Changing the First Day of the Time Sheet Week Assign a new time recording profile with a different first day of the week. Context The working week is different from country to country. For example, it's Monday to Sunday in Germany and Sunday to Saturday in the US. The working week can differ between different employee groups within the same organization. Therefore, you can configure the first day of the working week for time recording and time valuation. Procedure 1. Assign a new time recording profile with a different first day of the week in the employee's Job Information. 2. Make sure that the employee hasn't submitted time sheets that are valid on or after the effective date of the new Job Information record. Note If the employee has submitted time sheets on or after the effective date of the change, delete the entire Employee Time Sheet instance. Use the Manage Data transaction in the Admin Center. The employee has to record the deleted time again. Results Depending on a number of factors, either one or two time sheets with a validity period of less than 7 days is created. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 325 3.6.1.2 Creating an Attendance Time Type Create time types and classify them as Attendance. Assign these time types to a time profile. Context The time type describes the business semantic of a time data record. For Time Sheet, time types with the classification Attendance are relevant. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type. 3. Enter an external name and an external code that is no longer than 10 characters. 4. Set Classification to Attendance. 5. Select the time unit Hour(s). 6. To create a time type for a country/region, enter a country/region. The country/region you enter here must match the country/region in the time profile to which this time type is assigned. 7. Assign your attendance time types to the time profiles of all relevant employees. Task overview: Basic Setup of Time Sheet [page 323] Previous task: Defining the First Day of the Time Sheet Week [page 324] Next task: Creating a Break Time Type (Clock Time-Based Recording Only) [page 327] 326 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.1.3 Creating a Break Time Type (Clock Time-Based Recording Only) Enable deductions for unpaid breaks. Create time types and classify them as breaks. Assign these time types to the time profiles of all relevant employees. Context Employees who record their attendance time using clock times can have scheduled unpaid breaks automatically deducted from their working time. They can also manually record unpaid break times in the time sheet. Create a time type for each break type you need. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type. 3. Enter an external name and a meaningful external code. 4. In the Classification field, select Break. 5. Select the time unit Hour(s). 6. Make the time type country-dependent by selecting a country. The country you select must match the country in the time profile to which this break time type is assigned. 7. Assign your break time types to the relevant employee time profiles. Task overview: Basic Setup of Time Sheet [page 323] Previous task: Creating an Attendance Time Type [page 326] Next task: Assigning Time Types to Time Profiles [page 328] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 327 3.6.1.4 Assigning Time Types to Time Profiles Assign time types, break types, and on-call time types to existing employee time profiles. Context The time profile is used to specify the various time types and allowance types that an employee can use in the Time Sheet to record their time. You also use the time profile to assign a main attendance and a main break time type to employees. To view the time profile assigned by choosing Employment Information Job Information Time Information . Procedure 1. Go to the Admin Center and choose Manage Data. 2. Search for the relevant time profile. 3. Assign all required time types in the Available Time Type field. 4. Assign the attendance time types you require. a. Maintain the Enabled in employee self-service scenario and Favorite Time Type fields. b. Define a unique external code for each assignment you make. 5. Decide whether to enable the time type for the Employee Self-Service scenario or not. ○ To allow employees to record time against the time type in their time sheet, select Yes. ○ To restrict editing of the time type to authorized employees, such as a time administrator, select No. 6. Select up to three time types defined in a time profile as favorites (optional). Note Don't give the favorites names that are longer than 20 characters. If you select Yes in the Favorite Time Type field, the time type appears as an individual button in the Time Off UI. The time type appears in the balance overview section of the Time Off UI. Because this feature is only relevant for Time Off time types such as vacation or sick leave, choose No in this field for all timesheet-relevant time types. 7. Define one of the assigned attendance time types as the default attendance time type in the Main Attendance Time Type field (optional). The time type you enter here then acts as the default time type for time recording by employees using this time profile. Note You can't set Enabled in employee self-service scenario for the main attendance time type to No. So, you can't prevent employees from changing the main attendance time type in their time sheet. 328 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 8. Assign the break time types you require. a. Maintain the Enabled in employee self-service scenario and Favorite Time Type fields. b. Define a unique external code for each assignment you make. c. Define one of the assigned break time types as the default break time type in the Main Break Time Type field. 9. Assign the on-call time types you require. a. Maintain the Enabled in employee self-service scenario and Favorite Time Type fields. b. Define a unique external code for each assignment you make. Task overview: Basic Setup of Time Sheet [page 323] Previous task: Creating a Break Time Type (Clock Time-Based Recording Only) [page 327] Next task: Creating a Time Recording Profile [page 329] 3.6.1.5 Creating a Time Recording Profile Define time recording profiles so that you can determine time recording settings for employees. Context Caution You can't update time recording profiles that are already in use. Time recording profiles bundle various time types and allowance types. You also use time recording profiles to assign a main attendance and a main break time type to employees. If employees use time accounts, time recording profiles define if a manager must approve of an accrual of overtime in a time account. There are separate fields for working time accounts and for TOiL accounts. Caution Don’t change a time recording profile that has already been used in your production system for a group of employees. The parameters of the changed time recording profile no longer match the ones previously used to generate the time valuation results for the employees’ existing time sheets. You can no longer reproduce how these time valuation results came about. Create a new time recording profile with the adjustments and assign it to the relevant employees with an effective date in the future. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 329 Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time recording profile. 3. Enter a unique external name and external code for the time recording profile. 4. Assign a time valuation period. 5. Select a time recording variant and a time recording method. 6. Enter the approval workflow for your time sheet in the Workflow Configuration field. 7. Specify time valuation rules. 8. Specify validation rules. Next Steps Assign the time recording profile to an employee or a group of employees. Task overview: Basic Setup of Time Sheet [page 323] Previous task: Assigning Time Types to Time Profiles [page 328] Next task: Enabling the Assignment of Time Sheet Master Data to Employees [page 332] 3.6.1.5.1 Time Recording Methods Time recording methods include positive time recording, overtime recording, negative time recording, and absences-only time recording. Positive Time Recording Employees record all the hours they actually work (their ‘attendance time’), in addition to overtime, absences, on-call time, and allowances. Overtime Recording Employees record only the time they work that is in addition to their planned working time, plus on-call time and allowances. 330 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Negative Time Recording Employees record only deviations (exceptions) from their planned working time. Other exceptions such as oncall time, allowances, and overtime can also be recorded using this method. Time sheet entries are generated automatically for the main attendance time types, based on the scheduled working time. These are then ‘merged’ in the time sheet with the actual recording of deviations by employees from their scheduled time, to produce the overall recorded time for the period under consideration. Absences-Only Time Recording Employees record only absences, for example, for reporting/internal administrative purposes only. This time recording method could apply, for example, to an executive level employee who receives a set compensation package where no overtime is recorded or paid. 3.6.1.5.2 Configuring Time Sheet Workflows You can configure an approval workflow for time sheets. Approvers can approve or decline a complete weekly time sheet submitted by an employee. Procedure 1. Create a business rule in the scenario base object Employee Time Sheet. Metadata Framework Rules for MDF Based Objects with the 2. Set Purpose to Workflow. 3. In the Then section, set Workflow Context.Workflow Configuration to to be equal to Get Time Sheet Approval Workflow Configuration(). 4. Set User ID to Employee Time Sheet.User. 5. Set Job Info Effective Date to Employee Time Sheet.Start Date. 6. In the object Employee Time Sheet, assign the rule in the Save Rules section. 7. Create a workflow and add the workflow in the time recording profile assigned to the employee. Related Information Workflows in SAP SuccessFactors Employee Central Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 331 3.6.1.6 Enabling the Assignment of Time Sheet Master Data to Employees Enable fields in Manage Business Configuration under jobInfo. Context There are some fields you must enable if you want them to appear in Job Information under Time Information for all your employees using the Time Sheet. Procedure 1. Go to the Admin Center and choose Manage Business Configuration. 2. Choose jobInfo. 3. Select Yes in the Enabled field for Time Recording Profile, Time Recording Variant, Time Recording Admissibility, and Default Overtime Compensation Variant. Task overview: Basic Setup of Time Sheet [page 323] Previous task: Creating a Time Recording Profile [page 329] 3.6.2 Permissions in Time Sheet When you implement time recording in SAP SuccessFactors, you also define which users can access which time recording functionality. By default, users can’t access and maintain time sheets. Therefore, you need to enable users to access and maintain time sheets. You also define which time recording objects users can access and how they can access them by setting up role-based permissions. Another aspect of user management in time recording is defining if and how users can change, or amend, time sheets that have already been approved. Enabling Users to Access Time Sheets [page 333] Secure the time sheet objects and grant users access to these objects so that users can access their own or their employees' time sheets and view time sheets in Manage Data. Enabling Users to Maintain Time Sheets [page 334] Grant employees, managers, and HR admins the Time Sheet permission. Setting Up Role-Based Permissions for Employee Self-Service [page 335] Set up permissions for Time Recording Profile, Time Recording Variant, Time Recording Admissibility, and Default Overtime Compensations Variant. Granting Users Manager or HR Admin Permissions [page 336] 332 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Grant users manager or HR role permissions for the time recording profile, time recording variant, time recording admissibility, and default overtime compensation variant. Set up role-based permissions in the Time Information section under Job Information. 3.6.2.1 Enabling Users to Access Time Sheets Secure the time sheet objects and grant users access to these objects so that users can access their own or their employees' time sheets and view time sheets in Manage Data. Context Note All new objects are secured by default. You can't turn off this security. The secured objects have the permission category Time Management Object Permissions. The configuration of existing objects isn’t affected. Procedure 1. Go to the Admin Center and choose Configure Object Definitions. 2. Open one of the relevant object definitions: ○ Employee Time Sheet ○ Employee Time Sheet Entry ○ Employee Time Valuation Result ○ Allowance 3. Choose Take Action and Make Correction. 4. Set Secured to Yes and select the permission category Time Management Object Permission. 5. Save your changes. 6. Repeat these steps for the other relevant object definitions. 7. Go back to the Admin Center and choose Manage Permission Roles. 8. Select the permission role for time sheet users. 9. Choose Permission.... 10. Go to the User Permissions section and choose Time Management Object Permission. 11. Select View for each relevant object. 12. Select Edit for objects that you want users to edit. 13. Choose Done and save your changes. Task overview: Permissions in Time Sheet [page 332] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 333 Related Information Enabling Users to Maintain Time Sheets [page 334] Setting Up Role-Based Permissions for Employee Self-Service [page 335] Granting Users Manager or HR Admin Permissions [page 336] 3.6.2.2 Enabling Users to Maintain Time Sheets Grant employees, managers, and HR admins the Time Sheet permission. Context Employees require the Time Sheet permission to record maintain their time sheets. Managers and HR admins require the Time Sheet permission to maintain time sheets for employees. Procedure 1. Go to the Admin Center and choose Manage Permission Roles. 2. Select the permission role for employee self-service. 3. Choose Permission.... 4. Choose Employee Views and select the Time Sheet. 5. Repeat these steps for the permission role for managers. 6. Repeat these steps for the permission role for HR admin. Task overview: Permissions in Time Sheet [page 332] Related Information Enabling Users to Access Time Sheets [page 333] Setting Up Role-Based Permissions for Employee Self-Service [page 335] Granting Users Manager or HR Admin Permissions [page 336] 334 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.2.3 Setting Up Role-Based Permissions for Employee Self-Service Set up permissions for Time Recording Profile, Time Recording Variant, Time Recording Admissibility, and Default Overtime Compensations Variant. Context Note All new objects are secured by default. You can't turn off this security. The secured objects have the permission category Time Management Object Permissions. The configuration of existing objects isn’t affected. If you want to grant the users who are assigned to Employee Self Service, Manager, and HR Role roles either the view or maintenance permissions for Time Recording Profile, Time Recording Variant, Time Recording Admissibility, and Default Overtime Compensation Variant fields within the Time Information section under Job Information, implement role-based permissions. Procedure 1. Go to the Admin Center and choose Manage Permission Roles. 2. Select the permission role for system admins. 3. Choose Permission..... 4. Go to the Administrator Permissions section, choose Manage System Properties, and select Employee Central Feature Settings. Task overview: Permissions in Time Sheet [page 332] Related Information Enabling Users to Access Time Sheets [page 333] Enabling Users to Maintain Time Sheets [page 334] Granting Users Manager or HR Admin Permissions [page 336] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 335 3.6.2.4 Granting Users Manager or HR Admin Permissions Grant users manager or HR role permissions for the time recording profile, time recording variant, time recording admissibility, and default overtime compensation variant. Set up role-based permissions in the Time Information section under Job Information. Context Note All new objects are secured by default. You can't turn off this security. The secured objects have the permission category Time Management Object Permissions. The configuration of existing objects isn’t affected. Procedure 1. Go to the Admin Center and choose Manage Permission Roles. 2. Select Employee Self Service in the permission role list and choose Permission.... 3. In the User Permissions section, choose Employee Central Effective Dated Entities. 4. Select the first two checkboxes of the Time Recording Profile, Time Recording Variant, Time Recording Admissibility, and Default Overtime Compensation Variant entries. 5. Choose Finished and save your changes. Task overview: Permissions in Time Sheet [page 332] Related Information Enabling Users to Access Time Sheets [page 333] Enabling Users to Maintain Time Sheets [page 334] Setting Up Role-Based Permissions for Employee Self-Service [page 335] 336 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.2.4.1 Granting the Permission to Trace Time Valuations Enable mangers and HR administrators to trace how information in a time sheet was arrived at by granting them the permission to trace time valuations. Context If set up role-based permissions for managers and HR administrators, you must grant them the permission to trace time valuations. Note All new objects are secured by default. You can't turn off this security. The secured objects have the permission category Time Management Object Permissions. The configuration of existing objects isn’t affected. Procedure 1. Go to the Admin Center and choose Manage Permission Roles. 2. Select the relevant role in the permission role list and choose Permission.... 3. In the User Permissions section, choose Manage Time. 4. In the resulting screen, select the View Time Valuation Trace checkbox. 5. Choose Finished and save your changes. Results The HR administrator and manager can use a Trace button from an employee's time sheet to view how information in that time sheet was arrived at. 3.6.2.4.2 Granting Access to Time Collectors Enable mangers and HR administrators to access time collectors. Context If set up role-based permissions for managers and HR administrators, you must grant them this permission. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 337 Note All new objects are secured by default. You can't turn off this security. The secured objects have the permission category Time Management Object Permissions. The configuration of existing objects isn’t affected. Procedure 1. Go to the Admin Center and choose Manage Permission Roles. 2. Select the relevant role in the permission role list and choose Permission.... 3. In the User Permissions section, choose Manage Time. 4. In the resulting screen, select the Access Time Collectors check box. 5. Choose Finished and save your changes. 3.6.2.4.3 Granting Access to the Time Workbench Enable mangers and HR administrators to access the Time Workbench. Context If set up role-based permissions for managers and HR administrators, you must grant them this permission. Note All new objects are secured by default. You can't turn off this security. The secured objects have the permission category Time Management Object Permissions. The configuration of existing objects isn’t affected. Procedure 1. Go to the Admin Center and choose Manage Permission Roles. 2. Select the relevant role in the permission role list and choose Permission.... 3. In the User Permissions section, choose Manage Time. 4. In the resulting screen, select the Access Workbench checkbox. 5. Choose Done and save your changes. 338 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.3 New Time Sheet UI A new employee self-service (ESS) user interface for attendance recording is available. This new UI supports accessibility standards and can be used on both desktop and mobile browsers. You can upgrade to the new UI in the Upgrade Center. Important Notes: ● Before you choose to upgrade, we strongly recommend that you test the new UI in your test instance, or in your production instance via the following URL (simply replace the placeholder with your own company URL): www.<placeholder>.com/xi/ui/attendancerecording/pages/sap/sf/ attendancerecording/timesheet/index.xhtml This will give you the opportunity to assess the new UI and prepare user guides and rollout material for your employees. ● You must ensure that you only use supported custom fields. Otherwise, the reimagined UI will display an error message. The link in the Related Information section provides more information. ● After the upgrade, the new Time Sheet UI will be available to all users. It isn’t possible to only apply the upgrade to a select group of users. ● If you want to undo the upgrade, you can do so within 30 days of the initial upgrade. ● The new time sheet UI doesn't support Microsoft Internet Explorer 11. Features of the New Time Sheet UI In addition to all the standard features of the old Time Sheet UI, here are some of the most notable aspects of the new UI. ● A two-month calendar overview that displays the status of previous time sheets, so employees can keep track of their scheduled payments. You open this calendar by using the Calendar button. ● Responsive to screen size, meaning it always displays the correct amount of information for the user's specific screen. ● Can be used on both desktop and mobile browsers, and fully supports accessibility standards. ● You can use all functionality included in the SAP SuccessFactors Time Tracking subscription. Related Information Limitations Of New Time Sheet UI 3.6.4 Customization of Attendance Recording Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 339 3.6.4.1 Break Time Recording 3.6.4.1.1 Setting Up Scheduled Breaks Add the start time and end time of the scheduled unpaid break to a work schedule day model. Prerequisites ● You've created a work schedule day model and defined scheduled working time. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Open the work schedule day model to which you want to add the scheduled unpaid break. 3. Choose Take Action and Make Correction. 4. Go to the Segments section and set Category to Scheduled Unpaid Break. 5. Enter the start time and end time of the scheduled unpaid break. 6. Save your changes. 3.6.4.1.2 Setting Up Dynamic Breaks If you want, you can specify that employees are entitled to dynamic rather than fixed breaks. The difference between the two is that fixed breaks are always at a particular time (for example, from 12:00- 12:45) whereas dynamic breaks occur automatically after an employee has worked a certain amount of time (for example, after 6 hours of work they are entitled to a 45-minute break). Prerequisites Determine whether you want or need to use dynamic breaks. For instance, in many countries it is a legal obligation to provide employees with a minimum break after a certain amount of working hours, so dynamic breaks are a convenient way to ensure that this happens automatically. Another benefit is that they will cover “unexpected” working times – for example, if an employee comes in on Saturday when no fixed break exists in the working schedule. 340 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note ● If both fixed breaks and dynamic breaks are scheduled for the same day, the fixed breaks will always take priority. ● Unlike with fixed breaks, employees cannot manually remove dynamic breaks from their working times. They can shorten or extend the length of the break by changing their start/end times for the day, but a proportionately determined break will always be automatically deducted from their working time. Procedure 1. Add the new dynamic break field to jobInfo. a. In the Admin Center, go to Manage Business Configuration. b. Select jobInfo from the tree on the left-hand side and add a new field with these settings: ○ Identifier: dynamic-break-config-code ○ Section: Time Off Information ○ Label: Assign a name ○ Enabled: Yes ○ Details Visibility : Edit 2. Assign the necessary permission. a. In the Admin Center, go to Manage Permission Roles. b. Under Employee Central Effective Dated Entries select all the checkboxes. Job Information Dynamic Break Configuration , 3. In the Admin Center Manage Data , create an create a new MDF object for dynamic breaks. Give the object an External Name and an External Code, and specify the following: ○ Method of Generating Breaks: Choose whether you want to generate breaks using partial deduction (which will generate partial breaks if there's not enough recorded working time or absences left) or full deduction (which could mean that the break starts earlier than specified in the dynamic breaks rule). ○ Gaps in Working Time: Choose whether you want the system to consider any and all gaps in working time as breaks, or just ignore them. ○ Working Time and Accumulated Break in Minutes: Specify how long employees need to work before they can take a break, and how long that break should be. 4. Assign the dynamic break object to all relevant users in jobInfo. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 341 3.6.4.2 Adding Additional Validation Checks for Attendance Recording Create a business rule for your time sheet validation. Context Tip To limit what users can enter in their time sheets, use time valuations rather than validation rules. Use validation rules only when valuating allowances. Validations are business rules that check time sheet entries for criteria you define. For example, you can define a validation that checks whether a particular time type is allowed on a particular day of the week. Restriction A general restriction is that validations can only check data entered per time type. They can't check the total entered for all the time types in a time sheet. Please also note that the Time Sheet Validation scenario has the following specific restrictions: ● You can't set any Always True flags. ● You can only raise messages with Error severity. ● contextUser is not supported: Procedure 1. Go to the Admin Center and choose Configure Business Rules. 2. Select the Time Sheet Validation scenario. You might see a scenario called Time Sheet Validation (Deprecated). Please ignore this - it's now obsolete, and shouldn't be used anymore. 3. Enter a rule name, rule ID, start date, and, if you need it, a description. 4. Choose Continue. 5. Enter the details of how you want to apply your time sheet validations. The IF condition of your rule consists of one or more time sheet day objects. Note At this time, only messages with severity Error are supported as possible output. If you enter messages with severity Warning or Information, nothing is displayed. 6. Enter your validation rule in your desired time recording profile. 342 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Restriction The system doesn't support time sheet validation by means of saveRules or validateRules directly attached to the Employee Time Sheet object. Such validation can lead to exceptions when the background jobs are processed. 3.6.4.3 Admissibility Rules Learn more about admissibility rules. Admissibility rules define which actions are possible. 3.6.4.3.1 Creating Admissibility Rules That Prevent Amendments You can prevent employees from changing time sheets that have been processed by payroll. To prevent employees from changing time sheets that have been approved, create admissibility rules that prevent amendments. Context By default, employees can amend time sheets without restrictions. Admissibility rules restrict how employees can amend time sheets. Note Admissibility rules don't apply to managers and HR administrators. Procedure 1. Go to the Admin Center and choose Manage Data. 2. In the Create New field, select Time Recording Admissibility. 3. Provide a unique external code and external name. 4. Set Amendments Allowed to No. 5. Save your changes. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 343 Next Steps Assign the admissibility rule to employees. 3.6.4.3.2 Creating Admissibility Rules That Define When Amendments Are Permitted You can prevent employees from changing time sheets that have been processed by payroll. To limit how far back employees can change time sheets that have been approved, create admissibility rules that define periods when amendments are permitted. Context By default, employees can amend time sheets without restrictions. Admissibility rules restrict how employees can amend time sheets. Note Admissibility rules don't apply to managers and HR administrators. Procedure 1. Go to the Admin Center and choose Manage Data. 2. In the Create New field, select Time Recording Admissibility. 3. Provide a unique external code and external name. 4. In the Past Weeks field, specify the number of weeks in the past employees are allowed to amend time sheet entries. 5. Save your changes. Next Steps Assign the admissibility rule to employees. 344 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.4.4 Creating Custom Fields for Time Sheet Create custom fields in the Employee Time Sheet Entry and Allowance object definitions. Context If the standard fields for time sheet entries or allowances don’t cover all your requirements, you can create your own custom fields in Time Sheet. Custom fields for Time Sheet are available in the Employee Time Sheet Entry and Allowance objects. Custom fields defined there are available within the Details section of the time sheet. Note In the Employee Time Sheet Entry object, don't assign rules in the Details section of a custom field to determine its visibility based on conditions derived at runtime. Note If you create custom fields and later delete them, both the custom fields and any content entered in them are deleted. Note Don't give your custom fields the same name as any of the existing standard fields. Note Don't set custom fields to Required. Note You can't display seconds in custom fields of type Time and DateTime in EmployeeTimeSheetEntry as well as in Allowances. Procedure 1. Go to the Admin Center and choose Configure Object Definitions. 2. Search for the Employee Time Sheet Entry object definition. Note There's a separate Allowance object. You create custom fields for allowances in that object. To create Allowance objects, choose Configure Object Definitions and select Allowance as the object. Data entered in custom fields in the Allowance object doesn't affect time valuation and isn’t passed on to Payroll. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 345 3. Choose Make Correction Take Action . 4. Scroll down to the end of the Fields section. 5. In the first blank line of the section, enter a technical name in the Name field. 6. Specify a maximum length for your custom field and its data type. The system will preface your chosen technical name with cust_ to denote it as a custom field. 7. Choose Details and add all required data for each of your custom field including an entry in the Label field. a. Enter a field label. The field label is the label of your custom field in the time sheet. b. Ensure that the Visibility field is set to Editable. 8. Hide the Deviating Cost Center standard field by choosing Details and setting the Visibility field to Not Visible (optional). Note You can't hide the standard fields Duration and Time Type. 9. Choose Done and save your changes. Restrictions on Custom Fields in Time Sheet [page 346] There are restrictions on how many custom fields you can use in some generic objects in Employee Central Time Sheet. 3.6.4.4.1 Restrictions on Custom Fields in Time Sheet There are restrictions on how many custom fields you can use in some generic objects in Employee Central Time Sheet. ● In the Employee Time Sheet object, do not use more than 5 decimal fields, 5 string fields, 5 number fields, and 5 date fields. ● In the Employee Time Sheet Entry object, do not use more than 10 decimal fields, 15 string fields, 15 number fields, and 10 date fields. ● In the Allowance object, do not use more than 5 decimal fields, 5 string fields, 10 number fields, and 5 date fields. ● In the Employee Time Valuation Result object, do not use more than 10 decimal fields, 10 string fields, 5 number fields, and 5 date fields. 346 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.5 Additional Time Recording Options Learn more about the different time recording options: allowance types, on-call time types, and extra time types. 3.6.5.1 Creating an Allowance Type Enable employees to record allowances by creating allowance types. Assign your allowance types to the time profiles of all relevant employees. Context Allowances are part of an employee's salary that is compensation for special working conditions, such as shift work or high-risk work. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create an allowance type. 3. Enter an external name and a meaningful external code. 4. Select the time unit Hour(s). 5. Make the allowance type country-dependent by selecting a country. The country you select must match the country in the time profile to which this allowance type is assigned. 6. Assign your required allowance types to the relevant employee time profiles. Assigning Allowance Types to Time Profiles [page 348] Assign allowance types to time profiles in the Available Allowance Type section of the relevant time profile. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 347 3.6.5.1.1 Assigning Allowance Types to Time Profiles Assign allowance types to time profiles in the Available Allowance Type section of the relevant time profile. Context After defining your attendance time types, break time types, on-call time types, and allowance types, you assign them required to existing employee time profiles. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Search for the relevant time profile. 3. Assign all required allowance types in the Available Allowance Type section. 4. Select an allowance type from the available options. 5. Maintain the Enabled in employee self-service scenario field. ○ To enable employees assigned to the time profile to record against this allowance type in their time sheet, select Yes. ○ If you don’t want employees to record against this allowance type in their time sheet, select No. Only the employee's supervisor or manager can record allowances of this type on behalf of an employee. 6. Define a unique external code for the allowance type. Task overview: Creating an Allowance Type [page 347] 3.6.5.2 Creating an On-Call Time Type Enable employees to record on-call time by defining time types with the classification On-Call. Assign the time types to the relevant employee time profiles. Context On-call duty is a form of employment duty. An employee isn’t present at the workplace but is ready and available to be called into work for specific tasks. Examples include emergency maintenance or covering for unforeseen absences of colleagues. Create a time type for each on-call type you need. 348 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type. 3. Enter an external name and a meaningful external code. 4. In the Classification field, select On call. 5. Select the time unit Hour(s). 6. Make the time type country-dependent by selecting a country. The country you select must match the country in the time profile to which this on-call time type is assigned. 7. Assign your on-call time type to the relevant employee time profiles. 3.6.5.3 Creating an Extra Time Type Define extra time types so that users can record additional time information that further specifies recorded attendance time. Context Collision checks prevent the recording of concurrent times for an employee. However, some scenarios require that recorded attendance time is further specified. Extra time types enable users to further specify certain attendance times without causing a collision. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type. 3. Enter an external name and a meaningful external code. 4. In the Classification field, select Extra. 5. Select the time unit Hour(s). 6. Assign the extra time types to the relevant employee time profiles. Next Steps To use the extra time type in a time valuation, create an extra time type group. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 349 3.6.6 Time Valuations Time valuations generate time valuation results, which provide the basis upon which employees are paid for the time they record. Time valuations process (valuate) input time data, calculate an employee's time, and generate time valuation results. Time valuation results provide the basis upon which employees are paid for the time they record. You must define time valuations to calculate time valuation results in Employee Central Time Sheet. You define time valuations by assigning time type groups for the input of time data and output of calculated times (hours), counted events, and by processing instructions on how to calculate these times from the time data coming from the input time type groups. This picture shows a simple time valuation using the time valuation type Aggregate Input Group and Split with three input time type groups and a threshold group as the input of the valuation. The output of the valuation is split with reference to the value from the threshold group, into: ● A time type group up to that value ● A time type group above that value Depending on your requirements, you can define time valuations on a daily or weekly basis (for example, for overtime calculation per day or per week) or on the basis of time collectors. You can also set up the time data for input in a flexible way where, for example, specific absence time types are taken or not taken into account for overtime calculation. You can achieve this in a variety of ways. However, it is executed according to the valuation type you set within each of your time valuation objects. 3.6.6.1 Valuation Types This is an overview of the valuation types provided by Employee Central Time Sheet. Employee Central Time Sheet provides a number of valuation types. Each type of time valuation has its own distinct use case. However, it is likely that you will use a combination of these valuation types to construct the time valuation runs you require for the Time Sheet. 350 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management This table provides an overview of the time valuation types you can use and links to more detailed information: Table 26: Available Valuation Types Valuation Type Aggregate Input Group and Split Description Aggregates (combines) input data from Valuates duration-based time data different input groups of time data and applies a pre-defined threshold to split the input time data into two distinct output time type groups. Filter Input Groups Typically used for Valuates clock time-based time data, taking into account only the durations of this data Valuates input time data using time re­ Valuates premium pay, based on cer­ cords filters. These filters are applied tain criteria such as weekday or shift within the valuation to derive premium classification pay. Filter Segments from Input Groups Valuates input time data using time Valuates clock time-based time data, segments filters. These filters are ap­ where explicitly defined time intervals plied within the valuation to derive (segments) are extracted from clock- clock-based times recorded by employ­ based recorded time ees. Deduct Group from Input Group Valuates input time data using deduc­ Valuates deductions from clock time- tion groups. These groups are applied based time data, such as unpaid sched­ within the valuation to derive clock- uled breaks. Here, time intervals (seg­ based time recorded by employees. ments) contained in another time type group (the deduction group) are ex­ tracted from clock-based recorded time. Difference Between Threshold and Input Calculates the difference between the Valuates the balance on a working time threshold time type group and the in­ account that records instances where put time type groups. an employee works less or more time than planned. Compare Threshold with Input Groups and Count Events Acts as an event counter. It examines Used for time collectors. the time records from its input group each day and if the input exceeds the threshold, the valuation counts 1 event. Compare Threshold with Comparison Group to Route Input Compares the time type group defined Determining time off in lieu (TOIL) pay­ as comparison group against a fixed ments. value and routes the data accordingly. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 351 3.6.6.2 Creating a Time Type Group On the Manage Data screen, create a time type group and specify the field values as required. Context Time type groups allow you to assign sets of time types as the source of time data. They also allow you to derive time data from the employee work schedule or holiday calendar. Time type groups are containers for intermediate and final time pay types, which themselves form the basis of time valuation results for employees. Time type groups used for output of a valuation must have the time category Calculated Time or Counted Events. Users can't assign time types to them. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type group. 3. Enter a meaningful external name and external code. For time type groups marked as being a time pay type, this name is used in data transfer to payroll systems. This key must therefore remain stable after the time type group is created. Note If the time type group is assigned as a time pay type, don't enter an external code that is longer than 10 characters. 4. Specify the values in the Valuation Result Category and Valuation Result Factor fields as required. These two fields are relevant in the following scenarios: ○ When you set up time type groups for time off in lieu of overtime pay. ○ When you take account of working time differences. Note When you take account of working time differences, enter 1 as the valuation result factor. 5. Select a time category. The time category indicates what kind of time data the time type group is holding, and what the source of this time data is. 352 Time Category Description Working Time, Recorded Overtime Attendance time types assigned to the time type group are considered. PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Time Category Description Paid Absences, Unpaid Absences, Time data is derived from times entered on the Payroll Time Sheet UI. Only time entries that correspond to the set of Unpaid Overtime Relevant Absences Time data is derived from times entered on the Payroll Time Sheet UI. Only timeTime data is derived from absen­ ces entered in Time Off. Only absences that correspond to the set of Absence time types assigned to the time type group are considered. Paid Holidays Time data is derived from the employee’s holiday calen­ dar. Scheduled Working Time Time data is derived from the employee’s work schedule. On-Call Time Time data is derived from times entered on the Payroll Time Sheet UI. Only time entries that correspond to the set of On-Call time types assigned to the time type group are considered. Unpaid Break Time data is derived from break times entered on the Pay­ roll Time Sheet UI. Only time entries that correspond to the set of Unpaid Break time types assigned to the time type group are considered. Scheduled Unpaid Break Time data is derived from the clock times of scheduled unpaid breaks within an employee's scheduled working time, taken from the work schedule. Calculated Time Time data is derived from the output of a time valuation. You select Calculated Time, for example, when you want to create time type groups above and time type groups be­ low, as part of a time valuation. Counted Events As with calculated time, time data is derived from the out­ put of a time valuation. You select Counted Events, for ex­ ample, when you want to create time type groups above and time type groups below, as part of a time valuation. Flextime Bandwidth Time data is derived from the flextime bandwidth defined in the work schedule. Extra As with calculated time, time data is derived from the out­ put of a time valuation. You select Extra, for example, when you want to create time type groups above and time type groups below, as part of a time valuation. 6. Set UI Component and Time Pay Type to Yes. 7. Assign the time types relevant for this time type group. Note You can’t assign time types to time type groups with time category Calculated Time, Scheduled Working Time, Counted Events, or Paid Holidays. 8. Specify whether the time type group is a time collector. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 353 3.6.6.3 Creating Time Valuations That Raise Error Messages To prevent employees from entering time values that aren't permitted, create time valuations that raise error messages. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set the valuation type. 4. In the Error Flag field, specify on which time type group the message is raised. 5. In the Error Message field, enter an appropriate message text. 6. Set Error Type to Error. 7. In the Input Time Type Group field, enter the time group to which the time valuation applies. Results If employees try to enter a time value that isn’t permitted, an error message is raised. 3.6.6.4 Setting Up Time Valuations That Prevent Time Recording To prevent employees from recording time on specific days at specific times, set up time valuations that prevent time recording. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Filter Input Groups. The time records filter and the time segment filter are displayed. 4. Apply the time records filter to the weekdays on which you want to prevent time recording. 5. In the time segments filter, add time segments for times for which you want to prevent time recording. 6. Specify the time type group below and the time type group above. 354 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management The time type group below contains input time data that fits all specified filter criteria. The time type group above collects all input time data that doesn’t pass through the filter criteria defined for this time valuation. 7. Set Error Flag to Raise error message on time type group above. 8. In the Error Message field, enter an appropriate message text. 9. Set Error Type to Error. 10. In the Input Time Type Groups field, enter all relevant time type groups from which you must calculate the output of the time valuation. You can enter a time type group from any time category as an input time type group. Note If you enter an input time type group with an associated Calculated Time time category, it must be calculated within the same time valuation run as the output of another time valuation. This time valuation must also be assigned to the employee’s time recording profile. 11. Save your new time valuation. Caution Within a time valuation, the input time type groups must be different from the time type groups assigned to the Time Type Group Above and Time Type Group Below. 12. Add the time valuation you created in the previous steps to the time recording profiles of all applicable employees. Results If an employee tries to record time on days or at times when time recording is prevented, an error message is displayed. 3.6.6.5 Configuring the Sequence of Time Valuation Results Configure how time valuation results appear in Time Sheet by using the external code of the time type group. Prerequisites Ensure that the UI Component field is set to Yes in the respective time type groups. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 355 Context The Week Summary Area of the time sheet contains a breakdown of the time valuation results for the displayed calendar week time. Without specific configuration, these time valuation results appear in the Week Summary Area in a random order. However, you can configure the sequence in which these time valuation results appear in the time sheet. Procedure 1. Sort the external code of the underlying time type group in a predefined order. 2. Specify external codes for the relevant time type groups with alpha-numeric values reflecting their sorting order. Results You can control the sequence in which time valuation results are displayed in the Week Summary Area. 3.6.6.6 Setting Up Time Valuations for Premium Pay To make sure that employees receive a premium for time recorded on specific days or at specific times, set up time valuations for premium pay. A premium is a payment made to employees for work that is compensated at a special rate. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Filter Input Groups. The time records filter and the time segment filter are displayed. 4. Apply the time records filter to the weekdays on which a premium is paid out. Note Without SAP SuccessFactors Time Tracking, you can only filter for one holiday class in the Holiday Class Filter for Current Day section. The No Holiday option is also only available as part of SAP SuccessFactors Time Tracking. If you haven't activated SAP SuccessFactors Time Tracking, you can still see and edit all holiday class filters and all filtering options. However, you can't save them. 356 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 5. In the time segments filter, add time segments for times for which a premium is paid out. 6. Specify the time type group below. The group you choose contains input time data that fits all specified filter criteria. 7. Specify the time type group above. The group you choose collects all input time data that doesn’t pass through the filter criteria defined for this time valuation. 8. In the Input Time Type Groups field, enter all relevant time type groups from which you must calculate the output of the time valuation. You can enter a time type group from any time category as an input time type group. Note If you enter an input time type group with an associated Calculated Time time category, it must be calculated within the same time valuation run as the output of another time valuation. This time valuation must also be assigned to the employee’s time recording profile. 9. Save your new time valuation. Caution Within a time valuation, the input time type groups must be different from the time type groups assigned to the Time Type Group Above and Time Type Group Below. 10. Add the time valuation you created in the previous steps to the time recording profiles of all employees for whom you wish to calculate premium pay. Results The output premium pay time pay types generated by the time record filter are saved to each individual employee's time valuation result. They can be seen within the time sheet assuming each time type group involved is set as a UI Component. Employee Central Payroll can process approved time valuation results when you've set up the integration between the Time Sheet and Employee Central Payroll. The generated time valuation results are saved in the time sheet, and are visible to employees within their individual time sheets. 3.6.6.7 Setting Up Time Valuations for Clock Times Define time valuations using the valuation type Filter Segments from Input Groups. Assign the time valuations to the time recording profiles of all employees for whom you wish to valuate clock times. Procedure 1. Go to the Admin Center and choose Manage Data. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 357 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Filter Segments from Input Groups. The screen is refreshed. 4. Define the time segment filters for this valuation. a. In the Start Time and End Time fields, specify the clock times. b. Provide an external code for the filter. You can assign multiple time segment filters within a single time valuation of type Filter Segments from Input Groups. 5. Specify a time type group below. This time type group below collects input time data that overlaps with the time period defined in the time segment filters. 6. Specify a time type group above. This time type group above collects input time data that doesn’t overlap with the time period defined in the time segment filters. Note You must specify a time type group below or a time type group above. 7. In the Input Time Type Groups field, enter all relevant time type groups from which you calculate the output of the time valuation. You can enter a time type group from any time category as an input time type group. Restriction Don't use the Factor field for clock time valuations. Caution Within a time valuation, the input time type groups must be different from the time type groups assigned to the time type group above and the time type group below. Note If you enter an input time type group with an associated Calculated Time time category, it must be calculated within the same time valuation run as the output of another time valuation. This time valuation must be assigned to the employee’s time recording profile. Tip To add durations of the time records within the input time type groups to the result that is compared to the threshold value, set Reverse Sign to No. To subtract durations of the time records within the input time type groups from the result that is compared to the threshold value, set Reverse Sign to Yes. 8. Save your new time valuation. 9. Assign the time valuation to the time recording profiles of all employees who are to use this valuation type. 358 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Results The time valuation is now assigned to the relevant time recording profiles. This single time valuation is normally assigned within a bundle of time valuations in any given time recording profile. Depending on how a bundle of time valuations is configured, the following is possible: ● Single time valuations within a bundle can produce intermediate (hidden) results. ● If they’re defined as a UI component, time valuations can be visible on the UI. ● Single time valuations can be stored within the time sheet and be visible on the UI as a time pay type. 3.6.6.7.1 Time Segments A time segment is a time interval with a defined start and end time. A clock-based time record is a time segment with an assigned time type. A time segment is defined as a time interval with a defined start and end time, for example, 09:00 and 17:00 or 17:00 and 19:00. The record also has an implicit duration, the end time minus the start time, in hours and minutes. Time segment filters are sets of one of more pairs of start and end clock times that are applied within time valuations of type Filter Segments from Input Groups. In such cases, explicitly defined time intervals (segments) are extracted from clock times recorded by employees. Time segments of the input time type groups in the valuation that overlap with time segments assigned in the time valuation are collected in the time type group below. The remaining time segments are collected in the time type group above. For example, a time segment has a start time of 18:00 and an end time of 22:00. A time valuation including this time segment extracts time records and parts of time records of the input time type groups that overlap with the time period defined in the time segment. The time valuation then collects the extracted records in the time type group below. The time records of the input time type groups that do not overlap at all with the time period defined in the time segment are collected in the time type group above. Therefore, a number of different outcomes of time valuation using time segments as filters are possible: ● No overlap: The input time record does not overlap at all with the time segments defined in the valuation. Result: the input time record is collected in the time type group above. ● Partial overlap: A part of an input time record overlaps with the time segments defined in the valuation. Result: the input time record is split. The parts which do not overlap with the time segments defined in the valuation are collected in the time type group above. The parts of the input time record that do overlap with the time segments defined in the valuation are collected in the time type group below. ● Full overlap: The input time record fully overlaps with the time segments defined in the valuation. Result: the input record is collected in the time type group below. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 359 3.6.6.8 Setting Up Time Valuations for the Deduction of Break Times Define time valuations using the valuation type Deduct Group from Input Groups. Assign these time valuations to the time recording profiles of all employees for whom you wish to deduct breaks. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Deduct Group from Input Groups. The screen is refreshed. 4. Assign a deduction group from an existing time type group. The deduction group acts as a type of filter. Time records within the deduction group are used as the time segments that are filtered. 5. Specify a time type group below. This time type group below collects input time data that overlaps with the clock-based time records contained in the deduction group. 6. Specify a time type group above. This time type group above collects input time data that doesn’t overlap with the clock-based time records contained in the deduction group. Note You must specify a time type group below or a time type group above. 7. In the Input Time Type Groups field, enter all relevant time type groups from which you calculate the output of the time valuation. You can enter a time type group from any time category as an input time type group. Restriction Don't use the Factor field for clock time valuations. Caution Within a time valuation, the input time type groups must be different from the time type groups assigned to the time type group above and the time type group below. Note If you enter an input time type group with an associated Calculated Time time category, it must be calculated within the same time valuation run as the output of another time valuation. This time valuation must be assigned to the employee’s time recording profile. 360 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Tip To add durations of the time records within the input time type groups to the result that is compared to the threshold value, set Reverse Sign to No. To subtract durations of the time records within the input time type groups from the result that is compared to the threshold value, set Reverse Sign to Yes. 8. Save your new time valuation. 9. Assign the time valuation to the time recording profiles of all employees who are to use this valuation type. Results The time valuation is now assigned to the relevant time recording profiles. This single time valuation is normally assigned within a bundle of time valuations in any given time recording profile. Depending on how a bundle of time valuations is configured, the following is possible: ● Single time valuations within a bundle can produce intermediate (hidden) results. ● If they’re defined as a UI component, time valuations can be visible on the UI. ● Single time valuations can be stored within the time sheet and be visible on the UI as a time pay type. 3.6.6.9 Setting Up Duration-Based Time Valuations To valuate duration-based times of your employees, you use the valuation type Aggregate Input Group & Split. This valuation type aggregates input data from different input groups of time data (for example, recorded working time and paid holidays) and then applies a predefined threshold. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Aggregate Input Group & Split. The screen is refreshed. 4. Specify the valuation method. The valuation method defines the basis on which the input time data is valuated, for example, whether overtime is calculated on a daily or weekly basis. ○ To valuate time on a daily basis, select Valuate Per Day. ○ To valuate time on a weekly basis, that is, for the whole time sheet, select Valuate Whole Sheet. ○ To valuate time for the period up to and including the current date, select Valuate Up To Today. 5. Specify the threshold type. ○ To use a fixed value (for example, 8 hours per day), set Threshold Type to Fixed Value. In the Threshold Value field, enter the number of hours that constitute your threshold. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 361 ○ To use a value calculated from a time type group (for example, the employee’s planned working time), set Threshold Type to Time Type Group. In the Threshold Group field, enter a time type group that defines how to calculate the threshold value. You can enter a time type group from any time category as a threshold group. Note If you enter a threshold group of time category Calculated Time, it must be calculated within the same time valuation run as the output of another time valuation that is also assigned to the employee’s time recording profile. 6. In the Time Type Group Below field, enter the time type group that collects the time valuation results up to the given threshold value. You can enter only time type groups from the Calculated Time time category. 7. In the Time Type Group Above field, enter the time type group that collects the time valuation results above the given threshold value. You can enter only time type groups from the Calculated Time time category. Note You must specify a time type group below or a time type group above. 8. In the Input Time Type Groups field, enter all relevant time type groups from which you calculate the output of the time valuation. You can enter a time type group from any time category as an input time type group. Caution Within a time valuation, the input time type groups must be different from the time type groups assigned to the time type group above and the time type group below. Note If you enter an input time type group with an associated Calculated Time time category, it must be calculated within the same time valuation run as the output of another time valuation that is also assigned to the employee’s time recording profile. Tip To add durations of the time records within the input time type groups to the result that is compared to the threshold value, set Reverse Sign to No. To subtract durations of the time records within the input time type groups from the result that is compared to the threshold value, set Reverse Sign to Yes. 9. Save your new time valuation. 10. Assign the time valuation to the time recording profiles of all employees who are to use this valuation type. Results The output time pay types generated by the valuation are saved to each individual employee's time valuation result. They’re displayed in the time sheet assuming each time type group involved is set as a UI Component. 362 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Employee Central Payroll can process approved time valuation results when you've set up the integration between the Time Sheet and Employee Central Payroll. 3.6.6.10 Best Practice Examples of Time Valuations This appendix contains a number of examples illustrating possible use of the time recording profile. The examples are defined for employees with the Positive time recording method, and either the Duration or Clock Times time recording variant. However, the time valuations assigned to each time recording profile would also be suitable for employees with the Negative time recording method. The business requirements for base pay and overtime premium calculation underlying the time valuations are the same for both time recording variants. However, as the Clock Times time recording variant requires that breaks be deducted from attendance and absence times before base pay and overtime premiums can be calculated, the time valuations are a bit more complicated in this case than for the Duration time recording variant. So the first example shows how the business requirements are met by the time recording profile for the Duration time recording variant, which has a smaller number of time valuations associated with it. Once this example is understood, the time recording profile for the Clock Times time recording variant will show how the time valuations need to be extended so that breaks are excluded from base pay and overtime premium calculation. Business Requirements for Base Pay and Overtime Premiums [page 363] Employees are paid for all credited time, which includes working time, overtime, and time off for certain paid absences and public holidays. Time Recording Profile For "Duration" Time Recording Variant [page 364] For the Duration time recording variant’, a time recording profile supporting the use case description above may look like this: Time Recording Profile For "Clock Times" Time Recording Variant [page 370] For the Clock Times time recording variant, a time recording profile supporting the use case description above may look like this: 3.6.6.10.1 Business Requirements for Base Pay and Overtime Premiums Employees are paid for all credited time, which includes working time, overtime, and time off for certain paid absences and public holidays. The employees receive base pay for all credited time, plus overtime premiums for those parts of credited time that are in excess of their planned working time. The overtime premium is 50% of base pay for the first 2 hours in excess of planned working time per day, except for Sundays, where the overtime premium for the first 2 hours is 75%. Overtime in excess of 2 hours per day or 6 hours per week, respectively, is paid at a 100% premium. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 363 3.6.6.10.2 Time Recording Profile For "Duration" Time Recording Variant For the Duration time recording variant’, a time recording profile supporting the use case description above may look like this: Here are the results produced by these time valuations: ● Daily overtime All relevant hours per day are checked against the employee’s planned working time. If more time is recorded on a day than the planned working time, an overtime premium of 50% is generated. ● An enhanced overtime threshold When daily overtime is calculated, the system checks: ○ Whether more than 2 overtime hours are calculated per day. If so, the generated overtime pay type is not 50% (as for the hours below 2), but 100%. ○ Additionally, whether more than 6 overtime hours are calculated in the work week. If so, the generated overtime pay type is not 50%, but 100%. ● Higher overtime premium for work on Sundays The overtime premium is normally 50% (unless it is the 3rd overtime hour on a day, or the 7th in a week), but when the overtime is recorded on a Sunday, the overtime premium is 75% instead of 50%. Additionally, there is a time valuation rule with which a specific time type “Overtime” can bypass all automated overtime calculations. When this time type is recorded, time valuation treats these times directly as overtime, regardless of whether the employee has worked more time than planned. Duration - Time Valuation 1: DUR - Pos & Neg – Calculate Overtime [page 365] In this example, the time valuation DUR – Pos & Neg – Calculate Overtime takes all overtime-relevant time type groups as input - namely Recorded Working Time, Paid Absences, Unpaid Overtime Relevant Absences, and Paid Holidays. Duration - Time Valuation 2: DUR - Pos & Neg – Split Per Week – OT Premiums Below vs Above Threshold [page 366] The time valuation DUR – Pos & Neg – Split Per Week – OT Premiums Below vs Above Threshold takes time type group Calculated Overtime from time valuation DUR – Pos & Neg – Calculate Overtime as input, and combines it with time type group Recorded Overtime, which holds all time recorded against attendance time types explicitly considered overtime, regardless of the overtime calculation rules. Duration - Time Valuation 3: Split Per Day – OT Premiums Below vs Above Threshold [page 367] 364 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Time valuation Split Per Day – OT Premiums Below vs Above Threshold takes time type group OT Premiums <= Threshold Per Week from time valuation DUR – Pos & Neg – Split Per Week as input. Duration - Time Valuation 4: Filter SUN vs MON-SAT – OT Premiums 75% vs 50% [page 367] The purpose of this filter is to generate the highest overtime pay in different constellations. For overtime on Sunday, 75% is granted, but only for the “normal” overtime hours (below 2 per day or below 6 in the week) that are not paid at 100% already. These hours are not touched. Duration - Time Valuation 5: Add Up – OT Premium 100% Per Day And Per Week [page 368] Time valuation Add Up – OT Premium 100% Per Day & Per Week is to generate a time pay type of 100% for the overtime hours above 2 hours per day or above 6 hours per week. It takes time type groups OT Premiums > Threshold Per Day and OT Premiums > Threshold Per Week as input. Duration - Time Valuation 6: DUR - Pos & Neg – Get Base Pay [page 369] Finally, keep in mind that the employee is paid hourly, so you need to generate a base pay type for all relevant hours, whether paid absence hours, paid holidays, attendance times, or the base hour portion for the calculated overtime. 3.6.6.10.2.1 Duration - Time Valuation 1: DUR - Pos & Neg – Calculate Overtime In this example, the time valuation DUR – Pos & Neg – Calculate Overtime takes all overtime-relevant time type groups as input - namely Recorded Working Time, Paid Absences, Unpaid Overtime Relevant Absences, and Paid Holidays. For each day in the time valuation period, which in this example is the week from Sunday to Saturday, the hours from the input time type groups are added up, and their total duration is compared with the duration of the threshold group Scheduled Working Time, which represents the employee’s planned working time. Time in excess of the daily planned working time is moved to the time type group above Calculated Overtime. For example, if an employee records 4 hours' attendance time for the Business Travel time type, and 6 hours' attendance time with the Working Time time type, the result shown in the Calculate Overtime time type group would be 2 hours. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 365 Note In this example, an input time type group Unpaid Overtime Relevant Absences is included in the overtime calculation, although the hours from the corresponding absence time types are not paid. This is necessary, for example, for the weekly overtime calculation when the employee is on 4 days' unpaid leave but works 10 hours on the 5th day. Then the 4 days' unpaid leave need to be counted into the weekly overtime calculation. So this time valuation just serves to demonstrate that slightly different sets of credited hours can be used to calculate overtime and base pay, respectively. Take a look also at Duration Example 6. DUR – Pos & Neg – Get Base Pay below. 3.6.6.10.2.2 Duration - Time Valuation 2: DUR - Pos & Neg – Split Per Week – OT Premiums Below vs Above Threshold The time valuation DUR – Pos & Neg – Split Per Week – OT Premiums Below vs Above Threshold takes time type group Calculated Overtime from time valuation DUR – Pos & Neg – Calculate Overtime as input, and combines it with time type group Recorded Overtime, which holds all time recorded against attendance time types explicitly considered overtime, regardless of the overtime calculation rules. This time valuation is relevant, for example, in those rare cases where an employee’s recorded time does not exceed a specific threshold, but he receives an overtime payment anyway - for example, employees do not record their times only on the basis of duration, meaning without start and end times. An employee works only 5 hours a day, but outside of his normally scheduled times (for example, in the evening). A daily overtime calculation would not calculate overtime pay in this case because the employee is not exceeding the daily threshold of, say, 8 hours' planned working time. However, by recording a time type that explicitly generates overtime pay, the employee will get this additional payment. The result of this time valuation will be to detect whether more than 6 hours' overtime have been calculated, or recorded with the explicit overtime time type. For the whole time valuation period, which in this example is the week from Sunday – Saturday, Calculated Overtime and Recorded Overtime are added up, and their total duration is compared with a fixed value of 6 hours. So overtime up to 6 hours per week is moved to the time type group below OT Premium <= Threshold Per Week, and distributed over the days of the week just like these overtime hours were recorded or calculated. 366 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Similarly, overtime in excess of 6 hours per week is moved to the time type group above OT Premiums > Threshold Per Week. 3.6.6.10.2.3 Duration - Time Valuation 3: Split Per Day – OT Premiums Below vs Above Threshold Time valuation Split Per Day – OT Premiums Below vs Above Threshold takes time type group OT Premiums <= Threshold Per Week from time valuation DUR – Pos & Neg – Split Per Week as input. For each day in the time valuation period, the overtime below the weekly threshold is compared to a fixed value of 2 hours per day. Overtime up to 2 hours per day is moved to the time type group below OT Premiums <= Threshold Per Day, which thus holds all overtime hours that will receive a premium of either 50% (if the overtime hours are worked on Monday – Saturday) or 75% (if the overtime hours are worked on Sunday). In addition, overtime in excess of 2 hours per day is moved to the time type group above OT Premiums > Threshold Per Day, which thus holds all daily overtime hours that will receive 100% premium. 3.6.6.10.2.4 Duration - Time Valuation 4: Filter SUN vs MONSAT – OT Premiums 75% vs 50% The purpose of this filter is to generate the highest overtime pay in different constellations. For overtime on Sunday, 75% is granted, but only for the “normal” overtime hours (below 2 per day or below 6 in the week) that are not paid at 100% already. These hours are not touched. Time valuation Filter SUN vs MON-SAT – OT Premiums 75% vs 50% takes the time type group OT Premiums <= Threshold Per Day as input. Each day of the time valuation period is passed through a time records filter for Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 367 Day of Week = Sunday. All overtime below 2 hours per day recorded on a Sunday passes the filter and so is moved to the time type group below Overtime Premium 75%. Conversely, all overtime below 2 hours per day recorded on Monday – Saturday is retained by the filter and moved to the time type group above Overtime Premium 50%. In contrast to the time type groups for intermediate results of overtime calculation, such as OT Premiums <= Threshold Per Week or OT Premiums <= Threshold Per Day, the time type groups for Overtime Premium 50% and Overtime Premium 75% represent time pay types that will be transferred to payroll. This means that these time type groups need to be defined as Time Pay Type = Yes. 3.6.6.10.2.5 Duration - Time Valuation 5: Add Up – OT Premium 100% Per Day And Per Week Time valuation Add Up – OT Premium 100% Per Day & Per Week is to generate a time pay type of 100% for the overtime hours above 2 hours per day or above 6 hours per week. It takes time type groups OT Premiums > Threshold Per Day and OT Premiums > Threshold Per Week as input. For the whole time valuation period, the overtime hours in excess of 2 hours per day or 6 hours per week, respectively, are added up and compared to a fixed threshold value of 0 hours. This means that all overtime hours from the input time type groups are moved to time type group above Overtime Premium 100%, and distributed over the days of the week just as they were recorded or calculated. In contrast to the time type groups for intermediate results of overtime calculation, such as OT Premiums > Threshold Per Day or OT Premiums > Threshold Per Week, the time type group for Overtime Premium 100% represents a time pay type that will be transferred to payroll. So this time type group needs to be defined as Time Pay Type = Yes. 368 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.6.10.2.6 Duration - Time Valuation 6: DUR - Pos & Neg – Get Base Pay Finally, keep in mind that the employee is paid hourly, so you need to generate a base pay type for all relevant hours, whether paid absence hours, paid holidays, attendance times, or the base hour portion for the calculated overtime. This is the purpose of time valuation DUR – Pos & Neg – Get Base Pay, which takes all those pay-relevant time type groups as input - namely Recorded Working Time, Recorded Overtime, Paid Absences, and Paid Holidays. For the whole time valuation period, the hours of the input time type groups are added up and compared with a fixed threshold value of 0 (zero) hours. So all hours from the input time type groups are moved to time type group above Base Pay, and distributed over the days of the week just as they were recorded or calculated. In contrast to the input time type groups for Recorded Working Time, Recorded Overtime, Paid Absences, and Paid Holidays, the time type group for Base Pay represents a time pay type that will be transferred to payroll. So this time type group needs to be defined as Time Pay Type = Yes. Remember, if you want to display this result to the employee in his Time Sheet, mark this time type group as “UI relevant = yes” as well. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 369 3.6.6.10.3 Time Recording Profile For "Clock Times" Time Recording Variant For the Clock Times time recording variant, a time recording profile supporting the use case description above may look like this: Time Valuation The examples of time recording profiles for the Duration and Clock Times time recording variants that are explained in this Appendix both serve the same business use case and so basically yield the same time valuation results. However, the Clock Times time recording variant adds a bit more complexity to the process. For duration-based time recording, no break deduction is necessary. It is not possible to deduct breaks from recorded duration-based times because we assume that the duration-based time that is recorded is already the “net” time excluding breaks. For the Clock Times time recording variant with breaks defined in the work schedule (or manually recorded breaks), breaks are not deducted automatically. Break deduction must be configured in the time valuation rules and, for all times that are recorded and for all time type groups you use for calculation purposes, break deduction needs to be set up in time valuation rules first. In general, it is only possible to deduct breaks when their start and end times overlap with the start and end times of recorded attendance or absence time. To deduct these breaks from the recorded or generated working time, it is necessary to deduct break times from the relevant input time type groups first. This is the purpose of time valuations 1 – 6 listed above. Time valuation 7 (below) adds up all overtime-relevant times without breaks, then, before its result is plugged into time valuation 8 to determine calculated overtime. Consequently, time valuations 1 – 8 in the time recording profile for the Clock Times time recording variant correspond to time valuation 1 in the time recording profile for the Duration time recording variant. This is the main point to keep in mind when doing overtime calculation based on the Clock Times time recording variant. From then on, time valuations 9 – 13 in the time recording profile for the Clock Times time recording variant corresponding to the time valuations 2 – 6 in the time recording profile for the Duration time recording variant’. So these time valuations are basically the same. 370 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Finally, time valuation 14 in the time recording profile for the Clock Times time recording variant generates an additional time pay type for hours worked between 18:00 – 24:00, serving as an example of pay type generation based on clock times. This is not possible for the Duration time recording variant. Clock Times - Time Valuation 1: CLT – Pos & Neg – Get Scheduled Working Time w/o Breaks [page 372] Time valuation CLT – Pos & Neg – Get Scheduled Working Time w/o Breaks is defined for valuation type Deduct Group From Input Groups. The primary purpose of this valuation type is to remove break times, as defined by the deduction group, from the times included in the input time type group(s). Clock Times - Time Valuation 2: CLT - Pos & Neg - Get Recorded Working Time w/o Breaks [page 372] In time valuation CLT – Pos & Neg – Get Recorded Working Time w/o Breaks, recorded unpaid breaks are removed from recorded working time. The respective times are represented by deduction group Recorded Unpaid Breaks and input time type group Recorded Working Time, which are both derived from time sheet entries for the time types assigned to the respective time type group. Clock Times - Time Valuation 3: CLT - Pos & Neg - Get Recorded Overtime w/o Breaks [page 373] In time valuation CLT – Pos & Neg – Get Recorded Overtime w/o Breaks, recorded unpaid breaks are removed from recorded overtime. Clock Times - Time Valuation 4: CLT - Pos & Neg - Get Paid Holidays w/o Breaks [page 374] In time valuation CLT – Pos & Neg – Get Paid Holidays w/o Breaks, scheduled unpaid breaks are removed from scheduled working time falling on a public holiday. Clock Times - Time Valuation 5: CLT - Pos & Neg - Get Paid Absences w/o Breaks [page 374] In time valuation CLT – Pos & Neg – Get Paid Absences w/o Breaks, scheduled unpaid breaks are removed from paid absences recorded in Time Off. Clock Times - Time Valuation 6: CLT - Pos & Neg - Get OT-Relevant Unpaid Absences w/o Breaks [page 375] In time valuation CLT – Pos & Neg – Get OT-Relevant Unpaid Absences w/o Breaks, scheduled unpaid breaks are removed from unpaid overtime-relevant absences recorded in Time Off. Clock Times - Time Valuation 7: CLT - Pos & Neg - Get OT-Relevant Times w/o Breaks [page 376] Time valuation CLT – Pos & Neg – Get OT-Relevant Times w/o Breaks takes all overtime-relevant time type groups as input- that is, Recorded Working Time w/o Breaks, Paid Holidays (w/o Breaks), Paid Absences (w/o Breaks), and OT-Relevant Unpaid Absences w/o Breaks. Clock Times - Time Valuation 8: CLT - Pos & Neg - Calculate Overtime w/o Breaks [page 376] This time valuation takes the overtime-relevant times without breaks from the time valuation CLT – Pos & Neg – Get OT-Relevant Times w/o Breaks as input. Clock Times - Time Valuation 9: CLT - Pos & Neg - Split Per Week - OT Premiums Below vs Above Threshold [page 377] This time valuation takes the time type group Calculated Overtime from time valuation CLT – Pos & Neg – Calculate Overtime w/o Breaks as input, and combines it with the time type group Recorded Overtime w/o Breaks, which holds all time (excluding breaks) recorded against attendance time types that are explicitly considered overtime, regardless of the overtime calculation rules. Clock Times - Time Valuation 10: CLT – Pos & Neg – Split Per Week [page 378] This time valuation takes time type group OT Premiums <= Threshold Per Week from time valuation CLT – Pos & Neg – Split Per Week as input. Clock Times - Time Valuation 11: Filter SUN vs MON-SAT - OT Premiums 75% vs 50% [page 378] This time valuation takes time type group OT Premiums <= Threshold Per Day as input. Clock Times - Time Valuation 12: Add Up - OT Premium 100% Per Day & Per Week [page 379] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 371 This time valuation takes time type groups OT Premiums > Threshold Per Day and OT Premiums > Threshold Per Week as input. Clock Times - Time Valuation 13: CLT - Pos & Neg - Get Base Pay [page 380] This time valuation takes all pay-relevant time type groups as input, i.e. Recorded Working Time w/o Breaks, Recorded Overtime w/o Breaks, Paid Absences (w/o Breaks), and Paid Holidays (w/o Breaks). Clock Times - Time Valuation 14: CLT - Pos & Neg - Get Working Time from 18:00 - 23:59 [page 381] Finally, time valuation CLT – Pos & Neg – Get Working Time from 18:00 – 23:59 is an example for pay type generation based on clock times, which is only possible for the Clock Times time recording variant. 3.6.6.10.3.1 Clock Times - Time Valuation 1: CLT – Pos & Neg – Get Scheduled Working Time w/o Breaks Time valuation CLT – Pos & Neg – Get Scheduled Working Time w/o Breaks is defined for valuation type Deduct Group From Input Groups. The primary purpose of this valuation type is to remove break times, as defined by the deduction group, from the times included in the input time type group(s). In this time valuation, scheduled unpaid breaks are removed from scheduled working time. The respective times are represented by deduction group Scheduled Unpaid Breaks and input time type group Scheduled Working Time, which are both calculated based on the work schedule assigned to the employee’s job information. The result is a time type group that contains the “net” scheduled working time without breaks. 3.6.6.10.3.2 Clock Times - Time Valuation 2: CLT - Pos & Neg Get Recorded Working Time w/o Breaks In time valuation CLT – Pos & Neg – Get Recorded Working Time w/o Breaks, recorded unpaid breaks are removed from recorded working time. The respective times are represented by deduction group Recorded Unpaid Breaks and input time type group Recorded Working Time, which are both derived from time sheet entries for the time types assigned to the respective time type group. Note For the Clock Times time recording variant with breaks defined in the work schedule, or manually recorded breaks in the time sheet, you must create rules to deduct these breaks from the recorded attendance times for the day. 372 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management In time valuation CLT – Pos & Neg – Get Recorded Working Time w/o Breaks, recorded unpaid breaks and scheduled unpaid breaks are removed from recorded working time. The respective times are represented by deduction group Recorded Unpaid Breaks and input time type group Recorded Working Time, which are both derived from time sheet entries for the time types assigned to the respective time type group. The resulting time type group is “Recorded Working Time w/o Breaks”, which represents the net duration of attendance times in case manual breaks have been recorded manually in time sheet, or been generated automatically from the scheduled breaks defined in the employees’ work schedules. If you do not have scheduled breaks defined in your work schedules, and do not breaks to be recorded manually in the time sheet, this time valuation is not necessary. 3.6.6.10.3.3 Clock Times - Time Valuation 3: CLT - Pos & Neg - Get Recorded Overtime w/o Breaks In time valuation CLT – Pos & Neg – Get Recorded Overtime w/o Breaks, recorded unpaid breaks are removed from recorded overtime. The respective times are represented by deduction group Recorded Unpaid Breaks and input time type group Recorded Overtime, which are both derived from time sheet entries for the time types assigned to the respective time type group. This time valuation is mostly the same as time valuation 2 above, the only difference being that the time type here is used in the following time valuations to represent time relevant for overtime pay, without checking any daily or weekly overtime thresholds. When employees record this time type and it overlaps with a manually recorded break or a scheduled break generated based on the employee’s work schedule, you need this time valuation rule. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 373 3.6.6.10.3.4 Clock Times - Time Valuation 4: CLT - Pos & Neg - Get Paid Holidays w/o Breaks In time valuation CLT – Pos & Neg – Get Paid Holidays w/o Breaks, scheduled unpaid breaks are removed from scheduled working time falling on a public holiday. The respective times are represented by deduction group Scheduled Unpaid Breaks and input time type group CLT – Paid Holidays, which are calculated based on the work schedule and holiday calendar assigned to the employee’s Job Information. This valuation rule is necessary when you, for example, pay hourly employees for a public holiday according to their work schedule, or when you need to use the planned time on a public holiday for overtime calculation. In these constellations, you need to deduct the scheduled breaks according to the work schedule from the scheduled working time. The result is the time type group “Paid Holidays”, and represents the “net” planned time on a public holiday without the breaks. 3.6.6.10.3.5 Clock Times - Time Valuation 5: CLT - Pos & Neg Get Paid Absences w/o Breaks In time valuation CLT – Pos & Neg – Get Paid Absences w/o Breaks, scheduled unpaid breaks are removed from paid absences recorded in Time Off. The respective times are represented by the deduction group Scheduled Unpaid Breaks and input time type group CLT – Paid Absences, which are calculated based on the work schedule assigned to the employee’s Job Information, or derived from absences recorded in Time Off for the time types assigned to time type group CLT – Paid Absences, respectively. For reasons of payment and overtime calculation, you need to deduct breaks from absences recorded in Time Off as well. If you did not deduct those breaks, time valuation would calculate overtime when you calculate against the schedule working time without breaks. 374 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Example A 1-week vacation from Monday – Sunday with working days on Monday – Friday would count for hourly payment / overtime calculation without break deduction in time evaluation: ● Monday: 08:00 - 17:00 = 9 hours ● Tuesday: 08:00 - 17:00 = 9 hours ● Wednesday: 08:00 - 17:00 = 9 hours ● Thursday: 08:00 - 17:00 = 9 hours ● Friday: 08:00 - 17:00 = 9 hours So 9 hours base pay would be paid per day by time valuation, or, for a weekly overtime calculation, this would result in 5 hours of overtime when the threshold is set to the scheduled working time without breaks time type group. So, you must deduct the breaks even from absences for time sheet valuation. The result is the time type group Paid Absences that does not include the break times. 3.6.6.10.3.6 Clock Times - Time Valuation 6: CLT - Pos & Neg - Get OT-Relevant Unpaid Absences w/o Breaks In time valuation CLT – Pos & Neg – Get OT-Relevant Unpaid Absences w/o Breaks, scheduled unpaid breaks are removed from unpaid overtime-relevant absences recorded in Time Off. The respective times are represented by deduction group Scheduled Unpaid Breaks and input time type group Unpaid Overtime Relevant Absences, which are calculated based on the work schedule assigned to the employee’s Job Information, or derived from absences recorded in Time Off for the time types assigned to time type group Unpaid Overtime Relevant Absences. For this rule, the same is applicable as for the Paid Absences. Breaks from the work schedule need to be deducted. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 375 3.6.6.10.3.7 Clock Times - Time Valuation 7: CLT - Pos & Neg Get OT-Relevant Times w/o Breaks Time valuation CLT – Pos & Neg – Get OT-Relevant Times w/o Breaks takes all overtime-relevant time type groups as input- that is, Recorded Working Time w/o Breaks, Paid Holidays (w/o Breaks), Paid Absences (w/o Breaks), and OT-Relevant Unpaid Absences w/o Breaks. The hours of the input time type groups are added up and compared to a fixed threshold value of 0 hours per day. So all hours from the input time type groups are moved to time type group above OT-Relevant Times w/o Breaks, and distributed over the days of the week just as they were recorded or calculated. Because, with the time valuation rules above, all input time type groups used in this valuation rule have been reduced by the break times, the time valuation engine now has the “net” times with which further calculations can be done. So, in this rule, all overtime-relevant net hours are summed up in the time type group “OTRelevant Times w/o Breaks”. 3.6.6.10.3.8 Clock Times - Time Valuation 8: CLT - Pos & Neg - Calculate Overtime w/o Breaks This time valuation takes the overtime-relevant times without breaks from the time valuation CLT – Pos & Neg – Get OT-Relevant Times w/o Breaks as input. 376 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management Note Time valuation CLT – Pos & Neg – Calculate Overtime w/o Breaks for the Clock Times time recording variant corresponds to time valuation 1. DUR – Pos & Neg – Calculate Overtime for the Duration time recording variant. This time valuation takes the OT-Relevant Times w/o Breaks from time valuation CLT – Pos & Neg – Get OTRelevant Times w/o Breaks as input. For each day in the time valuation period, which, in this example, is the week from Sunday – Saturday, the duration of the times from the input time type group is calculated and compared with the duration of the times from the threshold group Scheduled Working Time w/o Breaks, which represents the employee’s planned working time excluding breaks. Time in excess of the daily planned working time is then moved to the time type group above Calculated Overtime. 3.6.6.10.3.9 Clock Times - Time Valuation 9: CLT - Pos & Neg - Split Per Week - OT Premiums Below vs Above Threshold This time valuation takes the time type group Calculated Overtime from time valuation CLT – Pos & Neg – Calculate Overtime w/o Breaks as input, and combines it with the time type group Recorded Overtime w/o Breaks, which holds all time (excluding breaks) recorded against attendance time types that are explicitly considered overtime, regardless of the overtime calculation rules. Note Time valuation CLT – Pos & Neg – Split Per Week – OT Premiums Below vs Above Threshold for the Clock Times time recording variant corresponds to time valuation 2. DUR – Pos & Neg – Split Per Week – OT Premiums Below vs Above Threshold for the Duration time recording variant. For the whole time valuation period, which, in this example, is the week from Sunday – Saturday, Calculated Overtime w/o Breaks and Recorded Overtime w/o Breaks are added up, and their total duration is compared with a fixed value of 6 hours. So overtime up to 6 hours per week is moved to the time type group below OT Premium <= Threshold Per Week, and distributed over the days of the week just as these overtime hours were recorded or calculated. Similarly, overtime in excess of 6 hours per week is moved to the time type group above OT Premiums > Threshold Per Week and distributed over the days of the week. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 377 3.6.6.10.3.10 Clock Times - Time Valuation 10: CLT – Pos & Neg – Split Per Week This time valuation takes time type group OT Premiums <= Threshold Per Week from time valuation CLT – Pos & Neg – Split Per Week as input. Note Time valuation Split Per Day – OT Premiums Below vs Above Threshold is the same for both the Clock Times and Duration time recording variants. This time valuation takes time type group OT Premiums <= Threshold Per Week from time valuation CLT – Pos & Neg – Split Per Week as input. For each day in the time valuation period, the overtime below the weekly threshold is compared to a fixed value of 2 hours per day. Overtime up to 2 hours per day is moved to the time type group below OT Premiums <= Threshold Per Day, and overtime in excess of 2 hours per day is moved to the time type group above OT Premiums > Threshold Per Day. 3.6.6.10.3.11 Clock Times - Time Valuation 11: Filter SUN vs MON-SAT - OT Premiums 75% vs 50% This time valuation takes time type group OT Premiums <= Threshold Per Day as input. Note Time valuation Filter SUN vs MON-SAT – OT Premiums 75% vs 50% is the same for both the Clock Times and Duration time recording variants. 378 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management This time valuation takes time type group OT Premiums <= Threshold Per Day as input. Each day of the time valuation period is passed through a time records filter for Day of Week = Sunday. All overtime below 2 hours per day recorded on a Sunday passes the filter and so is moved to the time type group below Overtime Premium 75%. Conversely, all overtime below 2 hours per day recorded on Monday – Saturday is retained by the filter and is moved to the time type group above Overtime Premium 50%. In contrast to the time type groups for intermediate results of overtime calculation, such as OT Premiums <= Threshold Per Week or OT Premiums <= Threshold Per Day, the time type groups for Overtime Premium 50% and Overtime Premium 75% represent time pay types that will be transferred to payroll. For this reason, the entry for Time Pay Type for these time type groups must be Yes. 3.6.6.10.3.12 Clock Times - Time Valuation 12: Add Up - OT Premium 100% Per Day & Per Week This time valuation takes time type groups OT Premiums > Threshold Per Day and OT Premiums > Threshold Per Week as input. Note Time valuation Add Up - OT Premiums 100% Per Day & Per Week is the same for both the Clock Times and Duration time recording variants. This time valuation takes time type groups OT Premiums > Threshold Per Day and OT Premiums > Threshold Per Week as input. For the whole time valuation period, the overtime hours in excess of 2 hours per day or 6 hours per week, respectively, are added up and compared to a fixed threshold value of 0 hours. So all overtime hours from the input time type groups are moved to the time type group above Overtime Premium 100%, and distributed over the days of the week just as they were recorded or calculated. Unlike the time type groups for intermediate results of overtime calculation, such as OT Premiums > Threshold Per Day or OT Premiums > Threshold Per Week, the time type group for Overtime Premium 100% is representing a time pay type which shall be transferred to payroll. For this reason, the entry for Time Pay Type for this time type group must be Yes. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 379 3.6.6.10.3.13 Clock Times - Time Valuation 13: CLT - Pos & Neg - Get Base Pay This time valuation takes all pay-relevant time type groups as input, i.e. Recorded Working Time w/o Breaks, Recorded Overtime w/o Breaks, Paid Absences (w/o Breaks), and Paid Holidays (w/o Breaks). For each day in the time valuation period, which, in this example, is the week from Sunday – Saturday, the duration of the times from the input time type groups is calculated and added up, and compared to a fixed threshold value of 0 hours. So all hours from the input time type groups are moved to time type group above Base Pay, and distributed over the days of the week just as they were recorded or calculated. Unlike the input time type groups for Recorded Working Time w/o Breaks, Recorded Overtime w/o Breaks, Paid Absences (w/o Breaks), and Paid Holidays (w/o Breaks), which just hold intermediate results of time valuation, the time type group for Base Pay is representing a time pay type that will be transferred to payroll. For this reason, the entry for Time Pay Type for this time type group must be Yes. 380 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.6.10.3.14 Clock Times - Time Valuation 14: CLT - Pos & Neg - Get Working Time from 18:00 - 23:59 Finally, time valuation CLT – Pos & Neg – Get Working Time from 18:00 – 23:59 is an example for pay type generation based on clock times, which is only possible for the Clock Times time recording variant. This time valuation takes time type group Base Pay from time valuation CLT – Pos & Neg – Get Base Pay as input, and puts all time records included in that through a time segment filter for clock times from 18:00 – 23:59 in 24-hour format, which is equivalent to 6:00 PM – 11:59 PM in 12-hour format. All time records, or parts of time records, that overlap with the time segment from 6:00 PM – 11:59 PM will be passing the filter and be moved to time type group below Premium 18:00 – 24:00, which thus represents all payment-relevant times between 6:00 PM – 11:59 PM. Restriction Technical limitations mean that EC Time Management currently only supports clock times up to 23:59 / 11:59 PM, so it is not possible to record or evaluate clock times including or spanning midnight. This is why time valuation CLT – Pos & Neg – Get Working Time from 18:00 – 23:59 in our example is only defined with a filter for clock times from 18:00 – 23:59 / 6:00 PM – 11:59 PM. 3.6.7 Time Collectors Time collectors collect times over a certain period that differs from the period that is handled by a time valuation. Time valuations can only handle valuations within the time sheet. But sometimes times need to be collected over a bigger or different period. Time collectors collect times over such periods. You can also use time collectors to generate calculated results that can be used for other use cases such as accruals. 1. Setting Up Time Collectors [page 382] Set up time collectors using time type groups and time recording profiles. 2. Setting Up Time Valuations for Time Collectors [page 383] Define time valuations using the valuation type Compare Threshold with Input Groups and Count Events. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 381 3.6.7.1 Setting Up Time Collectors Set up time collectors using time type groups and time recording profiles. Context Time collectors are a means of gathering time data independently of time sheet periods. Restriction There are some restrictions on the use of time collectors: ● For performance reasons, a time recording profile can hold a maximum of 13 time collectors. Ensure that the number of time type groups activated as time collectors doesn’t exceed that total in a given time recording profile. No more than 3 out of the 13 can be Daily time collectors. The permitted total number of weekly or monthly time collectors is 10. ● You can’t use time collectors to generate pay components. If the output group generates pay components, you can’t use a time type group with collectors as the input group. ● Don't put time collectors in both the input group and the output group of a time valuation. ● Don't create time valuation alerts based on time collectors. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type group. 3. Make the entries you need as you would for any other time type group. 4. Set Time Collector Type to Yes. The Time Collector Periodicity field appears. 5. In the Time Collector Periodicity field, select one of the following options: ○ Daily ○ Weekly ○ Monthly 6. If you select Weekly, specify a first day of the week. The first day you specify doesn't have to be the same as the first day of the time sheet. 7. Save your new time type group. 8. Use your new time type group in a time valuation. Task overview: Time Collectors [page 381] Next task: Setting Up Time Valuations for Time Collectors [page 383] 382 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.7.2 Setting Up Time Valuations for Time Collectors Define time valuations using the valuation type Compare Threshold with Input Groups and Count Events. Context The valuation type Compare Threshold with Input Groups and Count Events, which is used with time collectors acts as an event counter. It examines the time records from its input group each day and if the input exceeds the threshold, the valuation counts one event. It also sets the amount of the corresponding day containers or the whole result group to 1. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Compare Threshold with Input Groups and Count Events. The screen is refreshed. 4. Specify the valuation method. 5. Specify the threshold type. ○ If you select Fixed Value, enter a threshold value. ○ If you select Time Type Group, assign a threshold group from an existing time type group. 6. Specify a time type group below. 7. Specify a time type group above. Note You must specify a time type group below or a time type group above. 8. In the Input Time Type Groups field, enter all relevant time type groups from which you must calculate the output of the time valuation. Caution Within a time valuation, the input time type groups must be different from the time type groups assigned to the time type group above and the time type group below. 9. Save your new time valuation. 10. Assign the time valuation to the time recording profiles of all employees who are to use this valuation type. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 383 Results The time valuation is now assigned to the relevant time recording profiles. This single time valuation is normally assigned within a bundle of time valuations in any given time recording profile. Depending on how a bundle of time valuations is configured, the following is possible: ● Single time valuations within a bundle can produce intermediate (hidden) results. ● If they’re defined as a UI component, time valuations can be visible on the UI. ● Single time valuations can be stored within the time sheet and be visible on the UI as a time pay type. Task overview: Time Collectors [page 381] Previous task: Setting Up Time Collectors [page 382] 3.6.8 Time Compensation You can use time accounts to compensate the difference between the actual and the planned working time. SAP SuccessFactors supports working time accounts and time off in lieu. In addition to processing by payroll, recorded working time can also be posted to time accounts. Time accounts store the difference between the actual working time and the planned working time. SAP SuccessFactors supports two types of time accounts: working time accounts and time off in lieu. Flextime [page 384] In flextime, working time accounts are used for a daily overtime and minus hours calculation that is added to or deducted from the time account. Time Off in Lieu [page 394] Time off in lieu is used for special overtime compensation. Employees eventually use this compensation to record absences. 3.6.8.1 Flextime In flextime, working time accounts are used for a daily overtime and minus hours calculation that is added to or deducted from the time account. 1. Setting Up Working Time Accounts [page 385] To record variations from standard working time, set up working time accounts and specify which employees can use them. 2. Flextime Bandwidth [page 388] To prevent flextime employees from recording extreme working times, flextime bandwidth defines the earliest possible start time and the latest possible end time that a flextime employee can record. 384 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.8.1.1 Setting Up Working Time Accounts To record variations from standard working time, set up working time accounts and specify which employees can use them. Context Working time accounts record variations from standard working time. These variations are recorded by calculating the balance of time worked in excess or falling short of standard working time. This balance is calculated by comparing the time employees actually work with their work schedule. Procedure 1. Create a time account type you can use to post data to a working time account. Note Do not use a time account type that you already use for time off in lieu. Note If you use period-end processing, do not use the account creation type Recurring for working time accounts. 2. Assign your time account type for working time accounts to a time profile. Note If Update Working Time Account Only When Changes Approved is activated, time sheet entries must be approved before they're posted to the working time account. 3. Decide which of your time type groups should show the working time input. 4. Create a time type group. a. Set Time Category to Calculated Time. b. Set Time Pay Type to Yes. c. Set Valuation Result Category to Difference in Working Time. d. In the Valuation Result Factor field, enter 1. 5. Create a time valuation. 6. Add your time valuation to a time recording profile. 7. Assign this time recording profile to employees that are to use working time accounts. 8. Assign a time profile. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 385 Results Employees for whom you've gone through the above process can see the balance on their working time account when they access their timesheet UI. Setting Up Time Valuations for Working Time Accounts [page 386] To calculate balances on working time accounts, define time valuations using the valuation type Difference Between Threshold and Input. Assign these time valuations to the time recording profiles of all employees for whom you want to use working time accounts. Task overview: Flextime [page 384] Next: Flextime Bandwidth [page 388] 3.6.8.1.1.1 Setting Up Time Valuations for Working Time Accounts To calculate balances on working time accounts, define time valuations using the valuation type Difference Between Threshold and Input. Assign these time valuations to the time recording profiles of all employees for whom you want to use working time accounts. Context When you calculate balances on working time accounts, you record instances where an employee has worked more or less time than planned and calculate the resulting balance. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Difference Between Threshold and Input. The screen is refreshed. 4. Set Valuation Method to Valuate Up To Today. The valuation stops with the current day. If users record time after the current day, the working time account posting isn’t reflected under the balance on the working time account. 5. Specify the threshold type. ○ If you select Fixed Value, enter a threshold value. ○ If you select Time Type Group, assign a threshold group from an existing time type group. 386 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 6. Specify a time type group below. 7. Specify a time type group above. Note You must specify a time type group below or a time type group above. 8. In the Input Time Type Groups field, enter all relevant time type groups from which you calculate the output of the time valuation. You can enter a time type group from any time category as an input time type group. Restriction Don't use the Factor field for clock time valuations. Caution Within a time valuation, the input time type groups must be different from the time type groups assigned to the time type group above and the time type group below. Note If you enter an input time type group with an associated Calculated Time time category, it must be calculated within the same time valuation run as the output of another time valuation. This time valuation must be assigned to the employee’s time recording profile. Tip To add durations of the time records within the input time type groups to the result that is compared to the threshold value, set Reverse Sign to No. To subtract durations of the time records within the input time type groups from the result that is compared to the threshold value, set Reverse Sign to Yes. 9. Save your new time valuation. 10. Assign the time valuation to the time recording profiles of all employees who are to use this valuation type. Results The time valuation is now assigned to the relevant time recording profiles. This single time valuation is normally assigned within a bundle of time valuations in any given time recording profile. Depending on how a bundle of time valuations is configured, the following is possible: ● Single time valuations within a bundle can produce intermediate (hidden) results. ● If they’re defined as a UI component, time valuations can be visible on the UI. ● Single time valuations can be stored within the time sheet and be visible on the UI as a time pay type. Task overview: Setting Up Working Time Accounts [page 385] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 387 3.6.8.1.2 Flextime Bandwidth To prevent flextime employees from recording extreme working times, flextime bandwidth defines the earliest possible start time and the latest possible end time that a flextime employee can record. Flextime allows employees to choose when they start and finish work, as long as they work for a certain number of hours each week. However, this flexibility allows employees to record long working days, early start times, and late end times. You can prevent employees from recording such extreme working times by implementing flextime bandwidth. Flextime bandwidth defines the earliest start time and the latest time that flextime employees can record. Working time recorded outside the flextime bandwidth isn’t taken into account. Before you can define flextime bandwidth, you need to define scheduled working time in the work schedule. Scheduled working time defines the typical start and end time of a working day and is used as a calculation basis for things such as weekly hours and overtime. You also define flextime bandwidth in the work schedule. To define that the time recorded outside the flextime bandwidth isn’t taken into account, you create time type groups and time valuations for flextime bandwidth. If necessary, you can also permit employees to record time outside their flextime bandwidth. 1. Defining Flextime Bandwidth in a Work Schedule [page 389] To specify the earliest and latest times employees are allowed to record working time, define flextime bandwidth in a work schedule. 2. Creating a Time Type Group for Flextime Bandwidth [page 390] Create a time type group for flextime bandwidth so that the flextime bandwidth you define in the work schedule can be processed by the time valuation. 3. Setting Up Time Valuations for Flextime Bandwidth [page 390] Define what happens when employees record time outside their flextime bandwidth. 4. Permission of Time Recording Outside the Flextime Bandwidth [page 392] If exceptional circumstances require employees to record working time outside their flextime bandwidth, you can permit employees to record such times. Parent topic: Flextime [page 384] Previous task: Setting Up Working Time Accounts [page 385] 388 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.8.1.2.1 Defining Flextime Bandwidth in a Work Schedule To specify the earliest and latest times employees are allowed to record working time, define flextime bandwidth in a work schedule. Prerequisites Note You can also add flextime bandwidth on a non-working day, so that if an employee would come to work, you could book that on their flextime account. ● You've defined scheduled working time in a work schedule. ● You've set the time recording variant of the work schedule to Clock Times. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Open a day in a work schedule or a day model. 3. Go to a segment and set Category to Flextime Bandwidth. 4. Enter the start time and end time of the flextime bandwidth. 5. Save your changes. Next Steps Set up a time type group for flextime bandwidth. Task overview: Flextime Bandwidth [page 388] Next task: Creating a Time Type Group for Flextime Bandwidth [page 390] Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 389 3.6.8.1.2.2 Creating a Time Type Group for Flextime Bandwidth Create a time type group for flextime bandwidth so that the flextime bandwidth you define in the work schedule can be processed by the time valuation. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type group with a meaningful external name and external code. 3. Select the time category Flextime Bandwidth. Task overview: Flextime Bandwidth [page 388] Previous task: Defining Flextime Bandwidth in a Work Schedule [page 389] Next task: Setting Up Time Valuations for Flextime Bandwidth [page 390] 3.6.8.1.2.3 Setting Up Time Valuations for Flextime Bandwidth Define what happens when employees record time outside their flextime bandwidth. Prerequisites ● You've defined flextime bandwidth in the work schedule. ● You've created a time type group for recorded working time. ● You've created a time type group for flextime bandwidth. ● You've created a time type group for working time taken into account. ● You've created a time type group for working time not taken into account. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Deduct Group from Input Groups. 390 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management The screen is refreshed. 4. In the Input Time Type Groups field, enter the time type group for recorded working time. Recorded working time is used as the basis for the following calculations. 5. Assign the time type group for flextime bandwidth as the deduction group. The recorded working time is filtered for time within and outside the flextime bandwidth. 6. Specify the time type group for working time taken into account as the time type group below. Time recorded within the flextime bandwidth is taken into account. 7. Specify the time type group for working time not taken into account as the time type group above. Time recorded outside the flextime isn't taken into account. 8. Specify what happens if an employee records time outside the flextime bandwidth. Use one of the following options: ○ To prevent employees from recording times outside the flextime bandwidth, create an error message on the time type group above. ○ To warn employees that time outside the flextime bandwidth isn't taken into account, create a time valuation alert on the time type group above. 9. Save your new time valuation and assign it to the time recording profiles of the employees who use this valuation type. Creating Time Valuation Alerts [page 391] Create time valuation alerts to notify employees and administrators of certain time valuation results. Task overview: Flextime Bandwidth [page 388] Previous task: Creating a Time Type Group for Flextime Bandwidth [page 390] Next: Permission of Time Recording Outside the Flextime Bandwidth [page 392] 3.6.8.1.2.3.1 Creating Time Valuation Alerts Create time valuation alerts to notify employees and administrators of certain time valuation results. Context Note Don't define alerts based on time collectors. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 391 Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set the valuation type. 4. In the Error Flag field, specify on which time type group the message is raised. 5. In the Error Message field, enter an appropriate message text. 6. Set Error Type to Alert and Warning. Results If the time valuation creates a result for which you've defined a time valuation alert, the following happens: A warning is displayed and an admin alert is created on the Admin Alerts page. 3.6.8.1.2.4 Permission of Time Recording Outside the Flextime Bandwidth If exceptional circumstances require employees to record working time outside their flextime bandwidth, you can permit employees to record such times. Flextime bandwidth is intended to prevent employees from working at specific times. However, there can be situations that require employees to work at unusual times. Examples include emergency situations and work in different timezones. In such cases, managers or HR administrators can permit employees to work outside the flextime bandwidth. If employees are permitted to record times outside the flextime bandwidth, these times are taken into account. You permit time recording outside the flextime bandwidth by defining extra time types, creating extra time type groups, and by setting up time valuations for flextime violation. 1. Creating Extra Time Type Groups [page 393] To process extra time types in time valuations, create an extra time type group. 2. Setting Up Time Valuations for Flextime Violations [page 393] Define what happens when employees record time outside their flextime bandwidth and are allowed to do so. Parent topic: Flextime Bandwidth [page 388] Previous task: Setting Up Time Valuations for Flextime Bandwidth [page 390] 392 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.8.1.2.4.1 Creating Extra Time Type Groups To process extra time types in time valuations, create an extra time type group. Prerequisites You have created an extra time type. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type group with a meaningful external name and external code. 3. Select the time category Extra. 4. Assign the extra time type that you want to use in a time valuation. Task overview: Permission of Time Recording Outside the Flextime Bandwidth [page 392] Next task: Setting Up Time Valuations for Flextime Violations [page 393] 3.6.8.1.2.4.2 Setting Up Time Valuations for Flextime Violations Define what happens when employees record time outside their flextime bandwidth and are allowed to do so. Prerequisites ● You've set up a time valuation for flextime bandwidth. ● You've defined an extra time type and created an extra time type group. ● You've created a time type group for working time outside the flextime bandwidth that is taken into account. ● You've created a time type group for working time outside the flextime bandwidth that isn't taken into account. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 393 Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Deduct Group from Input Groups. The screen is refreshed. 4. In the Input Time Type Groups field, enter the time type group for time outside the flextime bandwidth. Time outside the flextime bandwidth is used as the basis for the following calculations. 5. Assign the extra time type group as the deduction group. The recorded working time outside the flextime bandwidth is filtered for time within and outside the extra time period. 6. Specify the following time type group below: the time type group for working time outside the flextime bandwidth that is taken into account. Time recorded within the extra time period is taken into account. 7. Specify the following time type group above: the time type group for working time outside the flextime bandwidth that isn't taken into account. Time recorded outside the extra time period isn't taken into account. 8. Specify what happens if an employee records time outside the extra time. 9. Save your new time valuation and assign it to the time recording profiles of the employees who use this valuation type. Task overview: Permission of Time Recording Outside the Flextime Bandwidth [page 392] Previous task: Creating Extra Time Type Groups [page 393] 3.6.8.2 Time Off in Lieu Time off in lieu is used for special overtime compensation. Employees eventually use this compensation to record absences. 1. Setting Up Time Off in Lieu of Overtime Pay [page 395] Set up Time Sheet so that calculated overtime hours are posted to employee-specific time off in lieu of overtime pay (TOIL) time accounts when eligible employees save their time sheets. 2. Setting Up Time Valuations for Time Off in Lieu (TOIL) Payments [page 397] To valuate time for time off in lieu (TOIL) payments, use the valuation type Compare Threshold with Comparison Group to Route Input. 394 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.8.2.1 Setting Up Time Off in Lieu of Overtime Pay Set up Time Sheet so that calculated overtime hours are posted to employee-specific time off in lieu of overtime pay (TOIL) time accounts when eligible employees save their time sheets. Context Time off in lieu of overtime pay is the compensation of employees for overtime worked by an entitlement to paid leave, in addition to the regular entitlement to paid time off. It’s one of several methods by which employees are compensated for time worked in excess of their regular working time. Restriction Currently, you must decide at an organizational level which specific overtime compensation variant you assign to employees. Procedure 1. Create a time account type that supports time off in lieu of overtime pay as one form of overtime compensation for employees. a. Set the unit of the time account type to Hours. b. Ensure that the time account type is clearly distinguishable from time account types with balances that are built through regular accruals. 2. Create time types to take time off in lieu of overtime pay from the time accounts. a. Set the unit of the time types to Hours. b. Classify the time types as absences. c. Ensure that the time types are clearly distinguishable from the time types for vacation, paid time off, and so on. d. Include the time types in the available time type of the relevant time profile. Caution Ensure the correct posting of time off in lieu hours to the time off in lieu time account for an employee. Configure the time account posting rules with the same time account type that you specify in the time profile field Time Account Type for Time Off in Lieu. 3. Enhance time profiles assigned to employees with the time account type and time types for time off in lieu of overtime pay. a. In the Time Account Type for TOIL field of the time profile, select the time account type for time off in lieu. b. In the Available Time Type section of the time profile, add your time types for time off in lieu. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 395 Caution In the time profile, assign a time type that references the same time account type in the time account posting rules as the time account type you specify in the Time Account Type for Time Off in Lieu field. Note To configure that time off in lieu postings require an approval, activate Update TOIL Account Only When Changes Approved. 4. Based on your time account types, create time off in lieu of overtime pay time accounts for employees. Note ○ If you use a new hire process to onboard an employee, this stage may not be necessary. ○ If you enhance a time profile with a time account type for time off in lieu, use the Manage Time Off Calendars feature in the Admin Center to create an account. 5. Create time type groups that valuate the base and premium components of calculated overtime. a. Set Valuation Result Category to either Overtime Base or Overtime Premium. b. Set Time Pay Type to Yes. c. Specify the valuation result factor. This factor converts time valuation results for calculated overtime to hours of time off in lieu. 6. Create time valuations that derive time valuation results for both the base and premium components of calculated overtime. 7. Create time recording profiles that valuate overtime compensation for all eligible employees, and assign your time valuation rules to these time recording profiles. The time valuations you assign in the time recording profile derive all required time valuation results for each employee assigned to the profile. Remember The default compensation variant of the respective employee determines if the valuated overtime is paid out to the employee or converted to time off in lieu. The overtime compensation is based on a same set of time valuation results. Therefore, a time recording profile that valuates the calculated overtime of an employee can lead to three different forms of overtime compensation. 8. Assign role-based permissions for the Default Overtime Compensation Variant field in the job information and activate this field. a. Assign role-based permission settings that grant view or maintenance permissions for the Default Overtime Compensation Variant field to users who are assigned to the Employee Self Service, Manager, and HR Role roles. b. In the employee job information, activate the Default Overtime Compensation Variant field. 9. Configure the job information of your employees and assign the required default overtime compensation variant to all eligible employees. a. For each employee, go to Job Information. b. Select one of your enhanced time profiles. You enhance time profiles when you create time off in lieu of overtime pay time accounts. 396 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management c. Select one of your time recording profiles. d. In the Default Overtime Compensation Variant field, select either Payout and Time Off or Time Off. By selecting Payout and Time Off, you specify that the portion of the calculated overtime of an employee paid at the basic hourly rate is converted into time pay types and paid out. The premium component of the calculated overtime of an employee is converted to time off in lieu of overtime pay and posted to a dedicated time off in lieu time account. By selecting Time Off, you specify that all calculated overtime of an employee is converted to time off in lieu of overtime pay and posted to a dedicated time off in lieu time account. Results Employees can take time off in lieu that is posted to their time off in lieu time account immediately. Task overview: Time Off in Lieu [page 394] Next task: Setting Up Time Valuations for Time Off in Lieu (TOIL) Payments [page 397] 3.6.8.2.2 Setting Up Time Valuations for Time Off in Lieu (TOIL) Payments To valuate time for time off in lieu (TOIL) payments, use the valuation type Compare Threshold with Comparison Group to Route Input. Context The valuation type Compare Threshold with Comparison Group to Route Input determines where time data should go after another time type group, the comparison group, is compared with a given threshold value. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Compare Threshold with Comparison Group to Route Input. The screen is refreshed. 4. Specify the valuation method. 5. Specify the threshold type. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 397 ○ If you select Fixed Value, enter a threshold value. ○ If you select Time Type Group, assign a threshold group from an existing time type group. 6. Specify a time type group below. 7. Specify a time type group above. Note You must specify either a time type group below or a time type group above. 8. Specify a time type group as the comparison group. The values of the threshold group or the threshold value are compared with this group. 9. In the Input Time Type Groups field, enter all relevant time type groups from which you must calculate the output of the time valuation. Caution Within a time valuation, the input time type groups must be different from the time type groups assigned to the time type group above and the time type group below. 10. Save your new time valuation. 11. Assign the time valuation to the time recording profiles of all employees who are to use this valuation type. Results The time valuation is now assigned to the relevant time recording profiles. This single time valuation is normally assigned within a bundle of time valuations in any given time recording profile. Depending on how a bundle of time valuations is configured, the following is possible: ● Single time valuations within a bundle can produce intermediate (hidden) results. ● If they’re defined as a UI component, time valuations can be visible on the UI. ● Single time valuations can be stored within the time sheet and be visible on the UI as a time pay type. Task overview: Time Off in Lieu [page 394] Previous task: Setting Up Time Off in Lieu of Overtime Pay [page 395] 398 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 3.6.9 Integrating Time Sheet with Employee Central Payroll In the time recording profile, set isPayComponent to Yes. Context You can set up an integration that replicates employee time valuation results generated by Time Sheet to Employee Central Payroll. The replicated time valuation results are used to pay employees based on their recorded times and other time-related data. For more information about time valuations, see Time Valuations [page 350]. Procedure 1. Go to Job Info and choose Time Recording Profile. 2. Choose Time Valuation Time Type Group Time Pay Type . 3. Set isPayComponent to Yes. 3.6.10 Setting Up Email Notifications Activate email notification templates so that employees who submit time sheets and approvers of time sheets receive email notifications. Procedure 1. Go to the Admin Center and choose System Properties. 2. Choose E-Mail Notification Templates Settings. 3. Select Workflow Action Pending Notification, Workflow Action Approval Notification, Workflow Action Rejected Notification, and Workflow Comment Posted Notification. 3.6.11 Recommendations and Restrictions for Time Sheet Please note that Time Sheet is supported for permanent employees only - not for contingent workers. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 399 3.6.12 Troubleshooting: Known Issues in Time Sheet There are some known issues in Time Sheet. Table 27: Known Issues Description More Information It’s strictly not supported to upload time sheet data directly to a customer system using Export Data Admin Center Import and . You can't change the approval status of a time sheet using Manage Data. You can't make manual changes on time sheet entries or time valuation results using Manage Data. There are a number of issues you should be aware of when importing work schedules in Time Off with the template pro­ vided by export/import data. Time Sheet doesn't use custom fields that are defined in the Avoiding Time Off Custom Field Issues [page 401] Employee Time object. Therefore, these custom fields result in an error when employees submit time sheets for approval. Save Rule checks implemented in the Time Off module can affect processing in Time Sheet. Avoiding Issues Caused by Time Off Rule Checks [page 401] Avoiding Issues when Changing the To-Do Category [page When you change ToDo Category from Generic Object Change Requests to Time Sheet Requests, existing time 402] sheet requests that haven't been approved are still displayed in the generic section of the ToDo tile. After these existing time sheet requests are approved, they remain in the generic section of the ToDo tile and can’t be removed. The MDF field property Private or Sensitive Information isn’t respected in Time Sheet; the value is rendered as before without masking. Moving the rehire date can lead to data inconsistency when there’s already a time sheet with valuation results at this fu­ ture point in time. Avoiding Issues when Moving the Rehire Date [page 402] Various problems can occur when unchanged time sheets are recalculated. For example, a time sheet has been saved. Since then, a new custom field has been created that should be filled using an onSave rule. If the new field is the only change, the recalculation job doesn’t save the time sheets again. Avoiding Issues Caused by Unchanged Time Sheets [page 403] Avoiding Time Off Custom Field Issues [page 401] Define that required custom fields are relevant only for Employee Central Time Off. Avoiding Issues Caused by Time Off Rule Checks [page 401] Ensure Save Rule checks from Time Off are not processed in Time Sheet. Avoiding Issues when Changing the To-Do Category [page 402] Approve or decline all existing time sheet requests before changing To-Do Category. Avoiding Issues when Moving the Rehire Date [page 402] 400 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management To avoid data inconsistency, delete the valuation results before moving the rehire date. Avoiding Issues Caused by Unchanged Time Sheets [page 403] In the time management configuration object, temporarily set Switch off enhanced save for to All. 3.6.12.1 Avoiding Time Off Custom Field Issues Define that required custom fields are relevant only for Employee Central Time Off. Context Employee Central Time Off allows the use of custom fields with required entries that are implemented using the Employee Time object. Employee Central Time Sheet doesn't use custom fields that are defined in the Employee Time object. Therefore, custom fields result in an error when employees submit time sheets for approval. Although those fields are required, employees cannot access them, and the submission process fails. You can avoid this issue by defining that the custom fields are only relevant for the time types of the category Absence. This time type category is used only in Employee Central Time Off. Procedure 1. Choose Admin Center Configure Object Definitions . 2. Edit the Employee Time object definition. a. For each of your custom fields with a mandatory entry (Required = Yes), choose Details. b. Set Field Id to timeType.category. c. Set value to Absence. You can create custom fields for Time Sheet by using the Employee Time Sheet Entry object. For more information, see Creating Custom Fields for Time Sheet [page 345]. 3.6.12.2 Avoiding Issues Caused by Time Off Rule Checks Ensure Save Rule checks from Time Off are not processed in Time Sheet. Context Save Rule checks implemented in Time Off can affect processing in Time Sheet. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 401 Procedure 1. Check which Save Rule checks exist in Time Off. 2. Ensure that these rule checks are not processed in Time Sheet. 3.6.12.3 Avoiding Issues when Changing the To-Do Category Approve or decline all existing time sheet requests before changing To-Do Category. Context When you change To-Do Category from Generic Object Change Requests to Time Sheet Requests, existing time sheet requests that haven't been approved are still displayed in the generic section of the To-Do tile. After these existing time sheet requests are approved, they remain in the generic section of the To-Do tile and cannot be removed. Procedure 1. Approve or decline all existing time sheet requests. 2. Change To-Do Category to Time Sheet Requests. 3.6.12.4 Avoiding Issues when Moving the Rehire Date To avoid data inconsistency, delete the valuation results before moving the rehire date. Context Moving the rehire date can lead to data inconsistency when there is already a time sheet with valuation results at this future point in time. Procedure 1. Delete the valuation results. 402 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management 2. Move the rehire date. 3.6.12.5 Avoiding Issues Caused by Unchanged Time Sheets In the time management configuration object, temporarily set Switch off enhanced save for to All. Context Various problems can occur when unchanged time sheets are recalculated. For example, a time sheet has been saved. Since then, a new custom field has been created that should be filled using an onSave rule. If the new field is the only change, the recalculation job does not save the time sheets again. Procedure 1. Go to the time management configuration object. 2. Set Switch off enhanced save for to All. 3. Recalculate your time sheets. 4. Set Switch off enhanced save for back to None. Implementing Time Management in SAP SuccessFactors Implementation of Employee Central Time Management PUBLIC 403 4 Implementation of SAP SuccessFactors Time Tracking SAP SuccessFactors Time Tracking is a subscription that provides you with additional attendance recording capabilities. The capabilities included in SAP SuccessFactors Time Tracking extend those provided by the time sheet of Employee Central Time Management. SAP SuccessFactors Time Tracking features are only available in the new time sheet UI. Clock In Clock Out Clock In Clock Out helps you track employees' time when they use the swipe machine or any external time tracking service like a terminal. It automatically records the duration of time events in the SAP SuccessFactors Time Sheet. Setting Up Single Record Approval [page 404] Set up single record approval so that time sheet entries are approved separately rather than on a weekly basis. Night Shift Bandwidth [page 406] Night shift bandwidth ensures that all relevant attendance recordings are registered for the intended planned working time segment, on the day the night shift in question starts. To use it, you must have SAP SuccessFactors Time Tracking active in your system. Advanced Filtering Options for Holiday-Related Premium Pay [page 413] SAP SuccessFactors Time Tracking provides extensions to the time records filter of the time valuation. These extensions support complex premium pay scenarios involving holidays such as night shifts on holidays or half-day holidays. 4.1 Setting Up Single Record Approval Set up single record approval so that time sheet entries are approved separately rather than on a weekly basis. Prerequisites ● You have activated Time Tracking in Provisioning. ● Your organization can access the new time sheet UI. 404 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking Context By default, employees submit their time sheets for approval on a weekly basis. However, some organizations require that certain or all time sheet entries are approved separately. Typical use cases include entries that require more than one approver and entries that require approval in advance. Note You can't add single record approval to time types that are main attendance time types or main break time types in a time recording profile. Procedure 1. Create an attendance, on call, break, or extra time type. Note You can't add single record approval to allowance types. 2. Enter a workflow configuration to your time type. Note You can't add to or delete the workflow configuration from a time type that is used in existing time sheet entries. Results Time sheet entries with this time type require single approval. Note The submit job will not pick up and submit a time sheet - and users cannot manually submit a time sheet until all working time recordings are approved. Task overview: Implementation of SAP SuccessFactors Time Tracking [page 404] Related Information Night Shift Bandwidth [page 406] Advanced Filtering Options for Holiday-Related Premium Pay [page 413] Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking PUBLIC 405 4.2 Night Shift Bandwidth Night shift bandwidth ensures that all relevant attendance recordings are registered for the intended planned working time segment, on the day the night shift in question starts. To use it, you must have SAP SuccessFactors Time Tracking active in your system. It determines the earliest possible start time and the latest possible end time that an employee can record as part of a night shift. An example would be where a night shift is scheduled from 22:00 until 06:00. The night shift bandwidth is from the start of the shift until 08:00. An additional attendance is then booked from 06:30 until 07:30 on day 2. This means that an additional hour is added to the actual time worked on the night shift for day 1. Before you can specify night shift bandwidth, you need to define scheduled working time in the work schedule and any work schedule day models used. Scheduled working time defines the typical start and end time of a working day and is used as a calculation basis for things such as weekly hours and overtime. To ensure that the time recorded outside the night shift bandwidth isn’t taken into account, you create time type groups and time valuations for night shift bandwidth. If necessary, you can also permit employees to record time outside their night shift bandwidth. The following considerations and restrictions apply to the use of night shift bandwidth: ● Night shift bandwidth can only be specified in cross-midnight work schedules. ● Night shift bandwidth can only be specified in work schedules where the clock times recording variant is selected. ● Breaks in a cross-midnight work schedule day cannot be defined outside the planned working time when no night shift bandwidth is defined. ● Breaks in a cross-midnight work schedule day cannot be defined outside the night shift bandwidth. ● Night shift bandwidth cannot exceed 24 hours. ● Night shift bandwidths of two work schedule days cannot overlap. ● Night shift bandwidth must start before midnight and end after midnight. ● Planned working time has to fall inside the night shift bandwidth. ● Planned working time cannot overlap with planned working time from the previous day or the next day. ● Breaks cannot overlap with night shift bandwidth from the previous day. ● Breaks cannot overlap with planned working time from the previous day. ● Planned working time and night shift bandwidth have to start on the same day. 1. Setting Up Night Shift Bandwidth in a Work Schedule [page 407] To specify the latest times employees are allowed to record working time in a night shift, set up night shift bandwidth in their work schedule. 2. Creating a Time Type Group for Night Shift Bandwidth [page 408] Create a time type group for night shift bandwidth so that the night shift bandwidth you define in the work schedule can be processed by the time valuation. 3. Setting Up Time Valuations for Night Shift Bandwidth [page 408] Define what happens when employees record time outside their night shift bandwidth. 4. Permission to Record Time Outside the Night Shift Bandwidth [page 410] If exceptional circumstances require employees to record working time outside their night shift bandwidth, you can permit employees to record such times. 406 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking Parent topic: Implementation of SAP SuccessFactors Time Tracking [page 404] Related Information Setting Up Single Record Approval [page 404] Advanced Filtering Options for Holiday-Related Premium Pay [page 413] 4.2.1 Setting Up Night Shift Bandwidth in a Work Schedule To specify the latest times employees are allowed to record working time in a night shift, set up night shift bandwidth in their work schedule. Prerequisites ● You've specified scheduled working time in the work schedule. ● You've set the time recording variant of the work schedule to Clock Times. ● You've activated cross-midnight processing in the work schedule. If the work schedule uses the Period model, you also need to have activated cross-midnight processing in the work schedule day models used in the work schedule. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Open a day in a work schedule or a day model. 3. Go to a segment and set Category to Night Shift Bandwidth. 4. Enter the start time and end time of the night shift bandwidth. Remember that it must start before midnight and end after midnight and that the bandwidth entered can't exceed 24 hours in duration. 5. Save your changes. Task overview: Night Shift Bandwidth [page 406] Next task: Creating a Time Type Group for Night Shift Bandwidth [page 408] Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking PUBLIC 407 4.2.2 Creating a Time Type Group for Night Shift Bandwidth Create a time type group for night shift bandwidth so that the night shift bandwidth you define in the work schedule can be processed by the time valuation. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type group with a meaningful external name and external code. 3. Select the time category Night Shift Bandwidth. Task overview: Night Shift Bandwidth [page 406] Previous task: Setting Up Night Shift Bandwidth in a Work Schedule [page 407] Next task: Setting Up Time Valuations for Night Shift Bandwidth [page 408] 4.2.3 Setting Up Time Valuations for Night Shift Bandwidth Define what happens when employees record time outside their night shift bandwidth. Prerequisites ● You've defined night shift bandwidth in the work schedule and, in the case of work schedules of the Period model, in the relevant work schedule day models. ● You've activated cross-midnight processing for the work schedule and day models. ● You've created a time type group for recorded working time. ● You've created a time type group for night shift bandwidth. ● You've created a time type group for working time taken into account. ● You've created a time type group for working time not taken into account. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Deduct Group from Input Groups. The screen is refreshed. 408 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking 4. In the Input Time Type Groups field, enter the time type group for recorded working time. Recorded working time is used as the basis for the subsequent calculations. 5. Assign the time type group for night shift bandwidth as the deduction group. The recorded working time is filtered for time within and outside the night shift bandwidth. 6. Specify the time type group for working time taken into account as the time type group below. Time recorded within the night shift bandwidth is taken into account. 7. Specify the time type group for working time not taken into account as the time type group above. Time recorded outside the night shift bandwidth isn't taken into account. 8. Specify what happens if an employee records time outside the night shift bandwidth. Use one of the following options: ○ To prevent employees from recording times outside the night shift bandwidth, create an error message on the time type group above. ○ To warn employees that time outside the night bandwidth isn't taken into account, create a time valuation alert on the time type group above. 9. Save your new time valuation and assign it to the time recording profiles of the employees who use this valuation type. Task overview: Night Shift Bandwidth [page 406] Previous task: Creating a Time Type Group for Night Shift Bandwidth [page 408] Next: Permission to Record Time Outside the Night Shift Bandwidth [page 410] 4.2.3.1 Creating Time Valuation Alerts Create time valuation alerts to notify employees and administrators of certain time valuation results. Context Note Don't define alerts based on time collectors. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking PUBLIC 409 3. Set the valuation type. 4. In the Error Flag field, specify on which time type group the message is raised. 5. In the Error Message field, enter an appropriate message text. 6. Set Error Type to Alert and Warning. Results If the time valuation creates a result for which you've defined a time valuation alert, the following happens: A warning is displayed and an admin alert is created on the Admin Alerts page. 4.2.4 Permission to Record Time Outside the Night Shift Bandwidth If exceptional circumstances require employees to record working time outside their night shift bandwidth, you can permit employees to record such times. Night shift bandwidth is intended to define the times employees work as part of a night shift. However, there can be situation where employees might need to work at unusual times. In such cases, managers or HR administrators can permit employees to work outside the night shift bandwidth. If employees are permitted to record times outside the night shift bandwidth, these times are taken into account. You permit time recording outside the night shift bandwidth by defining extra time types, creating extra time type groups, and by setting up time valuations to cover time worked outside the specified night shift bandwidth. 1. Defining Extra Time Types [page 411] Define extra time types so that users can record additional time information that further specifies recorded attendance time. 2. Creating Extra Time Type Groups [page 411] To process extra time types in time valuations, create an extra time type group. 3. Setting Up Time Valuations for Night Shift Violations [page 412] Parent topic: Night Shift Bandwidth [page 406] Previous task: Setting Up Time Valuations for Night Shift Bandwidth [page 408] 410 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking 4.2.4.1 Defining Extra Time Types Define extra time types so that users can record additional time information that further specifies recorded attendance time. Context Collision checks prevent the recording of concurrent times for an employee. However, some scenarios require that recorded attendance time is further specified. Extra time types enable users to further specify certain attendance times without causing a collision. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time type. 3. Enter an external name and a meaningful external code. 4. In the Classification field, select Extra. 5. Select the time unit Hour(s). 6. Assign the extra time types to the relevant employee time profiles. Next Steps To use the extra time type in a time valuation, create an extra time type group. Task overview: Permission to Record Time Outside the Night Shift Bandwidth [page 410] Next task: Creating Extra Time Type Groups [page 411] 4.2.4.2 Creating Extra Time Type Groups To process extra time types in time valuations, create an extra time type group. Procedure 1. Go to the Admin Center and choose Manage Data. Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking PUBLIC 411 2. Create a time type group with a meaningful external name and external code. 3. Select the time category Extra. 4. Assign the extra time type that you want to use in a time valuation. Task overview: Permission to Record Time Outside the Night Shift Bandwidth [page 410] Previous task: Defining Extra Time Types [page 411] Next task: Setting Up Time Valuations for Night Shift Violations [page 412] 4.2.4.3 Setting Up Time Valuations for Night Shift Violations Prerequisites ● You've set up a time valuation for night shift bandwidth. ● You've defined an extra time type and created an extra time type group. ● You've created a time type group for working time outside the night shift bandwidth that is taken into account. ● You've created a time type group for working time outside the night shift bandwidth that isn't taken into account. Procedure 1. Go to the Admin Center and choose Manage Data. 2. Create a time valuation and enter a unique external name and external code. 3. Set Valuation Type to Deduct Group from Input Groups. The screen is refreshed. 4. In the Input Time Type Groups field, enter the time type group for time outside the night shift bandwidth. Time outside the night shift bandwidth is used as the basis for the following calculations. 5. Assign the extra time type group as the deduction group. The recorded working time outside the night shift bandwidth is filtered for time within and outside the extra time period. 6. Specify the following time type group below: the time type group for working time outside the night shift bandwidth that is taken into account. Time recorded within the extra time period is taken into account. 412 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking 7. Specify the following time type group above: the time type group for working time outside the night shift bandwidth that isn't taken into account. Time recorded outside the extra time period isn't taken into account. 8. Specify what happens if an employee records time outside the extra time. 9. Save your new time valuation and assign it to the time recording profiles of the employees who use this valuation type. Task overview: Permission to Record Time Outside the Night Shift Bandwidth [page 410] Previous task: Creating Extra Time Type Groups [page 411] 4.3 Advanced Filtering Options for Holiday-Related Premium Pay SAP SuccessFactors Time Tracking provides extensions to the time records filter of the time valuation. These extensions support complex premium pay scenarios involving holidays such as night shifts on holidays or halfday holidays. In Employee CentralTime Management, you can set up time valuations for premium pay that support paying a premium on a full public holiday. You set this up by filtering for a full holiday on a current day. However, many organizations require filtering options that support more complex holiday scenarios. The filtering options of Time Tracking support a number of these scenarios. Night Shifts with Holidays Nights shifts are usually paid at a premium rate. However, the premium rate is even higher when the night shift coincides with a public holiday. Unless there are consecutive public holidays, though, only a part of the shift falls on a public holiday. To pay the premium for the part of the night shift on the public holiday, you filter for public holidays on the current, previous, or next day. Days Before a Public Holiday Sometimes a premium is payed on a day before a public holiday. In this case you can filter for no holiday for on the current day and a holiday class for the next day. Parent topic: Implementation of SAP SuccessFactors Time Tracking [page 404] Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking PUBLIC 413 Related Information Setting Up Single Record Approval [page 404] Night Shift Bandwidth [page 406] Setting Up Time Valuations for Premium Pay [page 356] 414 PUBLIC Implementing Time Management in SAP SuccessFactors Implementation of SAP SuccessFactors Time Tracking 5 Recalculation in Time Management Some changes to an employee's job information, for example, changes to the work schedule or time profile, cause absences or attendances or accruals to be recalculated. Changes to actual absences or temporary changes to time information can also result in recalculations. Note Time sheets, absences, and accruals are automatically recalculated up to three times. After the third unsuccessful recalculation attempt, you need to trigger the recalculation manually after correcting the error that caused the recalculation to fail. Note The recalculation doesn't import external time data and external time records. You need to use the import job instead. By default, the import job only imports data up to 20 weeks in the past. To import earlier data, set the recalculation date accordingly. Restriction Changes within objects don’t trigger an automatic recalculation. For example, changing which holiday calendar is assigned to an employee triggers a recalculation. However, if you simply change the holiday calendar itself - say, by adding another holiday or removing one already there - no automatic recalculation takes place. You can trigger one manually. The Triggering Recalculation documentation tells you how. Changes to an employee's time data or job information normally trigger a response in Time Management. Depending on the change, different business processes have to be rerun to adapt and re-evaluate existing data in Time Off and Time Sheet. The recalculation process must be switched on by configuration and is always initiated by a recalculationrelevant change in data. Note There are no additional authorization checks for recalculation. The recalculation is initiated by the data change that triggers it, and so is based on authorizations processed by the relevant transaction. Time Management Recalculation Event (TMRE) The recalculation process is based on the Time Management Recalculation Event (TMRE) object. Each recalculation process is controlled by TMRE objects of its own type. The triggering data change creates a TMRE instance of the initial recalculation type and this TMRE then starts the recalculation for an employee. At the end of the first recalculation process, a TMRE is created for the following process step, which in turn triggers the recalculation for its recalculation process until the last recalculation process is performed and recalculation ends. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 415 The exact number of recalculation processes might vary depending on the triggering data change. Relevant recalculation processes are, however, always performed in the same order as a chain of independent recalculation processes. Each recalculation process provides error resolution capabilities and can be restarted independently from the other process parts. Recalculation Processing Options ● Automatically and asynchronously. By default, the recalculation is triggered as a Time Management eventbased task. The recalculation is integrated in the job TLMTriggerTask. ● Manually. You trigger an immediate recalculation run yourself. Recalculation Example 1 An administrator retroactively changes the work schedule assignment in an employee's job information. Therefore, absences already recorded and simulated are out of date and need to be corrected, taking account of the new work schedule. The Time Sheet valuation is also affected. Accruals need to be recalculated. Recalculation Example 2 The administrator retroactively assigns another Time Recording Profile to an employee for whom time sheets have already been created. In this case, no recalculation of absences is needed. However, time sheets for the affected periods do need to be re-evaluated, and accruals must be adapted. 5.1 Configuring Recalculation in Time Management Use the links to access information on what's involved in configuring recalculations in Time Management. 5.1.1 Time Management Configuration Object The Time Management Configuration object contains attributes that regulate whether, how, and as of when recalculation takes place. Here's some information on how to use the attributes: ● Enable Recalculation You select Yes or No for this, which determines whether recalculation is active in your system. ● Schedule Immediate Execution 416 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management You select Yes or No for this. making it possible to trigger an immediate time management recalculation if you need it, rather than just waiting for the next scheduled job. ● Earliest Recalculation Date Only changes made on or after this date affect the recalculation. If a change is made before it, the system creates a time management recalculation event with the earliest recalculation date as its start date. There's more about this in the next chapter. ● External Code Enter a meaningful external code here. Note Configuration is not effective dated. 5.1.2 Effect of the Earliest Possible Recalculation Date on Recalculation You use the Earliest Possible Recalculation Date to restrict recalculation in Time Management to a specified period. By specifying the Earliest Possible Recalculation Date within the Time Management Configuration object, you can deactivate recalculation across the whole Time Management module before the Earliest Possible Recalculation Date you define. Defining the earliest recalculation date ensures that there are no time management recalculation events with a date earlier than the Earliest Possible Recalculation Date. However, when you set this date, you can still change data retroactively in periods before the Earliest Possible Recalculation Date. You can use rule functions in Take Rules (Leave Request Validations) to prevent backdated changes prior to the Earliest Possible Recalculation Date. For more information on these rules, see Business Rule Functions for Recalculation [page 418]. Example The Earliest Possible Recalculation Date is defined in a system as 01/01/2020. The Job information data for an employee is retroactively changed, effective from 01/01/2019. Where this change to the employee's Job information data is relevant for recalculation, the system stores a time management recalculation event with an Earliest Possible Recalculation Date of 01/01/2020. Unless the Earliest Possible Recalculation Date is changed to 01/01/2019, the required recalculation will not be made in the system. Other Recalculation Scenarios Accrual periods and absences that straddle the earliest possible recalculation date can be recalculated. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 417 5.1.3 Business Rule Functions for Recalculation There are 2 rule functions offering access to the configured recalculation (example: consumption in Take Rules). The rule functions are: ● isTimeManagementRecalculationActive() This returns True if recalculation is active. ● getTimeManagementEarliestRecalculationDate() This returns the earliest possible recalculation date if recalculation is active. Otherwise, it returns 01/01/1900. 5.1.4 Time Management Recalculation Event The recalculation process is based on a generic object (GO) called the Time Management Recalculation Event (TMRE). The list below gives some information on how the attributes are used. All of them, except the Schedule Job ID, are required entries. ● External Code This is generated automatically. ● Event Type Possible entries for recalculation here are: ○ Recalculate Absences ○ Recalculate Time Sheets ○ Recalculate Accruals ○ Recalculate Transfer Dates ● Start Recalculation on Save If you choose Yes here, saving this TMRE triggers the start of the recalculation process. All target IDs of this event are processed. ● Target Type Your options: ○ Enter a specific user. ○ Time Recording Profile If you choose this, the target population for the profile is every user with the relevant profile. ○ Holiday Calendar You can only select this if you also select the event type Recalculate Absences. The target population for the holiday calendar is then every user with the relevant holiday calendar. ● Target ID This is the ID of the user, time recording profile, or holiday calendar you're doing the recalculation for. ● Date This indicates when the recalculation will start. It can be either today's date or a date in the past. ● Status Values: To Be Processed, Running, Completed Successfully, Completed with Errors. ● Schedule Job ID You can use this field to enter a meaningful ID for the scheduled job. 418 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management Time Management Recalculation Event Parameters You can use the parameters to restrict which account types are relevant for accrual recalculation and which kinds of employee time will trigger a transfer date recalculation. ● Target Event Type Select either Recalculate Accruals or Recalculate Transfer Dates. ● Name Select either Time Account Type or Employee Time. ● Value If you selected Time Account Type above, enter the external code of the time account type or enter ALL. If you selected Employee Time, enter the external code of the Employee Time. ● External Code Enter a meaningful external code for this parameter. 5.2 Triggering Recalculation This section describes the triggering of recalculation in Time Management. Note Recalculation in Time Management is based on the Time Management Recalculation Event (TMRE). For more information on TMREs, see Time Management Recalculation Event [page 418]. 5.2.1 How Recalculation is Triggered Recalculation in Time Management is triggered by three major groups of changes to time management data in Employee Central. These groups are listed below, together with the individual triggers contained within each of the groups. Tip How Recalculation Affects Time Management Data [page 438] provides more information on the actual impact in Time Management of the changes described below. You can also trigger instant recalculations manually using the Run Job on Save field in the Time Management Recalculation Event. Changes to Time Information in Employee Job Information Changes to the following Time Information within an employee's Job Information trigger recalculation in Time Management: ● Work Schedule (standard or individual) Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 419 ● Time Profile ● Holiday Calendar ● Time Recording Profile ● Default Overtime Compensation Variant Note ○ Changes within these objects do not automatically trigger a calculation. For example, if you change which holiday calendar is assigned to an employee, this triggers a recalculation. However, if you simply make a change to the holiday calendar itself - say, by adding another holiday or removing one already there - no recalculation takes place. This is the system working as designed. However, if you do, in fact, need to trigger a recalculation in such circumstances, you can trigger one manually. There's a description of how you do this below. ○ Changes done via termination import do not automatically trigger a recalculation. You can create a Time Management Recalculation Event for this user manually. Changes to Employee Central Time Management Data Changes to the following Time Management data trigger recalculation: ● Absence data in Time Off ● Temporary time data Changes Within A Holiday Calendar or Time Recording Profile So far, we've discussed recalculations that are triggered automatically when a different object is assigned to a an employee's job information - for example, if holiday calendar US1 is assigned to an employee and we change that assignment to US2. Sometimes, however, although the same object is assigned to an employee, a change takes place within the object. For example, a new public holiday might be created and entered in holiday calendar US1. In such cases, recalculation is not triggered automatically. You need to trigger it manually by creating a time management recalculation event (TMRE) as detailed in the Time Management Recalculation Event [page 418] documentation. ● Here's what to do in the TMRE if you want to recalculate data based on a change within a holiday calendar: ○ Choose Recalculate Absences as the event type. ○ Choose Holiday Calendar as the target type ○ Enter the external code of the relevant holiday calendar in the External Code field. ○ Set the Start Job on Save to Yes. The recalculation starts when you save this TMRE. ● Here's what to do in the TMRE if you want to recalculate data based on a change within a time recording profile: ○ Choose Recalculate Time Sheets as the event type. ○ Choose Time Recording Profile as the target type 420 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management ○ Enter the external code of the relevant time recording profile in the External Code field. ○ Set the Start Job on Save to Yes. The recalculation starts when you save this TMRE. 5.3 Recalculation in Time Management - Process Overview This section describes the recalculation process in Time Management and provides information about the main ways in which recalculation is performed. There are four different recalculation processes in Time Management, each based on a defined Time Management Recalculation Event [page 418] (TMRE) and TMRE event type: ● Absences are recalculated in Time Off based on time management recalculation events with event type Recalculate Absences. For more information, see: Recalculating Absences [page 430]. ● Time sheets are recalculated based on time management recalculation events with event type Recalculate Time Sheets. All time sheets assigned with the target ID within the TMRE and valid on the dates specified in the TMRE are recalculated. For more information, see: Recalculating Time Sheets [page 436]. ● Transfer dates are recalculated based on time management recalculation events with event type Recalculate Transfer Dates. For more information, see Recalculating Transfer Dates [page 430]. ● Accruals are recalculated in Time Off based on time management recalculation events with event type Recalculate Accruals. For more information, see: Recalculating Accruals [page 431]. Depending on the actual trigger for the recalculation (and based also on system settings), all or only a subset of recalculation processes are performed by the system. Each process is atomic and is based solely on the specific event type assigned to the time management recalculation event. In Which Order Is Recalculation Performed? The order of recalculation processes is always fixed and is as follows: 1. Recalculation of existing absences is performed in Time Off. 2. All affected time sheets are recalculated (assuming that Time Sheet has been activated in the system). 3. Transfer dates are recalculated and adjusted based on the Effect on Transfer Date rule. 4. Accruals are recalculated and adjusted accordingly. Each process calls the next one as it runs. Note Where the initial time management recalculation event is of type Recalculate Time Sheets, any absence recalculation process is immediately skipped (due to missing TMRE for this user) and the time sheet recalculation starts directly. Afterwards, the accrual recalculation is executed. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 421 5.3.1 The Time Management Recalculation Task and 'TLMTriggerRecalculation' Job The whole recalculation is processed as an event-based Time Management task if recalculation is activated in Time Management. Immediately after a recalculation is triggered, it is processed by this task. The TLMTriggerRecalculation job should additionally run daily, even if event-based recalculation is enabled, so that erroneous recalculation events are processed again. The Time Management Recalculation task and the TLMTriggerRecalculation job consists of four separate services, processed sequentially: ● AbsenceRecalculate - based on a time management recalculation event with event type ABSENCE_RECALCULATE ● TimeSheetRecalculate - based on a time management recalculation event with event type TIME_SHEET_RECALCULATE ● TransferDateRecalculate - based on a time management recalculation event with event type TRANSFER_DATE_RECALCULATE ● AccrualRecalculate - based on a time management recalculation event with event type ACCRUAL_RECALCULATE The TLMTriggerTask job executes the TLMTriggerRecalculation job if recalculation events exist in the system. The system picks up the recalculation tasks before other tasks such as importing accruals or importing time sheets. You can use the Execution Manager dashboard to monitor the TLMTriggerRecalculation. The summary also contains a log file to help you identify and troubleshoot any recalculation issues or errors. Additionally, the Execution Manager dashboard shows failures of the recalculation executed through the Time Management Task framework. These issues are listed under Middelware Integrations. Alerts are created for erroneous recalculations. You can see the alerts on the Admin Alerts UI. Process the alerts regularly so that the recalculation can be executed in a timely manner to update the absences, time sheets, and accruals according to the changes that triggered the recalculation. Take a look at the Viewing Time Management Recalculation Results from the Execution Manager [page 423] information for details of how to monitor recalculation results. 422 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management Job Run Details The job run details can be viewed using the Scheduled Jobs Manager in the Admin Center. Here's how the how the Scheduled Jobs Manager displays the TLMTriggerRecalculation job: 5.3.2 Viewing Time Management Recalculation Results from the Execution Manager You can use the Execution Manager to view failed recalculation runs. Caution To run the TLMTriggerRecalculation job, the TLMTriggerTasks job must already be configured in Provisioning, and be scheduled to run in your system. It contains all required time sheet background jobs and the TLMTriggerRecalculation job. All time sheet background jobs run automatically based on the configuration for the TLMTriggerTasks job in Provisioning. Recalculation events are processed by default as Time Management evant-based tasks. You can access the Execution Manager from the Admin Center by choosing Execution Manager Dashboard. In Execution Manager Dashboard you need to choose Middleware Integrations. Alerts are created for erroneous recalculations. You can see the alerts in the Admin Alerts UI. Process the alerts regularly so that the recalculation can be executed in a timely manner to update the absences, time sheets, and accruals according to the changes that triggered the recalculation. In addition you can use the Execution Manager to view information on recalculation jobs that have already run and have taken up mainly recalculation events in status "Error" again. The Execution Manager dashboard shows failures of recalculation that was executed through the Time Management Task framework. Here's information to help you better understand where each job status appears: Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 423 Table 28: Job Status Daily Recalculation Job In Progress Successful Yes (under Scheduled Job) No Failed Yes (under Scheduled Job) No Technical errors Completed With Er­ rors/Warnings Yes (under Scheduled Job) Yes (Errors are shown) "The user is being ter­ minated and rehired in the accrual period. This scenario is not supported. Please cre­ ate an accrual man­ ually." In Progress No No Successful No No Failed Yes (Under Middleware No Integrations) Technical errors Completed With Er­ rors/Warnings No "The user is being ter­ minated and rehired in the accrual period. This scenario is not supported. Please cre­ ate an accrual man­ ually." (Schedule Immediate Recalculation is set to 'Never' in Time man­ agement Configuration) Immediate Recalcula­ tions (Time Manage­ ment Event Based Task, Time Manage­ ment Recalculation Events) Examples No 'error' status) Daily Recalculation job Admin Alert 2.0 Yes (under Scheduled Job) (Time Management Recalculation Event in Execution Manager Dashboard Yes How can I use the Execution Manager to View Recalculation Results? Note For a full description of the Execution Manager, please look at the Execution Manager documentation in the Admin Center guide. You must have the necessary permissions before you can use the Execution Manager. These appear under Admin Center Permissions in Role-Based Permission maintenance. 424 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management You use the Execution Manager to monitor these recalculation background jobs, ensure they run correctly, and fix any errors that may arise during the execution of these jobs. As already mentioned, alerts are created for erroneous recalculations. You can see the alerts in the Admin Alerts UI. Process the alerts regularly so that the recalculation can be executed in a timely manner to update the absences, time sheets, and accruals according to the changes that triggered the recalculation. See The Time Management Recalculation Task and 'TLMTriggerRecalculation' Job [page 422] for a description of the background recalculation jobs in Time Management you can monitor using the Execution Manager. You can access the Execution Manager from the Admin Center by choosing Execution Manager Dashboard. In the resulting display, specify: ● A timeframe ● TLMTriggerRecalculation as the Process Identifier ● Process States, such as Completed With Errors. Data is then shown per your selection. Here's an example: The list under the graphic shows: ● The Process Instance Name, which in this case is TLMTriggerRecalculation. ● The Process Definition Identifier, also TLMTriggerRecalculation. ● The Process Definition Name, which in this case is Trigger Recalculation Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 425 ● A timestamp, showing when the job ran. ● The process states you selected. Our example shows COMPLETED_WITH_WARNINGS. ● Click the i in the Summary So Far column to display information on the status. Click the right pointing arrow next to a job to view details for that job. Here's an example: Click the link for a row in the Event Description column to see more information on that row. For a row starting with "Finished Recalculate" you get a log file to be downloaded. Click Download Report to download the attachment containing the complete details for that row. You can use the information provided to troubleshoot any problems. You should do this at regular intervals as unresolved configuration issues can cause problems later. ● For the event type Recalculate Time Sheets, the payload file shows the following: ○ External Code ○ User ○ External Assignment ID ○ Start Date ○ End Date ○ Approval Status ○ Workflow Action ○ Error Message ● For the event type Recalculate Absences, the payload file shows the following: 426 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management ○ External Code ○ User ○ External Assignment ID ○ Start Date ○ End Date ○ Start Time ○ End Time ○ Number of Days ○ Number of Hours ○ Unit ○ Approval Status ○ Status ○ Error Message ● For the event type Recalculate Transfer Dates, the payload file shows the following: ○ External Code ○ User ○ External Assignment ID ○ Time Account Type ○ Last Transfer Date ○ Next Transfer Date ○ Employee Time ○ Date Type ○ Original Date ○ Adjusted Date ○ Status ○ Error Message ● For the event type Recalculate Accruals, the payload file shows the following: ○ External Code ○ User ○ External Assignment ID ○ Time Account Type ○ Account Valid From ○ Account Valid Until ○ Posting Date ○ Posting Type ○ Amount Posted ○ Posting Unit ○ Accrual Period ID ○ Status ○ Error Message Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 427 5.3.3 Workflow and Approval The basic principle of Time Management workflows and approvals is that recalculation processes do not create additional approval tasks, over and above any existing open workflows and pending approvals. Time sheets and other time management objects affected by any recalculation remain with the same workflow status they had before the relevant recalculation process began. This means, for example, that objects already approved automatically retain the status 'Approved' at the end of recalculation processes and a new workflow is not triggered, despite the fact that the business process itself would normally require an approval. Caution Recorded time data may be recalculated in a completely different way in the system, for example, if the time recording method is changed from positive to overtime-only recording. This change may result in a lot of overtime and it is important to realize that such recalculation effects are not recognizable in any subsequent workflow approval step by a manager or time administrator. The pending workflow behaves differently for Time Sheet and Time Off. In Time Sheet, an existing pending workflow is cancelled and a new workflow is initiated as soon as a time sheet is recalculated and there is a change to the existing time sheet. For Time Off, the pending workflow is not touched, although there is a change in an existing employee time. The employee time is updated in pending status and the workflow remains pending as well. Example Time sheet processing for an employee is regulated by a time profile that defines a specific workflow and requires explicit approval from an authorized supervisor. A recalculation is required for a time sheet already approved for this employee. The recalculation process runs, makes the amendment required and creates a new time sheet for this period. However, the workflow is not re-triggered and the new time sheet is automatically approved. Where the time sheet to be recalculated has a pending status - (To be submitted; To be approved) - the recalculation process updates the time sheet and retains the existing To be submitted or To be approved status. An approval workflow is started by the submission of the time sheet according to the regular workflow for this employee's time sheets. 5.4 Recalculation in Time Off It is sometimes necessary to recalculate existing absences, transfer dates, accruals, and entitlements. 428 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management 5.4.1 Recalculation Triggers in Time Off So, what can trigger a recalculation in Time Off and why? ● Change in holiday calendar assignment If a different holiday calendar is assigned to an employee as of a certain date, a recalculation is triggered. Here's an example: An employee has a holiday calendar assigned where according to the holiday calendar December 24th is a working day, while December 25th and December 26th are holidays. The employee's work schedule shows that he is working from Monday to Friday 8 hours per day. He has requested an absence from Monday, December 22nd to Friday, December 26th, so he is taking a full week off and duration of the absence is calculated as 24 hours. If a different holiday calendar is assigned where December 24th is marked as a holiday, the vacation request would have to be recalculated and the absence duration should be adjusted to 16 hours. ● Change in work schedule assignment An employee’s planned working time may change. This can take the form of a permanent change of work schedule, entered in job information, or a temporary change. Such a change can affect absences and accruals in a way similar to the effect of a change in holiday calendar assignment. ● Change in time profile assignment When a new time profile is assigned to an employee, you need to check whether absences exist as of the assignment of the new profile. If this is the case, another check is needed as to whether the time type of the corresponding absence is included in the new profile. ○ If it is, no action is necessary. ○ If it is not, the existing absence needs to be deleted. Accrual and entitlements are recalculated. If the time account type is no longer assigned, existing accruals outside the assignment period will be recalculated to 0. If the accrual period overlaps with the period the time account type is no longer assigned, the accrual is recalculated to a new value based on the corresponding accrual rule. Restriction There are some limitations on using recalculation in Time Off: ● Take rules are not covered by the recalculation, which means that leave requests are not validated again as part of the recalculation process. ● Absences with an undetermined end date are not recalculated. ● Recalculation is not available if you are using just Time Off for Leave of Absence Only. Cases when no recalculation is triggered Changes within an assigned holiday calendar - for example, adding another public holiday - do not trigger an automatic recalculation. You have to trigger one manually. The How Recalculation is Triggered [page 419] documentation tells you what you need to do. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 429 5.4.2 Recalculating Absences In certain circumstances, it might be necessary to recalculate absences already applied for and/or approved. For example, take a situation where an employee has a holiday calendar assigned where December 24th is a working day, but December 25th and December 26th are holidays. His work schedule shows that he is working from Monday to Friday 8 hours per day. He has requested an absence from Monday, December 22 to Friday, December 26th, which means he is taking a full week off. The duration of the absence is being calculated as 24 hours. However, a new holiday calendar is then assigned to the employee. In that new holiday calendar, December 24th is marked as a holiday, so the vacation request has to be recalculated. The absence duration needs to be adjusted to 16 hours. Recalculation in Time Off is performed within the TLMTriggerRecalculation job. For more information on this job, see The Time Management Recalculation Task and 'TLMTriggerRecalculation' Job [page 422]. Recalculation starts with determining the earliest date on which recalculation can start - this called the earliest possible recalculation date. The recalculation process is based entirely on the time management recalculation event (TMRE) of the event type ABSENCE_RECALCULATE. The recalculation itself depends also on the time recording method of the employee - duration or clock times and starts with the absence closest to the earliest possible recalculation date. Related Information Viewing Time Management Recalculation Results from the Execution Manager [page 423] 5.4.3 Recalculating Transfer Dates In certain circumstances, it might be necessary to recalculate an employee's transfer dates. Specifically, if the employee takes a certain type of leave that doesn't count towards their time in service. Recalculating transfer dates is only relevant if you use the entitlement method Entitled as transferred for the time account type. This means that accruals cannot be consumed unless they are transferred into an entitlement. The dates on which this transfer occurs are determined by the (Initial) Accrual Transfer Date rule. Transfer dates need to be recalculated whenever an employee takes a type of absence that has been marked as Not to count as time in service. Whenever such an absence is created/edited/cancelled/declined, transfer dates are adjusted based on the configuration in the Effect on Transfer Date rule. Note An important prerequisite here is that you choose Absences not to count as time in service as a recalculation field in the time account type, and that you assign an Effect on Transfer Date rule. If a transfer date in the past is adjusted, a recalculation of the associated entitlement amount might also be required. This is taken care of during the subsequent accrual recalculation. 430 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management Example An employee is hired on 01.01.2019. They receive daily accruals of 0.1 days, and the initial transfer of accruals to entitlements takes place after one year at the company. As such, 36.5 days are transferred on 01.01.2020. However, now the employee retroactively creates an absence for 10.12.2019 which is marked as Not to count as time in service (for example, leave without pay). As a result, the Effect on Transfer Date rule adjusts the transfer date, moving it by one day from 01.01.2020 to 02.01.2020. The accrual transfer rule then recalculates the entitlement amount accordingly, adjusting it from 36.5 days to 36.6 days. Let’s take the example further and assume that today is 01.08.2020. The accrual transfer date rule specifies a yearly transfer frequency. So the employee’s next transfer date is 02.01.2021 (originally 01.01.2021, but due to the absence on 10.12.2019 it's been shifted by 1 day). Now the employee creates another absence which is marked as Not to count as time in service on 03.01.2021. Because this absence falls after the next transfer date, nothing happens yet. On 02.01.2021, the entitlement calendar runs the accrual transfer date rule and sets the subsequent transfer date. It realises that there's another Not to count as time in service absence between the “old” transfer date (02.01.2021) and the “new” transfer date (02.01.2022), and as such adjusts the “new” transfer date to 03.01.2022. Summary Transfer dates are automatically recalculated in the following situations: ● During the execution of the Accrual Transfer Date rule (that is, during the entitlement calendar run) if there are absences marked as Not to count as time in service in the period between the “old” next transfer date and the “new” next transfer date. ● During the execution of the Initial Accrual Transfer Date (that is, during account creation) if there are existing absences marked as Not to count as time in service between the validity start date of the time account and the (in this case initial) next transfer date. ● When an absence marked as Not to count as time in service, with a start date that doesn't fall after the next transfer date, is created/edited/cancelled/declined. This includes when such an absence is recalculated. The result of recalculating a transfer date is the Adjusted Transfer Date, which is stored in the Time Account Type Accrual Transfer object. 5.4.4 Recalculating Accruals Accruals in Time Off need to be recalculated in a number of different scenarios. Examples include: ● If a field in the employee’s job information changes, which is used in the accrual rule to determine the accrual value. For example, if his or her full-time equivalent (FTE) is changed. ● If a change is made to the effective start date of an employee’s job information. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 431 If the FTE has been changed on, for example, on January 1, 2019 and based on this change, the accrual has been recalculated and afterwards the FTE change is moved from January 1, 2019 to March 1, 2019, a recalculation must be triggered again. ● If the working time of an employee changes and the accrual rule calculates the accrual amount based on this information. The change can be done either by assigning a different work schedule in the employee’s job information or by creating a temporary work schedule change in the employee’s workbench. ● If an employee is terminated. In this case the termination rule, not the accrual rule, is not executed to determine the accrual for the termination accrual period. ● If an absence has been changed, which should influence the accrual calculation. How the recalculation is made depends on the recalculation settings you've made in the relevant time account type and on the event parameters. Note To recalculate accruals as described in this guide, you need to switch on the recalculation feature as described in the Time Management Configuration Object [page 416] documentation. Furthermore, you need to specify the recalculation trigger for each time account type. Related Information Viewing Time Management Recalculation Results from the Execution Manager [page 423] 5.4.5 How Recalculation and Other Time Off Jobs Interact Recalculation is part of Time Management job execution. It is the first task of that job, coming before such tasks as period-end processing. During absence recalculation, recorded user entries are preserved. Some checks, such as collision checks or bookable amounts, are applied as they would be if manual changes were being made. 5.4.6 How Recalculation Affects Time Account Payouts Payouts are affected if the work schedule assigned to the relevant employee changes. This is because payouts are calculated on the basis of the average times entered in the work schedule assigned to an employee. If the work schedule assignment changes, or if changes are made to the assigned work schedule, the average times might change too. So you need to check to which of your employees the work schedule is assigned. You also need to look at the employees’ time types with time account types assigned. If a time account is assigned and payout is enabled there, check whether an employee payout exists. 432 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management Caution No changes are made to existing time account payouts. If adjustments are necessary regarding the payment amounts, this is not done automatically. 5.5 Recalculation in Time Sheet Learn more about recalculation in Time Sheet. 5.5.1 Recalculation Triggers in the Time Sheet There are two main groups of triggers that cause recalculation in the Payroll Time Sheet. The groups are: ● Triggers Originating Outside of the Time Sheet ● Triggers Created by Changes to the Payroll Time Sheet Itself The remainder of this section describes these two groups of triggers in more detail, and provides information on the impact of these recalculations in the Payroll Time Sheet. Time Sheet Recalculation - Triggers Originating Outside the Time Sheet The list below outlines the recalculation triggers within Time Management: 1. Assignment of New Time Management Object in Employee Job Information ● Change of time recording variant Attendances in the time sheet are recalculated based on the date of the change of time recording variant in the employee's Job Information. The recalculation is based on a Time Management Recalculation Event (TMRE). ● Assignment of a different holiday calendar The impact of the holiday calendar changes on time sheets (and resulting recalculation) depends on the employee’s time recording method and the corresponding set of time valuation rules: ○ Overtime only recording - overtime recorded on a holiday may result in a different premium than overtime recorded on a regular working day ○ Positive time recording - all working time recorded on a holiday would typically be considered as overtime, and possibly result in a different premium than overtime on a regular working day ○ Negative time recording - no working time is generated for a holiday, but the scheduled working time on the holiday would be taken into account in time valuation and, in the case of attendances entered manually, may possibly lead to different premiums than for actual working time. For example, in Germany, where premiums for ‘as if’ payments on holidays are taxable, while the premiums for actual working time are tax-exempt. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 433 When a different holiday calendar is assigned to an employee, it will affect all time sheets and absences valid on and after the effective date of the change. While the time sheet has no direct link to the absences overlapping with its validity period, the absences are typically included in overtime calculation and premium pay generation, and the corresponding time valuation results (also known as time pay types) are stored in the time sheet. This means that when a different holiday calendar is assigned, the affected absences are recalculated first, followed by the affected time sheets. This happens automatically, regardless of the employee’s time recording method. Performing a recalculation in this sequence means that the time valuation results stored within the affected time sheet(s) will be correct. The recalculation starts from the time sheet valid on the effective date of the change of holiday calendar assignment. For positive time recording, this is done, up to and including the employee’s most recent existing time sheet; for negative time recording, recalculation stops with the current time sheet. Note ○ Any manually recorded or imported time sheet entries in the time sheet are retained. For negative time recorders, the time sheet entries for scheduled working time not covered by manually recorded attendances, recalculated absences and the different holiday calendar are re-generated. Based on the time sheet entries, recalculated absences, and new holiday calendar, the time valuation results are recalculated and the time sheet is saved again with status ‘To be submitted’. ○ If a time sheet requiring recalculation has already been submitted but is still in status ‘To be approved’, the Withdraw time sheet process is triggered and the time sheet status is reset to ‘To be submitted’. From this point on, the recalculation process is the same as for a time sheet in status ‘To be submitted’ - the time sheet is updated and saved with status ‘To be submitted’. ○ If a time sheet requiring recalculation has the status ‘Approved’, the Make Amendments process is triggered, and a replacement time sheet is created for the week in question. The replacement time sheet includes copies of all manually recorded and imported time sheet entries from the original time sheet. For negative time recorders, the time sheet entries for scheduled working time not covered by attendances recorded manually, recalculated absences and the different holiday calendar are regenerated. Based on the time sheet entries, recalculated absences and new holiday calendar, the time valuation results are recalculated, and the replacement time sheet is submitted and automatically approved. Regardless of the status of a time sheet affected by a change of holiday calendar, any allowances recorded in the time sheet may also need to be updated because some of them may be representing premiums that can be different for a holiday versus a regular working day. Therefore, while the overall recalculation process is automated, some manual adjustment may be necessary in addition - when an affected time sheet includes allowances. Tip See Recalculating Time Sheets [page 436] for an example of recalculation in the time sheet triggered by a change in an employee's holiday calendar. ● Assignment of a different work schedule An employee’s planned working time may also be changed - a permanent change in the Job Information or a temporary change. In both cases, this assignment change has an impact on the time sheet. In general, if a different work schedule is assigned to an employee, the recalculation process for the time sheet is similar to that triggered when a different holiday calendar is assigned to an employee. The recalculation is triggered immediately after the change in work schedule, as with a change in holiday calendar. 434 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management ● Assignment of a different time profile In the time sheet, the time profile controls an employee's ability to make new time sheet entries rather than ensuring the consistency of existing attendance, on-call time and allowance entries with the available time types and allowance types listed in the employee’s time profile. Existing time sheet entries for time types and allowance types that are no longer included in the employee’s current time profile, either because a new one has been assigned to him or because they were deleted from the current one, are still displayed in the employee's time sheet. However, an employee can only delete such time sheet entries and cannot change them or create new ones for the corresponding time types and allowance types. In time valuation, time sheet entries not matching the employee’s current time profile are also not a problem. Assuming that the employee’s time recording profile and, thus, time valuation rules remain the same, the time types missing in the new time profile would still be included there (or maybe were never included). Therefore, the time valuation results stored in all affected time sheets would still be the same, irrespective of the change of time profile. ● Assignment of a different time recording profile The assignment of a different time recording profile can have an impact on time sheets, with respect to attendances, overtime, and premiums. When a different time recording profile is assigned to an employee, all existing time sheets that are valid on or after the effective date of the change are automatically recalculated. When a new time recording profile is assigned, a corresponding TMRE event is created as of the effective date of the change. The TMRE triggers recalculation of absences, then ABSENCE_RECALC triggers recalculation of time sheets, then TIMESHEET_RECALC triggers recalculation of accruals. ● Changes within a time recording profile Changes within an assigned time recording profile do not trigger an automatic recalculation. You have to trigger one manually. The How Recalculation is Triggered [page 419] documentation tells you how to do this. ● Change of time recording admissibility A change of time recording admissibility assignment in an employee's Job Information has no impact on existing time sheets and no recalculation is triggered by such a change. This setting simply controls the employee’s ability to record time and make retroactive changes to existing time sheets. 2. Changes to Time Management and Attendance Objects (transactional data) ● Change of Absences or Temporary Time Information Here, the new work schedule assignment can be achieved using a mass change, and a recalculation is triggered as described above in Assignment of a different work schedule. Note Creating, updating, or deleting an employee time (absence) will trigger a recalculation event in the Time Sheet, even if recalculation has been set to inactive. This is true for both positive and negative time recorders. 3. Changes to Job Information Data Outside of the Time Information Section Changes to Job Information data outside of the Time Information section do not trigger recalculations of the time sheet. However, changes to an employee's Job Information outside of the Time Information section can have an impact on other time management data and can trigger certain recalculations. A typical example is the FTE, which is frequently used to calculate an employee’s accruals. Other information that may be used for accrual calculation is organizational data such as the Job Code. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 435 5.5.2 Recalculating Time Sheets Recalculation in time sheets is performed within the TLMTTriggerRecalculation job. For more information on this job, see The Time Management Recalculation Task and 'TLMTriggerRecalculation' Job [page 422]. During an ongoing recalculation for an employee, the affected employee can't change their time sheet on the UI. The recalculation process is based entirely on the time management recalculation event (TMRE) of the event type TIME_SHEET_RECALCULATE. The recalculation itself depends also on the time recording method of the employee: ● Positive time recording Recalculation covers every time sheet period from the recalculation date until time sheets up to one year in the future. It considers every period in which the employee was a positive time recorder. If there is a period where no time sheet exists, a new time sheet is generated for this period. No new time sheets are generated in the future. Time sheet recalculation is processed as follows, starting with the time sheet closest to the TMRE date: 1. All generated attendances and breaks are deleted. This is required to cover a situation where a negative time recording employee for the time sheet period under consideration later changes to positive time recording. 2. Any data in the external time record generic object relating to the employee is included when the time sheet is recalculated. 3. Time valuation is performed again, based on the recalculated data. ● Negative time recording Recalculation covers every time sheet period from the recalculation date until time sheets up to one year in the future. It considers every period in which the employee was a negative time recorder. If there is a period where no time sheet exists, a new time sheet is generated for this period. No new time sheets are generated in the future. No time records are generated for existing future time sheets. Time sheet recalculation is processed as follows, starting with the earliest date calculated from TMRE instances.: 1. All generated attendances (and breaks within these attendances) are deleted. 2. Attendances and breaks are generated again, based on the work schedule and on time data that was entered manually. 3. Time valuation is performed again, based on the recalculated data. Otherwise the recalculated 'earliest' time sheet is saved, and recalculation is then performed for the time sheet in the next time sheet period. Example Below is an example of time sheet recalculation triggered by the assignment of a new holiday calendar for an employee. An employee has a holiday calendar assigned where Deceembe 24 is a working day and December 25 and 26 are holidays. A work schedule of Mon-Fri, 8 hours per day is assigned. However, the employee actually worked 10 hours each on Monday, December 22 and Tuesday, December 23, leading to 2 hours of overtime on each of 436 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management those days. On Wednesday Dec 24th the employee worked a further 4 hours, and recorded a 4 hour absence for the rest of that day. For each hour of regular working time, time pay types for base pay are generated by valuation in the time sheet, in addition to time pay types for overtime paid at 1.5 times the base pay rate. Because absences and holidays are paid ‘as if’ they were working time, the time valuation results for the employee look like this: Date Time Pay Type Hours Worked Monday, December 22 Base pay 8 Overtime paid 1.5 times base pay rate 2 Base pay 8 Overtime paid 1.5 times base pay rate 2 Wednesday, December 24 Base pay 4 Thursday, December 25 Base pay 8 Friday, December 26 Base pay 8 Tuesday, December 23 When a new holiday calendar is assigned where December 24 is defined as a holiday, the employee’s holiday request for that day would have to be canceled first. The 4 hours working time recorded on December 24 would now count as overtime. For each hour of overtime on the Decemeber 24 holiday, time pay types for overtime paid at the base pay rate and overtime paid at 1.75 times the base pay rate would now be generated, with the pay rate being different from the overtime rate that was generated for overtime on regular working days and not holidays. Date Time Pay Type Hours Worked Monday, December 22 Base pay 8 Overtime paid 1.5 times base pay rate 2 Base pay 8 Overtime paid 1.5 times base pay rate 2 Base pay 8 Overtime paid 1.75 times base pay rate 4 Thursday, December 25 Base pay 8 Friday, December 26 Base pay 8 Tuesday, December 23 Wednesday, December 24 Result: The change to the assigned holiday calendar in this example triggers a recalculation of absences or time valuation results in the time sheet as shown. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 437 Related Information Viewing Time Management Recalculation Results from the Execution Manager [page 423] 5.5.3 How Recalculation and Other Time Sheet Jobs Interact The TLMTriggerTasksJob orchestrates the various time sheet jobs, and ensures that processing of TMREs is optimized. 5.6 How Recalculation Affects Time Management Data A detailed summary of the effects of recalculation on the groups of time management data or entities identified earlier in this guide: ● Time Information Within Employee Job Information ● Employee Central Time Management Data See Recalculation in Time Management - Process Overview [page 421] for a description of the recalculation processes within Time Management. The impact of recalculation on the following Time Management data/entities is provided in the first two sections of this summary - Changes to Time Information within Employee Job Information and Changes to Employee Central Time Management Data: ● Absences ● Transfer Dates ● Accruals ● Payroll Time Sheet Note In the Accruals column of the table, the answer Yes indicates that a recalculation is potentially required in such cases, depending on the exact entries made in the parameters of Time Management Recalculation Event (TMRE) objects. 438 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management Changes to Time Information Within Employee Job Information The table shows the impact of recalculation triggered by the following changes to an employee's Time Information within the Job Information: Changing this data... Absences Time Sheet Transfer Dates Accruals Work Schedule (stand­ Simulation employeeTi­ Yes No Yes ard or individual) meCalendars Account de­ ductions dedicated time periods Yes A change to planned working time affects re­ calculation as follows: ● Only for employees who record their time negatively: any generated attendan­ ces and breaks are deleted and are gen­ erated again accord­ ing to the current work schedule. ● For all employees: attendances or breaks created man­ ually are not af­ fected. ● For all employees: time valuation is re­ processed. ● For all employees: changes to the work schedule affect time valuation when valu­ ation rules exist that have dependencies based on an employ­ ee's planned working time. If not, the exist­ ing time valuation re­ sults remain un­ changed. Caution Changing the work schedule means that the planned working time might be changed. Valuation rules for overtime Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 439 Changing this data... Absences Time Sheet Transfer Dates Accruals calculation might lead to different re­ sults since the at­ tendances recorded manually are not adapted. 440 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management Changing this data... Absences Time Sheet Transfer Dates Accruals Time Profile No Yes No Yes Recalculation occurs if one of the following fields is changed (comparing the formerly assigned Time Profile with the new one): ● Main Attendance Time Type: Recalcu­ lation is processed but only affecting employees who re­ cord their time nega­ tively. For these em­ ployees, any gener­ ated attendances are deleted and gen­ erated again using the new main attend­ ance time type. Time valuation is reproc­ essed and may react on the new attend­ ance time type. For employees using a time recording method other than negative, no recalcu­ lation occurs. ● Time Off in Lieu Time Account Type: Rele­ vant for all users with an Overtime Compensation Var­ iant that books times to Time Off. In such a case the existing bookings to the old TOIL time account type are canceled and the same times are booked to the new TOIL time ac­ count type. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 441 Changing this data... Absences Time Sheet ● Transfer Dates Accruals No Yes No N/A Default Break Time Type: Relevant only for employees who record their time negatively - gener­ ated breaks within the time frame of generated attendan­ ces are replaced us­ ing the new break time type. Holiday Calendar Simulation employeeTi­ meCalendars Account de­ ductions Yes Yes Changing the holiday cal­ endar triggers recalcula­ tion and also impacts the planned working day. Recalculation is executed in the same way as that triggered by a change of the work schedule. Time Recording Var­ Change duration-based to iant clock-based time record­ ing: employeeTimes shall not exist, otherwise for­ bidden Change clock-time based No This change is only per­ mitted when no attend­ ances exist in the time sheet and therefore no recalculation is triggered to duration-based time re­ in this situation either. cording : employeeTimes shall not exist, otherwise forbidden ==> no absence recalc event No recalculation is trig­ gered because any change from durationbased to clock-time- Only allowed if no data is based time recording. recorded after Effective The reverse is only al­ Date Validation. lowed where no employee times exist for the af­ fected period. 442 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management Changing this data... Absences Time Recording Profile No impact No Time Sheet Transfer Dates Accruals Yes No N/A The time recording method and the time val­ uations contained in the new time recording pro­ file are considered during time sheet recalculation. The recalculation works as follows: ● For employees using a negative time re­ cording method: any generated attendan­ ces and breaks are deleted and gener­ ated again. ● For employees using a non-negative time recording method: generated attendan­ ces and breaks are only deleted but not regenerated. For ex­ ample, when the time recording method for an em­ ployee changes from a negative method to a non-negative method. For both time recording methods: ● Manually created at­ tendances or breaks are not affected. ● Time valuation is re­ processed based on the current time re­ cording valuations. Caution Recorded time data may be evaluated in a completely differ- Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 443 Changing this data... Absences Time Sheet Transfer Dates Accruals No N/A ent way, for example, if the time recording method is changed from positive to over­ time-only recording. This change might result in large amounts of 'new' overtime. Such recalculation effects are not recog­ nizable in any subse­ quent workflow ap­ proval step by a man­ ager or time adminis­ trator. Default Overtime Com­ No impact pensation Variant No Yes The posting target of the time valuation results is adjusted. The bookings for payroll/time off that have been specified by the former overtime com­ pensation variant are canceled. The time valua­ tion results are booked again based on the newly-assigned overtime compensation variant. 444 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management Changes to Employee Central Time Management Data The table shows the impact of recalculation triggered by the following changes to Employee Central time management data: Changing this data... Absences Absence Data in Time Off No impact Payroll Time Sheet Transfer Dates Accruals Yes Yes Recalculation occurs in Only for Not to the time sheet as follows: count as time in Depends on configuration at time type level. For example, unpaid leave may result in an accrual deduction. ● For employees using service absences a negative time re­ cording method: any generated attendan­ ces and breaks are deleted and gener­ ated again, based on the changed, cre­ ated, or deleted ab­ sence. ● For all employees: at­ tendances or breaks created manually are not affected. ● For all employees: time valuation is re­ processed. Accrual Data in Time Off(calculation base ob­ ject) No impact No No No Impact If posting orders are used to deduct from multiple time accounts, a recalculation of the time account allocation might make sense. Manually trigger simu­ lation to identify cases where balance was in­ sufficient. Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 445 Changing this data... Absences Temporary Time Data Simulation employeeTi­ Yes (Work Schedule) meCalendars Account deductions dedicated time periods Yes Payroll Time Sheet Transfer Dates Accruals No Yes When planned working time is changed, recalcu­ lation is triggered as fol­ lows: ● For employees using a negative time re­ cording method: any generated attendan­ ces or breaks are de­ leted and generated again according to the current tempo­ rary time informa­ tion. ● For all employees: at­ tendances or breaks created manually are not affected. ● For all employees: time valuation is re­ processed. ● For all employees: changes to the work schedule affect time valuation when valu­ ation rules exist that have dependencies based on an employ­ ee's planned working time. If not, the exist­ ing time valuation re­ sults remain un­ changed. Caution Changes to tempo­ rary time information mean that the plan­ ned working time might also be changed as a result. Valuation rules for overtime calculation 446 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management Changing this data... Absences Payroll Time Sheet Transfer Dates Accruals might lead to different time valuation re­ sults because the at­ tendances recorded manually are not adapted. Related Information Recalculation Triggers in Time Off [page 429] Recalculation Triggers in the Time Sheet [page 433] 5.7 Retry Counter The retry counter prevents erroneous recalculation events such as time sheets, absences, and accruals from being recalculated more than three times. Erroneous time sheets, absences, and accruals that are recalculated automatically can lead to performance issues. To prevent such issues, the retry counter limits the number of automatic recalculation attempts. After three unsuccessful recalculation attempts, you need to trigger the recalculation after correcting the error that caused the recalculation to fail. Incrementation of the Retry Counter The retry counter is incremented by one whenever either user data or a recalculation type is erroneous during the recalculation. This incrementation isn’t limited to automatic recalculations. Manual recalculations can also increment the retry counter if configuration or data issues occur. How frequently the retry counter is incremented depends on how frequently the TLMRecalculation job runs. You can configure how frequently the TLMRecalculation job runs. However, if there are erroneous recalculation events, the retry counter is incremented at least daily because of the daily recalculation run. What Happens After Three Unsuccessful Recalculation Attempts After three unsuccessful recalculation attempts, the erroneous recalculation events are excluded from automatic recalculation runs. An admin alert that informs you about the erroneous recalculation event is created. You then reset the retry counter by resolving the issues that are described in the alerts and by Implementing Time Management in SAP SuccessFactors Recalculation in Time Management PUBLIC 447 triggering a recalculation from the alerts. After the retry counter is reset, the recalculation event is included in the automatic recalculation runs again. 448 PUBLIC Implementing Time Management in SAP SuccessFactors Recalculation in Time Management 6 Rules and Rule Functions in Time Management Learn more about rules and rule functions in time management. Concepts Common to All Rules [page 449] Some concepts are common to any rules you might create and use in Employee Central Time Management, regardless of what type of rule they are. Common Rules [page 457] There is a wide selection of rules available for general use. Rule Scenarios for Time Off [page 503] Various different rule scenarios are available in Time Off. Time Sheet Validation Rule [page 509] Notes on Rule Functions in Time Off [page 510] Use these links to access detailed information on rule functions you can use in Employee Central Time Off. Notes on Rule Functions in Time Sheet [page 628] Use these links to access detailed information on rule functions you can use in Employee Central Time Sheet. Country/Region Specific Rules and Rule Functions [page 632] In addition to the country/region-specific functions described in this guide, we also deliver rules and rule functions that are specific to particular countries. 6.1 Concepts Common to All Rules Some concepts are common to any rules you might create and use in Employee Central Time Management, regardless of what type of rule they are. Use the links provided here to access information on these common concepts. Defining The "Time Off" Rule Type [page 450] When you create a business rule, you need to assign a rule type. Defining The Start Date of A Rule [page 450] When you define a rule, you need to enter a Start Date. By default, this value is set to January 1, 1900. Except in the case of the accrual scenario, it makes sense to keep that value because the rule that is valid today is always selected. Using Employee-Specific Information [page 451] Employee Time or Time Account is an object that has a User field assigned. You can navigate to the employee's Employment Details, Job Information, and Personal Information to access employeespecific information. Using ELSE Statements [page 451] Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 449 You might need to configure Time Off data differently for different groups of employees within your business. You can achieve this by including an ELSE or ELSE IF statement in your rule. For example, you can create bookings with different quantities based on job information fields like FTE or company. Using Lookup Tables [page 452] Sometimes you need to consider additional information in a rule. For example, the booking amount may depend on criteria like the age, division, or pay grade of an employee. For simple cases, you can define ELSE and ELSE IF-statements in the rule but, for more complex scenarios, a lookup table is helpful. Using Variables to Store Interim Rule Results [page 455] Sometimes you use rule functions or lookup table calls to do more complex calculations in a rule. 6.1.1 Defining The "Time Off" Rule Type When you create a business rule, you need to assign a rule type. Rules related to time off should be created with reference to the "Time Off” rule type. If this doesn't exist yet, go to the Admin Center and choose Configure Object Definitions. Then search “Picklist” and select Rule Type (RuleType). Add a value with External Code TIMEOFF: 6.1.2 Defining The Start Date of A Rule When you define a rule, you need to enter a Start Date. By default, this value is set to January 1, 1900. Except in the case of the accrual scenario, it makes sense to keep that value because the rule that is valid today is always selected. For the accrual scenario, your business might require rule changes over time. For example, if you want to change the accrual amount starting from next year, you can make an effective dated rule change. Depending on the accrual period you calculate an accrual for, the appropriate rule is considered. We recommend that you do not change the rule within an accrual period. 450 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.1.3 Using Employee-Specific Information Employee Time or Time Account is an object that has a User field assigned. You can navigate to the employee's Employment Details, Job Information, and Personal Information to access employee-specific information. For example, you can use this information to define If conditions or to do table lookups. The user information changes when you make effective dated changes. For the different scenarios, user information available, in the rule, is read with the dates in this table: Scenario Date Accrual Accruable Start Date of Accrual Period by default. If the accruable end date is specified in the setting of the time account type, termination rule data effective date, this is set to Accruable End Date of Accrual Period. Period-End Processing Today Interim Account Update Today Take Rules Absence Start Date If the employee isn’t active at this point in time (for example, due to a leave of absence), the user information isn’t filled. 6.1.4 Using ELSE Statements You might need to configure Time Off data differently for different groups of employees within your business. You can achieve this by including an ELSE or ELSE IF statement in your rule. For example, you can create bookings with different quantities based on job information fields like FTE or company. Here's an example where employees who work fulltime should get a booking of 24 days, but other employees should only get 12 days. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 451 If you need to combine more conditions, you also can add ELSE IF-conditions. 6.1.5 Using Lookup Tables Sometimes you need to consider additional information in a rule. For example, the booking amount may depend on criteria like the age, division, or pay grade of an employee. For simple cases, you can define ELSE and ELSE IF-statements in the rule but, for more complex scenarios, a lookup table is helpful. You can create your own lookup table by going to the Admin Center and choosing Configure Object Definitions Create New Object Definition . As a template, please compare the object settings from the sample lookup table Accrual Lookup By Seniority. For the header definition, enter a code and set Effective Dating to “None”. If you don´t want to enter the external code manually when you create table entries, you can set the Data Type to “Auto Number”. You then add the fields needed for your table lookup. 452 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management In this example, four custom fields are defined in addition to the standard fields. This would be a typical sample when you want to determine the booking amount based on the division and the age of an employee. Ensure that you assign the right data type for all the fields you define. For example, if a table lookup should return a booking amount for a booking on a time account, assign the same data type here as the one defined for the bookingAmount field in the Time Account Detail object. If you refer to a Foundation Object. assign the technical name of the Foundation Object field to Valid Values Source. In the sample below, it is set to “division”. In addition, make sure that the visibility of all fields you want to access in your rule definition is set to “Editable”. If a name is not relevant for your entries, you can set the visibility of the externalName field to “Not Visible”. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 453 After saving the table, you can create table records by going to the Admin Center and choosing Files Employee Manage Data . Here's an example of how you can define a table lookup in a rule. The booking amount for an employee is selected based on the division and the age of a user. The Difference in Calendar Years rule function is used for the age calculation. 454 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.1.6 Using Variables to Store Interim Rule Results Sometimes you use rule functions or lookup table calls to do more complex calculations in a rule. Instead of using nested function calls, you can store interim results in variables to make the rule function more readable and to avoid identical calculations. In the example below, there are nested calls to determine the booking amount. A table lookup is done and, in the where-condition, two identical calls of rule function Difference In Calendar Years() are made to calculate the age of an employee. Here it´s better to assign the result of the rule function call to a previous step and just assign the variable when you define the where-condition. For example, for accrual rules, the parameter accrualRuleVariables is available to store interim results. The Accrual Rule Variables object has some predefined fields, but as “age” is not yet available, you need to add it as a custom field to the object definition (do this by going to the Admin Center and choosing Configure Object Definitions. You choose “Number” as a Data Type and select Details to ensure that Visibility is set to “Editable”. Here's an example where the age is calculated in a first step and assigned to the Age field. This field is used to define the where-condition in the second step. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 455 You can even consider using another set condition so that you assign the lookup result to another variable and then just assign that amount when you create the Time Account Detail. Please make sure that the expressions are defined in the right order. You first need to set the variable so that it is filled when you use it in the Createexpression. Using Variables at the Beginning of a Rule If you want, you can use your variables right at the very beginning (even before the IF statement). The variable will then be used wherever the Calculate Balance() rule function is called. This will improve the performance of your rule if you're using the rule function several times within it. Here's how the rule looks without the variable. 456 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management And here's how it looks with the variable before the IF statement: 6.2 Common Rules There is a wide selection of rules available for general use. Accrual Rules [page 458] You can use accrual rules to help you calculate accruals in Employee Central Time Off. Accrual Transfer Rules [page 480] The Accrual Transfer rule is used to create the entitlement and ad hoc entitlement posting on the time account. Period-End Processing Rules [page 487] Rules are used to close old accounts and carry over balances as part of period-end processing. Interim Account Update Rules [page 491] While manual adjustments are usually created manually by an HR admin, the interim account calendar run enables you to do mass data updates for time accounts based on a business rule. Take Rules [page 494] When you create, cancel, or edit a leave request, the system performs certain checks. For example, an error comes up when the time account balance is not sufficient to book leave. Sometimes, you want to add further validation checks. This can be done using "Take Rules”. Time Off Workflow Rules [page 498] Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 457 To set up workflow when an employee requests leave, you need to assign the workflow rule as a save rule to the Employee Time object. On Change Rules [page 500] There's a rule you can use to default the start and end times of an absence request according to the employee's work schedule. Flexible Account Creation [page 501] In this scenario, the account start date of each employee with this time account type assigned is defined as the employee’s seniority date. Periodic Update for Balance Reduction [page 502] In this scenario, the balance at the end of each periodic update period must not exceed a predetermined amount. 6.2.1 Accrual Rules You can use accrual rules to help you calculate accruals in Employee Central Time Off. Fixed Amount Accruals [page 459] In this scenario, every employee gets an accrual of a fixed amount for the accrual period. Determine Posting Date Based on Booking Offset [page 459] If you want to shift the date, you can use the Date Plus() function. For example, you can post the accrual 5 days after the accruable start date. Prorating Hire Accrual [page 460] In the scenario shown below, every employee gets an accrual of 2 days per month. The number of months are the months counted between hire date and accrual end date (for example, annual accruals from January 1 until December 31; the accrual end would be December 31, 2014 / 2015 / 2016). You can decide whether the hire month itself should be counted in case the employee doesn’t start working. Accrual Based on Average FTE [page 461] In this scenario, every employee gets an accrual of 30 days per year, multiplied by his or her average FTE (full-time equivalent) within this year. Accrual Based on Seniority [page 462] This sample accrual rule creates accruals dependent on the seniority of the employee - that is, how long he or she has been employed at the company so far. Prorating Accruals Based on Seniority [page 465] Specify how accruals should be handled for different seniority levels, using rules and job information fields. Capping Accruals Based on Balance Limit [page 471] Your company might have a policy that defines a maximum balance on accruals. You can use this sample rule to check that maximum balance. Capping Accruals Based on Balance Limit Taking Account of Seniority [page 472] Here is an example that combines accruals based on seniority with a cap based on a maximum balance Accruals Based on Planned Time [page 474] In this scenario, you have a vacation time account type in unit days. Accruals Based on Recorded Times [page 475] 458 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management In this scenario below, you have a vacation time account type in unit hours. Prorating Weekly Accruals [page 476] 6.2.1.1 Fixed Amount Accruals In this scenario, every employee gets an accrual of a fixed amount for the accrual period. The example shows employees getting an accrual of 18 hours for the accrual period. This rule, SF_Accrual_FixedAmount, is part of the Time Off - Sample rules package in the Success Store. You can import this package of pre-configured rules: Go to Data Admin Center Import and Export Data Import SuccessStore . 6.2.1.2 Determine Posting Date Based on Booking Offset If you want to shift the date, you can use the Date Plus() function. For example, you can post the accrual 5 days after the accruable start date. This rule, SF_ACCRUAL_MovePostingDate, is part of the Time Off - Sample Rules package in the Success Store. You can import this package of pre-configured rules. Go to Data Admin Center Import and Export Data Import SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 459 6.2.1.3 Prorating Hire Accrual In the scenario shown below, every employee gets an accrual of 2 days per month. The number of months are the months counted between hire date and accrual end date (for example, annual accruals from January 1 until December 31; the accrual end would be December 31, 2014 / 2015 / 2016). You can decide whether the hire month itself should be counted in case the employee doesn’t start working. This rule, SF_ACCRUAL_ProratingHire, is part of the Time Off - Sample Rules package in the Success Store. You can import this package of pre-configured rules: Go to Data Admin Center Import and Export Data Import SuccessStore . Note The Get Number of Months from Hire Date() function only works with the Hire rule, and you need to ensure that the accrual frequency is Annually. For more information about this rule function, see Get Number Of Months From Hire Date() [page 607]. 460 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.1.4 Accrual Based on Average FTE In this scenario, every employee gets an accrual of 30 days per year, multiplied by his or her average FTE (fulltime equivalent) within this year. If the employee is not eligible for a date, the FTE is counted as 0 (zero). For details, please refer to the description of the Average Full-Time Equivalent for Accrual Period() [page 586]. If you use this rule as an accrual rule, you can also mark “FTE” in the time account type as recalculation field. That means that, if the employee's FTE changes, a recalculation is triggered automatically and the FTE change is considered. This rule, SF_ACCRUAL_FteAndSeniority, is part of the Time Off - Sample Rules package in the Success Store. You can import this package of pre-configured rules: Go to Data Admin Center Import and Export Data Import SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 461 6.2.1.5 Accrual Based on Seniority This sample accrual rule creates accruals dependent on the seniority of the employee - that is, how long he or she has been employed at the company so far. Years with the Company Accrual Amount (Days) 0-2 1.8 3-10 1.9 11-100 2.0 The amount of the accruals for the individual employee is derived from a lookup you need to maintain. In the rule, you can determine the seniority based on the employee's hire date in a first step and in a second step you derive the accrual amount from the lookup table. The number of custom MDF SAP Guided Outcomes is limited; if you are planning to implement Time Off in many countries, please consider adding the Country/Region field (reference to SAP Guided Outcomes) to your lookup table. This allows you to get the appropriate balance from the lookup using country as key. 462 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Lookup Table You first need to define the intervals in a “lookup table”. We deliver an example table, called Accrual Lookup by Seniority. Because you typically have different intervals for different time account types or you need other fields for your lookup table as criteria to determine the booking amount, we recommend that you create your own lookup table for each rule or time account type. To fill the table, go to the Admin Center and choose Employee Files Manage Data , then choose Create New and select Accrual Lookup By Seniority. Do this for each row or interval of the table you need. Rule Definition This rule, SF_ACCRUAL_BasedOnSeniority, is part of the Time Off - Sample Rules package in the Success Store. You can import this package of pre-configured rules: Go to Data Admin Center Import and Export Data Import SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 463 Three expressions are added to the THEN part of the rule. The first one calculates the seniority of an employee, taking account of the employee's hire date and the posting date of the accrual (Accrual Start Date). There are three rule functions available for calculating the seniority: ● Difference in Calendar Years (shown above) If you choose this option, the system calculates the difference between the two dates in calendar years, taking account only of the calendar years in the start and end dates, not the days or months. For example, if the hire date is December 1, 2013, and the posting date is January 1, 2015, the result will be 2 years. ● Difference in Calendar Years (Round Up) If you choose this option, the system calculates the difference between the two dates in calendar years, taking account of the calendar years in the start and end dates, and the day and months. The result is rounded up to calendar years. For example, if the hire date is December 1, 2013 and the posting date is January 1, 2015, the result will be 2 years - that is, 1 year, 1 month, rounded up. ● Difference in Calendar Years (Round Down) If you choose this option, the system calculates the difference between the two dates in calendar years, taking account of the calendar years in the start and end dates, and the day and months. The result is rounded down to calendar years. For example, if the hire date is December 1, 2013 and the posting date is January 1, 2015, the result will be 1 year - that is, 1 year, 1 month, rounded down. With the second expression, you read the correct accrual amount from the lookup table. To determine the booking amount, you define the table lookup to select the right entry from table Accrual Lookup By Seniority. Here, the seniority calculated in the first step is used to define the "where" conditions. With the third expression, you create the accrual booking. 464 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.1.6 Prorating Accruals Based on Seniority Specify how accruals should be handled for different seniority levels, using rules and job information fields. Steps 1. Prepare a lookup table Create a lookup table that contains all the necessary information about the annual accrual for each country, pay grade, and level of seniority. Split the pay grade into two fields, and enter this information in the lookup object. This table will be used to fill the accrual fields in the job info. Here’s an example of how it should look: Accrual Amount Accrual Amount Accrual Amount Seniority Level 1 Seniority Level 2 Seniority Level 3 (5 to 9 years) (10 to 99 years) Country Pay Grade From Pay Grade To (0 to 4 years) USA 1 4 25 30 32 USA 5 9 20 25 30 USA 10 99 18 20 25 2. For each seniority level, create a new field in the job info. For example: Seniority Level Field (Suggested Name) Level 1 (0 to 4 years) custom-double1 Level 2 (5 to 9 years) custom-double2 Level 3 (10 to 99 years) custom-double3 Because seniority levels differ from country to country, there might be countries with different requirements for the individual levels (for example, level 1 in Germany might mean 0-6 years as opposed to 0-4 years in the US) or with more or fewer seniority levels entirely. You simply need to ensure that you create enough custom fields to cover the maximum number of seniority levels that you can have in any given country. 3. Create a new business rule to fill the new job info fields You need a rule that will run every time the job info is saved, and that will ensure that the new job info fields are always updated accordingly if any change is made to the employee’s FTE, pay grade, or country. As such, create an OnSave rule with the Calculate Average Value for Numeric Job Info Field() rule function that does the following: ○ Calculates the accrual amount based on the employee’s country, pay grade, and FTE. ○ Reads the lookup tables with your parameters, multiplies by the employee’s FTE, and updates the three job info fields based on the result. 4. Add the recalculation fields Add any fields that are relevant for accrual calculation to the Time Account Type object as recalculation fields. This ensures that a recalculation will be triggered automatically in case of any changes to these fields. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 465 5. Create and assign an accrual rule The rule needs to cover the following example scenarios: Scenario 1: Employee remains at first seniority level for entire accrual period If condition: Specifies that the employee’s seniority level should be 5 years or higher. Then condition: Calculates the average accrual amount for the job info field custom-double1, which contains the accrual amount for a seniority level of 1 to 4 years. If the employee has not reached a seniority level of 5 years by the accrual period end date (as specified by the If condition), that accrual amount is valid for the entire accrual period. 466 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Scenario 2: Employee starts the accrual period at the first seniority level and ends the accrual period at the second seniority level Else If condition: If the employee reaches 5 years of seniority midway through an accrual period, but has not reached 10 years by the end of the accrual period. Then condition: Since the employee has not yet reached 5 years of seniority for the first half of the accrual period, accruals are calculated using the first accrual amount field (custom-double1, which is valid for a seniority level of 1 to 4 years). In the second half of the accrual period, the employee has reached 5 years - but not yet 10 years - so accruals are calculated using the second field (custom-double2, which is valid for a seniority level of 5 to 9 years). Note If you want the employee to get the higher accruals of seniority level 2 for the full accrual period, you can change the rule accordingly. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 467 Scenario 3: Employee remains at second seniority level for entire accrual period Else If condition: If the employee has reached 5 years of seniority by the start of the accrual period, but hasn't yet reached 10 years of seniority by the end of the accrual period. Then condition: Calculates the average accrual amount for job info field custom-double2, which contains the accrual amount for a seniority level of 5 to 9 years. Since the employee has not yet reached 10 years of seniority (as specified by the Else If condition), that accrual amount is valid for the entire accrual period. 468 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Scenario 4: Employee starts the accrual period at the second seniority level and ends the accrual period at the third seniority level Else If condition: If the employee has not reached 10 years of seniority by the start of the accrual period, but does so midway through the accrual period. Then condition: Since the employee has not yet reached 10 years of seniority for the first half of the accrual period, accruals are calculated using the second accrual amount field (custom-double2, which is valid for a seniority level of 5 to 9 years). In the second half of the accrual period, the employee has reached 10 years, so accruals are calculated using the third field (custom-double3, which is valid for a seniority level of 10 to 99 years). Note If you want the employee to get the higher accruals of seniority level 3 for the full accrual period, you can change the rule accordingly. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 469 Scenario 5: Employee remains at third seniority level for entire accrual period If condition: If the employee has reached 10 years of seniority before the start of the accrual period, and retains that level for the entire period. Then condition: Calculates the average accrual amount for job info field custom-double3, which contains the accrual amount for a seniority level of 10 to 99 years. Because the employee has reached a seniority level of 10 years before the start of the accrual period (as specified by the If condition), that accrual amount is valid for the entire accrual period. 470 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.1.7 Capping Accruals Based on Balance Limit Your company might have a policy that defines a maximum balance on accruals. You can use this sample rule to check that maximum balance. You first need to define a limit that should prevent the accrual run from further updating an employee's time account, ensuring that the employee does not accrue more time off than he or she is entitled to. Such a limit can take the form of a fixed amount, or might be variable. This sample accrual rule checks a maximum balance. Further accruals are only added if the employee's account balance does not exceed the maximum (limit). In this rule, accruals with a fixed amount of 30 days are generated up to a maximum of 100 days. The effect of this is that the employee normally accrues 30 days of time off per accrual period and the maximum that may be on his or her time account at any one time is 100 days. If the balance is already 95 days when the next accrual of 30 days is due, only 5 days actually are accrued so that the balance is not exceeded. This rule, SF_ACCRUAL_StopAccrualFixed, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Data Admin Center Import and Export Data Import SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 471 Restriction Do not use the Calculate Balance() rule function for a time account when creating a time account detail for that account, for example, to create the amount. If you do this, balance calculation will fail as the time account detail is already added to that account, but is empty. Instead, define the rule as follows: 1. Calculate the account and assign the result to a variable (SET-statement). 2. Then create the time account detail and assign the value calculated before. 6.2.1.8 Capping Accruals Based on Balance Limit Taking Account of Seniority Here is an example that combines accruals based on seniority with a cap based on a maximum balance This rule, SF_ACCRUAL_StopAccrualWithSeniority, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Data Import Data 472 PUBLIC Admin Center Import and Export SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management The rule contains three SET-expressions to do calculations and to assign the result to field of accrualRuleVariables: ● The first expression calculates the balance of the time account. ● The second expression calculates the seniority of the employee. ● With the third expression, the target amount of the accrual is detected from a lookup table, taking into account the seniority calculated before. Afterwards, the accrual is created using the Cap Accrual() function. As maximum accrual, the target quantity derived from the lookup table is assigned and as account balance limit, this quantity is multiplied by a factor 6. Let's look at an example: An accrual calculation is done for October 2017. For October 1, 2017, the account balance is 5 days. As the employee was hired in 2000, the seniority is 14 years. In the lookup table is defined that employees with a seniority from 10 to 19 years get an accrual amount of 2 days per month. So here, the balance limit is 2*6=12 days and the employee will get the whole accrual amount of 2 days as the resulting balance of 7 days will not exceed the limit of 12 days. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 473 Restriction Do not use the Calculate Balance() rule function for a time account when creating a time account detail for that account, for example, to create the amount. If you do this, balance calculation will fail as the time account detail is already added to that account, but is empty. Instead, define the rule as follows: 1. Calculate the account and assign the result to a variable (SET-statement). 2. Then create the time account detail and assign the value calculated before. Example 6.2.1.9 Accruals Based on Planned Time In this scenario, you have a vacation time account type in unit days. The amount of the posted accrual is a value of 0.12 (days) for each planned working day of the employee. If you have, for example, weekly accruals and a work schedule with 5 working days, the employee would get 0.12 multiplied by 5 days, which is equal to 0.6 days. This rule, SF_ACCRUAL_BasedOnPlannedTime, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Import Data 474 PUBLIC Admin Center Import and Export Data SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.1.10 Accruals Based on Recorded Times In this scenario below, you have a vacation time account type in unit hours. The amount of the posted accrual is a value of 0.1 (hours) multiplied with the employee’s actual hours worked. If you have for example weekly accruals and the employee worked 40 hours in this week, the employee would get 0.1 multiplied with 40 days which is equal to 4 hours. This rule, SF_ACCRUAL_BasedOnReportedTime, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Import Data Admin Center Import and Export Data SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 475 6.2.1.11 Prorating Weekly Accruals In this scenario, you have weekly accruals and annual time accounts that run from January 1 to December 31. Sometimes a calendar week might span over two time accounts. For example, accrual week December 30, 2019, - January 5, 2020, would be part of both the 2019 time account (valid from January 1, 2019 - December 31, 2019) and the 2020 time account (valid from January 1, 2020 - December 31, 2020). When this happens, you have three options: ● Option #1: Post the full accrual amount on the 2019 time account, post an accrual with 0 as amount on the 2020 time account. ● Option #2: Post the full accrual amount on the 2020 time account, post an accrual with 0 as amount on the 2019 time account. ● Option #3: Prorate the accruals and post 2/7 on the 2019 time account and 5/7 on the 2020 time account. The accrual rule distinguishes between two cases: Is the accrual period part of one time account, or part of two time accounts? Note To check if the current accrual period is part of one or two time accounts, check the following: ● Is the end date of the accrual period (Accrual Rule Parameters.End Date) and the start date of the accrual period (Accrual Rule Parameters.Start Date) part of the account validity period? If the accrual period start date isn’t part of this time account, the end date is part of the time account. You have to decide how much of the accrual should be posted on the second time account. (In the above example, that's the 2020 time account). If the accrual period end date isn’t part of this time account, the start date is part of the time account. You have to decide how much of the accrual should be posted on the first time account. (In the above example, that's the 2019 time account). The following rule shows option 1. Accrual amount of 2 is an example for the full week balance. Please change it according to your requirements. 476 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 477 The following rule shows option 2. Accrual amount of 2 is an example for the full week balance. Please change it according to your requirements. 478 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 479 The following rule shows option 3. Accrual amount of 2 is an example for the full week balance. Please change it according to your requirement. 6.2.2 Accrual Transfer Rules The Accrual Transfer rule is used to create the entitlement and ad hoc entitlement posting on the time account. It's assigned to the corresponding field on the time account type. The rule is executed at the time of the entitlement calendar run. 480 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Here's some information on the available parameters: Parameter Time Account A Time Account Detail represents a posting on the time ac­ count. This is the parameter you create with the Accrual Transfer rule. The Time Account Detail is the result of the ap­ plication of this rule. You need to specify the following: ● Amount Posted.. This is typically the sum of accruals (see Accrual Transfer Rule Parameters). ● Posting Type: You need to select Entitlement or Ad Hoc Entitlement depending on the scenario code (see Ac­ crual Transfer Rule Parameters). ● Posting Date. Here you need to select Next Transfer Date or Ad Hoc Transfer Date depending on the scenario code (see Accrual Transfer Rule Parameters). ● External Code: Here you typically select Generate External Code for Time Off(). ● Posting Unit: Here you must select the unit of the re­ spective time account type. Refer to the Time Account [page 711] documentation for more information. Accrual Transfer Rule Parameters The following parameters are read-only, so you can't modify them with the Accrual Transfer rule. ● Scenario Code: This parameter contains information about the scenario in which the rule is called (ad hoc or regular accrual transfer). Caution You should always make use of the scenario code and distinguish the time account posting based on it. Not doing so can lead to several issues. In case of a regular transfer, the posting type should set to be Entitlement. The posting date should be set to the Next Transfer Date. Caution In case of an ad hoc transfer, the posting type should be Ad Hoc Entitlement and the posting date should be the “Ad Hoc Transfer Date”. ● Sum of Accruals: This parameter represents the sum of ● Sum of Ad Hoc Transfers: This parameter represents the sum of all posted ad hoc transfers since the last regular accrual transfer. ● Sum of Total Accruals: This parameter represents the sum of accruals from the date of the last entitlement until now. Ad hoc transfers are not considered. accruals since the date of the last (ad hoc) entitlement. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 481 Parameter Time Account Type Accrual Transfer The following parameters are read-only, so you can't modify them with the Accrual Transfer rule. ● The Next Transfer Date is the date on which the next ac­ crual transfer happens. ● The Last Transfer Date is the date on which the previ­ ous, last accrual transfer has happened. ● The Ad Hoc Transfer Date is the date on which the next ad hoc transfer takes place, if scheduled. Refer to Time Account Type Accrual Transfer:Time Account Type Accrual Transfer [page 732] for further information. Accrual Transfer [page 482] To use accrual and entitlement, you need to create a rule to create the corresponding time account detail to be created during transfer. This rule is called the Accrual Transfer Rule. Accrual Transfer Rounding [page 483] To use accrual and entitlement, you need to define a rule to create the corresponding time account detail that needs to be generated during transfer. This is called the Accrual Transfer Rule. Initial Accrual Transfer Date Depending On Scenario [page 485] To use accruals and entitlements, you must create a rule to set the next accrual transfer date initially. This rule is called the Initial Accrual Transfer Date Rule. Next Accrual Transfer Date Based On Seniority [page 486] To use accrual and entitlement, you must create a rule to set the next accrual transfer date. This rule is called the Accrual Transfer Date Rule. 6.2.2.1 Accrual Transfer To use accrual and entitlement, you need to create a rule to create the corresponding time account detail to be created during transfer. This rule is called the Accrual Transfer Rule. The rule is called during an accrual transfer. The scenario could be an ad-hoc accrual transfer or a regular accrual transfer. In the example below, the sum of the accrual starting on the last accrual transfer date (regular or ad-hoc transfer) until the day before the current transfer date will be posted. The posting type depends on the scenario as well as the posting date. ● If the scenario is an ad-hoc transfer, the posting type is also ad-hoc entitlement. ● If the scenario is a regular accrual transfer, the posting type is entitlement. ● If the scenario is an ad-hoc transfer, the posting date should also be the ad-hoc transfer date taken from the Time Account Type Accrual Transfer object. ● In the case of a regular accrual transfer, the posting date should be the next transfer date. This rule, SF_ENTITLEMENT_TransferAccrual, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Import Data 482 PUBLIC Admin Center Import and Export Data SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.2.2 Accrual Transfer Rounding To use accrual and entitlement, you need to define a rule to create the corresponding time account detail that needs to be generated during transfer. This is called the Accrual Transfer Rule. The rule is called during an accrual transfer. The scenario could be an ad-hoc accrual transfer or a regular accrual transfer. In the example below, the amount is rounded to full days. In this case you have an ad hoc transfer before the regular transfer you need to be careful to get the correct amount. Let's take a look at an example: Sum of Total Ac­ Sum of Ad-Hoc Posting Date Posting Type Amount Sum of Accruals cruals Transfers January 1st, 2016 Accrual 0.3 0.3 0.3 0 February 1st, 2016 Accrual 0.3 0.6 0.6 0 February 15th, Ad-hoc entitle­ 1 0 0.6 1 2016 ment March 1st, 2016 Accrual 0.3 0.3 0.9 1 April 1st, 2016 Accrual 0.3 0.6 1.2 1 Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 483 Sum of Total Ac­ Sum of Ad-Hoc Posting Date Posting Type Amount Sum of Accruals cruals Transfers May 1st, 2016 Accrual 0.3 0.9 1.5 1 June 1st, 2016 Accrual 0.3 1.2 1.8 1 July 1st, 2016 Accrual 0.3 1.5 2.1 1 July 15th, 2016 Entitlement 1 0 2.1 1 Notes on the Table ● The Sum columns are calculated including the posting in their line. ● The first transfer is an ad-hoc transfer on February 15th. The sum of total accruals on February 14th is 0.6. Until then, no ad-hoc transfer has been executed, therefore the sum of ad-hoc transfers is 0. The rule rounds up to full days - in this case 1 day ad-hoc entitlement is posted. ● The second transfer is a regular transfer. The sum of total accruals is 2.1, but 1 has already been posted for the ad-hoc transfer. So 1 is subtracted from 2.1, which leads to a rounded result 1. The posting type depends on the scenario as well as the posting date. If it is the ad-hoc transfer scenario the posting type is also ad-hoc entitlement and if the scenario is regular accrual transfer, the posting type is entitlement. If the scenario is ad-hoc transfer, the posting type date should also be the ad-hoc transfer date taken from the Time Account Type Accrual Transfer object. In case of regular accrual transfer it should be the next transfer date. Info: To subtract ad-hoc transfers from all accruals needs only to be done in case of rounding. This rule, SF_ENTITLEMENT_TransferAccrualRounding, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Data Import Data 484 PUBLIC Admin Center Import and Export SuccessStore Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.2.3 Initial Accrual Transfer Date Depending On Scenario To use accruals and entitlements, you must create a rule to set the next accrual transfer date initially. This rule is called the Initial Accrual Transfer Date Rule. The rule is called during creation of the corresponding time account - for example, during hire. In the example below, the next transfer date is set based on the scenario. If the rule is called during the hire scenario, the next transfer date is set to the end date of the year the employee is hired. If the rule is not called during the hire process (for example, because a new Time Type with an Entitlement Time Account Type has been created and assigned to an existing time profile and now all accounts for all employee are created), the next transfer date is set to the job info start date (date the time profile is assigned to the employee) plus 12 months. This rule, SF_ENTITLEMENT_SetInitialTransferDateDependingOnScenario, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Center Import and Export Data Import Data Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Admin SuccessStore PUBLIC 485 6.2.2.4 Next Accrual Transfer Date Based On Seniority To use accrual and entitlement, you must create a rule to set the next accrual transfer date. This rule is called the Accrual Transfer Date Rule. The rule is called during an accrual transfer. An accrual transfer takes place based on the Accrual Transfer Rule, and the next transfer date is set based on the Accrual Transfer Date Rule. In the example below, the next transfer date is set based on the seniority of the employee. If the number of calendar years between the employee's hire date and the current next transfer date is fewer than 6 years, the next transfer date will be moved 12 months into the future. If the employee's seniority is 6 years or longer, the accrual transfer period is shorter. In this case, it is moved 6 months into the future. This rule, SF_ENTITLEMENT_SetTransferDateBasedOnSeniority, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Export Data 486 PUBLIC Import Data Admin Center Import and SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.3 Period-End Processing Rules Rules are used to close old accounts and carry over balances as part of period-end processing. When you create a period-end processing rule, please assign "Time Account" as the Base Object. Close Old Account and Set Account Balance to Zero [page 487] You can use this sample period-end processing rule if you don't want to carry forward the remaining balance. It sets the remaining balance of the old account to zero, by posting a negative balance amount. Close Old Account and Carry Over Balance to Follow-Up Account [page 488] This sample period-end processing rule carries forward the remaining balance to the new account. It sets the remaining balance of the old account to zero, by posting a negative balance amount, and closes the old account. If a follow-up account exists, the rule carries over the remaining balance from the old account to the new account. Close Old Account and Carry Over Balance to Follow-Up Account Up To Defined Limit [page 489] This sample period-end processing rule carries forward the remaining balance only up to a defined limit. 6.2.3.1 Close Old Account and Set Account Balance to Zero You can use this sample period-end processing rule if you don't want to carry forward the remaining balance. It sets the remaining balance of the old account to zero, by posting a negative balance amount. This rule, SF_PEP_Close, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Admin Center Import and Export Data Import Data SucessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 487 6.2.3.2 Close Old Account and Carry Over Balance to Follow-Up Account This sample period-end processing rule carries forward the remaining balance to the new account. It sets the remaining balance of the old account to zero, by posting a negative balance amount, and closes the old account. If a follow-up account exists, the rule carries over the remaining balance from the old account to the new account. This rule, SF_PEP_CarryOver, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Admin Center Import and Export Data Import Data SuccessStore . 488 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.3.3 Close Old Account and Carry Over Balance to Follow-Up Account Up To Defined Limit This sample period-end processing rule carries forward the remaining balance only up to a defined limit. It sets the remaining balance of the old account to zero, by posting a negative balance amount, and closes the old account. If a follow-up account exists, then the rule carries over the remaining balance from the old account to the new account. As there is a limit of 15 defined, only up to 15 days or 15 hours are carried forward. The rule definition looks the same as in the Carry Over example above. You just have to make sure that you use the Minimum()-function to determine the Amount posted for the Time Account Detail you create for the followup account. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 489 This rule, SF_PEP_CarryOverLimit, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules: Go to Admin Center Import and Export Data Import Data SuccessStore . 490 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.4 Interim Account Update Rules While manual adjustments are usually created manually by an HR admin, the interim account calendar run enables you to do mass data updates for time accounts based on a business rule. When you create an interim account update rule, please assign “Time Account” as the Base Object. Adjusting Balances To A Certain Limit [page 491] With this sample interim account update rule, you can adjust account balances to a certain limit. Closing Accounts for Terminated Employees [page 492] With this sample interim update rule, you can close time accounts for terminated employees. Closing Recurring Accounts [page 493] With this sample interim update rule, you can close recurring time accounts that have not been bookable for more than 6 months. 6.2.4.1 Adjusting Balances To A Certain Limit With this sample interim account update rule, you can adjust account balances to a certain limit. An example of where you could use such a rule would be if your business year ends on December 31, but you allow employees to carry forward up to 5 days of leave into the new year, to be booked no later than March 31. So your time accounts have an extended booking period of 3 months. You can then run an interim account update on December 31 with a rule that checks the balance and creates an adjustment booking if needed. This rule, SF_INTERIM_AdjustBalance, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules: Go to Data Admin Center Import and Export Data Import SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 491 6.2.4.2 Closing Accounts for Terminated Employees With this sample interim update rule, you can close time accounts for terminated employees. If the time account is not yet closed and the employee status is terminated ("T") or retired ("R"), the employee’s time account will be closed. If you create this rule, you must add all employee statuses related to termination. 492 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.4.3 Closing Recurring Accounts With this sample interim update rule, you can close recurring time accounts that have not been bookable for more than 6 months. If the time account is not yet closed and the bookable end date of the time account is more than 6 months in the past, the time account will be closed. To choose 6 months as an indicator is only an example - you can add any value you require. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 493 6.2.5 Take Rules When you create, cancel, or edit a leave request, the system performs certain checks. For example, an error comes up when the time account balance is not sufficient to book leave. Sometimes, you want to add further validation checks. This can be done using "Take Rules”. When you create a take rule, assign “Employee Time” as the Base Object. Before you create the rule, please create the message definition by going to the Admin Center and choosing Manage Data Create Message Definition . Absence Creation / Change / Cancellation Allowed Depending on Employee Status [page 495] You can use take rules to decide, based on the employee's status, whether the creation, update, or cancellation of a leave request should be allowed or not. Limited Absence Duration [page 496] You can use take rules to enforce limits on how much absence associated with a particular time type can be taken. No Time Off Creation in the Past [page 496] With this sample rule, you can prevent an employee creating an absence with a start date in the past. If you add the If-condition “User is equal to Login User()”, you restrict the check to the Employee-SelfService scenarios. No Change of Time Off in the Past [page 497] With this sample rule, you can prevent an employee changing or canceling an existing absence in the past. 494 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.5.1 Absence Creation / Change / Cancellation Allowed Depending on Employee Status You can use take rules to decide, based on the employee's status, whether the creation, update, or cancellation of a leave request should be allowed or not. There are two rule functions that can be used. ● The first one returns the information on whether the employee is active on a given date. The date should be typically the start date of the leave request. If the employee is not active on that date, you can decline the process. ● The second way is more detailed. You can decide for which employee status you want to allow absence request actions. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 495 6.2.5.2 Limited Absence Duration You can use take rules to enforce limits on how much absence associated with a particular time type can be taken. This sample rule checks the requested absence. If the time between the start date and the end date is more than two days, the rule blocks the request and generates an error message. You don´t need to add a rule parameter. This rule, SF_TR_LimitedAbsence, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Admin Center Import and Export Data Import Data SuccessStore . 6.2.5.3 No Time Off Creation in the Past With this sample rule, you can prevent an employee creating an absence with a start date in the past. If you add the If-condition “User is equal to Login User()”, you restrict the check to the Employee-Self-Service scenarios. An HR admin can edit or cancel such requests. You don't need to add a rule parameter. This rule, SF_TR_NoCreationInPast, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Data SuccessStore . 496 PUBLIC Admin Center Import and Export Data Import Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.5.4 No Change of Time Off in the Past With this sample rule, you can prevent an employee changing or canceling an existing absence in the past. To check against the original state of the absence, you use parameter editedEmployeeTime to define the Ifconditions instead of the base object that contains the changed state. If you add the IF-condition “User is equal to Login User()”, you restrict the check to the Employee-Self-Service scenario. An HR admin can edit or cancel such requests. If you add the If-condition “editedEmployeeTime.ApprovalStatus is equal to Approved” you restrict the check to approved absences. For pending absences, the employee is still able to make changes. This rule, SF_TR_NoChangeInPast, is part of the Time Off - Sample Rules package of the Success Store. You can import this package of pre-configured rules. Go to Admin Center Import and Export Data Import Data SuccessStore . Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 497 6.2.6 Time Off Workflow Rules To set up workflow when an employee requests leave, you need to assign the workflow rule as a save rule to the Employee Time object. Example This rule, SF_WF_EmployeeTime, is part of the Time Off - Sample rules package in the Success Store. You can import this package of pre-configured rules: Go to Admin Center Import and Export Data Import Data SuccessStore . 498 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.2.6.1 Creating Alert Rules for Time Off Learn the specific settings that are to be used in alert rules for Time Off objects. Procedure 1. Create a basic rule and select the Employee Time as the base object. 2. You do not need to add any parameters. You can use the default parameter. 3. Define the IF conditions for the triggering conditions. Note To prevent alerts from being created for every record change in the database, do not use the Always True feature and avoid creating alert rules without any IF condition. 4. For the THEN statement, select Execute and Trigger Employee Time Alert Event(). Then, define the following information: Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 499 Field Description Workflow Information Assign the workflow for alert recipients. Effective Date Define when the created alerts are sent. Alert Message Assign an alert message template. If you no template is assigned, the system uses the default message to create the alert. External Code Select the external code for Employee Time. For Example: Create a rule to send an alert to a manager 10 days before an employee's unpaid leave is over. 5. Save the rule. 6.2.7 On Change Rules There's a rule you can use to default the start and end times of an absence request according to the employee's work schedule. First, you have to create a custom field (named “string” in this example), where the user can enter AM or PM when creating a leave request to define whether he or she wants to be absent in the morning or in the afternoon. 500 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Afterwards, you can assign an on change rule to the custom field looking like this: If the user has a one day absence and a time type based on hours and minutes, the user needs to fill the dates and the custom field with AM or PM. The on-change rule then updates the start time and end time according to the user's work schedule. The rule calculates the duration between start time of the working day based on work schedule and end time. In the case of AM, half of the duration is added to the start time to get the end time. In the case of PM, half of the duration is deducted. 6.2.8 Flexible Account Creation In this scenario, the account start date of each employee with this time account type assigned is defined as the employee’s seniority date. Assign the rule in the time account type as the Flexible Account Start Date Rule. You can either copy this rule or create a new one based on the Flexible Account Start Date scenario. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 501 6.2.9 Periodic Update for Balance Reduction In this scenario, the balance at the end of each periodic update period must not exceed a predetermined amount. In the example below, if the balance is higher than 8, the difference will be deducted from the time account, meaning that a counter posting will be created for the employee's time account. Note The time account balance on the end date of the periodic update period is already available in the periodic update rule parameters. As such, it doesn’t need to be calculated again. To create the rule, use the Periodic Time Account Update rule scenario. 502 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.3 Rule Scenarios for Time Off Various different rule scenarios are available in Time Off. Absence Validation The Absence Validation rule scenario is used to perform additional checks on leave requests. You can assign rules of this scenario as take rules to time types. This table shows the available parameters: Name Object Time Account Time Account New Time Account New Time Account Edited Employee Time Edited Employee Time Take Rule Parameters Take Rule Parameters Accrual The Accrual rule scenario is used for time account types where the accrual frequency is defined. You can assign rules of this scenario as Accrual Rule, Hire Rule, Termination Rule for the time account types based on standard. You can also assign them as the Simulation Rule. This table shows the available parameters: Name Object Time Account Time Account Accrual Rule Parameter Accrual Rule Parameter Accrual Rule Variables Accrual Rule Variables Accrual Transfer The Accrual Transfer rule scenario is used for time account types where the entitlement method is set to Entitled as Transferred. You can assign rules of this scenario only as the Accrual Transfer Rule to time account types. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 503 This table shows the available parameters: Name Object Time Account Time Account Accrual Transfer Rule Parameter Accrual Transfer Rule Parameter Time Account Type Accrual Transfer Parameters Time Account Type Accrual Transfer Parameters Accrual Transfer Date Handling The Accrual Transfer Date Handling rule scenario is used for time account types where the entitlement method is set to Entitled as Transferred. You can assign rules of this scenario only as the Accrual Transfer Date Rule to the time account types. This table shows the available parameters: Name Object Time Account Accrual Transfer Time Account Accrual Transfer Accruals on Actuals The Accruals on Actuals rule scenario is used for time account types where the accrual frequency is defined. You can assign rules of this scenario as Accrual Rule, Hire Rule, Termination Rule for the time account types based on recorded times. This table shows the available parameters: Name Object Time Account Time Account Accrual Rule Parameter Accrual Rule Parameter Accrual Rule Variables Accrual Calculation Base Parameters Accrual Calculation Base Parameters Accruals on Planned Working Times The Accruals on Planned Working Times rule scenario is used for time account types where the accrual frequency is defined. You can assign rules of this scenario as Accrual Rule, Hire Rule, Termination Rule for the time account types based on standard. You can also assign them as the Simulation Rule. 504 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management This table shows the available parameters: Name Object Time Account Time Account Accrual Rule Parameter Accrual Rule Parameter Accrual Rule Variables Accrual Rule Variables Planned Working Time Parameters Planned Working Time Parameters Flexible Time Account Start Date Derivation You can use this rule scenario to save the flexible time account start date in Time Off. This table shows the available parameters: Name Object Time Account Type Start Date Reference Time Account Type Start Date Reference Initial Accrual Transfer Date Handling The Initial Accrual Transfer Date Handling rule scenario is used for time account types where the entitlement method is set to Entitled as Transferred. You can assign rules of this scenario only as the Initial Accrual Transfer Date Rule to the time account types. This table shows the available parameters: Name Object Time Account Accrual Transfer Time Account Accrual Transfer Initial Accrual Transfer Date Rule Parameters Initial Accrual Transfer Date Rule Parameters Interim Time Account Update Use this scenario for rules that update interim time accounts. The rules will then be applied to any time account for which interim adjustments are required. This takes place at Time Account Type level through the calendar run. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 505 This table shows the available parameters: Name Object Time Account Time Account New Time Account New Time Account Interim Time Account Update Rule Parameters Interim Time Account Update Rule Parameters If the interim time account update rule doesn't set a time account to closed, a rerun will process that time account again. If your rule creates a time account detail, you can use rule function Get Number Of Postings For Posting Types In Period() to avoid another time account details creation. Here's an example: Linking Absence The Linking Absence rule scenario is used if you want to run some checks during the process of linking of 2 absences. This rule is not assigned - it is executed by the system automatically during the linking process. This table shows the available parameters: Name Object Employee Time Employee Time 506 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Name Object Linked Employee Time Linked Employee Time Period-End Processing Use this scenario for any rules that control the period-end processing of recurring time accounts. During period-end processing, the rule assigned to the time account type is called for the time account that is about to be closed. The rule allows you to specify how the remaining balance is handled (carried forward or forfeited) before closing the time account. This table shows the available parameters: Name Object Time Account Time Account New Account New Account Period End Processing Rule Parameters Period End Processing Rule Parameters Note We recommend that you close the "old" time account during period-end processing. This ensures that a rerun will not select that account again. If you don´t close the time account, you still prevent duplicate time account details from being created by using an additional condition based on the Get Number Of Postings For Posting Types In Period() rule function. See the example for the Interim Account Update rule scenario above. Periodic Time Account Update Use this scenario for any time account types for which a periodic update should be executed on a regularly basis. You can assign rules that use this scenario as update rules in the periodic time account update profile object, which you can then assign to the time account type itself. This table shows the available parameters: Name Object Time Account Time Account Periodic Update Rule Parameter Periodic Update Rule Parameter Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 507 Time Account Configuration Use this scenario to configure the bookable period of a time account or to set custom fields on a time account. This table shows the available parameters: Name Object Context Context Time Account TimeAccount Time Account Payout Validation Use this scenario for any rules applied to payouts for accrued time. Add validations for payout requests or when administrators edit payouts based on your payout policy. Business rules created for this scenario are added to the payout validation rules on the Time Account Payout Profile object. This table shows the available parameters: Name Object Time Account Payout Time Account Payout Edited Time Account Payout Time Account Payout Payout Validation Rule Parameter Payout Validation Rule Parameter Time Account Purchase Leave Validation Use this scenario for any rules applied to leave purchases. Add validation for requests to purchase time or when administrators create or edit purchase requests. You can also use the rule scenario to set the value of quantity or equivalent quantity and deduction start and deduction end date fields when creating or editing purchases. Business rules created for this scenario are added to the purchase validation rules on the Time Account Purchase Profile object. This table shows the available parameters. Name Object Time Account Purchase Time Account Purchase Edited Time Account Purchase Time Account Purchase Purchase Validation Rule Parameters Purchase Validation Rule Parameters 508 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Period-End Processing with Payout Use this scenario for any rules that control the period-end processing of recurring time accounts that are eligible for payout. During period-end processing, the rule assigned to the time account type is called for each time account that is about to be closed. The rule allows you to specify how the remaining balance is handled (paid out, carried forward, forfeited) before closing the time account. This table shows the available parameters: Name Object Time Account Time Account New Account New Account Period End Processing Rule Parameters Period End Processing Rule Parameters Time Account Payout Rule Parameters Time Account Payout Rule Parameters 6.4 Time Sheet Validation Rule Time Sheet Validation This rule scenario is used to perform additional validation on Employee Time Sheet using time sheet validation rules. Rules created using this scenario are invoked when employee time sheets are edited. For example, if you change something in the time sheet interface, the rule is invoked automatically, provided it is entered In the relevant time recording profile as the validation rule. Alternatively, the rule is invoked automatically when background jobs are run. This table shows the available parameters: Name Object Time Sheet Day Time Sheet Day Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 509 6.5 Notes on Rule Functions in Time Off Use these links to access detailed information on rule functions you can use in Employee Central Time Off. Note Rule functions must only be used with Employee Times whose time types are classified as Absence. That's because Time Off rule functions only accept time types where the parameter has been classified as Absence. Calculate Balance() [page 589] This function calculates the account balance for a time account on a specific date. Calculate Balance for Types() [page 590] This rule function is an advanced version of the Calculate Balance() rule function. It's designed so that it can be used in a Take rule, because the base object is EmployeeTime and you can pass the external code of the time type. Calculate Entitlement Balance() [page 591] This rule function is used to retrieve the entitlement balance from a given time account with entitlement method “Entitled as Transferred” or time type for a given date. Cap Accrual() [page 592] This function determines which accrual value can be posted without exceeding the specified accrual balance limit. Generate External Code For Time Off() [page 592] This function generates a unique UUID which can be used as external code. The UUID is a 32-character long combination of numbers and letters. Get Balance For Posting Types In Period() [page 593] The rule function returns the balance of postings in a given period. Get Completed Calendar Weeks Between Dates (ISO Standard)() [page 595] This function calculates the number of weeks the employee is going to work in the accrual period. Get Completed Remaining Calendar Weeks (ISO Standard)() [page 597] This function calculates the number of weeks the employee is going to work in his hire period. Get Employee Status() [page 599] This rule function returns the external code of employee status for the input parameters User Id (mandatory) and date (optional). By default, the current date is considered. The rule function can be consumed as a take rule. Get Months Taking Account Of Threshold() [page 600] This function calculates the number of months the employee is going to work in the accrual period. It can be used for hire and termination rules. The function is used for fields that show data in numeric form. Get Months From Hire Date Taking Account Of Threshold [page 602] This function calculates the number of months the employee is going to work in the hire period. The threshold indicates whether the hire month is included in the calculation. Get Number Of Calendar Days() [page 604] This rule function calculates the number of calendar days between a start date and end date, including the start date and the end date. 510 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Get Number Of Eligible Days() [page 605] This function calculates the number of eligible days for getting accruals. It is used for fields that show data in numeric form. You can define upfront in Time Off which employee status is included in eligibility. Get Number Of Holidays For Period() [page 606] This function calculates the number of holidays for a user and a given time period. Get Number Of Months From Hire Date() [page 607] This function calculates the number of months the employee is going to work. Get Number Of Postings For Posting Types in Period() [page 609] The rule function returns the number of postings in a given period. Get Sum Of Accruals Since Last Transfer() [page 610] This function is required to retrieve the sum of accruals of a given time account with entitlement method “Entitled as Transferred” or time type since the last transfer date (ad-hoc transfer or regular transfer, whichever is later). Get Sum Of Advances() [page 612] This rule function is required to retrieve the advance balance from a given time account on a given date. The rule function only makes sense for Time Accounts with entitlement method “Entitled as Transferred” because for other accounts there are no advances. Get Time Management Earliest Recalculation Date () [page 613] This rule function returns the earliest date only if recalculation is active. Has Payouts in Period() [page 613] This rule function returns whether any active payouts exist in a given period or after a given start date. Has Temporary Work Schedule() [page 614] This function determines whether an employee has been assigned a temporary work schedule as of a specified date. The answer returned is Yes or No. Is Employee Active() [page 614] This rule function returns the active/inactive status of employee for the User Id as a mandatory input parameter and the date as an optional input parameter. Is Time Management Recalculation Active () [page 616] This rule function is used to validate whether time management recalculation is active or not. 6.5.1 Rule Functions for Absence Calculations 6.5.1.1 Get Absence Days() With this function, you can calculate how long an employee has been absent within one year for a specific time type. For example, if an employee has been sick for more than 30 days in a year, you can use this function to raise an alert to the manager. The result of this function is the accumulated absence for that employee for a specific time type – in this example, 30 days for the time type Sickness. The calculation considers the work schedule as well as the holiday calendar assigned to the employee. This rule function considers the Approved, Pending, and Pending Cancellation Employee Time statuses for calculating absence days or hours. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 511 Limitations Use this function only with base object Employee Time. Input Parameters For this parameter... Make this entry: User Select the User field. This is the user that creates the absence request in the Time Off calen­ dar. Time Type External Code Select Time Type.External Code. This defines which time type has been used for the ab­ sence request (for example, Sickness). Use Working Days Instead of Calendar Days Select Boolean. You can then enter the following: ● Yes to define that working days as defined in the working schedule should be used for calculating the absence. ● No to use calendar days for calculating the absence. Start Date Select Start Date. This is the start date the user has entered in the Time Off calendar. First Day of Year Select Number, and enter a number to define the beginning of the calendar year you want to use to sum up an employee’s absence days. For example, 1 to start with the first day of a month. First Month of Year Select Number, and enter a number to define the beginning of the calendar year you want to use to sum up an employee’s absence days. For example, 1 to start with January, or 4 to start with April. The end date of the calendar year is then defined by the system accordingly (for example, December 31 when the start of the calendar year has been defined as January 01). Use Case Because this is an application-specific rule function, we recommend that you stick to the use case of Employee Central Time Off. Please refer to the Implementing Employee Central Time Off guide for more information. 6.5.1.2 Get Absence In Days For Period() This function calculates cumulated absence days for the given date period and a given time type. If the time type calculation is based on calendar days, the rule function returns the number of calendar days. If the time type is based on work schedule days, the rule function returns the number of work schedule days, 512 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management considering holidays. If it is a flexible requesting time type based on unit hours, the rule function returns 0 days. Absences with undetermined end dates are also counted as 0 days. The calculation considers the work schedule as well as the holiday calendar assigned to the employee. This rule function considers the Approved, Pending, and Pending Cancellation Employee Time statuses for calculating absence days or hours. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. Note ● If you use this rule function in a take rule and the time type of the employee time triggering the take rule is the same as the rule function time type, the employee time that triggers the rule is not considered because it is not yet saved. ● If an employee time is edited, the absence in days from the existing employee time is covered. You can subtract that existing employee time quantity in days later and add the result of the current employee time. ● If no start date or end date is specified, the return is 0. Input Parameters For This Field Make This Entry User ID Select the User field. This is the user for which the absence days should be calculated. Time Type External Code Enter the time type external code the rule should be exe­ cuted for. Start Date Period start date End Date Period end date Examples Let's look at some examples. Example 1 Here’s the data for A.N.Other’s absence calculation. User ID: A.N. Other Time Type External Code: Enter text "SPECIAL LEAVE". For this time type, the time type calculation is based on work schedule days. Start Date = October 1, 2017 End Date = October 31, 2017 Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 513 Prerequisites: User A.N. Other has a work schedule: Monday - Friday 8 hours, Saturday and Sunday 0 hours. He also has a work schedule with October 3, 2017, marked as a full holiday. Result Taken Leave of Type "SPECIAL LEAVE" ● October 1, 2017 – October 4, 2017 => 2 days because October 1, 2017 is a Sunday with 0 working hours and October 3, 2017 is a full holiday with 0 working hours ● October 31, 2017 – November 4, 2017 =>8 hours within October ● The rule function returns 24 hours. Example 2 Here’s the data for A.N.Other’s absence calculation. User ID: A.N. Other Time Type External Code: Enter text "SPECIAL LEAVE". For Time Type "SPECIAL LEAVE", the time type calculation is based on calendar days. Start Date = October 1, 2017 End Date = October 31, 2017 Prerequisites: User A.N. Other has a work schedule: Monday - Friday 8 hours, Saturday and Sunday 0 hours. He also has a work schedule with October 3, 2017, marked as a full holiday. Result Taken Leave of Type "SPECIAL LEAVE" ● October 1, 2017 – October 4, 2017 => 4 calendar days. ● October 31, 2017 – November 4, 2017 => 1 calendar day within October. ● The rule function returns 5 days. Example 3: Cross Midnight Here’s the data for A.N.Other’s absence calculation. ● User ID: A.N.Other ● Time Type External Code: Enter text "SPECIAL LEAVE". For Time Type Special Leave, the time type calculation is based on work schedule days. ● Start Date = October 1, 2020 ● End Date = October 20, 2020 Prerequisites: User A.N. Other has a cross-midnight work schedule: Monday - Friday 8 hours from 10pm to 6am (next day), Saturday and Sunday 0 hours. He also has a holiday calendar with October 3, 2017 marked as full holiday. Result Taken Leave of Type "SPECIAL LEAVE" ● September 30, 2020 – October 1, 2020 (in detail September 30, 2020 10pm until October 2, 2020 6am, which belongs to the working day October 1, 2020) => 1 day. Only the working day started on October 1 is considered. October 20, 2020 – October 22, 2020 (in detail October 20, 2020 10pm until October 23, 2020 6am) => 1 days within selection period (October 20, 2020 10pm until October 21, 2020 6am). The hours physically 514 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management lying on October 21, 2020 are considered as well, because they belong to the working day starting on October 20, 2020 as full absence. ● The rule function returns 2 days. 6.5.1.3 Get Absence In Days For Period Based On Calendar Days For Time Types() This rule function calculates the total number of absence days in given duration for the time types provided. This calculation is based on calendar days and does not take account of the work schedule or holiday calendar in the employee’s job info. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. The calculation considers the work schedule as well as the holiday calendar assigned to the employee. This rule function considers the Approved, Pending, and Pending Cancellation Employee Time statuses for calculating absence days or hours. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. Input Parameters For This Field Make This Entry User ID Select the User field. This is the user for which the total num­ ber of absence days should be calculated. Start Date First day of duration in which absences are to be considered for calculation. You can use the start date of accrualRule­ Parameters. Take a look at use case 1 below. End Date Last day of duration in which absences are to be considered for calculation. You can use the end date of accrualRulePara­ meters. Take a look at use case 1 below. Employee Time (optional) The employee time is only necessary if you use the rule func­ tion in a take rule. Take a look at use case 2 below. Time Types Select time types. These are used to select employee times for calculation. Note Please only use time types with the time type category Absence for this rule function. Otherwise it can lead to errors. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 515 Use Case 1: Accrual Rule This rule function can be used in the accrual rule for a time account type where the accrual to be posted needs to consider the impact of other absences (like leave without pay) that the employee has taken in a specified time frame. For example, this rule function can be used to calculate total number of absences that employee has taken from January 1, 2015, to December 31, 2015, which were of type leave without pay and unauthorized leave. Examples Here is data to calculate the total number of days of leave without pay (time type: LWOP) and unauthorized leave (time type: UNAL) during the year 2015 during accrual rule processing: User ID: A.N. Other Start Date = January 1, 2015 End Date = December 31, 2015 Time Types: “LWOP”, “UNAL” Example Details 1: Existing Employee Times October 1, 2015 – October 31, 2015 Result 1: The rule function will return 31 days. Example Details 2: Existing Employee Times No employee times. Result 2: The rule function will return 0 days. Example Details 3: Existing Employee Times ● February 15, 2015 - February 20, 2015 (6 days) ● December 20, 2015 - January 10, 2016 (12 days) Result 3: The rule function returns 18 days. Use Case 2: Take Rule This rule function can be used in a take rule to check whether someone is allowed to take the corresponding leave. For example, an employee is this rule function can be used to calculate total number of absences that employee has taken from January 1, 2015, to December 31, 2015, which were of type leave without pay and unauthorized leave. The processing action (Create, Edit, Cancel) is part of the take rule parameters. Depending on this action, you can use the rule function to get the current number of calendar days, taken by the time type of the current 516 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management employee time. If the action is Create or Edit, forward the employee time to the rule function. In the case of Cancel, it does not make sense to call the rule function at all. Examples Here is data to calculate total number of days taken of Time Type: Vacation during the year 2015: User ID: A.N. Other Start Date = January 1, 2015 End Date = December 31, 2015 Time Types: “Vacation” Created Employee Time: November 2, 2015 - November 1, 2015 Results Example Details 1: ● Existing Employee Time: October 1, 2015 – October 31, 2015 Result 1: The rule function returns 33 days. Depending on this result, an error can be thrown to avoid the creation of the employee time. Example Details 2: ● Existing Employee Time: October 1, 2015 – October 31, 2015 ● Existing Employee Time will be updated: November 1, 2015 - November 2, 2015 Result 2: The rule function returns 2 days. Depending on this result, an error can be thrown to avoid the creation of the employee time. Example Details 3: ● Existing Employee Time: February 15, 2015 - February 20, 2015 (6 days) ● Existing Employee Time: December 20, 2015 - January 10, 2016 (12 days in 2015) ● Created Employee Time: November 1, 2015 - November 2, 2015 (2 days) Result 3: The rule function returns 20 days. Depending on this result, an error can be thrown to avoid the creation of the employee time. Cross-Midnight Example Here’s the data for A.N.Other’s absence calculation. User ID: A.N. Other Start Date = October 1, 2020 End Date = October 20, 2020 Time Types: "SPECIAL LEAVE" Result Taken Leave of Type "SPECIAL LEAVE" ● September 30, 2020 – September 30, 2020 (in detail September 30, 2020 10pm until October 1, 2020 6am, which belongs to the working day September 30, 2020)=> 0 days, because the working hours laying on October 1st belong to the working day of September 30, 2020 and therefore are not considered. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 517 ● October 5, 2020 - October 10, 2020 (in detail October 5, 2020 10pm until October 11, 2020 6am) => 6 calendar days; although the leave ends physically on October 11, 2020 6am, this day belongs to October 10, 2020 and is not considered. October 20, 2020 – October 22, 2020 (in detail October 20, 2020 10pm until October 23, 2020 6am)=> 1 day within selection period (October 20, 2020 10pm until October 21, 2020 6am). The hours physically lying on October 21, 2020 are considered as well, because they belong to the working day starting on October 20, 2020 and mark the working day starting on October 20, 2020 as full absence. The rule function returns 7 days. 6.5.1.4 Get Absence In Days For Period Based On Working Days For Time Types() This function calculates the cumulated absence days for the given duration and given time types. The calculation considers the work schedule as well as the holiday calendar assigned to the employee. This rule function considers the Approved, Pending, and Pending Cancellation Employee Time statuses for calculating absence days or hours. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. Regardless of the unit used in the time type (hours or days), the rule function returns the absence in working days. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. Note This rule function doesn't work properly with leave of absence time types. It will return a figure of 0. Input Parameters For This Field Make This Entry User ID Select the User field. This is the user for which the start time of the working day should be calculated. Start Date First day of duration in which absences are to be considered for calculation. You can use the start date of accrualRule­ Parameters. Take a look at use case 1 below.. End Date Last day of duration in which absences are to be considered for calculation. You can use the end date of accrualRulePara­ meters. Take a look at use case 1 below. Employee Time (optional) The employee time is only necessary if you use the rule func­ tion in a take rule. Take a look at use case 2 below. 518 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management For This Field Make This Entry Time Types Select Time Types. These are used to select Employee Times for calculation. Use Case 1: Accrual Rule This rule function can be used in the accrual rule for a time account type where the accrual to be posted needs to consider the impact of other absences (like leave without pay) that the employee has taken in a specified time frame. For example, this rule function can be used to calculate total number of absences that employee has taken from January 1, 2016, to December 31, 2016, which were of type leave without pay and unauthorized leave. Examples Here is data to calculate the total number of days of leave without pay (time type: LWOP) and unauthorized leave (time type: UNAL) during the year 2016 during accrual rule processing: User ID: A.N. Other Start Date = January 1, 2016 End Date = December 31, 2016 Time Types: “LWOP”, “UNAL” Work schedule pattern : Monday to Friday are working days. Example Details 1: Existing Employee Times October 1, 2016 – October 31, 2016 Result 1: The rule function returns 21 days. Example Details 2: Existing Employee Times No employee times. Result 2: The rule function returns 0 days. Example Details 3: Existing Employee Times ● February 15, 2016 - February 20, 2016 (6 days) ● December 20, 2016 - January 10, 2017 (9 days) Result 3: The rule function returns 14 days. Cross-Midnight Example Here’s the data for A.N.Other’s absence calculation. User ID: A.N. Other Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 519 Start Date = October 1, 2020 End Date = October 20, 2020 Time Types: "SPECIAL LEAVE" Prerequisites: ● User A.N. Other has a cross-midnight work schedule: Monday - Friday 8 hours from 10pm to 6am (next day), Saturday and Sunday 0 hours. ● No holidays in selection period October 1, 2020 - October 20, 2020. Result Taken Leave of Type "SPECIAL LEAVE" ● September 30, 2020 – September 30, 2020 (in detail September 30, 2020 10pm until October 1, 2020 6am, which belongs to the working day September 30, 2020)=> 0 days, because the working hours laying on October 1st belong to the working day of September 30, 2020 and therefore are not considered. ● October 5, 2020 - October 10, 2020 (in detail October 5, 2020 10pm until October 11, 2020 6am) => 5 work schedule days ● October 20, 2020 – October 22, 2020 (in detail October 20, 2020 10pm until October 23, 2020 6am)=> 1 day within selection period (October 20, 2020 10pm until October 21, 2020 6am). The hours physically lying on October 21, 2020 are considered as well because they belong to the working day starting on October 20, 2020 and mark the working day starting on October 20, 2020 as full absence. The rule function returns 6 days. Use Case 2: Take Rule This rule function can be used in a take rule to check whether someone is allowed to apply for or modify the absence. For example, this rule function can be used to calculate absence in terms of total number of working days that the employee has taken from January 1, 2016, to December 31, 2016, which were of type leave without pay and unauthorized leave. If these leaves exceeds a specific number, for example 20 days, then the employee cannot create the absence record for future leave. The processing action (Create, Edit, Cancel) is part of the take rule parameters. Depending on this action, you can use the rule function to get the current number of calendar days, taken by the time type of the current employee time. If the action is Create or Edit, forward the employee time to the rule function. In the case of Cancel, it does not make sense to call the rule function at all. Examples Here is data to calculate total number of days taken of Time Type: Vacation during the year 2016: User ID: A.N. Other Start Date = January 1, 2016 End Date = December 31, 2016 520 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Time Types: “Vacation” Results Example Details 1: ● Existing Employee Time: October 1, 2016 – October 31, 2016 ● Created Employee Time: November 1, 2016 - November 2, 2016 Result 1: The rule function returns 23 days. Depending on this result, an error can be thrown to avoid the creation of the employee time. Example Details 2: ● Existing Employee Time: October 1, 2016 – October 31, 2016 ● Existing Employee Time will be updated: November 1, 2016 - November 2, 2015 Result 2: The rule function returns 2 days. Depending on this result, an error can be thrown to avoid the creation of the employee time. Example Details 3: ● Existing Employee Time: February 15, 2016 - February 20, 2016 (5 days) ● Existing Employee Time: December 12, 2016 - January 10, 2017 (15 days in 2015) ● Created Employee Time: November 1, 2016 - November 2, 2016 (2 days) Result 3: The rule function returns 22 days. Depending on this result, an error can be thrown to avoid the creation of the employee time. 6.5.1.5 Get Absence In Days For Period Based On Working Days For Time Types Excluding Weekdays() With this rule function, you can exclude the weekdays of your choice when getting the sum total of absence days. The calculation considers the work schedule as well as the holiday calendar assigned to the employee. This rule function considers the Approved, Pending, and Pending Cancellation Employee Time statuses for calculating absence days or hours. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. Here’s an example of a situation where you might want to do that. As an employer, you want to provide your employees with meal vouchers for lunch using Employee Central Global Benefits. At the beginning of each month, employees receive one meal voucher for each day worked during the previous month. As such, in order to calculate the individual number of meal vouchers for each employee, the employee’s absences need to be deducted from the number of planned working days according to the employee’s work schedule. However, on one weekday (say Friday), employees leave work prior to lunch, so Fridays are excluded from the sum of working days. If, in addition to that, an employee records an absence on Friday, the rule function avoids deducting this day twice from the final number by excluding it from the calculation of absence days. For cross midnight absences, the absence is considered based on the working day to which the absence belongs. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 521 Note This rule function does not work for Leave of Absence time types, or for absences with undetermined end dates. Input Parameters For this field Make this entry User ID Select the user for which the start time of the working day should be calculated. Start Date The start date of the time period for which you want to cal­ culate. End Date The end date of the time period for which you want to calcu­ late. Weekdays to be Excluded Select the Get Weekdays() rule function, and choose one or more days you want to exclude from calculation. Employee Time (optional) Note This is only relevant if you use the rule function in a Take rule. Enter the employee time that will be modified or created when the Take rule is triggered. Time Types Select time types. These are used to select employee times for calculation. Note Please only use time types with the time type category Absence for this rule function. Otherwise it can lead to errors. Examples Let’s look at some examples. Here’s the data for A.N.Other’s absence calculation. User ID: A.N. Other Start Date = July 1, 2019 End Date = July 31, 2019 Time Types: “Vacation”, 'Sick Leave' 522 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Weekdays: "Friday" Prerequisites: User A.N. Other has a work schedule: Monday - Friday 8 hours, Saturday and Sunday 0 hours. Example Details 1: Existing Employee Times Employee Time: MON, July 8, 2019 - FRI, July 12, 2019 Result: The rule function returns 4 days. Example Details 2: Existing Employee Times Employee Time: MON, July 8, 2019 - THU, July 11, 2019 Result: The rule function returns 4 days. Example Details 3: Existing Employee Times Employee Time: FRI, July 12, 2019 Result: The rule function returns 0 days. Cross-Midnight Example: Here’s the data for A.N.Other’s absence calculation. User ID: A.N. Other Start Date = October 1, 2020 End Date = October 20, 2020 Time Types: "SPECIAL LEAVE" Weekdays: "Friday" Prerequisites: User A.N. Other has a cross-midnight work schedule: Monday - Friday 8 hours from 10pm to 6am (next day), Saturday and Sunday 0 hours. Prerequisites: No holidays in selection period October 1, 2020 - October 20, 2020. Result Taken Leave of Type "SPECIAL LEAVE" September 30, 2020 – September 30, 2020 (in detail September 30, 2020 10pm until October 1, 2020 6am, which belongs to the working day September 30, 2020)=> 0 days, because the working hours laying on October 1st belong to the working day of September 30, 2020 and so are not considered. October 5, 2020 - October 10, 2020 (in detail October 5, 2020 10pm until October 11, 2020 6am) => 4 work schedule days, cause Friday (October 9, 2020) is excluded. October 20, 2020 – October 22, 2020 (in detail October 20, 2020 10pm until October 23, 2020 6am)=> 1 day within selection period (October 20, 2020 10pm until October 21, 2020 6am). The hours physically lying on October 21, 2020 are considered as well, because they belong to the working day started on October 20, 2020 and mark the working day starting on October 20, 2020 as full absence. The rule function returns 5 days. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 523 6.5.1.6 Get Absence In Days For Period Based On Working Days For Leave Of Absence Time Types() This rule function calculates the number of absence days during a given duration for the given time types. The calculation considers the work schedule as well as the holiday calendar assigned to the employee. This rule function considers the Approved, Pending, and Pending Cancellation Employee Time statuses for calculating absence days or hours. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. ● You can use this rule function for the time type setting Duration display according to calendar days as well as for work schedule days. ● You can use it to prorate accruals in an accrual rule scenario, or to raise validation errors in Take rules. ● You can specify whether the holiday calendar should be considered or not. Note This rule function returns the result in working days. If you want to see the result in calendar days, you should use the Get Absence In Days For Period Based On Calendar Days() rule function instead. Reduced Scope ● This rule function can only be used for leave for absence time types. ● It cannot get absence days for a period of time longer than one year. ● The start date of the period cannot fall after the end date. Input Parameters For this field Make this entry User ID Select the user for which the absence days should be calcu­ lated. Start Date Enter the start date of the period for which the absence days should be calculated. End Date Enter the end date of the period for which the absence days should be calculated. 524 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management For this field Time Types Make this entry Select time types. These are used to select employee times for calculation. Note Please only use time types with the time type category Absence for this rule function. Otherwise it can lead to errors. Employee Time (optional) This is only necessary if you want to use the rule function in a Take rule. Consider Holidays Specify whether holidays should be taken into account when calculating absence days. Behavior in Case of Errors If the Start Date is greater than the End Date, the rule execution is stopped and an error message is shown. If the value between Start Date and the End Date is greater than 12, the rule execution is stopped and an error message is shown. If the Start Date, End Date, User ID, Consider Holiday, or Time Type is null, the rule execution is stopped and an error message is shown. If you select a time type that is not a Leave of Absence time type, the rule execution is stopped and an error message is shown. Example #1: Using the Rule Function in an Accrual Rule In this example, let's assume we have the following scenario: ● Employee's work schedule: Monday to Friday, 8 hours each day ● Existing absences: ○ October 1st 2019 - October 6th 2019 (Tuesday to Sunday); Time Type = Leave of Absence 1 ○ October 31st 2019 - November 5th 2019 (Thursday to Tuesday); Time Type = Leave of Absence 2 ● Public holiday (full day) on Friday October 3rd 2019 ● Employee does not accrue leave in the accrual period if they take more than a specified number of leave of absence days within that period. You run the rule function with these parameters: ● User ID: Employee's ID ● Start Date: October 1st 2019 ● End Date: October 31st 2019 ● Time Type External Codes: Leave of Absence 1; Leave of Absence 2 Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 525 And you get the following results: ● If you selected Consider Holidays, the result is 5 days. The first leave request is counted in its entirety, but only October 1st 2019 to October 4th 2019 are working days (4 days). From the second leave request, only October 31st 2019 falls within the selection period, and it's a working day (1 day). ● If you didn't select Consider Holidays, the result is 4 days. The first leave request is counted in its entirety, but only October 1st, 2nd, and 4th 2019 are working days (3 days). From the second leave request, only October 31, 2019 is within the selection period, and it's a working day (1 day). Example #2: Using the Rule Function in a Take Rule In this example, we have the following scenario: ● Employee's work schedule: Monday to Friday, 8 hours each day ● Existing absences: ○ October 1st 2019 - October 6th 2019 (Tuesday to Sunday); Time Type = Leave of Absence 1 ○ October 31st 2019 - November 5th 2019 (Thursday to Tuesday); Time Type = Leave of Absence 2 ● Employee Time in creation: December 1st 2019 to December 5th 2019 (Tuesday to Saturday); Time Type = Leave of Absence 1 ● Public holiday (full day) on Friday October 3rd 2019 ● Employee is allowed to take a maximum of 25 days leave in calendar year 2019. You run the rule function with these parameters: ● User ID: Employee's ID ● Start Date: January 1st 2019 ● End Date: December 31st 2019 ● Time Type External Codes: Leave of Absence 1; Leave of Absence 2 ● Employee Time: EmployeeTime And you get the following results: ● If you selected Consider Holidays, the result is 12 days. The first leave request is counted in its entirety, but only October 1st to October 4th 2019 are working days (4 days). From the second leave request, 4 working days are counted. And from the leave request, 4 days are counted (Tuesday to Friday, since Saturday and Sunday are non-working days). ● If you didn't select Consider Holidays, the result is 11 days. The first leave request is counted in its entirety, but only October 1st, 2nd, and 4th 2019 are working days (3 days). From the second leave request, there are 4 working days. And the employee time in creation has 4 working days as well. ● The total number of leave days is less than 25. As such, if you specified that an error message should appear if the number of leave days in a year exceeds 25, no error message will be produced in this case. 526 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.5.1.7 Get Absence in Days For Period with Threshold() This rule function calculates the sum of absence days in a given period for the time types provided where individual Employee Time duration exceeds a given threshold value. The calculation considers the work schedule as well as the holiday calendar assigned to the employee. This rule function considers the Approved, Pending, and Pending Cancellation Employee Time statuses for calculating absence days or hours. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. If an Employee Time does not fall into the rule function period completely, but overlaps, only the days within the period are considered. Please refer to the examples for more details. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. This rule function can carry out this calculation in two different ways based on the value of indicator parameter: ● Count All Days In Range Identify all Employee Times for which absence duration individually exceeds threshold. For all these Employee Times, calculate sum of total absence days in each Employee Time. ● Count Only Days Above Threshold Identify all Employee Times for which absence duration individually exceed threshold. For all these Employee Times, calculate sum of those absence days in each Employee Time which exceed threshold value. This calculation is based on calendar days and does not take into account the work schedule or public holiday calendar as mentioned in employee’s job info. If a one day Employee Time is considered, the number of days is taken from the quantity in days field, meaning 0.5 days for a half day absence. The rule function can be used in the accrual rule for time account types where any accrual to be posted needs to consider the impact of other absences that the employee has taken in the specified time frame. Input Parameters For This Field Make This Entry User ID Select the User field. This is the user for which the absence days should be calculated where each Employee Time has a duration that exceeds the Threshold value. Start Date Start date of duration in which absences are to be consid­ ered for calculation. You can use the start date of accrualRu­ leParameters. End Date End date of duration in which absences are to be considered for calculation. You can use the end date of accrualRulePara­ meters. Threshold This is used to specify the limit that is compared with dura­ tion of each Employee Time to identify whether that Em­ ployee Time needs to be considered for calculation or not. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 527 For This Field Make This Entry Counting Method Specifies whether for each relevant Employee Time whether: total days or only the part that exceeds the threshold value are used for the calculation of total absence days. Possible values are: Time Types ● Count All Days In Range ● Count Only Days Above Threshold Select time types. These are used to select employee times for calculation. Note Please only use time types with the time type category Absence for this rule function. Otherwise it can lead to errors. Examples Example 1 Here is data to calculate the total number of absences that an employee has taken from January 1 to December 31 2015 which were of type leave without pay (LWOP) and unauthorized leave (UNAL) with a duration of more than 5 days for each absence: ● User ID: A.N. Other ● Start Date: January 1, 2015 ● End Date: December 31, 2015 ● Threshold: 5 ● Counting Method: Count All Days in Range ● “LWOP”, “UNAL”. The employee has taken the following absences during 2015: ● Leave without pay from March 2, 2015, to March 10, 2015 (exceeds threshold of 5 days) ● Leave without pay from May 15, 2015, to May, 16, 2015 (does not exceed threshold of 5 days) ● Unauthorized leave from October 1, 2015, to October 15, 2015 (exceeds threshold of 5 days) ● Result 1: Rule function returns 24 because: ○ For the first Employee Time: Threshold of 5 days is exceeded = 9 days ○ For the second Employee Time: Threshold of 5 days is not exceeded = 0 days ○ For third Employee Time: Threshold of 5 days is exceeded = 15 days Example 2 Here is data to calculate the total number of absences that an employee has taken from January 1 to December 31 2015 which were of type leave without pay (LWOP) and unauthorized leave (UNAL) with a duration of more than 5 days for each absence: 528 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management ● User ID: A.N. Other ● Start Date: January 1, 2015 ● End Date: December 31, 2015 ● Threshold: 5 ● Counting Method: Count Only Days Above Threshold ● “LWOP”, “UNAL” The employee has taken the following absences during 2015: ● Leave without pay from March 2, 2015, to March 10, 2015 (exceeds threshold of 5 days) ● Leave without pay from May 15, 2015, to May, 16, 2015 (does not exceed threshold of 5 days) ● Unauthorized leave from October 1, 2015, to October 15, 2015 (exceeds threshold of 5 days) ● Result 2: Rule function returns 14 because: ○ For the first Employee Time: Threshold of 5 days is exceeded by 4 days = 4 days ○ For the second Employee Time: Threshold of 5 days is not exceeded = 0 days ○ For third Employee Time: Threshold of 5 days is exceeded by 10 days = 10 days Example 3 Here is data to calculate the total number of absences that an employee has taken from January 1 to December 31 2015 which were of type leave without pay (LWOP) and unauthorized leave (UNAL) with a duration of more than 5 days for each absence: ● User ID: A.N. Other ● Start Date: January 1, 2015 ● End Date: December 31, 2015 ● Threshold: 5 ● Counting Method: Count Only Days Above Threshold ● “LWOP”, “UNAL” Employee has taken following absences during year 2015: ● Leave without pay from December 28, 2014, to January 10, 2015 (exceeds threshold of 5 days) ● Leave without pay from May 15, 2015, to May, 16, 2015 (does not exceed threshold of 5 days) ● Unauthorized leave from December 28, 2015, to January 10, 2016 (exceeds threshold of 5 days) ● Result 3: Rule function returns 9 because: ○ For the first Employee Time: Threshold of 5 days is exceeded by 5 days within selection period. Days in December 2014 are not considered = 10 days. ○ For the second Employee Time: Threshold of 5 days is not exceeded = 0 days. ○ For third Employee Time: Threshold of 5 days is not exceeded within selection period. Days in January 2016 are not considered = 0 days. Example 4 Here is data to calculate the total number of absences that an employee has taken from January 1 to December 31 2015 which were of type leave without pay (LWOP) and unauthorized leave (UNAL) with a duration of more than 5 days for each absence: ● User ID: A.N. Other ● Start Date: January 1, 2015 ● End Date: December 31, 2015 ● Threshold: 5 Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 529 ● Counting Method: Count All Days In Range ● “LWOP”, “UNAL” Employee has taken following absences during year 2015: ● Leave without pay from December 28, 2014, to January 10, 2015 (exceeds threshold of 5 days) ● Leave without pay from May 15, 2015, to May, 16, 2015 (does not exceed threshold of 5 days) ● Unauthorized leave from December 28, 2015, to January 10, 2016 (exceeds threshold of 5 days) ● Result 4: Rule function returns 10 because: ○ For the first Employee Time: Threshold of 5 days is exceeded by 5 days within selection period. Days in December 2014 are not considered at all = 5 days ○ For the second Employee Time: Threshold of 5 days is not exceeded = 0 days ○ For third Employee Time: Threshold of 5 days is exceeded within selection period. Days in January 2016 are not considered at all = 0 days Example 5: Cross Midnight Here is data to calculate the total number of absences that an employee has taken from July 1 to July 31 2020 which were of type leave without pay (LWOP) and unauthorized leave (UNAL) with a duration of more than 5 days for each absence. The user has a cross-midnight work schedule Monday to Friday 10pm to 6am, Saturday and Sunday are not working days. ● User ID: A.N. Other ● Start Date: July 1, 2020 ● End Date: July 31, 2020 ● Threshold: 5 ● Counting Method: Count All Days in Range ● “LWOP” (Leave without pay), “UNAL” (Unauthorized leave) Employee has taken following absences during July 2020: ● Leave without pay from July 3, 2020 to July 7, 2020, which means the shift starting on July 7, 2020 is included in the absence and the absence ends physically on July 8, 2020 6am (does not exceed threshold of 5 days) ● Leave without pay from July 10, 2020 to July 20, 2020 (exceeds threshold of 5 days) ● Unauthorized leave from July 28, 2020 to August 10, 2020 (does not exceed threshold of 5 days) ● Result 5: Rule function returns 11 because: ○ For the first Employee Time: Threshold of 5 days is not exceeded; July 8, 2020 is not considered because it belongs to July 7th where the shift starts = 0 days ○ For the second Employee Time: Threshold of 5 days is exceeded by 6 days = 11 days ○ For third Employee Time: Threshold of 5 days is not exceeded within selection period = 0 days 6.5.1.8 Get Absence In Hours For Period() This function calculates cumulated absence hours for the given date period and a given time type. The calculation considers the work schedule as well as the holiday calendar assigned to the employee. This rule function considers the Approved, Pending, and Pending Cancellation Employee Time statuses for calculating absence days or hours. For cross midnight absences, the absence is considered based on the working day to which the absence belongs. 530 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management If the time type is relevant for leave of absence, the rule function returns 0 hours because leave of absence calculation is only based on calendar days. If it is a flexible requesting time type based on unit days, the rule function returns 0 hours. Note ● If you use this rule function in a take rule and the time type of the employee time triggering the take rule is the same as the rule function time type, the employee time that triggers the rule is not considered because it is not yet saved. ● If an employee time is edited, the absence in hours from the existing employee time is covered. You can subtract that existing employee time quantity in hours later and add the result of the current employee time. ● If no start date or end date is specified, the return is 0. Input Parameters For This Field Make This Entry User ID Select the User field. This is the user for which the absence hours should be calculated. Time Type External Code Enter the time type external code the rule should be exe­ cuted for. Start Date Period start date End Date Period end date Examples Let’s look at some examples. Example 1 Here’s the data for A.N.Other’s absence calculation. User ID: A.N. Other Time Type External Code: Enter text "SPECIAL LEAVE". Start Date = October 1, 2017 End Date = October 31, 2017 Prerequisites: User A.N. Other has a work schedule: Monday - Friday 8 hours, Saturday and Sunday 0 hours. He also has a holiday calendar with October 3, 2017 marked as a full holiday. Result Taken Leave of Type "SPECIAL LEAVE" ● October 1, 2017 – October 4, 2017 => 16 hours because October 1st, 2017 is a Sunday with 0 working hours and October 3rd, 2017 is a full holiday with 0 working hours. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 531 ● October 31, 2017 – November 4, 2017 => 8 hours within October. ● The rule function returns 24 hours. Example 2 Cross Midnight Here’s the data for A.N.Other’s absence calculation. User ID: A.N. Other Time Type External Code: Enter text "SPECIAL LEAVE". Start Date = October 1, 2020 End Date = October 20, 2020 Prerequisites: User A.N. Other has a work schedule: Monday - Friday 8 hours from 10pm to 6am (next day), Saturday and Sunday 0 hours. He also has a holiday calendar with October 3, 2020 marked as a full holiday. Result Taken Leave of Type "SPECIAL LEAVE" ● September 30, 2020 – October 1, 2020 (in detail September 30, 2020 10pm until October 2, 2020 6am, which belongs to the working day October 1, 2020)=> 8 hours, because only the working day starting on October 1st is considered, which is October 1, 2020 10pm until October 2, 2020 6am. October 1 midnight until 6am belongs to the working day starting on September 30, 2020 and is not considered here. ● October 20, 2020 – October 22, 2020 (in detail October 20, 2020 10pm until October 23, 2020 6am) => 8 hours within selection period (October 20, 2020 10pm until October 21, 2020 6am). The hours physically lying on October 21, 2020 are considered as well because they belong to the working day starting on October 20, 2020. ● The rule function returns 16 hours. 6.5.1.9 Get Absence In Hours For Period For Time Types() This function calculates the cumulated absence hours for the given duration and given time types. The calculation considers the work schedule as well as the holiday calendar assigned to the employee. This rule function considers the Approved, Pending, and Pending Cancellation Employee Time statuses for calculating absence days or hours. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. Regardless of the unit used in the time type (hours or days), the rule function returns the absence in hours. If the time type is relevant for leave of absence, the rule function returns 0 hours because leave of absence calculation is only based on calendar days. For the calculation the quantity in hours field on the Employee Time and Employee Time Calendar is considered. The calculation is based on the employee's work schedule and holiday calendar. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. 532 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Input Parameters For This Field Make This Entry User ID Select the User field. This is the user for which the start time of the working day should be calculated. Start Date Duration start date. End Date Duration end date. Employee Time The employee time is only necessary if you use the rule func­ tion in a take rule. This should be the employee time being modified or created when the take rule is triggered. Time Types Select time types. These are used to select employee times for calculation. Note Please only use time types with the time type category Absence for this rule function. Otherwise it can lead to errors. Use Case 1: Accrual Rule This rule function can be used in the accrual rule for a time account type where the accrual to be posted needs to consider the impact of other absences (like leave without pay) the employee has taken in a specified time frame. For example, this rule function can be used to calculate the total number of absences that employee has taken from January 1, 2016, to December 31, 2016, which were of type leave without pay and unauthorized leave. Examples Here is data to calculate the total number of days of leave without pay (time type: LWOP) and unauthorized leave (time type: UNAL) during the year 2016 during accrual rule processing: User ID: A.N. Other Start Date = January 1, 2016 End Date = December 31, 2016 Time Types: “LWOP”, “UNAL” Work schedule pattern : Monday to Friday are working days of 8 hours each. Example Details 1: Existing Employee Times October 3, 2016 – October 5, 2016 Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 533 Result 1: The rule function returns 24 hours. Example Details 2: Existing Employee Times No employee times. Result 2: The rule function returns 0 hours. Example Details 3: Existing Employee Times ● February 15, 2016 - February 16, 2016 (16 hours) ● December 30, 2016 - January 10, 2017 (8 hours) Result 3: The rule function returns 24 hours. Use Case 2: Take Rule This rule function can be used in a take rule to check whether someone is allowed to apply for or modify the absence. For example, the rule function can be used to calculate absence in terms of total number of working hours that the employee has taken from January 1, 2016, to December 31, 2016, which were of type leave without pay and unauthorized leave. If these leaves exceed a specific number, for example 20 hours, then the employee cannot create the absence record for future leave. The processing action (Create, Edit, Cancel) is part of the take rule parameters. Depending on this action, you can use the rule function to get the current number of calendar days, taken by the time type of the current employee time. If the action is Create or Edit, forward the employee time to the rule function. In the case of Cancel, it does not make sense to call the rule function at all. Examples Here's the data to calculate total number of days taken of Time Type: Vacation during the year 2016: User ID: A.N. Other Start Date = January 1, 2016 End Date = December 31, 2016 Time Types: “Vacation” Results Example Details 1: ● Existing Employee Time: October 1, 2016 – October 31, 2016 ● Created Employee Time: November 1, 2016 - November 2, 2016 Result 1: The rule function returns 32 hours. Depending on this result, an error can be thrown to avoid the creation of the employee time. Example Details 2: ● Existing Employee Time: October 1, 2016 – October 31, 2016 ● Existing Employee Time will be updated: November 1, 2016 - November 2, 2015 534 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Result 2: The rule function returns 16 days. Depending on this result, an error can be thrown to avoid the creation of the employee time. Example Details 3: ● Existing Employee Time: February 15, 2016 - February 17, 2016 (27 days) ● Existing Employee Time: December 30, 2016 - January 10, 2017 (8 hours in 2016) ● Created Employee Time: November 1, 2016 - November 2, 2016 (16 hours) Result 3: The rule function returns 51 hours. Depending on this result, an error can be thrown to avoid the creation of the employee time. Example 4: Cross Midnight: Here’s the data for A.N.Other’s absence calculation. User ID: A.N. Other Time Type External Code: Enter text "SPECIAL LEAVE". Start Date = October 1, 2020 End Date = October 20, 2020 Prerequisites: User A.N. Other has a cross-midnight work schedule: Monday - Friday 8 hours from 10pm to 6am (next day), Saturday and Sunday 0 hours. He also has a holiday calendar with October 3, 2020 marked as a full holiday. Result Taken Leave of Type "SPECIAL LEAVE" ● September 30, 2020 – October 1, 2020 (in detail September 30, 2020 10pm until October 2, 2020 6am, which belongs to the working day October 1, 2020)=> 8 hours, because only the working day starting on October 1 is considered, which is October 1, 2020 10pm until October 2, 2020 6am. October 1 midnight until 6am belongs to the working day starting on September 30, 2020 and is not considered here. ● October 20, 2020 – October 22, 2020 (in detail October 20, 2020 10pm until October 23, 2020 6am)=> 8 hours within selection period (October 20, 2020 10pm until October 21, 2020 6am). The hours physically lying on October 21, 2020 are considered as well because they belong to the working day starting on October 20, 2020. The rule function returns 16 hours. 6.5.1.10 Get Completed Months Of Time Types In Period() This rule function calculates the number of complete months for which the employee was absent in a given period for the time types provided. The calculation is based on full calendar months covered during the absence and does not include partial months. The rule function can be used in accrual rules for time account types where the accrual to be posted needs to consider the impact of other absences including full months that an employee has taken in the specified time frame. Each absence is considered separately and a month is only counted if it is fully covered by one absence. Please refer to the second example for more details. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs to. Please refer to the third example for more details. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 535 Input Parameters For This Field Make This Entry User ID Select the User field. This is the user for which the total num­ ber of absence days should be calculated. Start Date First day of duration in which absences are to be considered for calculation. You can use the start date of accrualRule­ Parameters. End Date Last day of duration in which absences are to be considered for calculation. You can use the end date of accrualRulePara­ meters. Time Types Select time types. These are used to select employee times for calculation. Note Please only use time types with the time type category Absence for this rule function. Otherwise it can lead to errors. Examples Example 1 Here is data to calculate number of complete months covered by leave without pay leave (Time Type: LWOP) and unauthorized leave (Time Type: UNAL) during year 2015 during accrual rule processing: User ID: A.N. Other Start Date = January 1, 2015 End Date = December 31, 2015 Time Types: “LWOP”, “UNAL” Example Details 1 The employee has taken the following absences during 2015: ● Leave without pay from February 1, 2015, to March 16, 2015. ● Leave without pay from April 3, 2015, to May 4, 2015. ● Unauthorized leave from September 28, 2015, to December 12, 2015. Result 1: The rule function returns 3 because February, October and November months are fully covered by absences of time types LWOP and UNAL. March, April, May, September and December months have absences of time types LWOP and UNAL, but these absences do not cover these months fully. Example Details 2 The employee has taken the following absences during 2015: 536 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management ● Leave without pay from February 1, 2015, to March 16, 2015. ● Leave without pay from March 17, 2015, to March 31, 2015. Result 2: The rule function returns 1 because each Employee Time is considered separately. This means that March is not covered fully. Example 3: Cross Midnight Here is data to calculate the number of complete months covered by leave without pay leave (Time Type: LWOP) and unauthorized leave (Time Type: UNAL) during year 2020 during accrual rule processing: User ID: A.N. Other Start Date = January 1, 2020 End Date = December 31, 2020 Time Types: “LWOP”, “UNAL” Prerequisites: User A.N. Other has a cross-midnight work schedule. Monday to Friday he is working from 10 p.m. to 6 a.m. Saturday and Sunday are non working days. Example Details 3: The employee has taken the following absences during 2020: ● Leave without pay from February 20, 2020 (10 p.m.), to March 30, 2020 (this absence includes the shift starting on March 30, means physically the absence ends on March 31 at 6 a.m.) ● Unauthorized leave from April 1, 2020 (10 p.m.), to May 4, 2020. Result 3: The rule function returns 1 because only April is fully covered by time type UNAL. Although there is a part of the working day for April for midnight until 6am, which is not covered by the absence, the month is completely counted because this part belongs to the day the shift starts on - March 31, 2020). March is not fully covered because March 31, 2020 is not part of the first absence request. 6.5.1.11 Get Number of Absences for Period for Time Types() This function calculates the number of absences of a list of time types within a given period. An absence is also considered if it overlaps partially with the given period. For cross midnight absences, the absence is considered based on the working day to which the absence belongs. Input Parameters For This Field Make This Entry User Select the User field. This is the user for which the number of absences is calculated. Start Date Select period start date. End Date Select period end date. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 537 For This Field Time Types Make This Entry Select time types. These are used to select employee times for calculation. Note Please only use time types with the time type category Absence for this rule function. Otherwise it can lead to errors. Examples Let's look at some examples. Example 1 User: A.N. Other Start Date: January 1, 2017 End Date: December 31, 2017 Time Types: Vacation; Sickness Existing Absences for this user: ● December 20, 2016 – January 1, 2017; Time Type = Sickness ● May 1, 2017 – May 5, 2017; Time Type = Special Leave ● June 1, 2017 – June 10, 2017; Time Type = Vacation Result The number of absences is 2. The Sickness absence is counted because it overlaps with the period and the time type is part of the time types list. The Vacation absence is counted because it is completely within the period and the time type is part of the time types list. The Special Leave is not counted because it is not part of the time types list. Example 2: Cross Midnight User: A.N. Other Start Date: July 1, 2020 End Date: July 31, 2020 Time Types: Vacation; Sickness Prerequisites: User A.N. Other has a cross midnight work schedule. He is working Monday to Friday from 10pm to 6am. Saturday and Sunday are non working days. 538 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Existing Absences for this user: ● June 15, 2020 - June 30, 2020 (in detail June 15, 2020 10pm to July 1, 2020 6am); Time Type = Sickness ● July 3, 2020 - July 3, 2020 (in detail July 3, 2020 10pm to July 4, 2020 6am); Time Type = Special Leave ● July 30, 2020 - August 30, 2020 (in detail July 30, 2020 10pm to August 31, 2020 6am); Time Type = Vacation Result The number of absences is 1. The Sickness absence is not counted because it does not overlap with the period. Although the absence ends on July 1, 2020 6am, this belongs to the shift starting on June 30, 2020 and is not counted. The Vacation absence is counted because it overlaps with the period and the time type is part of the time types list. The Special Leave is not counted because it is not part of the time types list. 6.5.1.12 Has Absences In Period() This rule function returns whether any active absences exist in a given period or after a given start date. For cross-midnight absences, the absence is considered based on the working day to which the absence belongs. Input Parameters For this parameter... Make this entry: User ID User ID for which active absences have to be checked. Start Date Enter a start date. Example: Termination date. End Date (optional) Enter an end date if you would like to. Time Types (optional) Enter one or more time types for which active absences have to be checked. Active absen­ ces are absences with status Pending, Pending Cancellation, and Approved. You can only en­ ter time types classified as Absence time types. If you do not enter any time types, all ab­ sences will be checked. Examples Let's look at some examples. Example 1: Overlapping Absence A.N. Other's data looks like this: ● User ID: A.N.Other ● Start Date: November 5, 2014 Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 539 ● End Date: Empty ● Time Type External Code: Empty Prerequisites: A.N.Other has a work schedule. He works Monday to Friday from 8am to 5pm. Saturday and Sunday are non-working days. Existing absences for this user: ● October 1, 2014 - October 4, 2014: Time Type - Vacation ● October 31, 2014 - November 5, 2014: Time Type - Vacation Result: The result is Yes, because the second Employee Time overlaps with the rule function period. Example 2: No Absence A.N. Other's data looks like this: ● User ID: A.N.Other ● Start Date: October 5, 2014 ● End Date: October 10, 2014 ● Time Type External Code: Empty Prerequisites: A.N.Other has a work schedule. He works Monday to Friday from 8am to 5pm. Saturday and Sunday are non-working days. Existing absences for this user: ● October 1, 2014 - October 4, 2014: Time Type - Vacation ● October 31, 2014 - November 5, 2014: Time Type - Vacation Result: The result is No, because no Employee Time overlaps with the rule function period. Example 3: Cross Midnight with Overlapping Absence A.N. Other's data looks like this: ● User ID: A.N.Other ● Start Date: July 1, 2020 ● End Date: July 31. 2020 ● Time Types: Vacation, Sickness Prerequisites: A.N.Other has a cross-midnight work schedule. He works Monday to Friday from 10pm to 6am. Saturday and Sunday are non-working days. Existing absences for this user: ● June 15, 2020 - June 30, 2020 (in detail June 15, 2020, 10pm, to July 1, 2020, 6am): Time Type = Sickness ● July 3, 2020 - July 3, 2020 (in detail July 3, 2020, 10pm, to July 4, 2020 6am): Time Type = Special Leave ● July 30, 2020 - August 30, 2020 (in detail July 30, 2020, 10pm to August 31, 2020, 6 am): Time Type = Vacation Result ● The number of absences is 1. ● The Sickness absence is not counted because it does not overlap with the period. Although the absence ends on July 1, 2020 6am, this belongs to the shift starting on June 30, 2020 and is not counted. ● The Vacation absence is counted because it overlaps with the period and the time type is part of the time types list. 540 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management ● The Special Leave is not counted because it is not part of the time types list. 6.5.1.13 Is Consecutive Limit for Time Type Reached() This function returns whether the limit of consecutive days or hours has already been reached considering the current (created, edited) employee time. Here's a sample use case: the employee should not be allowed to take more than 3 consecutive days of sick leave. The function is able to identify consecutive days also if there are multiple employee times created - for example, one for each day. The rule function supports changes to the work schedule if the work schedule change is within the consecutive employee times. And it works for both days and hours. You can simply enter the quantity in the unit that is relevant for your time type. If you choose Work Schedule as a basis, the rule function checks the next and previous working days, based on the work schedule and considering holidays. If you choose Calendar Days as a basis, the rule function checks the next and previous calendar days. In the case of a partial day absence, the rule function behaves differently depending on whether the employee times are based on duration or clock times. Duration-based half day absences are always considered if there is a second absence before or after to ensure that the limit is not exceeded. On the other hand, for clock-time based half day absences the absence is considered based on the work schedule, which shows if there is a gap the employee is working on or not. Please see example 9 for more details. Restriction ● The function is not supported for flexible requesting. ● The function is not supported for situations where the time type is based on hours and the rule function is based on calendar days. ● The function cannot count further than one month from the end date of a new Employee Time, or one month backwards from the start date of a new Employee Time. Input Parameters For this parameter Make this entry Employee Time Enter the employee time created or changed. Based On Decide how the consecutive days should be identified. If you choose calendar days, non-working days are considered as well and no holidays are considered. If you choose work schedule, only working days based on work schedule are considered, as well as holidays. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 541 For this parameter Make this entry Limit Enter a limit quantity here in the same unit as the corre­ sponding time type in the employee time. Examples: 3 (days) or 24 (hours). Details And Examples Defining Behavior for Employee Times Based On Durations ● Example 1A Maximum 3 consecutive days (based on work schedule). Employee Times on the database are employee times of the same time type as the requested one. If you request a full-day employee time, the rule functions checks all previous working days and nonworking days and sums up the working days until there is a working day which has some open booking quantity. Likewise, it processes all subsequent working days and non-working days in the same fashion. Finally, it sums up both these numbers. Result: Employee Time creation is not allowed because 3 consecutive working days (Friday, Monday, and Tuesday) are already booked. ● Example 1B Maximum 3 consecutive days (based on calendar days). Employee Times on the database are employee times of the same time type as the requested one. If you request a full-day employee time, the rule function checks all previous calendar days and sums them up until there is a calendar day which has some open booking quantity. Likewise, it processes all subsequent calendar days in the same fashion. Finally, it sums up both these numbers. 542 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Result: Employee Time creation is allowed because only 2 consecutive calendar days (i.e. Monday and Tuesday) are already booked. ● Example 1C Maximum 4 consecutive days (based on work schedule). Employee Times on the database are employee times of the same time type as the requested one. One single Employee Time on the database which encloses non-working days. Every non-working day enclosed counts as zero days when based on work schedule. Result: The creation of new employee time is allowed because the number of consecutive working days already booked are is only 3 days (i.e. Friday, Monday, and Tuesday). So here it sums up Tuesday, Monday and Friday and therefore it is still allowed to create a new employee time. ● Example 1D One single Employee Time on the database which encloses non-working days. Every non-working day enclosed counts as one day when based on calendar days.Maximum 4 consecutive days (based on calendar days). Employee Times on the database are employee times of the same time type as the requested one. Result: The creation of new employee time is not allowed because the number of consecutive calendar days already booked are 5 days. ● Example 2 Maximum 3 consecutive days (based on work schedule days). Employee Times on the database are employee times of the same time type as the one requested. Result: Employee Time creation is not allowed because this employee time would connect Tuesday and Thursday and the sum of days would be 4. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 543 ● Example 3 Maximum 3 consecutive days (based on work schedule). Employee Times on the database are employee times of the same time type as the one requested. ResultMaximum 4 consecutive days (based on: Employee Time creation is allowed because Wednesday is not fully booked and therefore the rule function does not consider Thursday. The sum of consecutive days is 2.5. ● Example 4 Maximum 3 consecutive days (based on work schedule). Employee Times on the database are employee times of the same time type as the one requested. Result: Employee Time creation is not allowed because the sum of employee times would be 3.5 days. ● Example 5 Maximum 3 consecutive days (based on work schedule). Employee Times on the database are employee times of the same time type as the one requested. If you request a half-day employee time, the rule function checks all previous working days and sums them up until there is a working day with an open booking quantity. It also sums up all next working days until there is a working day with an open booking quantity. 544 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Result: Employee Time creation is allowed. Adding the half-day employee time to the previous working days produces a result of 2.5 and adding it to the next working days produces a result of 1.5. Both these numbers are less than the permitted maximum of 3. ● Example 6 Maximum 3 consecutive days (based on work schedule) with half-day holiday. Employee Times on the database are employee times of the same time type as the one requested. If you request a half-day employee time and there is already another half day holiday on same day, the day is fully booked and previous and next working days with same time type will be added together. Result: Employee Time cannot be saved. Wednesday is fully booked because only half a day is open as the rest of the day is taken up with a half-day holiday. So previous and next working days are added up. The total is 3.5, which is above the limit. ● Example 7 Maximum 3 consecutive days (based on work schedule) with half-day employee time on same day. Employee times on the database are employee times of the same time type as the one requested. Result: Employee Time cannot be booked. There is already another half day employee time of the same time type on that day (Wednesday). Therefore, next and previous working days are summed up, which is 4 and above the limit. ● Example 8 Maximum 2.5 consecutive days (based on calendar days) with half-day holiday on one of the days and single employee time record spanning 3 days. Employee times on the database are employee times of the same time type as the one requested. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 545 Result: Employee time can be booked because it sums up 2.5 consecutive calendar days which is equal to the limit of 2.5 days. The behavior is same if the rule is based on work schedule. ● Example 9 Maximum 3 consecutive days (based on calendar days) with half-day employee time. Employee times on the database are employee times of the same time type as the one requested. Result: Employee Time cannot be booked. There is a two day Employee Time already on Sunday and Monday as well as a half day Employee Time already on Saturday. As the employee is a duration-based employee, it is not specified, where exactly the half day Employee Time is taken. Therefore it is considered and there are already 2.5 days taken, which means another full day on Tuesday is not allowed. Defining Behavior for Employee Times Based On Clock Times Full-day bookings are handled in the same way as duration-based employee times, so examples 1A, 1B, and 2 work for clock times too. However, half day holidays are not possible for a clock time employee, which means that example 6 cannot apply. To define consecutive clock times, the rule function identifies those employee times that are directly after each other based on their start and end times. The employee time is at the beginning of a day if the start time is the same as the start time defined in the corresponding work schedule for that specific day. The same is true for end time. ● Example 1 Maximum 14 consecutive hours allowed (based on work schedule). Employee Times on the database are employee times of the same time type as the one requested. 546 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Result: Employee Time can be saved because the end time (16:00) is not the end time of the work schedule (18:00) on Monday. This means that the employee time is not consecutive to the employee time on Tuesday. ● Example 2 Maximum 14 consecutive hours are allowed (based on work schedule). Employee Times on the database are employee times of the same time type as the one requested. Result: Employee Time cannot be saved because based on work schedule the start time (08:00) on Wednesday is consecutive to the end time of the employee time (18:00) on Tuesday and the sum is 16 consecutive hours. ● Example 3 Maximum 14 consecutive hours are allowed (based on work schedule). Employee Times on the database are employee times of the same time type as the one requested. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 547 Result: Employee Time can be saved because based on work schedule the start time (10:00) on Wednesday is not consecutive to the start time of work schedule (08:00) on Wednesday. Also, the end time (14:00) is not consecutive to the end time of the work schedule (18:00) on Wednesday. So, the requested employee time record is not consecutive to the work schedule on that day. 6.5.2 Rule Functions depending on Working Time 6.5.2.1 Get End Time Of Working Day () This function calculates the end time of the working day on a given date. It reads the work schedule associated with the user to calculate the end time of the date provided to the rule function. The rule function returns a value in 24 hour clock format. If the user applied for time off using clock times, you can use this rule function for specific validation against the end of the day. This is typically done in a take rule (absence validation rule) that you can set to be triggered when absence is created or modified. For cross-midnight working days, the returned end time is on the next calendar day. Please refer to the crossmidnight example below. The rule function returns null if: ● A duration-based work schedule is assigned to the user on the requested date. ● The requested date is a non-working day. Input Parameters For this parameter: Make this entry: User Select the User field. This is the user for which the end time of working day should be calcu­ lated. 548 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management For this parameter: Make this entry: Date Date for which the end time is required Example 1 - Non-Cross-Midnight Work Schedule Let's look at an example. Here’s the data for A.N.Other’s end time calculation: ● User ID: A.N. Other ● Date: Wednesday, July 1, 2020 Prerequisites: User A.N.Other should have the Clock Times time recording variant. The work schedule is configured with Monday to Friday as working days, from 08:00 to 17:00. Saturday and Sunday are non-working days. Result: The rule function returns an end time of 17:00:00. Example 2: Cross-Midnight Work Schedule This time, A.N Other's information looks like this: ● User ID: A.N.Other ● Date: Monday, July 6, 2020 Prerequisites: User A.N.Other should have the Clock Times time recording variant. The work schedule is configured with Monday to Friday as working days, from 22:00 to 06:00. Saturday and Sunday are nonworking days. Result: The rule function returns an end time of 06:00:00, which is physically Saturday morning, but belongs to the shift that starts on Friday. 6.5.2.2 Get Next Working Day() This function determines the next working day for a user and a specific date. Overview The calculation is based either on work schedule only or on work schedule and holiday calendar. The function tries to find the next working day within the next 365 days starting from the input date. In the case of a crossmidnight work schedule, the day the shift starts is defined as a working day. If there is no next working day, the function returns “null”. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 549 The following constellations lead to “null” as the return value: ● The employee has no work schedule assigned in the future. ● The employee has a work schedule assigned, but the work schedule has no working days. Input Parameters For this parameter User ID Make this entry Select the User field. This is the user for which the next working day will be determined. Date Select a date, which is used as a basis to determine the next working day. Consider Holidays Choose whether holidays should be considered or not. If hol­ idays are not considered, the next working date is deter­ mined based on the work schedule. If holidays are consid­ ered, the next working day is determined based on the work schedule and holiday calendar. If the day is a working day in the work schedule and there is no holiday, a none holiday, or a half-day holiday, the day is a working day. If the day is not a working day in the work schedule or there is a full holiday on that day, it is a non-working day. Example 1: Non-Cross-Midnight Work Schedule and Holidays Not Considered Let's look at an example. A.N.Other was hired on January 1, 2015 with a duration-based work schedule based on 8 hours working time Monday - Friday. Saturday and Sunday are days off. There is a public full day holiday on May 4, 2015. Here's the data used to determine A.N. Other's next working day: ● User ID: A.N.Other ● Date: May 1, 2015 ● Consider Holidays: No Result 1: May 1, 2015 is a Friday. The employee is not working on the next 2 days. so the function returns the next Monday as the next working day: May 4, 2015, because holidays are not considered. Example 2: Non-Cross-Midnight Work Schedule and Holidays Considered Here's another example. 550 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management A.N.Other was hired on January 1, 2015 with a duration-based work schedule based on 8 hours working time Monday till Friday and Saturday and Sunday as days off. There is a public full day holiday on May 4, 2015. Here's the data used to determine A.N. Other's next working day: ● User ID: A.N.Other ● Date: May 1, 2015 ● Consider Holidays: Yes Result 2: May 1, 2015 is a Friday. The employee is not working the next 2 days and the next working day is actually a public holiday, so the function returns Tuesday as the next working day: May 5, 2015. Example 3: Cross-Midnight Processing and Holidays Not Considered Now we'll look at an example where cross-midnight processing is active. A.N. Other was hired on January 1, 2015, with a cross-midnight work schedule with working time MondayFriday 22:00 - 06:00 (next day). Saturday and Sunday are days off. There is a public full day holiday on May 4, 2015. Here's the data used to determine A.N.Other's next working day: ● User: A.N.Other ● Date: May 1, 2015 ● Consider Holidays: No. Result 3: May 1, 2015, is a Friday. Saturday is not counted as a working day because the working hours 00:00 to 06:00 belong to the shift started on Friday. The employee is not working on the next 2 days (Saturday and Sunday), so the function returns Monday, May 4, 2015 as the next working day because holidays are not considered. Example 4: Cross-Midnight Processing and Holidays Considered Here's another example. A.N. Other was hired on January 1, 2015, with a cross-midnight work schedule with working time MondayFriday 22:00 - 06:00 (next day). Saturday and Sunday are days off. There is a public full day holiday on May 4, 2015. Here's the data used to determine A.N.Other's next working day: ● User: A.N.Other ● Date: May 1, 2015 ● Consider Holidays: Yes. Result 4: May 1, 2015, is a Friday. Saturday is not counted as a working day because the working hours 00:00 to 06:00 belong to the shift started on Friday. The employee is not working on the next 2 days (Saturday and Sunday). The next working day would be Monday, but, as this is a public holiday, the function returns Tuesday, May 5, 2015. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 551 6.5.2.3 Get Number Of Working Days Or Hours For Period() This rule function returns the number of days or hours for an employee in a given period. To calculate this, the work schedule assigned to the employees job information is considered as well as temporary changes. You can choose whether holidays should be considered or not. In the case of a cross-midnight work schedule, a working day is determined as the day on which the working time starts. If Hours is used as a parameter, all hours belonging to this working day are added together. Take a look at the cross-midnight examples, Input Parameters For this parameter Make this entry User Enter the user ID. Start Date Enter the start date End Date Enter the end date. Time Unit Select whether the rule function should return the quantity in hours or days. Consider Holidays Select whether holidays are considered or not. Examples with Non-Cross-Midnight Work Schedules Prerequisites ● A.N.Other has a work schedule based on duration, with 8 hours working time configured Monday to Friday. Saturday and Sunday are non-working days. ● A.N.Other's holiday calendar includes a full day public holiday on Monday, May 4, 2020, and a half day holiday on Wednesday, June 3, 2020. Example 1: Full day holiday is not considered. ● User: A.N.Other ● Start Date: Monday, May 4, 2020 ● End Date: Sunday, May 10, 2020 ● Time Unit: Hours ● Consider Holidays: No Result 1: The rule function returns 40 hours. May 4 counts because holidays are not considered. Saturday and Sunday are not working days at all. Example 2: Full day holiday is considered. 552 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management ● User: A.N.Other ● Start Date: Monday, May 4, 2020 ● End Date: Sunday, May 10, 2020 ● Time Unit: Hours ● Consider Holidays: Yes Result 2: The rule function returns 32 hours. May 4 doesn't count because it is a public holiday. Saturday and Sunday are not working days at all. Example 3: Full day holiday is not considered. ● User: A.N.Other ● Start Date: Monday, May 4, 2020 ● End Date: Sunday, May 10, 2020 ● Time Unit: Days ● Consider Holidays: No Result 3: The rule function returns 5 days. May 4 counts as a full day because holidays are not considered. Saturday and Sunday are not working days at all. Example 4: Full day holiday is not considered. ● User: A.N.Other ● Start Date: Monday, May 4, 2020 ● End Date: Sunday, May 10, 2020 ● Time Unit: Days ● Consider Holidays: Yes Result 4: The rule function returns 4 days. May 4 doesn't count because holidays are considered. Saturday and Sunday are not working days at all. Example 5: Half day holiday is not considered. ● User: A.N.Other ● Start Date: Monday, June 1, 2020 ● End Date: Sunday, June 7, 2020 ● Time Unit: Hours ● Consider Holidays: No Result 5: The rule function returns 40 hours. June 3 counts because holidays are not considered. Saturday and Sunday are not working days at all. Example 6: Half day holiday is considered. ● User: A.N.Other ● Start Date: Monday, June 1, 2020 ● End Date: Sunday, June 7, 2020 ● Time Unit: Hours ● Consider Holidays: Yes Result 6: The rule function returns 36 hours. June 3 counts as a half day because it is half day holiday and 4 hours are not considered. Saturday and Sunday are not working days at all. Example 7: Half day holiday is not considered. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 553 ● User: A.N.Other ● Start Date: Monday, June 1, 2020 ● End Date: Sunday, June 7, 2020 ● Time Unit: Days ● Consider Holidays: No Result 7: The rule function returns 5 days. June 3 counts because holidays are not considered. Saturday and Sunday are not working days at all. Example 8: Full day holiday is not considered. ● User: A.N.Other ● Start Date: Monday, June 1, 2020 ● End Date: Sunday, June 7, 2020 ● Time Unit: Days ● Consider Holidays: Yes Result 8: The rule function returns 4.5 days. June 3 counts as a half day because holidays are considered and 0.5 days are deducted. Saturday and Sunday are not working days at all. Examples with Cross-Midnight Work Schedules Prerequisites ● A.N.Other has a work schedule based on clock times, with 8 hours working time from 22:00 to 06:00 (next day) configured Monday to Friday. Saturday and Sunday are non-working days. ● A.N.Other's holiday calendar includes a full day public holiday on Monday, May 4, 2020. Half day holidays are not supported for employees with work schedules based on clock times. Example 1: Full day holiday is not considered. ● User: A.N.Other ● Start Date: Wednesday, May 6, 2020 ● End Date: Saturday, May 9, 2020 ● Time Unit: Days ● Consider Holidays: No Result 1: The rule function returns 3 working days (Wednesday, Thursday, Friday). Although the employee is physically working on Saturday (00:00 to 06:00), Saturday is not counted. A day is defined as a working day if the start time of the shift is on that day. Holidays are not considered, so May 6 is counted as well. Example 2: Full day holiday is considered. ● User: A.N.Other ● Start Date: Wednesday, May 6, 2020 ● End Date: Saturday, May 9, 2020 ● Time Unit: Days ● Consider Holidays: Yes Result 2: The rule function returns 2 working days (Thursday, Friday). Although the employee is physically working on Saturday (00:00 to 06:00), Saturday is not counted. A day is defined as a working day if the start time of the shift is on that day. Holidays are considered, so May 6 is not counted. 554 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Example 3: Full day holiday is not considered. ● User: A.N.Other ● Start Date: Wednesday, May 6, 2020 ● End Date: Friday, May 8, 2020 ● Time Unit: Hours ● Consider Holidays: No Result 3: The rule function returns 24 working hours (Wednesday 22:00-06:00, Thursday 22:00-06:00, Friday 22:00-06:00). Although the employee is physically working on Saturday (00:00 to 06:00), those hours are considered as being on Friday because the shift starts on that day. Holidays are not considered, so May 6 is counted as well. Example 4: Full day holiday is considered. ● User: A.N.Other ● Start Date: Wednesday, May 6, 2020 ● End Date: Saturday, May 9, 2020 ● Time Unit: Days ● Consider Holidays: Yes Result 4: The rule function returns 16 working hours (Thursday 22:00-06:00, Friday 22:00-06:00). Although the employee is physically working on Saturday (00:00 to 06:00), those hours are considered as being on Friday because the shift starts on that day. Holidays are considered, so May 6 is not counted. 6.5.2.4 Get Previous Working Day() This rule function determines the previous working day for a user and a specific date. Overview The calculation is based either on work schedule only or on work schedule and holiday calendar. The function tries to find the last working day within the last 365 days starting from the input date.In the case of a crossmidnight working day, the day on which the shift starts is defined as a working day. If there is no previous working day, the function returns “null”. The following constellations lead to “null” as the return value: ● There is no job information in the past. ● There is job information in the past, but no work schedule is assigned. ● There is a job information in the past with a work schedule, but the work schedule has no working days. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 555 Input Parameters For this parameter Make this entry User ID Select the User field. This is the user for which the previous working day will be determined. Date Select a date, which is used as a basis to determine the pre­ vious working day. Consider Holidays Choose whether holidays should be considered or not. If hol­ idays are not taken into account, the previous working date is determined based on the work schedule. If holidays are taken into account, the previous working day is determined based on the work schedule and holiday calendar. If the day is a working day in the work schedule and there is no holiday, a none holiday, or a half-day holiday, the day is a working day. If the day is not a working day in the work schedule or there is a full holiday on that day, it is a non-working day. Example 1: Non-Cross Midnight Work Schedule and Holidays Not Considered Let's look at an example. A.N.Other was hired on January 1, 2015 with a duration-based work schedule based on 8 hours working time Monday till Friday and Saturday and Sunday as days off. There is a public full day holiday on February 27, 2015. Here's the data used to determine A.N. Other's previous working day: ● User ID: A.N.Other ● Date: March 1, 2015 ● Consider Holidays: NO Result 1: March 1, 2015 is a Sunday. The employee is not working on the previous day – February 28, 2015 – which is a Saturday. Therefore the function returns the previous Friday as previous working day: February 27, 2015, because holidays are not considered. Example 2: Non-Cross Midnight Work Schedule and Holidays Considered Here's another example. A.N.Other was hired on January 1, 2015 with a duration-based work schedule based on 8 hours working time Monday till Friday and Saturday and Sunday as days off. There is a public full day holiday on February 27, 2015. Here's the data used to determine A.N. Other's previous working day: ● User ID: A.N.Other 556 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management ● Date: March 1, 2015 ● Consider Holidays: YES Result 2: March 1, 2015 is a Sunday. The employee is not working on the previous day – February 28, 2015 – which is a Saturday. On the next previous day there is a public holiday, so the function returns Thursday as previous working day: February 26, 2015. Example 3: Cross-Midnight Work Schedule and Holidays Not Considered Let's look at an example. A.N.Other was hired on January 1, 2015 with a cross-midnight work schedule with working time Monday Friday 22:00 - 06:00 (next day). Saturday and Sunday are days off. There is a public full day holiday on May 4, 2015. Here's the data used to determine A.N. Other's previous working day: ● User ID: A.N.Other ● Date: March 1, 2015 ● Consider Holidays: NO Result 3: March 1, 2015 is a Sunday. The employee is not working on the previous day – February 28, 2015 – which is a Saturday. Although the employee is physically working on Saturday from 00:00 to 06:00, the working day is specified as the day on which the shift starts, which, in this case, is Friday. So the function returns Friday as the previous working day: February 27, 2015, because holidays are not considered. Example 4: Cross-Midnight Work Schedule and Holidays Considered Here's another example. A.N.Other was hired on January 1, 2015 with a cross-midnight work schedule with working time Monday Friday 22:00 - 06:00 (next day). Saturday and Sunday are days off. There is a public full day holiday on February 27, 2015. Here's the data used to determine A.N. Other's previous working day: ● User ID: A.N.Other ● Date: March 1, 2015 ● Consider Holidays: YES Result 4: March 1, 2015 is a Sunday. The employee is not working on the previous day – February 28, 2015 – which is a Saturday. Although the employee is physically working on Saturday from 00:00 to 06:00, the working day is specified as the day on which the shift starts, which, in this case, is Friday. So the function returns Thursday as the previous working day: February 26, 2015, because holidays are considered. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 557 6.5.2.5 Get Start Time Of Working Day () This function calculates the start time of the working day on a given date. It reads the work schedule associated with the user to calculate the start time of the date provided to the rule function. The rule function returns a value in 24 hour clock format. If the user applied for time off using clock times, you can use this rule function for specific validation against the beginning of the day. This is typically done in a take rule (absence validation rule) that you can set to be triggered when absence is created or modified. The rule function returns null if: ● A duration-based work schedule is assigned to the user as of the requested date. ● The requested date is a non-working day. Input Parameters For this parameter. Make this entry User Select the User field. This is the user for which the start time of working day should be cal­ culated.Prerequisites: User A.N.Other should have Time Recording Variant as Clock Time and Work Schedule should be configured for working days. Date Date for which the start time is required Example 1: Non-Cross Midnight Work Schedule Here’s the data for A.N.Other’s start time calculation: User ID: A.N. Other Date = July 1, 2020 (Wednesday) Prerequisites: A.N.Other should have the Clock Times time recording variant. The work schedule is configured with Monday to Friday as working days from 08:00 to 17:00. Saturday and Sunday are non-working days. Result 1: The rule function returns a start time of 08:00:00 Example 2: Cross-Midnight Work Schedule This time, A.N Other's information looks like this: ● User: A.N.Other ● Date: Monday, July 6, 2020 558 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Prerequisites: A.N.Other should have the Clock Times time recording variant. The work schedule is configured with Monday to Friday as working days from 22:00 to 06:00 (next day). Saturday and Sunday are non-working days. Result 2: The rule function returns a start time of 22:00:00. 6.5.2.6 Get Working Time In Hours () This function calculates the working time in hours for the given duration and given time, based on the time recording variant and work schedule configured for the relevant user. If the time recording variant is Duration, the start time and end time will not be considered for the calculation. If the time recording variant is Clock Times then the start time and end time are considered for the calculation. If 00:00:00 is entered as the start or end time, it is defined as the start of the corresponding date. Input Parameters For this parameter... Make this entry: User Select the User field. This is the user for which the start time of working day should be cal­ culated. Start Date The start date of the duration. End Date The end date of the duration. Start Time The start time of the duration. End Time The end time of the duration. Example 1: Clock-Time Based Employee with Non-Cross Midnight Work Schedule Let's look at an example. Here’s the data for A.N.Other’s working time calculation: User ID = A.N. Other Start Date = January 4, 2016 End Date = January 6, 2016 Start Time = 13:00:00 End Time = 14:00:00 The work schedule is configured like this: Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 559 ● Day 1: Working time starting at 08:00:00 and ending at 17:00:00, with an unpaid break between 12:00:00 and 13:00:00 (4 hours) ● Day 2: Working time starting at 09:00:00 and ending at 18:00:00, with an unpaid break between 13:00:00 and 14:00:00 (8 hours) ● Day 3: Working time starting at 10:00:00 and ending at 18:00:00, with an unpaid break between 11:00:00 and 12:00:00 (3 hours) Result: The rule function returns a working time of 15 hours. That is comprised of 4 hours on day 1, 8 hours on day 2, and 3 hours on day 3. Example 2: Clock-Time Based Employee with Cross-Midnight Work Schedule Let's look at an example. Here’s the data for A.N.Other’s working time calculation: User ID = A.N. Other Start Date = January 3, 2016 End Date = January 6, 2016 Start Time = 00:00:00 (midnight) End Time = 14:00:00 (midnight) The work schedule is configured like this: ● Day 1 (January 3, 2016) is a non-working day. ● Day 2: Working time starting at 22:00:00 and ending at 06:00:00 on day 3. ● Day 3: Working time starting at 22:00:00 and ending at 06:00:00 on day 4. ● Day 4 (January 6, 2016): Working time starting at 22:00:00 and ending at 06:00:00 on day 5. Result: The rule function returns a working time of 10 hours. That is comprised of start time 22:00 on January 4, 2016 to end time 06:00 on January 5, 2016, and start time 22:00 on January 5, 2016, to end time 00:00 on January 6, 2016. Example 3: Duration-Based Employee Now let's look at another example where the time recording variant is set to Duration. Here’s the data for A.N.Other’s working time calculation: User ID = A.N. Other Start Date = January 6, 2016 End Date = January 8, 2016 Start Time = 13:00:00 End Time = 14:00:00 560 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management The work schedule is configured like this: ● Day 1: Working time duration is 5 hours ● Day 2: Working time duration is 8 hours ● Day 3: Working time duration is 6 hours Result: The rule function returns a working time of 19 hours. That is comprised of 5 hours on day 1, 8 hours on day 2, and 6 hours on day 3. The Start Time and End Time parameters in the rule function are not considered. 6.5.2.7 Has Working Time In Interval () This function validates whether the employee has any working time interval for the given duration and given time based on work schedule configured for that user. If the time recording variant is Duration for any of the dates in question, the function returns an error message, and if the time recording variant is Clock Time, it will validate whether the user has any working time interval in the time that has passed. If 00:00:00 is entered as the start or end time, it is defined as the start of the corresponding date. Input Parameters For this parameter... Make this entry: User Select the User field. This is the user for which you want to calculate the working time in hours. Start Date The start date of the duration. End Date The end date of the duration. Start Time The start time of the duration. Note If you want to calculate for full days when using clock times as the time recording var­ iant, you always have to enter a specific time here (for example 00:00:00). Otherwise you'll get an error message. End Time The end time of the duration. Note If you want to calculate for full days when using clock times as the time recording var­ iant, you always have to enter a specific time here (for example 23:59:00). Otherwise you'll get an error message. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 561 Example 1: Non-Cross-Midnight Work Schedule Let's look at an example with clock times as the time recording variant and a check over multiple days. Here’s the data for calculating A.N.Other’s working time in hours: User ID = A.N. Other Start Date = January 4, 2016 End Date = January 6, 2016 Start Time = 13:00:00 End Time = 14:00:00 The work schedule is configured like this: ● Day 1: Working time starting at 08:00:00 and ending at 17:00:00, with an unpaid break between 12:00:00 and 13:00:00 ● Day 2: Working time starting at 09:00:00 and ending at 18:00:00, with an unpaid break between 13:00:00 and 14:00:00 ● Day 3: Working time starting at 10:00:00 and ending at 18:00:00, with an unpaid break between 11:00:00 and 12:00:00 Result 1: The employee has a working time of 17 hours. That is comprised of 4 hours on day 1, 9 hours on day 2, and 4 hours on day 3. So the result is True. Example 2: Clock-Time Based Employee With Cross-Midnight Work Schedule Let's look at an example with clock times as the recording variant and the cross-midnight feature activated. Here’s the data for calculating A.N.Other’s working time: User ID = A.N. Other Start Date = January 3, 2016 End Date = January 6, 2016 Start Time = 00:00:00 (midnight) End Time = 00:00:00 (midnight) The work schedule is configured like this: ● Day 1 (January 3, 2016) is a non-working day. ● Day 2: Working time starting at 22:00:00 and ending at 06:00:00 on day 3. ● Day 3: Working time starting at 22:00:00 and ending at 06:00:00 on day 4. ● Day 4: Working time starting at 22:00:00 and ending at 06:00:00 on day 5. Result 2: The employee has a working time of 10 hours. That is comprised of start time 22:00 on January 4, 2016, to end time 06:00 on January 5, 2016, and start time 22:00 on January 5, 2016, to end time 00:00 on January 6, 2016. 562 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Example 3: Clock-Time Based Employee With Cross-Midnight Work Schedule Here's another example. Here’s the data for calculating A.N.Other’s working time: User ID = A.N. Other Start Date = January 3, 2016 End Date = January 4, 2016 Start Time = 00:00:00 (midnight) End Time = 00:00:00 (midnight) The work schedule is configured like this: ● January 2 is a working day with start time 22:00:00 and end time at 06:00:00 next day (January 3). ● January 3 is a non-working day. Result 3: The employee has a working time of 6 hours. That is comprised of start time 00:00 on January 3, 2016, to end time 06:00 on January 3, 2016. 6.5.3 Job Information Rule Functions 6.5.3.1 Calculate Average Value For Numeric Job Info Field() This rule function calculates the average value of any numeric job information field. You can decide whether you want to calculate the average for the accrual period or for the accruable period. In addition, you can decide whether the eligibility status should be considered. Restriction Please use this rule function only in the Accrual scenario. Look at the examples below for further details. Input Parameters For this parameter Make this entry User Select the User field. This is the user the average will be cal­ culated for. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 563 For this parameter Job Info Field ID Make this entry Caution Please enter the field ID from your data model. Type it in manually - do not navigate to the corresponding job in­ formation field. The field in your data model must be a numeric field to calculate an average. For example: custom-long1 or cus­ tom-double1. Start Date Please use Manage Parameters accrualRuleParameters and select Start Date. End Date Please use Manage Parameters accrualRuleParameters and select End Date. Consider Eligibility Please choose whether you want the eligibility status to be considered in the calculation or not (see example below). Time Account Type Please select the Time Account Type. Accruable Start Date Please use Manage Parameters accrualRuleParameters and select Accruable Start Date. Accruable End Date Please use Manage Parameters accrualRuleParameters and select Accruable End Date. Calculation Period Please choose whether you want the average value calcula­ tion for the accrual period or for the accruable period (see example below). Examples Let's look at some examples. Case 1: Without Eligibility and for Accrual Period ● User: A. N. Other ● Job Info Field ID: standard-hours ● Start Date: January 1, 2016 564 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management ● End Date: December 31, 2016 ● Consider Eligibility: No ● Time Account Type: Vacation ● Accruable Start Date: January 1, 2016 ● Accruable End Date: October 31, 2016 (because the employee is terminated). ● Calculation Period: Accrual Period Table 29: Job Information Data Effective Start Date Effective End Date Standard Hours 01.01.2016 31.03.2016 40 01.04.2016 31.12.2016 30 Result The average will be calculated for the complete year 2016. The employee would no longer be eligible after termination date, but the eligibility should not be considered. For the period from January 1, 2016, until March 31, 2016, the employee has 40 standard hours per week. The period consists of 91 days. For the period from April 1, 2016 until December 31, 2016, the employee has 30 standard hours per week. The period consists of 275 days. 40 * 91 / 366 + 30 * 275 / 366 = 9.945 + 22.54 = 32.49 32.49 is the average value of the standard hours for the year 2016. Case 2: With Eligibility and for Accrual Period ● User: A. N. Other ● Job Info Field ID: standard-hours ● Start Date: January 1, 2016 ● End Date: December 31, 2016 ● Consider Eligibility: Yes ● Time Account Type: Vacation ● Accruable Start Date: January 1, 2016 ● Accruable End Date: October 31, 2016 (because the employee is terminated). ● Calculation Period: Accrual Period Table 30: Job Information Data Effective Start Date Effective End Date Standard Hours 01.01.2016 31.03.2016 40 01.04.2016 31.12.2016 30 Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 565 Table 31: Eligibility Status Effective Start Date Effective End Date 01.01.2016 31.12.9999 Yes The employee is eligible starting from the hire date until high date. In this scenario, a termination rule is executed. This happens before the termination entry is saved in job info and the eligibility status is updated. However, the accruable end date is already correct (= last working day) and is used to determine that the employee is no longer eligible outside this period. Result The average will be calculated for the complete year 2016. The employee is no longer eligible after the termination date. For the period from January 1, 2016, until March 31, 2016, the employee has 40 standard hours per week. The period consists of 91 days. For the period from April 1, 2016 until October 31, 2016, the employee has 30 standard hours per week. The period consists of 214 days. 40 * 91 / 366 + 30 * 214 / 366 = 9.945 + 17.54 = 27.49 27.49 is the average value of the standard hours for the year 2016. Case 3: Without Eligibility and for Accruable Period ● User: A. N. Other ● Job Info Field ID: standard-hours ● Start Date: January 1, 2016 ● End Date: December 31, 2016 ● Consider Eligibility: No However, the employee is not eligible between January 1, 2016, and January 31, 2016, because he is on long term leave. ● Time Account Type: Vacation ● Accruable Start Date: January 1, 2016 ● Accruable End Date: October 31, 2016 (because the employee is terminated). ● Calculation Period: Accruable Period Table 32: Job Information Data Effective Start Date Effective End Date Standard Hours 01.01.2016 31.03.2016 40 01.04.2016 31.12.9999 30 Effective Start Date Effective End Date Eligibility Status 01.01.2016 31.01.2016 No Table 33: Eligibility Status 566 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Effective Start Date Effective End Date Eligibility Status 01.02.2016 31.12.9999 Yes The employee is not eligible for the first month because of any leave of absence. Afterwards, he is eligible until the high date. In this scenario, a termination rule is executed before the termination entry is saved in job info and the eligibility status is updated. However, the accruable end date is already correct (= last working day) and is used to determine that the employee is no longer eligible outside this period. Result The average will be calculated for the period from January 1, 2016 until October 1, 2016 (305 days). The employee is not eligible in January, but the eligibility should not be considered. For the period from January 1, 2016, until March 31, 2016, the employee has 40 standard hours per week. The period consists of 91 days. For the period from April 1, 2016 until October 31, 2016, the employee has 30 standard hours per week. The period consists of 214 days. November and December are outside the accruable period. 40 * 91 / 305 + 30 * 214 / 305 = 11.93 + 21.05 = 32.98 32.98 is the average value of the standard hours for the year 2016. Case 4: With Eligibility and for Accruable Period ● User: A. N. Other ● Job Info Field ID: standard-hours ● Start Date: January 1, 2016 ● End Date: December 31, 2016 ● Consider Eligibility: Yes However, the employee is not eligible between January 1, 2016, and January 31, 2016, because she is on long term leave. ● Time Account Type: Vacation ● Accruable Start Date: January 1, 2016 ● Accruable End Date: October 31, 2016 (because the employee is terminated). ● Calculation Period: Accruable Period Table 34: Job Information Data Effective Start Date Effective End Date Standard Hours 01.01.2016 31.03.2016 40 01.04.2016 31.12.9999 30 Effective Start Date Effective End Date Eligibility Status 01.01.2016 31.01.2016 No 01.02.2016 31.12.9999 Yes Table 35: Eligibility Status Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 567 The employee is not eligible for the first month because of any leave of absence. Afterwards, he is eligible until the high date. In this scenario, a termination rule is executed before the termination entry is saved in job info and the eligibility status is updated. However, the accruable end date is already correct (= last working day) and is used to determine that the employee is no longer eligible outside this period. Result The average will be calculated for the period from January 1, 2016 until October 1, 2016 (305 days). The employee is not eligible in January. For the period from January 1, 2016, until January 31, 2016, the employee is not eligible, so there are no standard hours. For the period from February 1, 2016, until March 31, 2016, the employee has 40 standard hours per week. The period consists of 60 days. For the period from April 1, 2016 until October 31, 2016, the employee has 30 standard hours per week. The period consists of 214 days. November and December are outside the accruable period. 40 * 60 / 305 + 30 * 214 / 305 = 7.87 + 21.05 = 28.92 28.92 is the average value of the standard hours for the year 2016. Use Case: Annual Accrual Calculation Depending on Pay Grade Change How can you use the Calculate Average Value For Numeric Job Info Field rule function to handle this use case? 1. Create an onChange or onSave rule for job information based on changes to the pay grade. 2. Use a job information numeric custom field to store a value for which you can create an average in the accrual rule. Here's an example: 1. For pay grade A, employees get an accrual of 32 days. For pay grade B, the accrual is 30 days. 2. The pay grade field is added as a recalculation field to the time account type definition. 3. On January 1, an employee is hired with pay grade B and 30 is entered in the custom field. The annual accrual calls the average value rule function for the custom field and posts the result, 30, as the accrual. 4. The employee changes job on July 1. The pay grade adjusts to A and 32 is entered in the custom field. The existing accrual is recalculated in line with the time account type configuration. 5. Now the accrual is calculated based on the average for the custom field. For 182 days, the field contains 30 and for 184 it contains 32. So the average is calculated like this: 30 * 182/366 + 32 * 184/366 = 31.01. 6.5.3.2 Calculate Average Value For Numeric Job Information Field Based on Months() This rule function calculates the average value of any numeric job information field based on months. You can prorate or recalculate the leave accrual value depending on the changes to the job information field. When using this rule function, you can decide: 568 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management ● Whether you want to calculate the average for the accrual period or for the accruable period. ○ When you are using the Calculation Period as the Accruable Period, you can also specify the Accruable End Date as the Contract End Date from the job information. Please make sure that the Contract End Date isn't null and not greater than the Accruable End Date. ● Whether to consider a particular month (or not) for calculations based on specified thresholds. Note ○ If an employee is hired on or before a specified threshold value, then the hire month should be considered. ○ If an employee is terminated after a specified threshold value, then the termination month should be considered. ○ If there is a change in the job information of the employee on or before a specified threshold value, then that month is considered for the new value of the job information field. Restrictions ● This rule function should only be used in the Accrual scenario. ● This rule function does not consider eligibility status. The specified thresholds determine whether a month is considered or not. Validation Checks ● The job information field ID must be a field in the data model, and it must be a numeric field (double, long, big decimal, salary). ● The start date must be earlier than or the same as the end date. ● The accruable start date must be earlier than or the same as the accruable end date, and the accruable period must fall within the accrual period. ● The accrual frequency for time account types must be set to Annually or Monthly. ● You have to specify a threshold value. It is possible to enter a value of "0", but please keep the following behavior in mind: ○ If Threshold Start is 0, the rule function will ignore the month in which the user was hired. ○ If Threshold End is 0, the rule function will include the month in which the user was terminated. ○ If Threshold Data Change is 0, then the old value of the job information field will be used for the calculation. ● If the threshold is negative, the rule function will not work. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 569 Input Parameters For this parameter Make this entry User Select the user you want to calculate the average for. Job Information Field ID Enter the field ID from your data model. Type it in manually don't navigate to the corresponding job informationrmation field. Note The field in your data model must be a numeric field in order to calculate an average. For example, customlong1 or custom-double1. Start Date Under Manage Parameters select Start Date. accrualRuleParameters , End Date Under Manage Parameters select End Date. accrualRuleParameters , Time Account Type Select the relevant time account type. Accruable Start Date Under Manage Parameters select Accruable Start Date. Accruable End Date Under Manage Parameters accrualRuleParameters , select Accruable End Date. You can also select the Contract End Date field in the Job Information as the Accruable End Date. Calculation Period Choose whether you want to calculate the average value cal­ culation for the accrual period or for the accruable period (see example below). Threshold Start Month will be considered if hire date is on or before thresh­ old. Threshold End Month will be considered if termination date is after the threshold. Threshold Data Change Month will be considered for new value if data change is on or before the threshold. accrualRuleParameters , Now let's have a look at the rule function in action. In this example, a hypothetical employee called Aanya Singh has been hired on 17th February 2020, and has annual accruals with the following weekly hours and entitlements: Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value 17.02.2020 (hire date) 31.12.9999 40 25 570 PUBLIC No. of Eligible Months in Accrual Period 10 (March to Decem­ ber, since Aanya was only hired in February) Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Scenario #1: Calculation Based on Accrual Period Here's what you would enter as the parameters for the rule function. Parameter Entry User Aanya Singh job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accrual period Threshold Start 10 Threshold End 15 Threshold Data Change 14 The calculation takes place based on the following formula: Sample Code Number of eligible months in each job information period/number of months in accrual period× job information field value In the case of the example above, that means you would get a result of 20.83 (10/12×25). Now let's say Aanya's work schedule is changed several times over the course of the year. Her leave entitlements will change accordingly, and her accruals will need to be recalculated. Change #1: Weekly hours changed from 40 to 35 on 16th June Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value No. of Eligible Months in Accrual Period 17.02.2020 (hire date) 15.06.2020 40 25 4 (March to June) 16.06.2020 (work schedule changed) 31.12.9999 35 22 6 (July to December) Here's what you would enter as the parameters for the rule function. Parameter Entry User Aanya Singh job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 571 Parameter Entry Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accrual period Threshold Start 10 Threshold End 15 Threshold Data Change 14 Due to Aanya's changed working hours and entitlements, the result will now be 19.33 (4/12×25+6/12×22). Note Since Threshold Data Change is set to 14, and Aanya's work schedule was changed on 16th June, the entire month of June is counted with the old entitlement value of 25. Change #2: Weekly hours changed from 35 to 30 on 10th August Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value No. of Eligible Months in Accrual Period 17.02.2020 (hire date) 15.06.2020 40 25 4 (March to June) 16.06.2020 (work schedule changed) 09.08.2020 35 22 1 (July) 10.08.2020 (work schedule changed) 31.12.9999 30 19 5 (August to Decem­ ber) As before, you would enter these parameters for the rule function. Parameter Entry User Aanya Singh job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accrual period Threshold Start 10 Threshold End 15 Threshold Data Change 14 But now the result will be 18.08 (4/12×25+1/12×22+5/12×19). 572 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Note Since Threshold Data Change is set to 14, and Aanya's work schedule was changed on 10 August, the month of August is not counted with the old entitlement value (25) but with the new value (19). Change #3: Weekly hours changed from 30 to 40 on 18 November Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value No. of Eligible Months in Accrual Period 17.02.2020 (hire date) 15.06.2020 40 25 4 (March to June) 16.06.2020 (work schedule changed) 09.08.2020 35 22 1 (July) 10.08.2020 (work schedule changed) 17.11.2020 30 19 4 (August to Novem­ ber) 18.11.2020 (work schedule changed) 31.12.9999 40 25 1 (December) As before, you would enter these parameters for the rule function. Parameter Entry User Aanya Singh job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accrual period Threshold Start 10 Threshold End 15 Threshold Data Change 14 But now the result will be 18.58 (4/12×25+1/12×22+4/12×19+1/12×25). Note Since Threshold Data Change is set to 14, and Aanya's work schedule was changed on 18th November, the month of November is counted with the old entitlement value (19). Change #4: Employee is terminated on 10 December Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value No. of Eligible Months in Accrual Period 17.02.2020 (hire date) 15.06.2020 40 25 4 (March to June) Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 573 Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value No. of Eligible Months in Accrual Period 16.06.2020 (work schedule changed) 09.08.2020 35 22 1 (July) 10.08.2020 (work schedule changed) 17.11.2020 30 19 4 (August to Novem­ ber) 18.11.2020 (work schedule changed) 09.12.2020 40 25 0 (December is not considered) 10.12.2020 (termina­ tion) 10.12.2020 40 25 0 As before, here are the parameters for the rule function. Parameter Entry User Aanya Singh job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accrual period Threshold Start 10 Threshold End 15 Threshold Data Change 14 And the final result is 16.5 (4/12×25+1/12×22+4/12×19). Note The accruable end date is 10th December. As such, December is excluded from the calculation because Threshold End is set to 15. Scenario #2: Calculation Based on Accruable Period Here we'll look at the same example - an employee called Aanya Singh who is hired on 17th February with the following weekly hours, leave entitlements, and accruals: 574 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value 17.02.2020 (hire date) 31.12.9999 40 25 No. of Eligible Months in Accrual Period 10 (March to Decem­ ber, since Aanya was only hired in February) But in this scenario you want to calculate by accruable period, so you enter the following parameters for the rule function: Parameter Entry User Aanya Singh job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accruable period Threshold Start 10 Threshold End 15 Threshold Data Change 14 In this scenario, the formula used for the calculation is Sample Code Number of eligible months in each job information period/number of months in accruable period× job information field value As such, in Aanya's case the result would be 25 (10/10×25). Now let's say the Aanya's work schedule is changed several times over the course of the year. Her leave entitlements will change accordingly, and her accruals will need to be recalculated. Change #1: Weekly hours changed from 40 to 35 on 16 June Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value No. of Eligible Months in Accrual Period 17.02.2020 (hire date) 15.06.2020 40 25 4 (March to June) 16.06.2020 (work schedule changed) 31.12.9999 35 22 6 (July to December) Here's what you would enter as the parameters for the rule function. Parameter Entry User Aanya Singh Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 575 Parameter Entry job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accruable period Threshold Start 10 Threshold End 15 Threshold Data Change 14 Due to Aanya's changed working hours and entitlements, the result will now be 23.2 (4/10×25+6/10×22). Note Since Threshold Data Change is set to 14, and Aanya's work schedule was changed on 16 June, the entire month of June is counted with the old entitlement value of 25. Change #2: Weekly hours changed from 35 to 30 on 10 August Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value No. of Eligible Months in Accrual Period 17.02.2020 (hire date) 15.06.2020 40 25 4 (March to June) 16.06.2020 (work schedule changed) 09.08.2020 35 22 1 (July) 10.08.2020 (work schedule changed) 31.12.9999 30 19 5 (August to Decem­ ber) As before, you would enter these parameters for the rule function. Parameter Entry User Aanya Singh job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accruable period Threshold Start 10 Threshold End 15 576 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Parameter Entry Threshold Data Change 14 But now the result will be 21.7 (4/10×25+1/10×22+5/10×19). Note Since Threshold Data Change is set to 14, and Aanya's work schedule was changed on 10 August, the month of August is not counted with the old entitlement value (25) but with the new value (19). Change #3: Weekly hours changed from 30 to 40 on 18 November Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value No. of Eligible Months in Accrual Period 17.02.2020 (hire date) 15.06.2020 40 25 4 (March to June) 16.06.2020 (work schedule changed) 09.08.2020 35 22 1 (July) 10.08.2020 (work schedule changed) 17.11.2020 30 19 4 (August to Novem­ ber) 18.11.2020 (work schedule changed) 31.12.9999 40 25 1 (December) As before, you would enter these parameters for the rule function. Parameter Entry User Aanya Singh job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accruable period Threshold Start 10 Threshold End 15 Threshold Data Change 14 But now the result will be 22.3 (4/10×25+1/10×22+4/10×19+1/10×25). Note Since Threshold Data Change is set to 14, and Aanya's work schedule was changed on 18th November, the month of November is counted with the old entitlement value (19). Change #4: Employee is terminated on 10 December Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 577 Effective Start Date Effective End Date Standard Weekly Hours Entitlement Value No. of Eligible Months in Accrual Period 17.02.2020 (hire date) 15.06.2020 40 25 4 (March to June) 16.06.2020 (work schedule changed) 09.08.2020 35 22 1 (July) 10.08.2020 (work schedule changed) 17.11.2020 30 19 4 (August to Novem­ ber) 18.11.2020 (work schedule changed) 09.12.2020 40 25 0 (December is not considered) 10.12.2020 (termina­ tion) 10.12.2020 40 25 0 As before, you would enter these parameters for the rule function. Parameter Entry User Aanya Singh job information Field ID custom-double1 Start Date 01.01.2020 End Date 31.12.2020 Time Account Type VACATION Accruable Start Date 17.02.2020 Accruable End Date 31.12.2020 Calculation Period Accruable period Threshold Start 10 Threshold End 15 Threshold Data Change 14 And the final result is 22 (4/9×25+1/9×22+4/9×19). Note The accruable end date is 10 December. As such, December is excluded from the calculation because Threshold End is set to 15. 6.5.3.3 Get Job Info Date Field Value On Key Date() This rule function reads a job info date field for a specific key date. The rule function is needed because, if you navigate directly to the job info date field to retrieve it without this rule function, you cannot specify the key date the field should be returned for. The job information is effective dated and might have multiple records within an accrual period. If you navigate, the first job info record within the accruable period will be returned. If, for example, you want to get the field “contract end date”, you would like to get the latest record in the accrual period, not the first one. 578 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Limitations ● Use this rule function only in the Accrual scenario. ● You cannot read any job information outside the employee's accrual period. Input Parameters For this parameter Make this entry User Select the User field. This is the user the job info date will be read for. Job Info Field ID Caution Please enter the field ID from your data model. Type it in manually - do not navigate to the corresponding job in­ formation field. The field in your data model must be a date field to be returned. For example: custom-date1. Date Select a key date, such as Accrual End Date from accrualRu­ leParameters. Examples Let's look at an example. User: A.N. Other Job Info Field ID: custom-date1 Date: December 31, 2017 Job Information History for this user: ● Effective start date January 1, 2010; custom-date1 = December 31, 2016 ● Effective start date January 1, 2017; custom-date1 = May 31, 2017 ● Effective start date June 1, 2017; custom-date1 = November 30, 2017 Result The custom-date1 field from the job information valid on December 31, 2017 is November 30, 2017. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 579 6.5.3.4 Get Job Info Numeric Field Value On Key Date() This rule function reads a job info numeric field for a specific key date. The rule function is needed because, if you navigate directly to the job info numeric field to retrieve it without this rule function, you cannot specify the key date the field should be returned for. The job information is effective dated and might have multiple records within an accrual period. If you navigate, the first job info record within the accruable period will be returned. If, for example, you want to get the field “working days per week”, you would like to get the latest record in the accrual period, not the first one. Limitations ● Use this rule function only in the Accrual scenario. ● You cannot read any job information outside the employee's accrual period. Input Parameters For this parameter Make this entry User Enter a user ID. Job Info Field ID Caution Please enter the field ID from your data model. Type it in manually - do not navigate to the corresponding job in­ formation field. The field in your data model must be a numeric field to be returned. For example: custom-double1. Date Select a key date, such as Accrual End Date, from accrualRu­ leParameters. 580 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Example Let|s look at an example. User: A.N. Other Job Info Field ID: custom-double1 Date: December 31, 2017 Job Information History for this user: ● Effective start date January 1, 2010; custom-double1 = 12 ● Effective start date January 1, 2017; custom-double1 = 14 ● Effective start date June 1, 2017; custom-double1 = 16 Result The custom-double1 field from the job information valid on December 31, 2017 is 16. 6.5.3.5 Get Job Info String Field Value On Key Date() This rule function reads a job info string field for a specific key date. The rule function is needed because, if you navigate directly to the job info string field to retrieve it without this rule function, you cannot specify the key date the field should be returned for. The job information is effective dated and might have multiple records within an accrual period. If you navigate, the first job info record within the accruable period will be returned. If, for example, you want to get the field “employee class”, you would like to get the latest record in the accrual period, not the first one. Limitations ● Use this rule function only in the Accrual scenario. ● You cannot read any job information outside the employee's accrual period. Input Parameters For this parameter Make this entry User Select the User field. This is the user the job info date will be read for. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 581 For this parameter Job Info Field ID Make this entry Caution Please enter the field ID from your data model. Type it in manually - do not navigate to the corresponding job in­ formation field. The field in your data model must be a string field to be returned. For example: custom-string1. Date Select a key date, such as Accrual End Date from accrualRu­ leParameters. Examples Let's look at an example. User: A.N. Other Job Info Field ID: custom-string1 Date: December 31, 2017 Job Information History for this user: ● Effective start date January 1, 2010; custom-string1 = value1 ● Effective start date January 1, 2017; custom-string1 = value2 ● Effective start date June 1, 2017; custom-string1 = value3 Result The custom-string1 field from the job information valid on December 31, 2017 is value3. 582 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.5.4 Average Full-Time Equivalent Rule Functions 6.5.4.1 Average Full-Time Equivalent for Accruable Period() This function calculates the average full-time equivalent (FTE) as defined in the job information for the accruable period. Overview The accruable period is the period the employee is allowed to get an accrual for. The function is used for fields that show data in numeric form, to calculate accruals depending on FTE. The rule function counts the days for which the employee is not eligible as FTE = 0 - for example, if the employee is on parental leave for 2 months within the period. The function is used for fields that show data in numeric form, to calculate accruals depending on FTE. Manage Parameters When you click Manage Parameters, make the following entries: Code Name Object accrualRuleParameters accrualRuleParameters Accrual Rule Parameters Input Parameters Here’s a table showing the entries you need to make in the input parameters. For this parameter: User ID Make this entry Select the User field. This is the user for which the accrual should be created. Time Account Type Select the time account type the rule is valid for. Start Date Please use Manage Parameters accrualRuleParameters and select Start Date. End Date Please use Manage Parameters accrualRuleParameters and select End Date. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 583 For this parameter: Make this entry Accruable Start Date Please use Manage Parameters accrualRuleParameters and select Accruable Start Date. Accruable End Date Please use Manage Parameters accrualRuleParameters and select Accruable End Date Example Here’s the data for A.N.Other’s average FTE accrual calculation. The employee is hired on July 1, 2017 and the FTE is 1. The vacation account has an annual frequency period starting on January 1. User ID: A.N. Other Time Account Type: = Vacation Start Date = January 1, 2017 End Date = December 31, 2017 Accruable Start Date = July 1, 2017 Accruable End Date = December 31, 2017 Result A.N.Other’s average FTE would be calculated for the period July 1 to December 31. The result would be 1. 6.5.4.2 Average Full-Time Equivalent for Accruable Period Based on Months() This function calculates the average full-time equivalent (FTE) as defined in the job information for the accruable period. Overview The accruable period is the period the employee is allowed to get an accrual for. The average calculation is based on calendar months, meaning that the average of each month within the accruable period is calculated first. The rule function counts the days for which the employee is not eligible as FTE = 0 - for example, if the employee is on parental leave for 2 months within the period. The function is used for fields that show data in numeric form, to calculate accruals depending on FTE. 584 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management Manage Parameters When you click Manage Parameters, make the following entries: Code Name Object accrualRuleParameters accrualRuleParameters Accrual Rule Parameters Input Parameters Here’s a table showing the entries you need to make in the input parameters. For this parameter Make this entry User ID Select the User field. This is the user for which the accrual should be created. Time Account Type Select the time account type the rule is valid for. Start Date Please use Manage Parameters accrualRuleParameters and select Start Date. End Date Please use Manage Parameters accrualRuleParameters and select End Date. Accruable Start Date Please use Manage Parameters accrualRuleParameters and select Accruable Start Date. Accruable End Date Please use Manage Parameters accrualRuleParameters and select Accruable End Date. Example Let’s look at an example. Here’s the data for A.N.Other’s FTE accrual calculation. The employee is hired on July 1, 2017 and the FTE is 1. The vacation account has an annual frequency period starting on January 1. User ID: A.N. Other Time Account Type: = Vacation Start Date = January 1, 2017 End Date = December 31, 2017 Accruable Start Date = July 1, 2017 Accruable End Date = December 31, 2017 Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 585 Result A.N.Other’s average FTE is calculated for the period July 1 to December 31. The result is 1. 6.5.4.3 Average Full-Time Equivalent for Accrual Period() This function calculates the average full-time equivalent (FTE) as defined in the job information for the accrual period. Overview The accrual period is the period derived from the employee’s time account type, For example, for an annual account starting on January 1, the accrual period would be January 1 until December 31. The rule function counts the days for which the employee is not eligible as FTE = 0 (for example, if the employee is on parental leave for 2 months within the period. The function is used for fields that show data in numeric form, to calculate accruals depending on FTE. Manage Parameters When you click Manage Parameters, make the following entries: Table 36: Code Name Object accrualRuleParameters accrualRuleParameters Accrual Rule Parameters Input Parameters Here‘s a table showing the entries you need to make in the input parameters. For this parameter: User ID Make this entry Select the User field. This is the user for which the accrual should be created. Time Account Type Select the time account type the rule is valid for. Start Date Please use Manage Parameters accrualRuleParameters and select Start Date. 586 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management For this parameter: Make this entry End Date Please use Manage Parameters accrualRuleParameters and select End Date. Accruable Start Date Please use Manage Parameters accrualRuleParameters and select Accruable Start Date. Accruable End Date Please use Manage Parameters accrualRuleParameters and select Accruable End Date. Example Here‘s the data for A.N.Other‘s average FTE accrual calculation. The employee is hired on July 1, 2014 and the FTE is 1. The vacation account has an annual frequency period starting on January 1. User ID: A.N. Other Time Account Type: = Vacation Accruable Start Date = July 1, 2017 Accruable End Date = December 31, 2017 Start Date = January 1, 2017 End Date = December 31, 2017 Result A.N. Other's average FTE is calculated for period January – December as 0.504. The period January to June has 181 days and the period July to December has 184 days. The result is the following formula, which yields the result of 0.504: (181 days * 0 + 184 days * 1) / 365 6.5.4.4 Average Full-Time Equivalent for Accrual Period Based on Months() This function calculates the average full-time equivalent (FTE) as defined in the job information for the accrual period. Overview The accrual period is the period derived from the employee’s time account type. For example, in the case of an annual account starting on January 1, the accrual period would be January 1 to December 31. The average Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 587 calculation is based on calendar months, meaning that the average of each month within the accruable period is calculated first. The rule function counts the days for which the employee is not eligible as FTE = 0 - for example, if the employee is on parental leave for 2 months within the period. The function is used for fields that show data in numeric form, to calculate accruals depending on FTE. Manage Parameters When you click Manage Parameters, make the following entries: Code Name Object accrualRuleParameters accrualRuleParameters Accrual Rule Parameters Input Parameters Here‘s a table showing the entries you need to make in the input parameters. For this parameter Make this entry User ID Select the User field. This is the user for which the accrual should be created. Time Account Type Select the time account type the rule is valid for. Start Date Please use Manage Parameters accrualRuleParameters and select Start Date. End Date Please use Manage Parameters accrualRuleParameters and select Accrual End Date. Accruable Start Date Please use Manage Parameters accrualRuleParameters and select Accruable Start Date. Accruable End Date Please use Manage Parameters accrualRuleParameters and select Accruable End Date. Example Here’s the data for A.N.Other’s FTE accrual calculation. The employee is hired on July 1, 2017 and the FTE is 1. The vacation account has an annual frequency period starting on January 1. User ID: A.N. Other Time Account Type: = Vacation Start Date = January 1, 2017 588 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management End Date = December 31, 2017 Accruable Start Date = July 1, 2017 Accruable End Date = December 31, 2017 Result Average FTE would be calculated for period January – December. The result is 0.5. The average for each of the months January – June is 0 and the average for each of the months July – December is 1. The result is the following formula, which yields the result of 0.5: (6 * 0 + 6 * 1) / 12. 6.5.5 Calculate Balance() This function calculates the account balance for a time account on a specific date. Limitations ● Use this rule function only with Employee Central Time Off. ● This rule function does not consider the simulation of future leave. Input Parameters For this parameter... Make this entry: Date You can either: Time Account ● Select Date and enter the corresponding date. ● Select a date field. You have to select the Time Account MDF object. Please refer to the Time Off Guide under Capping Accruals. Restriction Do not use the Calculate Balance() rule function for a time account when creating a time account detail for that account, for example, to create the amount. If you do this, balance calculation will fail as the time account detail is already added to that account, but is empty. Instead, define the rule as follows: 1. Calculate the account and assign the result to a variable (SET-statement). 2. Then create the time account detail and assign the value calculated before. Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management PUBLIC 589 6.5.6 Calculate Balance for Types() This rule function is an advanced version of the Calculate Balance() rule function. It's designed so that it can be used in a Take rule, because the base object is EmployeeTime and you can pass the external code of the time type. It calculates the balance based on a given time type or time account type for a target user on a specific date. If multiple accounts are valid on that date, the balances of all valid accounts will be accumulated. Limitations ● This rule function does not consider the simulation of future leave. ● This rule function calculates the balance based on the information stored in the database already. Specifically, Time Type and Time Account Type are the only relevant parameters. If you're in the middle of a change scenario, any recent changes will not be not reflected by this rule function. Input Parameters For this parameter Make this entry Date The date for which the balance should be calculated. Selection Type Please choose “Enum” and select between Time Type or Time Account Type. User The target user. [List of] Time (Account) Type External Code Depending on what you selected for Selection Type, enter an external code of either a time type or time account type. If you add more than one value to this list, the resulting balan­ ces will be accumulated Related Information Calculate Balance() [page 589] 590 PUBLIC Implementing Time Management in SAP SuccessFactors Rules and Rule Functions in Time Management 6.5.7 Calculate Entitlement Balance() This rule function is used to retrieve the entitlement balance from a given time account with entitlement method “Entitled as Transferred” or time type for a given date. This is required for use cases where the accruals or entitlements need to be capped to a maximum value and the user needs to configure a rule based on current value of the entitlement balance. This rule function should return the entitlement balance that is available for use to the employee as of the given date. The entitlement balance is calculated per the following: Entitlement balance = Sum of entitlement postings + sum of manual adjustments + sum of interim transfers – sum of payouts – sum of employee times postings (also in the future). If both the time type and time account are passed, the time account takes precedence. Input Parameters For This Field Make This Entry User ID Select the