Symptom
As of 2024 1H release, it is possible to set up time containers that store data from time valuations for a flexible period of 1, 2, 4 weeks or between 1 and 12 months based on daily time container results from that period. SAP Help Implementation Guide: Flexible Periods in Time Valuation
Prerequisite: Time Tracking must be enabled, and Time Tracking requires individual license.
In this KBA we provide a sample Time Valuation configuration for a scenario in which an alert is raised when accumulated overtime (OT) exceeds 14 hours within a quarterly period (3 months).
The example demonstrates how Time Valuations can be used to store calculated OT in a Time Container and trigger an alert when the accumulated OT reaches the defined threshold during a quarterly flexible period.
Environment
SAP SuccessFactors Time Tracking
Resolution
Important notes:
- The configuration provided in this KBA is intended for reference purposes only. When implementing flexible-period time valuations, the configuration may need to be adapted to meet your specific business requirements.
- The Time Valuation configuration used to calculate overtime (OT) is not covered in this KBA. For guidance on that please check SAP Help Implementation Guide: Best Practice Examples of Time Valuations
- In the example below, the input time type group BLUE_OT_INPUT (Step 1.B) contains the OT hours that have already been calculated and serves as the input for the subsequent Time Valuation configuration.
- Set Up Daily Time Containers for Flexible Periods
- Create a time type group BLUE_OT_CONTAINER as a daily base time container to persist the OT time calculated.
Set Time Container Type to Yes.
Set Period Result to No. - Create an Aggregate Input Group and Split time valuation BLUE_OT_COLLECT to move the calculated OT value in BLUE_OT_INPUT to the time container BLUE_OT_CONTAINER (created in step 1.A).
The time type group BLUE_OT_CONTAINER (created in step 1.A) should be set to Time Type Group Above.
Input Time Type Group BLUE_OT_INPUT is the time type group that holds OT hours already calculated.
Because this time valuation is simply to persist the calculated OT from Input Time Type Group BLUE_OT_INPUT into time container BLUE_OT_CONTAINER (created in step 1.A) in Time Type Group Above, the Threshold Type is set to Fixed Value, and Threshold Value is set to 0. - Create a time container time type group BLUE_OT_READER to retrieve value persisted in time container BLUE_OT_CONTAINER (created in step 1.A) to be available for time valuation.
Set Time Category to Time Container.
Time type group BLUE_OT_CONTAINER (created in step 1.A) should be maintained under Time Container Group.
- Create a time type group BLUE_OT_CONTAINER as a daily base time container to persist the OT time calculated.
- Set Up Time Containers for Flexible Periods
- Create a time type group BLUE_FLEX_OT to hold the OT hours within the flexible period, here in this example, in a quarter.
Please set Period Result as Yes first. After Period Result is set to Yes, the screen refreshes, and then the Base Unit and Number of Base Units fields will appear.
Set Base Unit as Month.
Set Number of Base Units as 3, because in this example it is a quarterly valuation.
<You can set whichever number of months here from 1 to 12, depending on your requirement of the flexible period.>
Reference Date is the start date of the flexible period. - Create an Aggregate Input Group and Split time valuation BLUE_OT_FLEX_ALERT to raise alert when a certain threshold OT hour (14 hours in this example).
Input Time Type Group is the container time type group BLUE_OT_READER (created in step 1.C) which retrieves the OT hours persisted in the time container BLUE_OT_CONTAINER (created in step 1.A).
Time Type Group Above is the BLUE_FLEX_OT (created in step 2.A) to hold the values above the defined threshold, here in this example, Fixed Value is Threshold Type, and 14 is the fixed Threshold Value.
Valuation Method should be Valuate Whole Sheet or Period.
<Technically it is possible to use other Valuation Method than Valuate Whole Sheet or Period, but here in this example, Valuation Whole Sheet or Period is needed to check whether OT has reached the threshold or not in a quarterly flexible period.>
Message Flag is Raise Message on Time Type Group Above.
Message Type is Alert and Warning. Please note, currently 'Message Type = Error' is not supported by a time valuation that is influenced by a time container.
- Create a time type group BLUE_FLEX_OT to hold the OT hours within the flexible period, here in this example, in a quarter.
- Assign the time valuations BLUE_OT_COLLECT (created in step 1.B) and BLUE_OT_FLEX_ALERT (created in step 2.B) in a time recording profile.
- After the time recording profile is assigned to the employee in Job Information portlet, alert would be raised if more than 14 hours OT are recorded within a quarter.
Such alerts can be found in Admin Alerts UI for Time Valuation Alert or in Time Sheet UI instead of Administer Time of the employee.
After the above configurations, once the employee has recorded more than 14 hours OT in a quarter, there would be alert "BLUE_Q>14" raised.
In Admin Alerts, the alert can be found under Time Valuation Admin Alert Type.
And in Time Sheet UI, same alert would be displayed too.
Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.
Please consider the following allowed Time Container configurations. Source: SAP Help - Flexible Periods in Time Valuation
Keywords
TIM-37837, TIM-38311, TIM-38315, TTR, TV, flex, period, valuation, evaluate, valuate, evaluation, semi, monthly, quarterly, yearly, TIM-40723, time container, time pay type, annual, weekly, , KBA , LOD-SF-TTR , Time Tracking , LOD-SF-TTR-TMS , Time Sheet , How To
SAP Knowledge Base Article - Public