指定查询筛选条件

可以指定筛选条件您的查询可以查找工作项相关给您或您团队的。 您在查询中使用宏检查分配给您，则的任务，也可以查找最近更新的项。

所有工作项查询都包含一个或多个查询子句。 每个子句都包含一个字段、一个运算符和一个值。 可以在查询添加，修改和group子句和字段来查找一组工作项相关设置为。 定义查询是迭代的通常处理，其中是您调整筛选条件，直到获得所需的结果。

主题内容

1. 选择查询类型

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

3. (可选)为链接的工作项指定筛选条件

4. 添加，移除组，或对查询子句

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

6. 调整您的查询筛选条件

要求

• 您必须是 *** 读取器 *** 组的成员或具有 *** 查看此节点中的工作项 *** 权限设置为 *** 允许 ***。 有关查询权限的更多信息，请参见 查找 Bug、任务和其他工作项。

1.选择查询类型

1. 打开团队项目，选择 工作项 页，然后选择 *** 新的查询 ***。

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

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

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

   • *** 工作项和直接链接 ***:返回一组两层符合筛选条件，所有工作项及其链接根据辅助筛选条件的工作项。 此视图以可展开/可折叠的形式显示工作项。 有关更多信息，请参见使用链接的依赖项（直接链接）。

   •  *** 工作项树 ***:返回一组多层符合筛选条件的工作项并包含根据父子链接的顶级工作项链接的所有工作项。 此视图以可展开/可折叠的分层形式显示工作项。 有关更多信息，请参见使用链接层次结构（工作项树）。

   有关每个查询类型支持的任务摘要，请参见 选择对任务的正确查询工具。

返回页首

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

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

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

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

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

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

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

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

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

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

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

   • 一个类型，选择 *** 工作项类型 *** 字段的 值 列，然后选择所需的工作项类型。

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

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

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

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

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

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

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

3. 在查询工具栏上，选择 运行，并确认您的查询是否返回了预期结果。

4. 选择 *** 保存查询 ***。 有关更多信息，请参见保存、复制、重命名和删除工作项查询。

返回页首

3.(可选)为链接的工作项指定筛选条件

如果选择了 *** 工作项和直接链接 *** 或 *** 工作项树 ***，可以为以及顶层查找工作项的链接工作项指定筛选条件。

为工作项和直接链接查询指定筛选条件

1. 选择 *** 和与下面的查询的链接工作项 ***。 类似地添加和group子句为顶级条件定义它们。

   链接工作项的筛选条件

   

2. 选择在 *** 链接筛选器 *** 的项筛选第一层工作项列表:

   • “返回所有顶级工作项”：返回所有第一层工作项，而不考虑链接工作项筛选条件。 第二层与第一层链接的工作项返回，如果它们满足链接工作项筛选条件。

   • *** 仅返回具有指定链接的工作项 ***:，只有在具有工作项链接工作项筛选条件，指定的项目第一层工作项，将返回，但。

   • *** 仅返回没有指定链接的工作项 ***:，仅当它们没有工作项链接工作项筛选条件，指定的项目第一层工作项，将返回，但。

3. (可选)选择 *** 返回选定链接类型 ***，然后选择一个或多个可用复选框以链接类型可以包含在您的筛选条件。

4. 在查询工具栏上，选择 运行，并确认您的查询是否返回了预期结果。

5. 修改您的筛选条件并重新运行查询，直到获得的工作项第一个和第二层需要。

为工作项树指定筛选器critera

1. 在 *** 链接的工作项的筛选器 ***，请类似地添加和group子句下为顶级条件定义它们。

2. 选择将另外筛选第一层工作项列表的 *** 链接筛选器 *** 如下所示:

   1. *** 首先满足顶级工作项 ***:执行自顶向下搜索。 返回所有第一层工作项。 与第一层链接的所有工作项返回，如果它们满足链接工作项筛选条件。

   2. *** 与链接的工作项首先 ***:执行从下到上搜索。 查找所有链接的工作项，然后返回与找到的项链接的第一层工作项。

3. (可选)选择 *** 树的类型 ***。 如果添加了树拓扑的自定义链接类型，可以从值选择列表转换为自定义设置分层链接类型。 请参见 链接类型元素参考。

4. 在查询工具栏上，选择 运行，并确认您的查询是否返回了预期结果。

5. 修改您的筛选条件并重新运行查询，直到获得的工作项第一个和第二层需要。

返回页首

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. 打开选定子句的快捷菜单，然后选择 *** Group子句 ***。

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

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

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

   2. 打开组的快捷菜单，然后选择 *** 分组子句 ***。

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

      备注

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

返回页首

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

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

1. 在查询工具栏上，选择 运行。

   备注

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

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

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

返回页首

6.调整您的查询筛选条件

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

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

  • 检查 *** 和/或 *** 分配给每个子句。 如果结果包含的工作项超出预期，往往因为使用了**“或”子句而非“和”**子句。

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

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

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

返回页首

请参见

任务

使用简单列表（默认）查询

使用链接层次结构（工作项树）

概念

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

工作项查询示例

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

其他资源

使用链接的依赖项（直接链接）