指定查询筛选条件

更新：2010 年 8 月

通过为查询指定筛选条件，可以查找工作项并更容易地选择要使用的筛选数据。 通过使用不同的筛选条件，可以检查分配给您的任务、您的当前任务，也可以查看分配给您或您团队的功能列表。

所有工作项查询都由一个或多个查询子句组成；每个子句又包含一个字段、一个运算符和一个值。 在您通过筛选工作项集创建的查询中，您可以根据需要添加、修改其中的子句和字段并对它们进行分组。

主题内容

若要指定筛选条件，请完成以下过程，直到工作项集在**“查询结果”**视图中列出：

1. 指定查询类型

2. 指定顶级查询筛选条件

3. 对查询子句进行添加、移除、分组或取消分组

4. 运行或取消查询及检查查询结果

5. 调整查询筛选条件

   提示

   以下过程是针对团队资源管理器编写的。 针对 Team Web Access 的过程与之类似，但在细节上可能略有不同。

若要根据日期值或根据组成员的某个值筛选条件，请参见以下过程：

• 根据日期时间值指定筛选器

• 根据组成员身份指定筛选器

所需权限

若要执行这些过程，您必须是**“Readers (访问者)”组的成员，或者您对查询中每个团队项目的“查看此节点中的工作项”权限必须设置为“允许”。 要将查询另存为团队查询，您必须是“Project Administrators (项目管理员)”**组的成员。 有关更多信息，请参见 Team Foundation Server 权限。

选择查询类型

在团队资源管理器中选择查询类型

1. 打开团队项目，展开**“工作项”节点，然后选择“团队查询”或“我的查询”**。

2. 在**“团队”菜单上，单击 “添加查询”。 或者，右击“工作项”、“我的查询”或“团队查询”节点，然后单击 “添加查询”**。

   此时将打开一个新的**“工作项的简单列表(默认)”**查询。

3. 在查询工具栏上，根据要查找的视图或工作项的类型选择**“查询类型”**：

   • 工作项的简单列表(默认)：返回符合筛选条件的单层工作项（ 简单列表）。 通过使用此类型的查询，可以查找要链接到其他工作项的工作项，将工作项导出到 Office Excel 和 Office Project 以便成批更新列字段，或者生成有关一组工作项的报表。 有关更多信息，请参见列出工作项（默认简单列表）。

   • 工作项和直接链接：返回一组两层工作项 ()，包括符合筛选条件的工作项以及根据辅助筛选条件链接到这些工作项的所有工作项。 此视图以可展开/可折叠的形式显示工作项。 有关更多信息，请参见在直接链接视图中查看和修改工作项。

   • 工作项树：返回符合筛选条件的一组多层工作项 ()，其中包含根据父子链接关系链接到顶级工作项的所有工作项。 此视图以可展开/可折叠的分层形式显示工作项。 有关更多信息，请参见在树视图中查看和修改工作项。

返回页首

指定顶级查询筛选条件

顶级筛选条件将查询结果限定为某个团队项目和工作项类型。

提示

为新查询定义的默认筛选条件返回在当前团队项目（“团队项目=@Project”）中指派给您（“指派给=@Me”）的所有工作项（“工作项类型=[任何]”和“状态=[任何]”）。

如果您参与多个团队项目，可能希望使用一个查询在所有这些团队项目中进行搜索。

指定顶级筛选条件

1. 指定包含您要查找的工作项的团队项目。 应根据不同需要指定不同的工作项类型：

   • 若要返回当前团队项目的工作项，请保留**“团队项目=@Project”**。

   • 若要返回另一个团队项目的工作项，请在**“团队项目”字段的“值”**列中键入该团队项目的名称。

   • 若要返回几个团队项目的工作项，请输入下表中显示的值：

     And/Or	字段	运算符	值
     	团队项目	在 ... 中	<第一个团队项目名称>, <第二个团队项目名称>, ...

     使用逗号 (,) 分隔团队项目名称。

2. 指定要查找的工作项的类型。 应根据不同需要指定不同的工作项类型：

   • 若要返回所有类型的工作项，请保留**“工作项类型=[任何]”**。

   • 若要返回单个类型的工作项，请单击**“工作项类型”字段中的“值”**列，然后单击所需的工作项类型。

   • 若要返回几个类型的工作项，请输入显示在下表中的值：

     And/Or	字段	运算符	值
     And	工作项类型	在 ... 中	<第一个工作项类型>, <第二个工作项类型>...

     使用逗号 (,) 分隔每个工作项类型的名称。

   • 属于已命名类别的所有工作项类型，请输入下表中显示的值：

     And/Or	字段	运算符	值
     And	工作项类型	在组中	<工作项类型组的名称>

     有关如何定义工作项类型组的信息，请参见自定义工作项类型的类别 [witadmin]。

     有关可用于筛选顶级条件的其他选项，请参见查询字段、运算符、值和变量中的“运算符”部分。

