› Queries › Create a Work queue query

Create a Work queue query

A Work queue query helps you to search for required activities.

  1. Navigate to Queries > Work queue queries.

    The Work queue queries page appears.

  2. Click New.

    The New workqueue query dialog box is displayed.

  3. Enter a Name for the query.
  4. Select the Category in which to create a work queue query.

    By default, the query is added to your working category.

  5. Optional. Select Return query total to view the total number of items matching the query.

    At runtime, the total number of items regardless of the retrieval limit specified in the query is displayed.

    If you select this option, there may be a performance overhead.

  6. Specify the Filter criteria.
  7. Define the metadata.
    1. Select a Work type and the Filter operator.
    2. Configure and add the required meta fields.
  8. Add columns, provide access control, sort columns and work queue query filter fields in the query.
  9. Click Save.

Filter criteria for a work queue query

The following table describes the work queue fields available as search criteria:

Work queue field

Description

Activity name

Name of the activity.

Type

The type of activity. All, Normal, or Alert. (Default: All)

Assigned to

Includes Me, Me and My groups, My direct subordinates, Me and My direct subordinates, My subordinates, and Me and My subordinates.

  • None (default)

  • Me: The activity is assigned to you.

  • Me and my groups: The activity is assigned to you and the groups you are part of.

  • My direct subordinates: The activity is assigned to your direct subordinates.

  • Me and my direct subordinates: The activity is assigned to you and your direct subordinates.

  • My subordinates: The activity is assigned to the people that report to you and the people that report to them.

  • Me and my subordinates: The activity is assigned to you, to the people that report to you, and to the people that report to them.

Activity SLA

Current status of the activity. All, Green, Amber, Red (Default: All)

The activity SLA status is the visual representation of the activity status on your work queue to indicate if the activity is within or has exceeded the set time limits, that is, target duration.

Priority type

Allows selection of Activity or Job as a priority. (Default: Activity)

Priority

For Activity priority, accepted values are from 1 to 10 and for Job priority, accepted values are from 1 to 100. 1 being the highest and 10/100 lowest.

Retrieval limit

The number of the latest activities that are to be retrieved from the server at a given point in time.

Case tasks only

If selected, allows the display of activities that belong to cases.

The following table describes the job fields, dates, and metadata available as search criteria.

Work queue field Description

Job ID

The ID of the case job.

Process

Select a process based on which the job is created.

Job SLA

The status of the job. All, Green, Amber, Red (Default: All)

The job SLA status is the visual representation of the job status on your work queue to indicate if the job is within or has exceeded the set time limits (target duration).

Case reference

Case reference based on which the job is created.

Job state

Name of the state associated with the process.

Due date order

Allows selection of Activity or Job. (Default: Activity)

Due date

Includes All, Since, Between, Today, This week, This month, and This year.

If the due date option is "Since" or "Between", you can provide a value to be "@Today" or a certain number of days from today in the following format:

@Today +/- NUM. For example, <@Today - 7>

Metadata

Creates filter criteria by selecting the work type and corresponding fields. See Create metadata.