Using jobs (defect tracking)

Jobs enable you to record requests for work. You can associate jobs with changelists to track the work done to fulfill the request. When you submit the changelist, the job can be closed.

Creating jobs

  1. Go to View > Jobs.
  2. In the Jobs tool window, right-click anywhere in the job list pane and select New Job…​
  3. Fill in the Job form.

    The fields that appear on the Job form depend on the customizations set up by your Helix Server administrator. For more information, see Helix Core Server Administrator Guide.

  4. Click OK.

Editing jobs

  1. Go to View > Jobs.
  2. In the Jobs tool window, right-click a job row and select Edit Job…​.
  3. Update the Job form.

    The fields that appear on the Job form depend on the customizations set up by your Helix Server administrator. For more information, see Helix Core Server Administrator Guide.

  4. Click OK.

Displaying jobs

To view jobs:

  1. Go to View > Jobs.

    In the Jobs tool window, enter search terms in the Keywords field or the depot directory path in the Folder/file field.

    For keyword syntax, see Filtering Expressions.

    Use the Folder/file field when you know the location of a file that is included in an associated changelist. Enter the directory path using Helix Server syntax (//depot/folder/folder/filename or //depot/folder/…​)

  2. Click Filter.
  3. Click a job row to view details about the job.

To change the order in which columns are displayed, drag the column headings right or left to the desired position. To sort by column, click the sort arrow on a column heading.

Associating changelists with jobs

To add a job to a pending changelist:

  1. Open the Submit dialog.
  2. Select a changelist in the Link jobs to changelist list.

    If the job you want is not on the list, add it by clicking Browse…​. In the Jobs Browser, find and select the job you want. For keyword syntax, see Filtering Expressions.

  3. Specify the Job status upon submit: open, suspended, or closed.

You can also add a changelist to a job by editing the job. For more information, see Editing jobs.

Filtering Expressions

Valid job filtering expressions are as follows:

Syntax Description Example

word word word

Words separated by spaces indicate that the job must contain all the words in the string in any of the job fields to be included in the filter. Spaces represent the boolean "and".

filter file mailbox

Displays jobs containing all the words "filter", "file", and "mailbox" in any of the job fields.

word | word | word

Displays jobs that contain any of the specified words. Pipes represent the boolean "or".

filter|file|mailbox

Displays jobs containing the words "filter", "file" or "mailbox".

^word

Displays jobs that do not contain the specified word. The 'not' (^) operator cannot be used alone or with the 'or' operator (|), only with the 'and' operator (& or space).

filter ^file

Displays jobs that contain "filter" and do not contain "file".

fieldname = value

Displays jobs that include the specified value in the specified field.

status=open owner=edk

Displays open jobs owned by edk.

^fieldname = value

Displays jobs that do not include the specified value in the specified field. The 'not' (^) operator cannot be used alone or with the 'or' operator (|), only with the 'and' operator (& or space).

^status=closed& subsystem=parser

Displays unclosed jobs affecting the parser subsystem.

fieldname = value +*

Displays jobs that contain the specified value in the specified field, including any combination of characters in the position of the asterisk wildcard.

owner=*ed*

Displays jobs in which the value of the field owner contains the substring ed, including such values as Ted, Edk, and Fred.