按字段值比较进行查询

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

如果要通过将一个字段的值与另一个字段的值进行比较来筛选工作项,请使用比较字段运算符。 常见用途包括:

  • 查找创建者与被分配者或关闭者不同的工作项。
  • 查找原始估计小于已完成工时的任务。
  • 查找在其目标日期之前完成的已关闭任务。

先决条件

类别 要求
访问级别 - 若要查看和运行共享查询:项目成员
- 添加和保存共享查询:至少需要 基本 的访问权限。
权限 对于要添加查询的文件夹,请将参与权限设置为允许。 默认情况下,“参与者”组没有此权限。

注意

具有公共项目的 利益干系人 访问权限的用户,与具有 基本 访问权限的用户一样,对查询功能具有完全访问权限。 有关详细信息,请参阅利益干系人访问快速参考

类别 要求
访问级别 - 若要查看和运行共享查询:项目成员
- 要添加并保存共享查询:至少具有基本访问权限
权限 对于要添加查询的文件夹,请将参与权限设置为允许。 默认情况下,“参与者”组没有此权限。

支持的数据类型

可以将比较运算符(=[Field]、、<>[Field]>[Field]<[Field]、、>=[Field]<=[Field] 与以下列出的数据类型一起使用。 左侧字段和右侧字段的数据类型必须匹配。

  • 布尔值(支持 =[Field]<>[Field]
  • 日期/时间
  • Double、Integer
  • GUID
  • 标识
  • String(不包括标记)

注意

某些数据类型/运算符组合是无意义的(例如,Title >= [Field]Assigned To <= [Field])。 验证比较以确保双方都使用兼容的数据类型。

示例筛选器

将这些示例子句用作起点。 查询编辑器中的确切语法可能因客户端略有不同;如果有任何疑问,请在 Web 查询编辑器中生成子句并验证保存的 WIQL。

  • 非创建该工作项的人员所关闭的工作项:[由创建] <> [由关闭] 并且 [State] = 'Closed'

  • 原始估计小于已完成工时的任务:[原始估计] < [已完成工时]

  • 在目标日期之前完成的已关闭任务:[已关闭日期] <= [目标日期] 且 [状态] = '已关闭'

支持字段比较的字段

下表列出了支持比较查询的字段。 并非所有字段都可用于每个进程或工作项类型;有些需要自定义字段或进程配置。 有关自定义链接,请参阅以下说明。

注意

并非所有列出的字段都存在于每个项目/进程中。 可以添加自定义字段并启用它们以进行比较。 请参阅将自定义域添加到工作项类型(继承的进程)或修改字段(本地 XML 进程)。

J–N

O–Q

U-W

注意

字段到字段比较支持因客户端而异。 Web 查询编辑器支持大多数字段比较;复杂的比较(例如,某些使用 WAS EVER 或高级 WIQL 表达式)需要直接编辑 WIQL(WIQL 编辑器扩展)。 当有疑问时,请在 Web 查询编辑器中构建子句并查看保存的 WIQL。

REST API

要以编程方式与查询交互,请参阅以下 REST API 资源之一:

小窍门

如果需要 WIQL 或 REST 的引用名称(例如 System.IterationIdMicrosoft.VSTS.Common.Priority),请参阅 “工作项”字段和属性