查看、运行或通过电子邮件发送工作项查询

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

Visual Studio 2022 |Visual Studio 2019 |Visual Studio 2017 |Visual Studio 2015 |Visual Studio 2013

若要查找分配给你或团队的工作项,请运行查询。 许多工作项查询是使用进程预定义的。 团队成员可能已创建可查看和运行的共享查询。 通常,可以通过基于已可供使用的查询定义来更轻松地定义新查询。

先决条件

  • 默认情况下,具有 利益干系人 访问权限的所有项目成员和用户都可以查看所有共享查询并运行。 可以更改共享查询文件夹或共享查询的权限集。 有关详细信息,请参阅 设置查询权限
  • 若要在 共享查询下添加和保存查询,必须被授予 基本 访问权限或更高版本。 此外,还必须将 “参与” 权限设置为 “允许 要向其添加查询的文件夹”。 默认情况下, 参与者 组没有此权限。

备注

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

  • 默认情况下,具有 利益干系人 访问权限的所有项目成员和用户都可以查看所有共享查询并运行。 可以更改共享查询文件夹或共享查询的权限集。 有关详细信息,请参阅 设置查询权限
  • 若要在 共享查询下添加和保存查询,必须被授予 基本 访问权限或更高版本。 此外,还必须将 “参与” 权限设置为 “允许 要向其添加查询的文件夹”。 默认情况下, 参与者 组没有此权限。

打开查询

在 Web 浏览器中, (1 个) 检查是否已选择正确的项目, (2) 选择 “板>查询”,然后 (3) 选择“ 全部”。

打开板>查询,垂直导航

如果这是你第一次打开 查询,页面将打开到 收藏夹。 此页面列出了你指示的查询是收藏夹。 否则,可以选择 “全部 ”以查看为项目定义的所有查询和共享查询。

提示

你或你的团队选择的查询显示为 收藏夹显示在“收藏夹 ”页面上。 “ 项目 ”页面上也显示收藏的查询和其他对象。 若要了解详细信息,请参阅 “设置个人或团队收藏夹”。

在 Web 浏览器中打开 Boards>查询

从 Web 浏览器打开 Boards>查询

在 Azure Boards 中运行查询

若要运行任何查询,请展开文件夹并选择查询的标题。 此时将打开视图以显示查询 结果

还可以使用 Azure DevOps 命令行接口运行查询。

提示

“查询”页与其他 Web 门户页面一样,记住上次导航到的视图,并返回到该视图。

  1. 选择 “全部 ”可打开页面,可在其中查看已定义的所有查询或项目中共享的查询。

    Web 门户,选择“板>查询>所有”页

  2. 根据需要选择 “我的查询 ”。

    • 若要查看分配给你的所有工作项,请选择 “分配给我”。 此查询使用 @Me 宏列出分配给你的所有工作项。
    • 若要查看所关注的所有工作项,请选择 “已关注的工作项”。 此查询使用 @Follows 宏 (ID @Follows) 列出所选的所有工作项。 若要了解详细信息,请参阅 关注工作项或拉取请求
  3. 选择 “共享查询 ”以展开文件夹并访问保存为共享查询的查询。

  4. 选择痕迹导航中的文件夹以打开查询文件夹。

    查询痕迹导航示例的屏幕截图。

从命令行运行查询

可以使用 az boards query 命令在 CLI 中运行查询。 若要开始,请参阅 Azure DevOps CLI 入门

az boards query [--id]
                [--org]
                [--path]
                [--project]
                [--wiql] 

参数

  • id:现有查询的 ID。 除非指定了 --path 或--wiql,否则是必需的。
  • wiql:工作项查询语言格式的查询。 指定的 if--id 或--path 被忽略。
  • 路径:现有查询的路径。 指定的 if--id 被忽略。
  • 组织:Azure DevOps 组织 URL。 You can configure the default organization using az devops configure -d organization=ORG_URL. 如果未配置为默认或使用 git config选取,则为必需。 示例:--org https://dev.azure.com/MyOrganizationName/
  • 项目:项目的名称或 ID。 You can configure the default project using az devops configure -d project=NAME_OR_ID. 如果未配置为默认或使用 git config选取,则为必需。

示例

