Create a Job query

The Job queries help you search for required jobs and activities.

See Queries.

  1. Navigate to Queries > Job queries.
  2. Click New.

    The New job query dialog box is displayed.

  3. Enter a Name for the query.
  4. Select the Category in which to create a 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 are displayed.

    Note If you turn this setting on, there will 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 and sort columns in the query.
  9. Click Save.

Filter criteria for a Job query

The following table describes the fields available as filter criteria.

Job field

Description

Type

The type of job. Available options are: All, Job, Case, AssociatedJob, BusinessRule and Equals. (Default: All)

Created by

Includes the following options:

  • Static: (Default). Includes individual or group resource.

  • Dynamic: Includes the following resource options:

    • None (default)

    • Me

    • Me and my groups

    • My direct subordinates

    • Me and my direct subordinates

    • My subordinates

    • Me and my subordinates

Job owner

The resource who currently owns the job (Group or Individual). Available options:

  • Static: (Default) Includes group or individual resource.

  • Dynamic: Includes the following resource options:

    • None (Default)

    • Me

    • Me and my groups

    • My direct subordinates

    • Me and my direct subordinates

    • My subordinates

    • Me and my subordinates

Score

Specify the score rule. Score includes the following options:

  • Equals (Default: Equals, 0)

  • Greater than

  • Greater than equal to

  • Less than

  • Less than equal to

  • Not equal to

Priority

The priority of the activity (1 is the highest and 100 the lowest). (Default: All)

Category

The category under which the job is created.

Sub categories

If selected, shows the sub categories under which the job is created. (Default: Clear)

Retrieval limit

The number of the latest jobs to be retrieved from the server at a given point in time. (Default: 100)

The following table describes the job fields and date fields available as filter criteria.

Job field Description

Job ID

ID of the case job.

Case reference

Case reference based on which the job is created.

Process

Select a process based on which the job is created. The available versions of the process map appear on the Process version list, and the highest version number appears as process version.

Process version

Select the process version from the list. You can also select all versions. (Default: Highest version number of selected process)

Status

The following job statuses are available:

  • Active (default): Jobs which are currently in an active state, that is, actively progressing or in a state to progress.

  • Live and finished: Jobs which are currently live or finished.

  • Finished: Jobs which are completed or terminated.

  • Live: Jobs which are either not completed, terminated, awaiting completion or awaiting termination.

  • Completed: Jobs which have completed their life cycle as designed.

  • Ready for evaluation: Jobs which are in the process of re-evaluating what should happen next.

  • Pending: Jobs which have completed, but there are taken activities.

  • Suspended: Jobs which are suspended but can manually be reactivated to get them up and running again.

    Note The jobs that have failed evaluation cannot be suspended.

  • Terminated: Jobs which have stopped processing before completing the lifecycle.

  • On hold: Jobs which are on hold for a specific time to delay all event processing. When a job is placed on hold, exceptions, milestones and triggers are affected. When the hold time expires, the job moves to active status and the job activities become pending.

  • Awaiting associated jobs completion: Cases which are completed but still have active associated jobs.

  • Awaiting associated case completion: Associated jobs which are completed and awaiting case completion.

  • Terminated awaiting associated jobs completion: Terminated cases awaiting completion of associated jobs.

  • Terminated awaiting associated case completion: Associated jobs that have been terminated and awaiting case completion.

  • Evaluation failed: Jobs that have failed evaluation.

Job SLA

Current 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. Indicates if the job is within or has exceeded the set time or target duration.

Job state

Name of the state associated with the process.

Suspend reason

The reason for suspension of the job.

Start date

Completion date

The date when the job should start and complete.

Note If the 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 + 10>, <@Today - 7>

Due date

The date by which the job is to be completed.