Working with Jobs

The type of information tracked by the jobs system can be customized, using the jobspec. Fields in the jobspec form can be added, changed, and deleted by Perforce superusers, using the Perforce command-line client.

Using changelists, you can associate files with jobs, so that you can see which files were revised while working on a particular job. For instance, if a job involves fixing a bug, and several files were changed during that fix, you can refer to that job later to see which files were changed.

See Creating and Editing Jobs for additional information.

Accessing jobs

Click the Jobs tab to access jobs by name. Click on any job in the list to see more information about that job. While you are viewing a specific job, the Action menu at the top of the page has these additional options:

• View fixes for job: Lists any changelists that contain fixes for this job. A "fix" means that the job has been completed.
• View field descriptions: Displays details about the individual fields in the Jobs list. For more information, see Job Field Descriptions.

Fixing jobs

To fix a job (that is, change its status), you attach it to a changelist, to indicate that the files submitted in the changelist contain the changes required to complete the work required by the job. If you attach a job to a pending changelist, the job is fixed when you submit the changelist. If you attach a job to a submitted changelist, the job status is changed immediately.

To fix a job:

1. Browse to the pending or submitted changelist page.
2. Click the link to the changelist that fixes the job. The changelist is displayed.
3. From the dropdown list, choose Add Job to Changelist... A list of open jobs is displayed.
4. Click the job you want to fix. The changelist is redisplayed, listing the selected job.
5. Click Add Jobs.
6. Optional: select the desired job status from the dropdown list below the job list.

Customizing the Jobs view

You can customize your view of the Jobs page by using the constraints listed at the top of the page next to the Filter button. You can customize the following options:

• The list is sorted alphabetically. To choose the sort order, click highest or lowest.

• To specify the number of jobs that you see in the Jobs list, enter the desired number in the jobs text box.

• To see only the jobs that are fixed by edits to files in a specified path:
  1. Navigate to the desired path.
     
  2. Click the Jobs tab.
     
  3. On the Jobs list, check the if fixed in this path checkbox.

• To include jobs whose files have been integrated into files in this path, check the including integrated files checkbox.

• You can limit your view of jobs to those that match particular criteria using Jobview.

• To specify the fields displayed in the list of jobs, click the triangle at the top left corner of the table and check the desired fields. If Javascript is disabled, select the desired fields from the Visible Fields list. To select more than one field in this list, hold down the Ctrl key while selecting the desired fields. To select several fields concurrently, hold down the Shift key while selecting.

To save your preferences, bookmark the page.