3. 在查询工具栏上，单击 “运行”，确认查询是否返回了预期结果。

4. 单击 “保存”或“另存为”。 有关更多信息，请参见保存、复制、重命名和删除工作项查询。

返回页首

对查询子句进行添加、移除、分组或取消分组

通过为每个工作项字段添加一个新子句，可以细化搜索条件并只返回所需的工作项集。 如果未获得预期的查询结果，可以对查询子句进行添加、移除、分组或取消分组，从而细化查询结果。 有关查询子句中的元素的信息，请参见查询字段、运算符、值和变量。

每个查询子句都包含一个字段名称、一个查询运算符和一个值。 可根据需要使用任意多个子句以获得有用的结果。

可以对查询子句进行分组，使其作为独立于查询的其余部分的一个单元来工作，这类似于在数学等式或逻辑语句中的某个表达式两侧加上括号。 在对子句进行分组时，组中第一个子句的**“与”或“或”**应用于整个组。

如下表所示，分组子句被转换成对应的逻辑表达式。 第一个表达式返回优先级为 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)

对查询子句进行添加、移除、分组或取消分组

1. 通过以下方式之一添加子句：

   1. 若要将子句添加到筛选条件末尾，请单击**“单击此处添加新子句”**。

   2. 或者，若要插入子句，请右击要插入该子句的位置，然后单击 “插入子句”。

      一个新的查询子句行即会添加到指针所在位置的上方。

   3. 如果要将子句视为**“或”子句，请单击“与”，然后单击“或”**。

      如果该子句和上一子句必须都为 true 才能匹配结果，请选择**“与”。 如果该子句或上一子句有一个为 true 即可匹配结果，请选择“或”**。

   4. 为**“字段”、“运算符”和“值”**指定适当的值。

      查询列	用法
      字段	为要查找的工作项类型指定字段。 将根据为该字段定义的“运算符”和“值”来筛选工作项集。 按 Alt+向下键或键入要选择的字段名。
      运算符	指定查询如何比较在记录的指定字段中找到的值。 运算符选项的示例包括“=”（等于）、“<>”（不等于）、“>”（大于）、“<”（小于）、“>=”（大于或等于）、“<=”（小于或等于）、“包含”、“不包含”、“其中”以及“曾是”。
      值	指定要在所选字段中查找的值。 如果有可供选择的值列表，请单击箭头，从该列表中选择适当的值。 可以指定用于向查询中动态添加值的查询变量。 如果有可供选择的值列表，请单击箭头，选择所需的值。 如果有多个要筛选的值，请使用“在 ... 中”运算符指定逗号分隔值列表。 若要指定动态值，请指定有效的查询变量。

      有关更多信息，请参见查询字段、运算符、值和变量。

2. 若要删除查询子句，请右击要删除的子句行的左侧，然后单击 “删除子句”。

3. 要对工作项查询子句进行分组，请按以下步骤操作：

   1. 在查询中，通过单击相应行中最左侧的单元格，选中要组合成一个组的查询子句。 按住 Ctrl 的同时单击，以选择多行。

   2. 右击所选子句，然后单击 “将子句分组”。

      此时会在查询左侧的空白处显示一个括号，表示这些子句已经分组。

4. 若要对工作项查询子句取消分组，请按以下步骤操作：

   1. 在查询中，单击相应行中最左侧的单元格，选择要取消分组的整组查询子句。 按住 Ctrl 的同时单击，以选择多行。

   2. 右击该组，然后单击 “取消子句分组”。

      此时括号会从查询左侧的空白处移除，这些子句即取消分组。

      提示

      如果“取消子句分组”不可用，说明您没有选择查询组中的所有子句。 请选择所有子句，然后重试。

返回页首

运行或取消查询及检查结果

可以运行工作项查询在团队项目中搜索符合查询条件的工作项。 如果更改工作项会造成查询结果的更改，可以重新运行查询以更新查询结果。

根据查询筛选条件运行查询或取消查询

1. 在查询工具栏上，单击 “运行”。

   提示

   可以添加为要搜索的工作项定义的任意字段，从而控制查询结果的显示和排序方式。 有关更多信息，请参见对列进行添加、移除、重新排列或排序。

2. 若要取消查询结果，请单击 “停止查询”，或在**“团队”菜单上，单击“停止刷新”**。

