Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
Visual Studio 2022
本文介绍如何通过运行和共享查询来访问 Azure Boards 工作项并与之交互。 可以查看和运行内置或共享查询，以识别分配给你的工作项或满足其他条件的工作项。
先决条件
- 一个 Azure DevOps 项目，其中包含分配给你或你正在关注的工作项，或者由你定义或与您共享的查询。 若要定义查询，请参阅 “定义工作项查询”。
| 类别 | 要求 |
|---|---|
| 访问级别 | - 查看并运行共享查询：项目成员。 - 要添加并保存共享查询：至少具有基本访问权限。 |
| 权限 | 对于要添加查询的文件夹，请将参与权限设置为允许。 默认情况下，“参与者”组没有此权限。 |
注意
对公共项目具有“利益干系人”访问权限的用户可以完全访问查询功能，就像具有“基本”访问权限的用户一样。 有关详细信息，请参阅利益干系人访问快速参考。
| 类别 | 要求 |
|---|---|
| 访问级别 | - 查看并运行共享查询：项目成员。 - 要添加并保存共享查询：至少具有基本访问权限。 |
| 权限 | 对于要添加查询的文件夹，请将参与权限设置为允许。 默认情况下，“参与者”组没有此权限。 |
打开“查询”页
若要打开项目的 查询 页，请选择 看板>查询。 “ 查询 ”页将打开“ 收藏夹 ”选项卡，其中显示了你或团队选择的查询作为收藏夹。 有关详细信息，请参阅设置个人或团队收藏夹。
“收藏夹”选项卡还会在“继续上次中断的位置”下显示你最近打开的查询。
若要查看项目中的所有个人和共享查询，请选择“查询”页上的“所有”选项卡。 “ 所有 ”选项卡显示内置查询、定义的查询以及项目中共享的查询。 展开 “我的查询”、“ 共享查询”和其他文件夹以访问其查询。
在“查询”页的“所有”选项卡上，“我的查询”文件夹包含以下内置查询，以及你定义的查询：
-
分配给我 使用
@Me宏来列出当前项目中分配给你的所有工作项。 -
关注的工作项 使用 @Follows 宏
ID来@Follows列出你关注的所有工作项。 有关详细信息，请参阅跟进工作项或拉取请求。
“所有”和“收藏夹”选项卡支持的任务
你可以执行大多数任务，以便从“查询”页的“所有”或“收藏夹”选项卡查看和运行查询，如下表所示。
任务 |
收藏夹 | 全部 |
|---|---|---|
| 列出所有你或你所属团队标记为收藏的查询 | ✔️ | |
| 列出当前项目的所有查询或共享查询 | ✔️ | |
| 收藏查询 | ✔️ | |
| 取消收藏查询 | ✔️ | ✔️ |
| 筛选查询列表 | ✔️ | ✔️ |
| 展开或折叠文件夹 | ✔️ | ✔️ |
| 运行查询或打开查询的上下文菜单 | ✔️ | ✔️ |
只有在 “我的查询 ”下保存的内置查询和查询才会显示在 “我的查询”下。 仅你收藏的查询显示在 “我的收藏夹”中。 团队只能收藏保存在“共享查询”下的查询。
筛选查询列表
在“查询”页的“收藏夹”或“所有”选项卡上的筛选器框中输入关键字，以筛选显示的查询。 有关详细信息，请参阅以交互方式筛选积压工作、面板、查询和计划。
导航到查询和文件夹
在“查询”页的“收藏夹”或“所有”选项卡中，可以导航到查找和打开特定查询。
在“ 所有 ”选项卡上，查询页可以直接显示或显示在文件夹或子文件夹中。 可以导航到文件夹、子文件夹或查询页。
进行选择并打开文件夹时，痕迹导航将显示在页面顶部。
可以选择痕迹导航中的文件夹以打开该文件夹。
还可以从打开的查询的下拉菜单中打开收藏的查询或返回到“ 所有 查询”页。
运行查询
若要从“查询”页的“收藏夹”或“所有”选项卡运行查询，请根据需要展开其文件夹并选择查询。 此时将打开“查询 结果 ”页。
还可以在“查询”页上选择查询旁边的“更多作”图标，然后从上下文菜单中选择“运行查询”或其他选项。
从 Azure DevOps CLI 运行查询
可以使用 Azure DevOps 命令行接口中的 az boards query 命令运行 Azure Boards 查询。 若要开始，请参阅 Azure DevOps CLI 入门。
az boards query [--id] [--org] [--path] [--project] [--wiql]
参数
-
id：现有查询的 ID。 除非指定了--path或--wiql，否则是必需的。 -
wiql：工作项查询语言（WIQL）格式的查询。 如果指定了--id或--path，则忽略。 -
path：现有查询的路径。 如果--id指定，则忽略。 -
org：Azure DevOps 组织 URL，例如--org https://dev.azure.com/MyOrganizationName/。 除非已配置为默认情况或通过git config获取，否则这是必需的。 使用az devops configure -d organization=ORG_URL配置默认组织。 -
project：项目名称或 ID。 如果未配置为默认或使用 选取git config，则为必需。 使用az devops configure -d project=NAME_OR_ID. 配置默认项目。
例子
以下命令运行具有指定 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
以下命令运行 WIQL 查询，并按表格式显示结果。
az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork] 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
通过电子邮件发送或分享查询
在查询 编辑器 或 结果 视图中，可以将查询项的格式列表通过电子邮件发送给项目成员或复制要共享的查询 URL。
选择右上角的“ 更多作 ”图标，然后从上下文菜单中选择 “电子邮件查询 ”或“ 复制查询 URL ”。
只能向系统识别的单个项目成员发送电子邮件。 不支持发送到团队组或安全组。 收件人必须有权限读取被发送的工作项。
电子邮件通过默认邮件客户端发送，并包含一个查询链接，该链接仅返回所列的工作项。 有关详细信息，请参阅复制或克隆工作项。
注意
若要向非项目成员的人员发送电子邮件格式列表，请参阅 “复制”或通过电子邮件发送工作项列表。
注意
对于本地 Azure DevOps，所有电子邮件操作都需要配置 简单邮件传输协议（SMTP）服务器 。 如果没有配置 SMTP 服务器，可以使用 复制作为 HTML 来处理 此要求，如 复制或通过电子邮件发送工作项列表中所述。
在 Visual Studio 中查看工作项
在 Visual Studio 团队资源管理器的工作项页上，可以列出已连接项目的工作项。 必须在 Azure Boards Web 界面中完成查询创建和管理。
在 “工作项 搜索”窗格中，可以应用筛选器，以便按 “已分配给”、“ 创建者”、“ 状态”或 “工作项类型”查看列出的工作项。
可以展开工作项列表，然后选择当前视图旁边的下拉箭头来选择内置的已分配给我、关注、提及或我的活动视图。
对于列出的单个工作项，您可以执行以下操作：
- 将鼠标悬停在工作项上以显示信息。
- 选择工作项标题以重命名工作项。
- 右键单击工作项，将其分配给自己或完成工作项。
- 双击该项或右键单击并选择“ 打开 ”以在 Azure Boards UI 中打开工作项。
还可以通过选择 “新建工作项 ”并输入工作项标题来创建工作项。 通过 Visual Studio 所做的更改反映在 Azure Boards 中。