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)

Other Resources

Searching for Work Items (Team System Web Access)