Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create assignment workbench matching criteria

Create one or more matching criteria that can be used in an assignment workbench configuration.

Before you begin

Role required: admin

About this task

The assignment workbench uses configurable matching criteria, such as skills and availability, to evaluate agents in a selected group and provide an overall ranking. The Matching Criteria [matching_dimension] table stores the individual criterion that can be added to a matching rule to create an assignment workbench configuration.

Procedure

  1. Navigate to All > Routing and Assignment > Criteria.

  2. Click New.

  3. Enter a Name and a Description for the criterion.

  4. Select the Type of matching criterion.

Simple MatchCreates a one-to-one match. For example, match the time zone of an agent with the time zone of a task location.
AggregateTakes a simple query as an input and provides aggregate results. The query returns a set of users.
ScriptedIncludes a scripted query which returns a list of users.
  1. To create a Simple Match criterion, fill in the following fields.

    FieldDescription
    Applies toThe type of task that this criterion applies to.
    FieldThe field from the selected task table that you want to match.
    Resource TableThe table that stores the resource to use for this matching criterion.
    Resource Matching FieldThe field from the resource table that you want to match.
    Resource FieldThe resource field to be displayed for the task records that match the resource records.
  2. To create an Aggregate criterion, fill in the following fields.

FieldDescription
Aggregate TableThe type of task that this criterion applies to.
Aggregate FilterUse the condition builder to create a query that returns a set of users from the selected task table. For example, create a query that returns customer service cases with the following states: New, Open, Awaiting info.
Aggregate FieldThe field from the selected task table to be displayed for the task records that match the query conditions.
  1. To create a Scripted criterion, fill in the following fields.

    FieldDescription
    ScriptCreate a customized script which returns a list of users. An example script is included. The expected return from a customized script is an array of resource sys_ids.
    Aggregate FieldThe field from the selected task table to be displayed for the task records that match the query conditions.
  2. Enter a Display Name.

  3. Enable the Use Reference field.

    If you use a reference field, fill in the following fields.

    FieldDescription
    Reference TableThe table that stores the referenced information.
    Reference FilterAdd filter conditions to return the desired reference information.
    Reference FieldThe field from the selected reference table to be displayed for the records that match the filter conditions.
    UI Filter LabelThe label for this field that appears on the assignment workbench
  4. Click Submit.

Related topics

Matching criteria for case assignment