以下命令运行具有指定 ID 的查询,并按表格式显示结果。

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form
1           Fiber             Bug               Check issues with permissions     0
2           Fiber             Bug               Voicemail hang issue              0
2           FabrikamBB        Bug               Research slow response time
1           FabrikamBB        Bug               Fix performance issues            0 

以下命令使用指定的 WIQL 运行查询,并按表格式显示结果。

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork], [System.AssignedTo], [System.State], [System.Tags], [System.AreaPath] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions
2           Fabrikam Fiber  Bug               Fix performance issue
2           Fabrikam Fiber  Bug               Secure Sign-in 

查询目录、查询文件夹和痕迹导航

查询文件夹

备注

无法将文件夹添加到 “我的收藏夹 ”或 “团队收藏夹”。

查询 ”页包含一个以目录为中心的视图,可用于筛选以查找感兴趣的特定查询。 在 查询 页中工作时,可以导航到子文件夹、文件夹或页面。

查询痕迹导航

此外,还可以从选择器菜单中选择你喜欢的查询,或者,可以选择浏览所有查询,这将返回“ 所有查询 ”页。

查询选择器的屏幕截图。

查询 ”页在左窗格中显示文件夹结构。 可以展开和折叠文件夹、重命名文件夹,以及将查询从一个文件夹拖放到另一个文件夹。 若要了解详细信息,请参阅 管理和组织查询

“查询”页、TFS 2018 和早期版本的屏幕截图。

有关详细信息,请参阅 查询常见问题解答、导航和文件夹

支持的所有任务和收藏夹任务

可以执行大多数任务来查看和运行每个查询列表页中的查询,如下表所示。 仅在 “我的查询 ”下保存的查询,并且收藏夹显示在 “我的收藏夹”下。 只有共享 查询 下保存的查询才能由团队收藏。


任务
收藏夹
(Browser)
全部
(Browser)
工作项
(团队资源管理器)
查看所有你所属的常用查询、你的或团队 ✔️ ✔️
查看所有当前项目的查询或共享查询 ✔️ ✔️
运行查询,打开查询的上下文菜单 ✔️ ✔️ ✔️
展开或折叠容器文件夹或查询文件夹 ✔️ ✔️ ✔️
筛选查询列表 ✔️ ✔️
收藏 Web 门户的查询 (,选择 “收藏夹 ”) ✔️
取消 web 门户的查询 (,请选择 ) ✔️ ✔️ ✔️
添加新查询:选择 ✔️ ✔️ ✔️

筛选查询列表

在筛选器框中输入关键字,以筛选 “收藏夹 ”或“ 所有 ”页面上显示的查询集。 若要了解有关筛选的详细信息,请参阅 筛选器积压工作、板、查询和计划

显示由 WIT IQ 关键字条件筛选的项目中的所有查询的屏幕截图。

有关详细信息,请参阅 查询常见问题解答、导航和文件夹

Email查询项或共享查询 URL

“查询编辑器”或“结果”视图中,可以通过电子邮件发送查询项的格式列表或复制查询 URL。

选择操作图标以打开菜单,然后从列出的选项中进行选择,Email查询复制查询 URL

Web 门户,查询编辑器/结果,打开操作菜单,选择Email查询或复制查询 URL
只能将电子邮件发送到系统识别的项目成员的单个地址。 不支持将团队组或安全组添加到该行。 如果添加系统无法识别的电子邮件帐户,将收到一封邮件,即一个或多个电子邮件收件人无权读取已邮寄的工作项。

备注

若要向非项目成员的人员发送电子邮件格式列表,需要使用 “复制”作为 HTML 选项, 复制工作项列表中所述。 对于本地 Azure DevOps,所有电子邮件操作都需要 配置 SMTP 服务器。 如果没有配置 SMTP 服务器,可以使用 复制作为 HTML 解决此问题。

选择 “复制查询 URL”。 若要通过电子邮件发送查询项,请参阅 复制工作项列表

Web 门户,查询编辑器/结果,复制查询 URL

备注

通过Email查询,系统将向所选的队友发送电子邮件格式列表。 若要向不属于项目的人员发送电子邮件格式列表,需要使用 “复制”作为 HTML 选项, 复制工作项列表中所述。 所有电子邮件操作都需要 配置 SMTP 服务器。 如果没有配置 SMTP 服务器,可以使用 复制作为 HTML 解决此问题。

接下来尝试此操作