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 could later refer to that job and see which files were changed.

See Creating and Editing Jobs for additional information.

Accessing jobs

Select 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 pulldown menu at the top of the page has these additional options:

• View fixes for job - Shows you which changelists (if any) contain fixes for this job. A "fix" means that the job has been completed.
• View field descriptions - Gives you more information 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:

• To change the order in which the jobs are sorted, click the radio button next to either highest or lowest. Select "highest" to view the job with the highest number first. The list is sorted alphabetically, so if you've named your jobs (rather than using the automatic numbering), the job names closest to the beginning of the alphabet are first. Select "lowest" to view the job list from the bottom up. The default is highest.

• To change the number of jobs that you see in the Jobs list, enter the desired number in the jobs text box. The default is 10 .

• To see only the jobs that are fixed by edits to files in a specified path,
  1. Navigate to the desired path.
     
  2. Once you are in the desired path, select 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 may limit your view of jobs to those that match particular criteria using Jobview.

• You can select which fields are displayed in this view by selecting 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.