Add a timer control to the Case form to track time against an SLA
Applies to Dynamics 365 for Customer Engagement apps version 9.x
Add a timer control to an entity form to help users gauge the amount of time they have to complete a task—typically as specified in a service level agreement (SLA). The timer control initially displays a count-down timer to show the time remaining to complete the task.
On a case form, the timer control can show any of the following, depending on the actions of the customer service representative (CSR) and what you specify when you set up the timer control:
If the CSR completes the task within the time remaining, the control shows the word Succeeded.
If the CSR doesn’t complete the task within the time remaining, the control shows the word Expired.
As the timer counts down, the color changes to yellow as the time remaining nears non-compliance. If the time remaining expires, the timer shows the word Expired. Then the timer color changes to red and the timer starts counting up to show the elapsed time since the task should have been completed. This behavior is optional.
If a condition causes the milestone to be canceled, the control shows the word Canceled. This behavior is optional.
If either of the required fields in the Timer Control dialog box do not have a value in the record, the control shows the words Not Set.
- The instructions in this topic apply if you're adding a timer to track time for the date/time field of any entity, or for tracking time against standard SLAs on case records. If you are using enhanced SLAs and want to add a timer to your forms, see Add a timer to forms to track time against enhanced SLAs.
- The timer control is designed to visually show the current state or show the remaining or elapsed time relative to the date and time as specified in the Failure Time field of the SLA KPI Instance. It doesn’t calculate or keep track of the time for which the Pause condition is true.
The above screens showcase the timer control on a Unified interface based app. On a webclient app, the timer control is displayed as follows:
For more information, see: Track SLA details with Timer Control
Add a timer control to the Case form
Make sure that you have the System Administrator or System Customizer security role or equivalent permissions.
Check your security role
Follow the steps in View your user profile.
Go to Settings > Customizations.
Select Customize the System.
In the solution explorer, in the left nav pane, expand Entities, expand the Case entity, and select Forms.
To add the timer to the form so the customer service representatives can use it in the Customer Service Hub, open the case form of type Main.
Select on the form where you want to place the control. You can add it anywhere except the form header or footer.
On the Insert tab, in the Control group, select Timer.
In the Timer Control dialog box:
In the General section, type a name and label for the control.
Under Data Source, next to Failure Time Field, select the date-time field that represents the time when a milestone should be completed. For example, select the First Response By field.
Next to Success Condition, select a field to use to evaluate the success of the milestone, and then select the condition that indicates success. For example, select the First Response Sent field, and then select Yes to indicate the success criteria of the First Response metric. This setting is required.
Next to Failure Condition, select a field to use to evaluate the failure of the milestone, and then select the condition that indicates the failure. For example, in the first drop-down list, select IsEscalated. In the second drop-down list, select Yes.
Next to Warning Condition, enter the condition that will cause the timer control to display a warning when the time is about to expire. For example, in the first list next to Warning Condition, select First Response SLA Status. In the list to the right, select Nearing Noncompliance. This setting is optional.
Next to Cancel Condition, select a field to evaluate whether the achievement of the milestone should be canceled. Then choose the option that indicates the milestone is canceled. This setting is optional.
Next to Pause Condition, enter the condition that will cause the timer to pause the count down. For example, you want the timer to pause the count down every time the case status is set to “On-hold”. For this, in the first drop-down list, select Status. In the second drop-down list, select On-hold.
Select OK to add the control to the form.
The timer control refreshes on the OnChange form event, and also when the form is loaded.
You can add a timer control to a form based on any record type (entity), including custom record types.
You can add multiple timer controls for different key performance indicators (KPIs).
You can add a timer control to any Main or Main - Interactive experience form of other entities, but timer controls are not displayed in Dynamics 365 for tablets.