跨服务和增强的查询操作

  • 项目

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

托管查询主要侧重于列出和使用工作项。 但是，查询功能还支持多个跨服务操作，其中一些操作需要安装市场扩展。

基于查询的仪表板小组件

除了定义可添加到仪表板的平面列表查询图表之外，还可以配置以下基于查询的小组件之一。

图表工作项查询小组件。

查询结果小组件。

查询磁贴小组件。

Azure DevOps 市场提供了其他基于查询的小组件。

通知中使用的查询筛选器

通知支持查询筛选器条件，以便你可以在收到通知时进行自定义。 哪些字段可用于支持通知筛选，可能存在限制。

通知订阅中的查询筛选器的屏幕截图。

若要了解详细信息，请参阅 管理个人通知

WIQL 语法、Wiql 编辑器和 .wiq 文件

托管查询使用工作项查询语言 (WIQL) ，该语言类似于结构化查询语言 (SQL) 。 安装 Wiql 编辑器 市场扩展时，可以访问托管查询背后的 WIQL 语法。

此扩展将以下内容添加到Azure Boards Web 门户：

  • 编辑查询 wiql (工作项查询语言) 到查询编辑器和查询结果页上的“更多”命令菜单。
  • WIQL 操场 页面到 Boards。

在这些接口中，可以练习以下查询功能：

  • 查看托管查询的基础 WIQL 语法
  • 使用 ASOF 运算符 (ASOF 运算符运行历史查询不会保存在托管查询)
  • MODE指定链接工作项的子句以进一步优化查询结果，MODE (子句不会保存在托管查询)
  • 移动、复制或粘贴查询子句
  • 将查询作为 .wiq 文件从一个项目、组织或集合导入和导出到另一个项目、组织或集合
  • 导出 WIQL 以用于 REST API 调用。

你可能会发现，从 WIQL 格式读取包含大量子句或大量嵌套子句的查询会更容易。 对于异常大型的查询，WIQL 查询中的加载时间可能会产生更好的加载时间。

WIQL 语法

WIQL 包含以下语法片段中显示的五个部分。 WIQL 语法不区分大小写。

SELECT [State], [Title] 
FROM WorkItems
WHERE [Work Item Type] = 'User Story'
ORDER BY [State] Asc, [Changed Date] Desc
ASOF '6/15/2010'

若要了解有关 WIQL 的详细信息，请参阅 工作项查询语言的语法 (WIQL) 。

注意

对于针对 Azure DevOps 进行的查询，WIQL 长度不得超过 32K 个字符。 系统不允许创建或运行超过该长度的查询。

.wiq 文件结构

以下语法显示了文件的结构 .wiq 。 有关每个 WorkItemQuery 语法元素的详细信息，请参阅 定义要添加到进程模板的工作项查询

<WorkItemQuery Version="1">  
      <TeamFoundationServer>collectionURL </TeamFoundationServer>  
      <TeamProject>TeamProjectName </TeamProject>  
      <Wiql>  
      WorkItemQueryLanguage  
      </Wiql>  
</WorkItemQuery>

扩展和管理查询

以下 Azure DevOps 市场扩展适用于托管查询，以提供更多功能。

注意

大多数市场扩展不支持Azure Boards的功能，因此产品团队不支持这些功能。 如果在使用这些扩展时存在疑问、有建议或遇到问题，请访问其相应的扩展页面。

  • 基于查询的 Boards 支持将工作项的平面列表查询视为看板。 查询可以包含不同项目中定义的不同工作项类型和工作项。

  • 查询磁贴 PRO：将 查询磁贴 PRO 小组件添加到仪表板的小组件目录中。 此小组件支持所有查询类型， (不仅) 平面列表查询，还提供更多选项来配置小组件上的计算值。

  • Wiql 到 OData：将“转换为 OData”选项添加到查询编辑器和“查询结果”页上的“更多”命令菜单中。 然后，可以使用此查询或扩充查询从 Analytics 服务检索工作项。 若要了解详细信息，请参阅 使用 OData Analytics 查询工作跟踪数据。

  • 在 Power BI 中打开：将“在 Power BI 中打开”选项添加到查询编辑器和“查询结果”页上的“更多”命令菜单中。 然后，可以使用 Power BI 基于 Analytics 工作跟踪数据生成报表。 可以将这些报表添加到 Azure DevOps 仪表板。 若要了解详细信息，请参阅 使用 OData Analytics 查询工作跟踪数据。

  • 增强的导出：允许将工作项查询或测试计划导出为类似文档的格式。 若要按所需方式设置输出格式，可以选择不同的模板来获取所选窗体和布局。 可以直接在 Office 中预览、打印甚至打开文档。

REST API

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