3. 检查查询结果。 如果工作项列表与预期搜索条件不符，请检查筛选条件并根据需要对其进行修改。

返回页首

调整查询筛选条件

调整筛选条件

• 如果查询结果未返回预期的工作项集，请执行以下检查：

  1. 检查每个子句，确保它们按照您想要的方式定义。

  2. 检查为每个子句指定的**“与/或”。 如果结果包含的工作项超出预期，往往因为使用了“或”子句而非“和”**子句。

  3. 检查查询子句的分组以及为每个分组子句指定的**“与/或”**。

  4. 添加更多查询子句以细化查询筛选条件。

  5. 检查可用于指定字段、运算符或值的选项，如查询字段、运算符、值和变量中所述。 确定是否修改查询子句以使用不同的字段、运算符或值。

返回页首

根据日期时间值指定筛选器

可以按工作项的更改日期或按特定时间段对工作项进行排序。 您可以限制查询范围，使之只返回符合指定日期范围的结果，从而帮助提高查询性能。

根据日期特定的筛选条件查找工作项

1. 若要搜索当天修改的工作项，请按以下步骤操作：

   1. 选择一个用以添加或修改查询子句的日期数据类型的**“字段”**。

      提示

      大多数日期字段的字段名中都包含“日期”一词。

   2. 在**“运算符”列中选择“=”**（等于）。

   3. 在**“值”列中，单击箭头，然后选择“@Today”**作为当天日期。

      提示

      可以修改此变量，以搜索当前日期减去一些天数后的日期。 例如，若要查找上周启动的所有项，应将“字段”列设置为“激活日期”、将“运算符”列设置为“>=”，将“值”列设置为 @Today - 7。

   4. 单击 “运行”，然后检查查询结果。

2. 要搜索在特定日期修改的工作项，请按以下步骤操作：

   1. 选择一个用以添加或修改查询子句的日期数据类型的**“字段”**。

   2. 在**“运算符”列中选择“=”**（等于）。

   3. 在**“值”**列中，按照计算机操作系统接受的格式键入日期。

   4. 单击 “运行”，然后检查查询结果。

3. 若要搜索在某一日期范围内修改的工作项，请按以下步骤操作：

   1. 选择一个用以添加或修改查询子句的日期数据类型的**“字段”**。

   2. 在**“运算符”列中，如果仅需要该日期之后的项，请选择“>”（大于），如果需要包含所选日期的项，请选择“>=”**（大于等于）。

   3. 在**“值”**列中，按照计算机操作系统接受的日期格式输入日期范围内的第一个日期。

   4. 直接在上一查询子句下插入另一个查询子句。

   5. 在**“与/或”指定列中，选择“与”**。

   6. 在**“运算符”列中，如果仅需要该日期之前的项，请选择“<”（小于），如果需要包含所选日期的项，请选择“<=”**（小于等于）。

   7. 在**“值”**列中，按照计算机操作系统接受的日期格式输入日期范围内的最后一个日期。

   8. 在**“运算符”列中选择“=”**（等于）。

   9. 在**“值”**列中，按照计算机操作系统接受的格式键入日期。

   10. 选择这两个日期特定的查询子句并将其分为一组。

   11. 单击 “运行”，然后检查查询结果。

返回页首

根据组成员身份指定筛选器

使用**“在组中”或“不在组中”**运算符，可以根据是组成员或不是组成员的几个值来筛选查询。 可以在 Team Foundation Server 中指定通讯组或指定一个或多个工作项类型的类别。

根据属于某个组的值查找工作项

1. 指定下列子句类型：

   • 添加下列子句以查找指派给属于 Project Administrators 组的任何用户的工作项：

     And/Or	字段	运算符	值
     And	指派给	在组中	Project Administrators (项目管理员)

   • 添加下列子句以查找属于 Test category 组中的任何工作项类型的活动工作项：

     And/Or	字段	运算符	值
     And	状态	=	活动
     And	工作项类型	在组中	测试

   有关类别组的信息，请参见将工作项类型分组到类别中。

2. 单击**“运行查询”**，然后检查查询结果。

返回页首

请参见

任务

对列进行添加、移除、重新排列或排序

保存、复制、重命名和删除工作项查询

列出工作项（默认简单列表）

在直接链接视图中查看和修改工作项

在树视图中查看和修改工作项

概念

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

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

修订记录

日期	修订记录	原因
2010 年 8 月	添加了如何以逻辑方式计算分组子句的示例。	客户反馈
2010 年 9 月	更正了“在组中”运算符的示例。	客户反馈