Jobs

JobsA user-defined unit of work tracked by Helix server. The job template determines what information is tracked. The template can be modified by the Helix server system administrator. A job describes work to be done, such as a bug fix. Associating a job with a changelist records which changes fixed the bug. are a component of Helix server's defect tracking system and a record of bugs found or improvement requests. Jobs can be associated with changelists to create fix records, indicating the work that solved the problem or provided the requested feature. Begin browsing jobs by clicking Jobs in the menu.

You can search available jobs by entering a job filter in the search box. Words, phrases, and field=value pairs can be entered. For example, entering reportedby=steve.russell swarm displays jobs that user Steve Russell has reported that also contain the word swarm in the description.

The fields you can search for depend on the jobspecA form describing the fields and possible values for each job stored in the Helix server machine. defined in your Helix server.

Edit the Job columns

Configure the columns that are displayed:

1. Click the Select Columns button beside the search field to display the dropdown menu. The dropdown menu shows all of the available jobspecA form describing the fields and possible values for each job stored in the Helix server machine. fields.
2. Select the columns to display using the checkboxes in the dropdown menu.
3. Drag the column label up or down the list to change the order the columns are displayed in.
4. Click the Select Columns button again, or a blank portion of the page, to hide the menu.

Change the column order from the Jobs page:

1. Click a column heading and drag it to the left or right to move the column to a new position.
2. The column display updates as columns are dragged.

For more information on customizing job specifications, see Customizing Helix server: Job Specifications in Helix Core Server Administrator Guide.

Job display

Jobs are typically identified with the word job followed by six digits, e.g. job000123.

View a specific job by clicking on a linked job identifier, or by visiting the URL: https://myswarm.url/jobs/jobid.

When Swarm displays a job, the presentation is similar to:

The upper portion of the job presentation includes:

• The avatar and userid of the user that created the job
• The job's creation time
• If changes have been made to the job, the modifying userid and time
• A status indicator
• The job's description
• If any changelists have been submitted that fix the job, a list of those changelists and their descriptions. Each associated changelist includes an icon to represent their type: (review), (pending), (committed)

The lower portion of the job presentation lists all of the keys configured in your Helix server's jobspecA form describing the fields and possible values for each job stored in the Helix server machine.. Swarm inspects the jobspec and enhances the presentation of fields it recognizes. For example, date fields display as time ago, and links are created for userids.

Click the Comments tab to view any comments added to the job, or to add a comment.

Adding a comment sends a notification. The Comments tab displays the number of open comments associated with the job. If you hover your mouse over the comment count, a tooltip is displayed showing how many comments are archived:

For more information on customizing job specifications, see Customizing Helix server: Job Specifications in Helix Core Server Administrator Guide..

Add jobs

Swarm does not provide the ability to create new jobs in the Helix server, but jobs can be added to changelists or reviews:

1. Navigate to a changelist or review.
2. Click the Add Job link .

3. Scroll through the available jobs, or enter job search criteria to search available jobs.

   

   For more information on job search criteria, see Jobs in Helix Core Server User Guide.

4. If you find the job you want to add, click its row to highlight it and then click Select. Or, double-click the desired job to add it.
5. If you do not find the appropriate job, click Cancel.

Unlinking jobs

Swarm does not provide the ability to delete jobs from the Helix server, but jobs can be unlinked from changelists or reviews:

1. Navigate to a changelist or review that has an associated job.
2. Click the X button beside the job.
3. When prompted for confirmation, click Unlink to unlink the job.