Work Item Search Syntax (Team System Web Access)
You can use the Team System Web Access search box to search for work items. In the search box you can specify keywords, phrases, and use variables and shortcut identifiers to find work items. Searching is not case sensitive.
Required Permissions
To perform searches in Team System Web Access, you must be a member of the Readers group or have the View work items in this node permission set to Allow. For more information, see Team Foundation Server Permissions.
Note
The information in this topic works only with Team System Web Access 2008 Service Pack 1.
Keywords and Phrases
Use keywords and phrases to find specific text in work items. Keywords are just typed into the Search box. Phrases must be enclosed in quotation marks. Team System Web Access searches the Title and Description fields for any keywords and phrases that you type.
The following are examples of how to use keywords and phrases in the Search box.
To find all work items with the keyword "duplication" in the title or description:
Duplication
To find all work items with the phrase "Getting Started" in the title or description:
"Getting Started"
To find all work items with the phrase "Getting Started" and the keyword "feature" in the title or description:
feature "Getting Started"
Specifying Fields
You can also specify search criteria for fields other than Title and Description. To specify the work item field name, type the search string as shown in the following examples.
To find all of the work items that are in the Active state, specify one of the following two search strings:
system.State=Active
State=Active
To find all of the Bug work item types that are in the Active state:
State=Active WorkItemType=bug
Note
If the text for which you are searching contains spaces, you must enclose it in quotation marks. For example, when you search for work items assigned to a team member, use the format System.AssignedTo="FirstLast".
The following table lists the shortcut identifiers for several frequently used fields that you can use when you create a search string:
Shortcut |
Field |
---|---|
A |
AssignedTo |
C |
CreatedBy |
S |
State |
T |
WorkItemType |
The following examples show how to use a shortcut identifier that specifies the State field to search for work items.
To find all work items that are in the Active state:
S=Active
To find all bugs that that are in the Active state:
S=Active T=bug
Using the @Me Macro
You can also use the @Me macro to specify a search string for work items that are associated with you in some way. @Me is a macro that expands to your full name in any Team System Web Access search. Use the following examples to search for work items by using the @Me macro.
To find all work items assigned to me:
A=@me
To find all work items created by me:
C=@me
Search Operators
There are three operators that you can use when you specify search criteria. The following table describes each operator.
Operator |
Description |
---|---|
= |
The EQUALS operator. Use this operator to search for exact matches of text. |
: |
The CONTAINS operator. Use this operator to search for partial matches of text. |
- |
The NOT operator. Use this operator to exclude work items that contain certain text. |
The following examples show how to use operators when you create a search string.
To find all work items assigned to me:
A=@me
To find all work items where the discipline field contains the text "proj":
Discipline:proj
Note
Some fields, such as History and Description, cannot be searched with partial words. For example, if the History field contains the phrase "reproducible behavior" and you search for "History:repro" the work item will not be found. If you search for "History:reproducible" the work item will be found.
To find all work items that contain the keyword "triage" in the title or description, are not assigned to me, and are not closed:
triage -A=@me -S=Closed
To find all work items that contain the keyword "triage" but not "repro":
triage -repro
To find all active bugs that are assigned to me that do not contain the keyword "bugbash" in the title.
S=Active W=bug A=@Me -Title:bugbash
See Also
Tasks
How to: Search for Work Items (Team System Web Access)