Organizing queries by using tags in the web client
You can add tags to your personal or shared queries to help organize and retrieve your queries.
When you create a query or when you edit an existing query, you can add tags to your personal or shared queries to help organize and retrieve your queries.
About this task
- On the main menu, click Work Items, and then click Create Query.
- If you plan to save the query, in the query editor, type a name for the query.
- On the Conditions tab, click the plus sign icon, and then select an attribute to use as a query condition.
Click the Details tab. Enter a description of the query so that other
users can understand which work items the query returns. To add tags to your query, select
- Personal tags: Personal tags are used to organize queries in My queries; only the owner of the query can view and edit these tags.
- Shared tags: Shared tags are used to organize queries in
Shared queries. The Shared input section is only
enabled if the query is shared.Important: The ability to add, edit, or remove tags on a shared query is controlled by the Permissions page in the project area configuration page.
- Select .
- Select Permissions, and select the role of the person whose permissions you want to change.
- In the right pane, select
- Click Save.
Tags can be hierarchical; you can create a parent tag and add child and grandchild tags.
- Open a query and click Details.
- In the Tags section, place cursor in Personal text box, and type a name of your parent tag.
Beside the parent tag, type the name of the parent tag, and the name of a child tag:
Using the context menu beside the tag icon in the left pane, you can:
- Delete: Clicking Delete deletes the tag and all its child tags. It also updates all the queries that use these tags.
- Rename: Clicking Rename allows you to rename the tag.
Click My Queries tab, the
queries appear on the right pane, and the shared query icon appears indicating if the query has
been shared. You can view the queries by:
to see your personal queries. In the
- All queries: this lists all queries irrespective of whether they have tags.
- Untagged: this lists queries that are untagged.
The right pane of the queries page lists the queries. At the top of the right pane you can
select from a predefined filter to view:
In the Search text box beside the filter, you can further narrow down the search of your queries. For example, you could type Unresolved in the text box, and it will return any queries where the query name or description contains Unresolved. If you select a query or a few queries using the check box beside the query name, and then you clear the filter, the selections will remain checked.
- Shared and unshared queries
- Only shared queries
- Only unshared queries
From the context menu beside the query, you can:You can:
- Add Tags: You can add tags to the selected query.
- Remove Tag: If enabled, you can remove the current tag from the selected query.
- Open in a new tab: You can open the query in a new tab.
- Edit: You can make changes to the selected query.
- Delete: You can delete the selected query.
When you click a tag in a query on the right pane, that tag is also selected in the left pane:
When you have selected a personal tag in the left pane, and then click Create Query, the new query will contain the tags selected in the left pane:
- You can organize My Queries by dragging selected queries from the
right pane to the left pane. To drag a query to the left pane, click the drag handle of the query in
the right pane and drag it under a tag in the left pane. Note: The operation of organizing queries by dragging them under a specific tag is additive. It doesn't remove or replace existing tags.
When you click Shared Queries, your shared queries appear. The list that
appears includes queries that have been shared with you or with teams that you belong to. You can
share queries with a whole team or specific users. The queries are grouped by team area or by
predefined groups such as "Lifecycle Queries." You can use the drop down to Show Groups
(exclude empty) or Hide Groups. An icon beside a query indicates
if the logged-in user is the creator of the query:
At the top of the right pane you can select from a predefined filter to view queries that are:
- Any creator
- Created by me
- Created by others