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

项目
04/09/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

若要查找分配给你或你的团队的工作项，请运行查询。许多工作项查询是随进程预定义的。团队成员可能已创建可查看和运行的共享查询。通常，基于现有可用的查询定义来定义新查询会更容易。

先决条件

必须具有“利益干系人”访问权限才能查看和运行共享查询。默认情况下，所有项目成员都具有利益干系人访问权限。有关详细信息，请参阅更改共享查询或文件夹的权限。
必须具有“基本”访问权限或更高权限才能添加和保存共享查询。
对于要在其中添加查询的文件夹，必须将“参与”权限设置为“允许”。默认情况下，“参与者”组没有此权限。

注意

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

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

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

打开“面板”>“查询”，垂直导航

如果这是你首次打开“查询”，页面将打开“收藏夹”。此页列出了你指示加入收藏夹的查询。否则，可以选择“全部”来查看已定义的所有查询以及为项目定义的共享查询。

提示

你或你的团队选择加入收藏夹的查询显示在“收藏夹”页面上。加入收藏夹的查询以及其他对象也显示在“项目”页上。有关详细信息，请参阅设置个人或团队收藏夹。

在 Azure Boards 中运行查询

若要运行任何查询，请展开文件夹并选择查询的标题。视图随即打开，显示查询“结果”。

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

浏览器
Visual Studio

提示

与其他 Web 门户页一样，“查询”页会记住你上次转到的视图，并将你返回到该视图。

选择“全部”打开页面，可在其中查看已定义或在项目中共享的所有查询。
根据需要选择“我的查询”。
- 若要查看分配给你的所有工作项，请选择“已指派给我”。此查询使用 @Me 宏列出分配给你的所有工作项。
- 若要查看你正在关注的所有工作项，请选择“后续工作项”。此查询使用 @Follows 宏（@Follows)中的 ID）列出你选择关注的所有工作项。有关详细信息，请参阅跟进工作项或拉取请求。
选择“共享查询”以展开文件夹并访问保存为共享查询的查询。
选择痕迹导航中的文件夹以打开查询文件夹。

从命令行运行查询

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

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

参数

id：现有查询的 ID。必需，除非指定了 --path 或 --wiql。
wiql：工作项查询语言格式的查询。忽略，如果指定了 --id 或 --path。
path：现有查询的路径。忽略，如果指定了 --id。
org：Azure DevOps 组织 URL。可以使用配置默认组织 az devops configure -d organization=ORG_URL。如果未配置为默认或使用选取 git config，则为必需。示例：--org https://dev.azure.com/MyOrganizationName/。
项目：项目的名称或 ID。可以使用配置默认项目 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

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

注意

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

浏览器
Visual Studio

“查询”页包含一个以目录为中心的视图，你可以筛选该视图以查找感兴趣的特定查询。在“查询”页中操作时，可以转到子文件夹、文件夹或页面。

查询痕迹导航

此外，还可以从选择器菜单中选择收藏的查询，也可以选择浏览所有查询，这会返回到“所有查询”页。

查询、查询选择器的屏幕截图。

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

所有和收藏夹支持的任务

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

任务	收藏夹（浏览器）	全部（浏览器）	工作项（团队资源管理器）
查看所有收藏的查询、你的查询或你所属的团队	✔		✔
查看当前项目的所有查询或共享查询		✔	✔
运行查询，打开查询的上下文菜单	✔	✔	✔
展开或折叠容器文件夹或查询文件夹	✔	✔	✔
筛选查询列表	✔	✔
收藏查询（对于 Web 门户，选择）		✔
取消查询（对于 Web 门户，请选择）	✔	✔	✔
添加新查询：选择	✔	✔	✔