Toggle menu

Case Routines

Routines are sequences of automated actions performed when a case reaches a trigger point. In the configuration for a case you can select a trigger point, then create a list of actions that should be performed. A case can have multiple trigger points, each starting a different routine and it is possible for the actions in one routine to trigger another.

Configuring a Routine

Routines have a dedicated section in the case configuration manager:

Routines Config Menu

Here you can see existing routines, which can be edited, and also create new ones:

Existing Routines

You can add and update routines at any time and your changes will be picked up by active cases.

Trigger Points

All routines start with a trigger. This is the point in the case that will cause the routine to run.

Note that the number of times you can use a trigger in a case will vary, depending on other settings. For example, if there is only one group a case could possibly be reassigned to, and you create a routine using the reassign trigger, you won't be able to create another routine using the reassign trigger. If there were multiple groups the case could be reassigned to, you could create a routine for each group.

Case Started

The routine will run when the case is raised. This happens before the case is assigned to a user so the reassign action is not available (you can assign new cases to users dynamically without routines, see the Assigning and Claiming Cases documentation).

Case Escalated

This trigger includes escalations from breached SLAs and manual escalations.

Case Reassigned

Before you can set up this trigger you'll need to enter at least one group in the "reassignment groups" configuration section. The routine will run when the case is reassigned to your chosen group.

Stage Changed

Pick an existing stage, set in the "stages" configuration section. When the case is changed to this stage, the routine will run.

Status Changed

Pick an existing status, set in the "status" configuration section. When the case is changed to this status, the routine will run.

SLA Breached

The routine will run when the case SLA is breached. SLAs can only be breached once.

Task Started

Pick one of the tasks that have been set up for the case. When the case manager creates the task, the routine will run.

Task Completed

When the chosen task is completed the routine will run.

Task Cancelled

If the chosen task is cancelled the routine will run.

Actions

When you first set up a trigger the configuration manager will guide you through to the actions section. Pick the action you'd like to be performed. Once you've set up one action you can add more at any time.

All actions include a "description" field. This description only appears in the configuration to help you identify the action and what it does.

Add Note

The note will appear in the case history. You can choose whether it's public or private and the name it will appear to come from (which needn't be a real user).

Reassign

Pick the user group the case should be reassigned to and the reassignment reason. Both of these drop-down fields are populated with options from elsewhere in the configuration manager - the reassignment groups from the "Groups" section, the reassignment reason from the "Reasons" section.

Update Stage

Pick a stage that has been configured for the case. The optional note will appear as a private note in the case history alongside the new stage.

Update Status

Pick a status that has been configured for the case. The optional note will appear as a public note in the case history alongside the new status.

Clear, Set, Pause and Resume SLA

These actions let you modify the case SLA. They each write an optional private note into the case history. If you set a new SLA it will start counting from when it is set, not from case opening time.

Close Case

This action closes the case. You'll need to pick one of the configured close reasons and can add an optional closure note. The closure note is public and visible to the user who raised the case.

Case History

The history below has been written as a result of a routine.

Routines History Record

The trigger was the creation of the "Site visit" task. It performed the following (reading bottom to top in the image above):

  • Added a public note
  • Paused the case SLA which included a private note
  • Changed the case status

The topmost/final entry summarises the actions performed.

Last modified on 14 August 2023

Share this page

Facebook icon Twitter icon email icon

Print

print icon