Jobs

JobsA job is a component of the Helix Versioning Engine's defect tracking system and describes work to be done, such as a bug fix or improvement request. Associating a job with a changelist records which changes fixed the reported problem or added the requested improvement. are a component of Helix Core'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 the Jobs link in the main toolbar.

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=slord swarm displays jobs that the user slord has reported that also contain the word swarm in its description.

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

Adjusting Jobs columns

You can configure the columns that are displayed:

  1. Click the button beside the search field to display a tooltip menu showing all of the available jobspecA job specification is a template describing the fields and possible values for each job stored in the Helix Core machine. fields.
  2. While the tooltip menu is displayed, check or uncheck the columns to configure which columns to display.
  3. Click the button again, or a blank portion of the page, to hide the tooltip.

You can also adjust the order of the columns, in one of two ways:

  1. With the tooltip menu displayed, click and drag column labels up or down to adjust their position.
  2. When the tooltip menu is not displayed, click a column heading and drag it to the left or right to move the column to a new position.

The column display updates as columns are rearranged:

For more information on customizing jobspecs, see "Job Specifications" in Helix Versioning Engine Administrator Guide: Fundamentals.

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 lower portion of the job presentation lists all of the keys configured in your Helix server's jobspecA job specification is a template describing the fields and possible values for each job stored in the Helix Core 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 "Job Specifications" in Helix Versioning Engine Administrator Guide: Fundamentals.

Note

The default Helix Core job specification contains very few fields. Adding fields to record additional information, such as the modification time and userid, reporting time and userid, can assist Swarm use appropriate terminology when describing the current disposition of a job.

Adding 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 Versioning Engine 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.
Note

If you attempt to add a job to a review that affects a single project, Swarm applies the project's job view filter to display only jobs that affect the project. It is not currently possible to expand the filter to include jobs outside of the project.

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.