在 Azure Boards 和 Azure DevOps 中管理和组织查询

  • 项目

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

Visual Studio 2019 | Visual Studio 2022

通过添加查询文件夹，可以组织个人或共享查询。 然后，可以将查询添加到这些文件夹中，或将现有查询移动到这些文件夹中。 可以从 Web 门户或受支持的客户端（如 Visual Studio 团队资源管理器）创建查询和查询文件夹。

注意

若要在 Visual Studio 2019 中创建和管理查询，需要将工作项体验设置为旧版选项。 此外，还可以从 Visual Studio（而不是 Web 门户）将查询批量拖放到查询文件夹中。

先决条件

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

注意

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

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

打开查询

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

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

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

提示

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

运行、编辑和保存查询

定义查询的最简单方法是从现有共享查询开始。 下面的示例展示了如何通过修改随敏捷流程模板提供的“活动 bug”共享查询，来查找所有已关闭的 bug。 这些示例基于 Web 门户提供的用户界面。

  1. 打开共享查询。 例如，从 Web 门户打开“活动 bug”或类似的简单列表查询。

    运行活动 bug 查询

    提示

    如果是使用 Visual Studio 团队资源管理器，请打开“工作”页，访问查询和共享查询。 如果看不到团队资源管理器，请从顶级菜单中选择“查看”>“团队资源管理器”。

  2. 编辑查询以查找已关闭的 Bug，然后运行查询。 使用 插入新的筛选器行 可在当前子句的上方插入一个子句。 使用 移除筛选器行 可删除子句。 查询会自动限定为当前项目。 若要查找在多个项目中定义的工作项，请参阅跨项目查询。

    Web 门户、查询页、新查询体验、简单列表查询的编辑器视图

  3. 将查询保存到“我的查询”文件夹。

    “另存为查询”对话框，新体验

    若要将查询保存到“共享查询”文件夹，你需要是项目管理员组的成员，或者将对文件夹的“参与”权限设置为“允许”。 有关详细信息，请参阅设置查询权限。

重命名或删除查询

在“收藏夹”或“所有”页中，选择查询的 操作图标以运行、编辑、重命名或删除查询。

新查询体验、“收藏夹”页、查询上下文菜单

对于共享查询，还可以选择执行以下任务之一：

  • 添加到团队查询：选择团队以将查询添加为团队收藏夹
  • 安全性...：设置查询的权限。 有关详细信息，请参阅设置查询权限。
  • 添加到仪表板：将查询磁贴小组件添加到所选的团队仪表板。 有关详细信息，请参阅向仪表板添加小组件。

添加查询文件夹并将项移动到文件夹中

提示

需要“删除”权限才能重命名或移动共享查询或文件夹，需要文件夹的“参与”权限才能将查询移动到文件夹。 若要查看或设置授权，请参阅设置对查询和查询文件夹的权限。

需要从“面板”>“查询”>“全部”页添加查询文件夹。

  1. 选择“全部”。 根据要添加查询文件夹的位置展开“我的查询”或“共享查询”。

  2. 若要添加文件夹，请为现有文件夹或顶部容器文件夹选择 操作图标，然后选择“新建文件夹”。

    “打开操作”菜单、选择“新建文件夹”

  3. 在“新建文件夹”对话框中输入文件夹的名称。 如果要更改文件夹的位置，请从“文件夹”下拉菜单中选择它。

    输入文件夹的名称和位置。

  4. 若要将项移动到文件夹，请将查询拖放到文件夹。 在 Web 门户中，只能将单个查询从文件夹外部拖动到文件夹中。

    （可选）可以为现有查询选择“更多命令”，选择“编辑”，然后选择“另存为”。 在“将查询另存为”对话框中，选择要在其中保存查询的文件夹。

    “将查询另存为”对话框

将查询另存为团队收藏夹

若要将共享查询另存为团队收藏夹，你需要是该团队的成员。

若要将查询添加到仪表板，请打开查询的 操作图标（或 上下文图标）菜单，将查询添加到特定的仪表板或作为团队收藏夹。

通过将查询添加到“共享查询”容器下的文件夹，可以与团队共享查询。 若要将查询保存到“共享查询”文件夹，你需要加入项目集合团队管理员组，或者已经针对共享查询下的文件夹设置权限。

只能将共享查询添加到仪表板或添加为团队收藏夹，并且仅当你拥有团队管理员或项目管理员权限时才能这样做。

  1. 若要将查询另存为团队收藏夹，请从“查询”页中打开查询的 “更多操作”或 上下文菜单。

  2. 选择“添加到团队收藏夹”，然后从列出的团队中进行选择。 只会列出你所属的团队。

    将查询另存为团队收藏夹的屏幕截图。

将查询磁贴添加到仪表板

查询磁贴可以显示查询中工作项的计数。 你也可以从仪表板快速打开查询。 可以使用以下步骤，或者按照将小组件添加到仪表板中所述的步骤，从“查询”页将查询磁贴添加到仪表板。

注意

只能将共享查询添加到仪表板。 并且，若要添加或编辑团队仪表板的小组件，你需要是团队成员或已被授予编辑仪表板的权限。

  1. 若要从“查询”页将查询添加到仪表板，请打开查询的 操作图标（或 上下文图标）菜单。

    “更多操作”菜单的屏幕截图，选择“添加到仪表板”。

  2. 在“选择仪表板”对话框中，选择要在其中添加查询的仪表板。

    “选择仪表板”对话框的屏幕截图。

  3. 打开仪表板，验证是否已添加查询磁贴。 可以将查询磁贴配置为更改默认颜色，并根据你指定的条件规则来指定磁贴的颜色。

    查询磁贴小组件的“配置”对话框的屏幕截图。