查询字段、运算符、值和变量
您查找并创建工作项列表通过创建工作项查询。 通过定义一个或多个子句,将从团队项目或团队项目集合中的所有工作项筛选返回设置感兴趣的工作项。 对于每个子句,指定字段、运算符或值或变量。 例如,可以搜索在特定团队项目的所有工作项通过指定 团队项目 字段、等号 (=) 运算符和团队项目的名称作为值。 而不是指定值,可指定变量例如 @Project,表示当前团队项目。
示例查询子句
And/Or |
字段 |
运算符 |
值 |
And |
团队项目 |
= |
@Project |
有关查询的更多常规信息,请参见查找 Bug、任务和其他工作项。 有关如何使用键盘快捷方式在查询编辑器或查询视图中进行导航的信息,请参见查询编辑器和查询结果视图的键盘快捷键。
主题内容
And/Or
查询字段和值
查询运算符
查询变量
全文和部分单词搜索
查询索引字段
有关如何定义查询子句的检查表:
在第一个空行,在 字段 "列标题下方,请选择的下箭头以显示可用字段的列表,然后选择列表中的项。
有关更多信息,请参见查询字段和值。
在同一行中,在 运算符 "列标题下方,请选择的下箭头以显示可用运算符的列表,然后选择列表中的项。
有关更多信息,请参见运算符。
在同一行中,在 值 列标题下,任何一个类型值或者选择的下箭头,然后选择列表中的项。
有关如何使用变量指定当前团队项目、用户或日期的更多信息,请参见变量。
若要添加子句,选择 单击此处添加新子句 或 添加新子句。
可根据需要向查询末尾添加子句、在现有子句后插入子句 (
)、删除子句 (
)、分组 (
) 以及取消分组 (
)。
And/Or
指定 和 或 或 创建查询子句逻辑表达式。 指定 和 查找与当前子句和上一子句中条件的工作项。 指定 或 查找与当前子句或上一子句中条件的工作项。
可以将每个工作项字段的新子句以便优化您的搜索条件,因此,它只返回所需的工作项集。 如果未获得预期的查询结果,可以对查询子句进行添加、移除、分组或取消分组,从而细化查询结果。
可以对查询子句进行分组,使其作为独立于查询的其余部分的一个单元来工作,这类似于在数学等式或逻辑语句中的某个表达式两侧加上括号。 在对子句进行分组时,组中第一个子句的**“与”或“或”**应用于整个组。
如以下示例所示,分组子句将转换为相应的逻辑表达式。 第一个表达式返回优先级为 1 的工作项,以及任何优先级所有活动 bug。 第二个表达式返回任何有效的优先级别 1 工作项,以及所有优先级别 1 bug 是否处于活动状态。
分组子句 |
逻辑表达式。 |
---|---|
![]() |
Priority=1 OR (Work Item Type=Bug AND State=Active) |
![]() |
Priority=1 AND (Work Item Type=Bug OR State=Active) |
有关更多信息,请参见指定查询筛选条件。
查询字段和值
您指定字段的值必须符合该字段的数据类型。 下表列出了支持的数据类型:
数据类型 |
存储的数据 |
---|---|
DateTime |
协调世界时(UTC)时刻。 可指定变量(如 @Today 或 @Today-1),也可指定值(如 1/1/2012)。 |
Double |
一个实数,如 0.2 或 3.5。 |
GUID |
一个表示唯一 ID 的字符串。 |
History |
自定义格式化用于的字段来跟踪历史信息。 此数据类型仅用于支持 历史记录 字段。 当全文搜索可用时,此字段进行全文搜索自动创建索引。 请参见本主题后面介绍的 全文和部分单词搜索。 |
HTML |
支持格式化说明的文本字符串,例如 说明 或 重现步骤 字段。 当全文搜索可用时,这些字段进行全文搜索自动创建索引。 请参见本主题后面介绍的 全文和部分单词搜索。 ![]()
在升级 Team Foundation Server时,说明 字段从 PlainText 的字段类型更改为 HTML。使用 witadmin changefield 命令可以恢复此字段的数据类型根据需要。请参见 管理工作项字段 [witadmin]。
|
Integer |
一个 32 位有符号整数,如 0、1、2、34。 |
PlainText |
支持长说明的文本字符串,例如 应用程序开始信息 字段。 当全文搜索可用时,这些字段进行全文搜索自动创建索引。 请参见本主题后面介绍的 全文和部分单词搜索。 |
String |
可以包含 255 个 Unicode 字符的短文本字符串。 |
TreePath |
一个分支树结构,如“区域路径”或“迭代路径”。 必须选择在有效值列表项。 可查找相等或处于树结构下的工作项。 有关更多信息,请参见创建和修改区域和迭代。 |
返回页首
查询运算符
可使用下表中的查询运算符指定子句中的每个值必须如何与工作项中的对应值相关。 有关分配给工作项字段的数据类型的信息,请参见工作项字段参考 (Visual Studio ALM)。
查询运算符 |
如果工作项中的值与列出的条件匹配,则返回工作项 |
适用的数据类型 |
---|---|---|
= |
与子句中的值匹配。 |
计算,包括 Double、GUID、Integer和 String、DateTime和 TreePath |
<> |
与子句中的值不匹配。 |
数字、String、DateTime和 TreePath |
> |
大于子句中的值。 |
数字、String和 DateTime |
< |
小于子句中的值小于。 |
数字、String和 DateTime |
>= |
大于或等于子句中的值。 |
数字、String和 DateTime |
<= |
小于或等于子句中的值。 |
数字、String和 DateTime |
=[字段] |
与指定字段包含的值。 |
与指定字段具有相同数据类型的字段的名称 |
<>[字段] |
不与指定字段包含的值。 |
与指定字段具有相同数据类型的字段的名称 |
>[字段] |
大于指定字段中包含的值。 |
与指定字段具有相同数据类型的字段的名称 |
<[字段] |
小于指定字段中包含的值小于。 |
与指定字段具有相同数据类型的字段的名称 |
>=[字段] |
大于或等于指定字段中包含的值。 |
与指定字段具有相同数据类型的字段的名称 |
<=[字段] |
小于或等于指定字段中包含的值。 |
与指定字段具有相同数据类型的字段的名称 |
包含 |
包含文本字符串的确切或部分匹配项在用于筛选选择的域中。 |
String |
不包含 |
不包含文本字符串的确切或部分匹配项在用于筛选选择的域中。 |
String |
包含字词 |
包含完全的文本字符串或应用程序中用于筛选选择的域中。 您还可以输入包含通配符的部分单词或短语,*。 有关限制,为服务器和排序规则要求请参见 全文搜索。 |
进行全文搜索索引,对应于任何 PlainText 和 HTML 字段和 标题的长文本字段。 |
不包含字词 |
不包含的确切文本字符串或应用程序中用于筛选选择的域中。 |
text 进行全文搜索索引字段。 |
在 ... 中 |
与分隔的集合中的任何值匹配。 例如,如果为 ID 字段指定值 100、101 和 102,则可查找 ID 为这些值的工作项。 ![]()
用列表分隔符分隔值,列表分隔符与为您的客户端计算机定义的区域设置相对应。例如,可以使用逗号 (,)。
|
数字,String,DateTime,TreePath |
在组中 |
与作为子句中组的成员的值匹配。 可以在 Team Foundation Server 中指定默认组、自定义组或类别组。 例如,您可以创建一个查询,用来查找分配给 Contributors 组成员的所有工作项。 ![]()
不能将安全组或电子邮件通讯组指定为一个值。
|
匹配一个用户组或类别组的名称 Team Foundation Server的String。 ![]()
可以使用 在组中 只能将运算符用于使用 String 数据类型或 工作项类型 "字段。
有关类别组的信息,请参见定义类别以分组工作项类型。 |
不在组中 |
不与作为子句中组的成员的值。 |
与为团队项目定义的用户组或类别组的名称 Team Foundation Server 的String。 ![]()
可以使用 不在组中 只能将运算符用于使用 String 数据类型或 工作项类型 "字段。
有关类别组的信息,请参见定义类别以分组工作项类型。 |
曾是 |
在以前任意时间与子句中的值匹配。 |
String, DateTime |
其下 |
与子句中的值匹配或包含在子句中节点之下。 |
TreePath |
不在其下 |
与子句中的值不匹配并且未包含在子句中节点之下。 |
TreePath |
返回页首
查询变量
可使用下表中的变量查找与当前用户、当前项目或当前日期相关的工作项。
查询变量 |
用法 |
---|---|
@Me |
使用此变量可在包含用户别名的字段中自动搜索当前用户的别名。 例如,如果将“字段”列设置为“激活者”,将“运算符”列设置为“=”,将“值”列设置为 @Me,则可查找您打开的工作项。 |
@Project |
使用此变量可搜索当前团队项目中的工作项。 例如,如果将“字段”列设置为“团队项目”,将“运算符”列设置为“=”,将“值”列设置为 @Project,则可查找当前团队项目中的所有工作项。 |
@Today |
使用此变量可搜索与当前日期或更早日期相关的工作项。 还可以通过减去天数来修改 @Today 变量。 例如,如果将“字段”列设置为“激活日期”,将“运算符”列设置为“>=”,将“值”列设置为 @Today - 7,则可查找上周激活的所有项。 |
[Any] |
使用此变量可搜索为特定字段定义的任何值的相关工作项。 |
返回页首
全文和部分单词搜索
指定 包含 或 不包含 搜索词或短语的确切或部分匹配项。 指定 包含字词 或 不包含字词 搜索完全相同的声明或使用通配符,*。 这些运算符使用全文搜索索引。 只能使用通配符在部分单词或短语的末尾。
有关示例,请参见查找基于关键字或短语的工作项和使用“历史记录”字段查看历史记录和查找工作项。
备注
并非所有部署支持全文搜索。例如,SQL express 和 SQL azure,支持 Team Foundation 服务,不支持全文搜索。在这些情况下,只会看到 包含 和 不包含 运算符。
包含字词 和 不包含字词 筛选基于全文搜索索引的项目创建为长文本字段。 所有长文本都以 PlainText 和 HTML 的数据类型和全文搜索的 标题 字段自动 的Team Foundation 索引。 支持 Team Foundation Server 时的索引和运算符只可用,当 SQL Server 支持全文搜索。
全文搜索需要使用对应于语言都有一个单词破碎机到 SQL Server 注册的 SQL 排序规则。 如果使用的 Team Foundation Server 实例的团队项目集合数据库的排序规则设置不对应于受支持的语言,您的搜索结果可能与您的预期。 在这些情况下,您可能尝试使用 包含 或 不包含 运算符。
有关更多信息,请参见 全文搜索查询和排序规则设置。
查询索引字段
在对全文搜索索引的添加,查询索引创建。 根据启用的索引的字段。 查询索引提高响应时间,当您运行包含索引字段的查询时。
默认情况下,标记以下字段:指派给、创建日期、更改者、状态、原因、区域 ID、迭代 ID和 工作项类型。 如果您的团队在其查询常用的其他字段,您可以将它们添加到查询索引。
使用 witadmin indexfield 命令来启用或禁用字段的索引。 请参见 管理工作项字段 [witadmin]。
请参见
任务
概念
其他资源
修订记录
日期 |
修订记录 |
原因 |
---|---|---|
2012 年八月 |
描述字段的数据类型和移除的 Description 从中更正了表进行全文搜索索引字段集。 添加有关全文搜索 andn 的两个部分查询索引。 |
信息补充。 |