Tickets

[[include in-progress (not found)]]

Tickets Overview

SourceForge's ticket tracker tool is designed to allow for flexibility in how you track items of work that need to be completed. This includes bugs, feature requests from end users, or any other task you want to keep track of. You can even install multiple trackers for different purposes. For example, a large project could have individual trackers for the design team, the documentation team, the developers, and another for support. Each of these trackers can have their own unique list of tickets, as well as custom fields, custom milestones, and their own "mailing list." Tickets can even be moved between tickets instances, even if they're on different projects.

Features:

The feature set of the tracker is designed around the fundamental belief that a ticket is a set of data about what needs to be done. In addition, it's a way to structure conversations about how to do that work. The tracker includes:

• integrated comments/mailing list
• integrated markdown-style formatting support
• custom fields
• rich search syntax
• saved searches
• bulk edit
• individual and tracker wide e-mail subscriptions
• tagging

Integrated Comments and E-mail Subscriptions

One of the fundamental features of the tracker is that every ticket is its own mini-mailing list. Ultimately this idea comes from another bug tracker roundup which called the idea nosy lists. The idea is that everybody who edits or comments on a ticket is added to a mailing list (along with anybody who subscribes to that ticket). That mailing list is integrated with the in-page comments for that ticket, and makes it easy to keep up with the tickets in various trackers that interest you.

If you have your e-mail address set up in your SourceForge account, you'll automatically be subscribed to any ticket you edit.

You can also click the subscribe link (e-mail icon) on any ticket page to subscribe/unsubscribe from any ticket's mailing list.

If you'd like to subscribe to every change/every comment on the whole tracker there's another subscribe link right at the top of the mail tracker page.

Integrated Markdown-Style Formatting Support

Like the Wiki, the Discussion, and all of the other new forge tools, you can use markdown syntax to create rich formatting of your ticket text, or comments on tickets. For more information on using markdown syntax, see our Markdown Syntax Guide.

Custom Fields

If you are an admin on a project you can add and delete custom fields for your tracker. Custom fields can be used to track everything from a list of components, to the relative size of the ticket, the QA person responsible for the ticket, or (hopefully) anything you can imagine.

You can edit the Custom Fields for the tracker under Admin -> Tools for your project. Where your "tickets" instance is mentioned, select "Field Management"

There's a button there to add a new field. Custom fields have the following options:

• label: What the custom field is called
• Show in list view: whether or not this field should display in searches or other ticket listings.
• Type:
• Text: Allows free form text
• Number: is displayed as a free form text field, but will only allow numbers to be submitted
• Boolean: a checkbox that can be checked or unchecked (ie., true/false)
• Select: Offers users a dropdown of preselected options. The options are space delimited, and a * prefix will designate a default selection (otherwise the first option will be the default)
• Milestone: a milestone field will
• User: a drop down that lists project members

Rich search syntax

You can do full text searches for tickets at any time, but sometimes you want a bit more. You want to be able to filter results by milestone, or by who's working on the ticket, or by status, or some combination of the above.

Searches use the solr lucene query syntax. On a search page, like the Allura ticket search, you'll see a "Help" button which will show the different available search fields and some search examples.

Saved Searches

If you have a search that you want all users of the tracker to be able to share, you can save that search with a name, and it will be placed in the left nav bar of the tracker for everybody to use. Commonly saved searches are "all open tickets," "all unassigned tickets," etc. You can use these saved searches to watch the flow of tickets through the system, and make it easier for your development team to focus on groups of active tickets.

Bulk Edit

To edit a group of tickets all at once, just start with any search that returns the tickets you want -- and then click the Bulk Edit button at the upper right of that page (ie., the pencil icon). Check the boxes on the tickets you want to edit, and enter the new values for the tickets in the form provided.