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
- Go to View > Jobs.
- In the Jobs tool window, right-click anywhere in the job list pane and select New Job…
-
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.
- Click OK.
Editing jobs
- Go to View > Jobs.
- In the Jobs tool window, right-click a job row and select Edit Job….
-
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.
- Click OK.
Displaying jobs
To view jobs:
-
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/…
) - Click Filter.
- 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:
- Open the Submit dialog.
-
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.
- Specify the Job status upon submit:
open
, suspended
, orclosed
.
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 |
---|---|---|
|
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". |
Displays jobs containing all the words "filter", "file", and "mailbox" in any of the job fields. |
|
Displays jobs that contain any of the specified words. Pipes represent the boolean "or". |
Displays jobs containing the words "filter", "file" or "mailbox". |
|
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). |
Displays jobs that contain "filter" and do not contain "file". |
|
Displays jobs that include the specified value in the specified field. |
Displays open jobs owned by |
|
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). |
Displays unclosed jobs affecting the |
|
Displays jobs that contain the specified value in the specified field, including any combination of characters in the position of the asterisk wildcard. |
Displays jobs in which the value of the field |