工作项搜索语法 (Team Web Access)

可以使用 Team Web Access 搜索框来搜索工作项。 在搜索框中可以指定关键字和短语,还可以使用变量和快捷方式标识符来查找工作项。 搜索不区分大小写。

主题内容:

  • 指定关键字和短语

  • 指定字段

  • 使用 @Me

  • 使用搜索运算符

所需权限

若要在 Team Web Access 中执行搜索,您必须是**“Readers (访问者)”组的成员,或者将您的“查看此节点中的工作项”权限设置为“允许”**。 有关更多信息,请参见 Team Foundation Server 权限

指定关键字和短语

通过在**“搜索”框中键入关键字,您可以使用关键字和短语查找工作项的“Title”“Description”**字段中的特定文本。 必须将每个短语放入引号内。

下面的示例演示如何在**“Title”“Description”**字段中查找关键字和短语。

  • 若要查找包含关键字 duplication 的所有工作项,请键入下面的字符串:

    Duplication

    若要查找包含短语 Getting Started 的所有工作项,请键入下面的字符串:

    "Getting Started"

    若要查找包含短语 Getting Started 和关键字 feature 的所有工作项,请键入下面的字符串:

    feature "Getting Started"

指定字段

可以搜索**“Title”“Description”**之外的字段。 必须将每个短语放入引号内。 若要指定工作项字段名称,请键入如下示例中所示的搜索字符串。

  • 若要查找所有处于 Active 状态的工作项,请指定下面两个搜索字符串之一:

    system.State=Active

    State=Active

  • 若要查找所有处于 Active 状态的 Bug 工作项,请键入下面的字符串:

    State=Active WorkItemType=bug

  • 若要搜索分配给某个团队成员的工作项,请键入下面的字符串:

    System.AssignedTo="名字 姓氏"

可以使用快捷方式标识符代替一些常用字段的全名,如下表所示:

快捷方式

字段

A

AssignedTo

C

CreatedBy

S

State

T

WorkItemType

下面的示例演示如何使用两个快捷方式标识符。

  • 若要查找处于 Active 状态的任意类型的所有工作项,请键入下面的字符串:

    S=Active

  • 若要查找所有处于 Active 状态的 Bug 工作项,请键入下面的字符串:

    S=Active T=bug

使用 @Me

可以使用 @Me 宏来指定搜索字符串,查找与您在某些方面相关的工作项。 @Me 是一个宏,在任何 Team Web Access 搜索中均会扩展为当前用户的全名。在创建可与其他用户共享的搜索时,@Me 宏尤其有用,该宏可以减少您为指定自己的用户名而必须键入的字符数,从而简化您的工作。 以下示例演示如何使用 @Me 宏来搜索工作项。

  • 若要查找分配给您的所有工作项,请键入下面的字符串:

    A=@me

  • 若要查找您创建的所有工作项,请键入下面的字符串:

    C=@me

使用搜索运算符

可以使用三个搜索运算符来指定搜索条件,如下表所示。

运算符

说明

=

EQUALS 运算符。 使用此运算符可搜索文本的精确匹配项。

:

CONTAINS 运算符。 使用此运算符可搜索文本的部分匹配项。

-

NOT 运算符。 使用此操作符可排除包含特定文本的工作项。 NOT 运算符只能用于字段名称。

下面的示例演示创建搜索字符串时如何使用运算符。

  • 若要查找分配给您自己的所有工作项,请键入下面的字符串:

    A=@me

  • 若要查找 Discipline 字段包含文本 proj 的所有工作项,请键入下面的字符串:

    Discipline:proj

    提示

    对于诸如“History”“Description”等一些字段,不支持使用不完整的单词进行搜索。 例如,如果“History”字段包含短语 reproducible behavior,而您搜索 History:repro,则将找不到相应的工作项。 然而,如果搜索完整字符串 History:reproducible,则会找到相应的工作项。

  • 若要查找标题或说明中包含关键字 triage 且未分配给您的所有未关闭工作项,请键入下面的字符串:

    triage -A=@me -S=Closed

  • 若要查找分配给您且标题中不包含关键字 bugbash 的所有活动 Bug,请键入下面的字符串:

    S=Active W=bug A=@Me -Title:bugbash

请参见

任务

指定查询筛选条件

概念

查询字段、运算符、值和变量

查找 Bug、任务和其他工作项