SAP Knowledge Base Article - Public

2938249 - Troubleshooting Time Off Recalculation

Symptom

This is a collection of useful KBA articles, handbook guide and troubleshooting steps in Time Off Recalculation.

Environment

SAP SuccessFactors Employee Central - Time Off

Resolution

FAQ Index:

 

Q. How to enable recalculation?

A. Refer the steps in the guide Enabling Recalculation

Q. What triggers a recalculation?

A. Recalculation in Time Management is triggered by:

  1. Changes to any of the following Time Information field(s) in the employee's Job Information:
    • Work Schedule (standard or individual)
    • Time Profile
    • Holiday Calendar
    • Time Recording Profile
    • Default Overtime Compensation Variant
    • Job information fields which are marked as recalculation relevant on a Time Account Type level (example: "FTE") as well as changes in the job information itself, such as terminations.

Note: Changes within these objects do not automatically trigger a calculation. For example, if you modify the holiday calendar object, no recalculation takes place. (Refer KBA 2328948 - How To Recalculate Leave Balances When Holiday Calendar Is Updated)

2. Changes to the following Time Management data can also a trigger recalculation:

Absence data in Time Off
● Temporary time data

For more details Refer Recalculation Triggers in Time Off

Q. How to View Time Management Recalculation Results from the Execution Manager Dashboard

A. Recalculation events are processed by default as Time Management evant-based tasks.

  • 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 recalculat
  • 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.

    Q. Why recalculation did not trigger?

    A1. Accruals are not Recalculated

    Checks Next Steps
    • Recalculation should be enabled.
    • In Manage Data -> Time Management Configuration, check if recalculation is enabled.
    • The Trigger Tasks Job (or TLMTriggerTasksJob) must be scheduled to run nightly via Provisioning, and should be running successfully.
    1. Navigate to Provisioning > Manage Scheduled Job > Check if the "Trigger Taks Job" is scheduled to run nightly. If not, please create the job schedule the same.
    2. If Job is scheduled already > Navigate to Monitor Jobs (in provisioning) > Check if the "Trigger Taks Job" is running daily and successfully (i.e status of the job run is 'completed').
    • Is there an accrual posting present in the employee's time account (In Administer Time/Workbench UI)?

    If no, then it's expected that recalculation doesn't occur since there is no existing accrual posting to recalculate.

    1. Run the accrual calendar for the time account type to create the missing Accrual postings.
    2. Make sure there is an Accrual posting under Administer Time ->Time Account Detail Postings.

    Note: The Time Account may show balance even without any Accrual (and/or Manual Adjustment postings). This could be due to the option 'Simulate Accrual' set to 'Yes' in the related Time Account Type. Therefore, to post accrual, follow the above steps.

    • Is the accrual posting in the Time Account a valid one that's posted by the system?
    • In Admin Tools > Check Tool > Validation tab > Check if the accrual posting is valid by running the check "TimeAccountAccrualWithEmptyPeriodIds".
    • There is also a quick fix to correct the posting type.
    After the fix, post valid accrual to the Time Account:
    1. Run the accrual calendar for the time account type to create the missing Accrual postings.
    2. Make sure there is an Accrual posting under Administer Time ->Time Account Detail Postings.
    • Navigate to the Time Account Process Simulator tool > Run the tool for an employee and related Time Account Type with recalculation flag enabled. Does it show the correct recalculated value?
    • The field that is updated in job information to trigger recalculation is defined as Recalculation Relevant field in Time Account Type?
    1. Navigate to Manage Data > Time Account Type
    2. Open the related Time Account Type  > Check if the field is added under 'Recalculation Relevant Field'.
    • The recalculation is not happening automatically, but it is reflected during simulation/creation of Time Management Recalculation Event (TMRE).
    • Check the accrual rule if you are using the "Key Date" rule functions. This ensures the system pulls the value of the job info field on the latest job info record, and not the value valid on Accruable start date.
      • KBA2557428 - Changing a Users Job Information Field Does not Trigger a Recalculation
    • Refer Guide: Job Information Rule Functions
      • Get Job Info Date Field Value On Key Date()
      • Get Job Info Numeric Field Value On Key Date()
      • Get Job Info String Field Value On Key Date() 
    • If absence change does not trigger an accrual recalculation.
    1. Check the related Time Type of the absence >  "Accrual Calculation Relevance" Field.
    2. If the field is set to 'none', then the time type is not relevant for recalculation.

    A2. Absences are not Recalculated / Absence Change does not Trigger a Recalculation

    Checks

    Next Steps
    • Recalculation should be enabled.
    • In Manage Data -> Time Management Configuration, check if recalculation is enabled.
    • The Trigger Tasks Job (or TLMTriggerTasksJob) must be scheduled to run nightly via Provisioning, and should be running successfully.
    1. Navigate to Provisioning > Manage Scheduled Job > Check if the "Trigger Taks Job" is scheduled to run nightly. If not, please create the job schedule the same.
    2. If Job is scheduled already > Navigate to Monitor Jobs (in provisioning) > Check if the "Trigger Taks Job" is running daily and successfully (i.e status of the job run is 'completed').
    • Changes within Time objects do not automatically trigger a calculation. For example, if you modify the holiday calendar object, no recalculation takes place.
    • If Flexible requesting is enabled on the Time Type, recalculation will not occur.
    1. Navigate to Manage Data -> Time Type
    2. Check if "Flexible Requesting Allowed" is set to 'Yes. (meaning flexible requesting is enabled).
    • Is there a Absence Counting Method/Absence Counting Configuration configured for the related Time Account Type?
    1. Navigate to Manage Data > Time Account Type > Check if Absence Counting Method/Absence Counting Configuration is configured.
    2. It may be configured with 'Consider Holidays' as 'No', therefore no absense recalculation will occur to recalculate absence created on a holiday.
    • Recalculation fails with error 'Your requested time off must include at least one workday. Please change the dates you've entered accordingly', for 1 day leave applied on the new holiday/non-working day.
    1. For the employee with 1 day leave, go to the associated time type and set 'Requesting on Non-Working Days Allowed' as 'Yes'
    2. Create the Time Management Recalculation Event (TMRE) to recalculate the absence.
    3. Once the absence is recalculated, change the 'Requesting on Non-Working Days Allowed' field in the time type back to 'No'
    Note: An enhancement is present to improve the behaviour  so that recalculation does not give error if absence exists on a day which becomes a holiday/non-working day later. Please reach out to your CSM/CEE to track the progress of the enhancement "TIM-31284".

     Q. In Which Order Is Recalculation Performed?

    A. The order of recalculation processes is 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.

    For more details refer Recalculation in Time Management - Process Overview

    @Technial Support: Refer internal memo

    See Also

    Recalculation in Time Management

    Recalculation in Time Management - Process Overview

    Recalculation in Time Off

    How Recalculation Affects Time Management Data

    Keywords

    Time Off, Recalculation, Trigger Recalculation, TLMTriggerTasksJob, Trigger Tasks Job, Trigger Task Job, TLMTriggerRecalculation, Accrual Calculation Relevance, recalculation is not working, recalculation is posting wrong balance, absence, accrual, Time Management Recalculation Event, TMRE, order of recalculation, not recalculated, recalculation trigger, troubleshoot recalculation, Your requested time off must include at least one workdayTIM-31284 , KBA , LOD-SF-EC-TIM-REC , Recalculation , LOD-SF-EC-TIM , Time Off , How To

    Product

    SAP SuccessFactors Employee Central all versions