Defining a Query

With a large number of issues defined in a repository, it can be difficult to keep track of which issues are assigned to who, and what their current status is. Queries allow you to define any number of 'Views' of this information and quickly switch between these views.

Queries are easy to create and allow more pertinent information to be displayed when required. They can also be used as the basis of reports. To create a new Query, select Action / New / Query from the main menu, or click on the New Query button in the toolbar. The Query definition dialog box will be displayed:

The General page allows you to enter a Name and Description for the query as well as to specify whether it is Temporary, User, or Shared. The Query page allows you to define the query itself.

The actual fields of the issue are displayed in the top list, and the current query definition is displayed below. To add a field to the query, select the field and press the Add button:

The actual contents of the dialog depend on what type of field is being added, but full selection criteria can be specified for each field.

The And, Or, Not, and Brackets buttons can be used to define complex relationships between the various criteria entered.

Pressing the OK button will create the new query. Selecting a query in the main window causes the query to be executed against all issues in the repository and the results to be displayed in the List Pane.

The results of a query are fully editable, and changes that affect the query results will cause the query to be re executed.

Note: if another user has created or modified an object since you have started TC Tracker, the new objects will not show up on your system until you do a refresh. To refresh the local cache, press F5, or select View / Refresh from the main menu.