Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022
本快速入门介绍如何在 Azure DevOps 中创建、编辑、重命名和删除仪表板。 它还介绍了权限设置、添加小组件以及排查常见问题。
了解如何执行以下任务：
- 创建团队和项目仪表板
- 添加、配置、移动、调整大小和删除部件
- 设置仪表板权限和共享选项
- 排查常见仪表板和小组件问题
快速步骤：
- 在项目中，打开 “概述>仪表板”
- 选择 “新建仪表板 ”以创建团队或项目仪表板
- 选择“编辑”，打开小组件目录，将小组件拖到画布上，然后选择“完成编辑”
- 打开 更多选项>仪表板设置 以重命名或更改刷新设置
- 打开 “更多选项>安全性 ”以设置权限
提示
可以使用 AI 帮助完成 Azure DevOps 任务。 请参阅 在 Azure DevOps MCP Server 启用 AI 辅助功能 即可入门。
先决条件
| 类别 | 要求 |
|---|---|
| 访问级别 |
-
项目成员。 - 至少 基本 访问权限或特定 仪表板权限。 |
| 权限 | 若要添加、编辑或管理团队仪表板：团队成员和 项目管理员 组的成员。 |
| 工具 | 要让仪表板上的分析小组件正常工作，需要启用分析功能。 |
注意
图表或小组件中显示的数据受已登录用户授予的权限的约束。 例如，如果用户没有权限查看特定区域路径下的工作项，这些工作项将不会显示在仪表板上的查询型小部件中。 有关详细信息，请参阅 Azure DevOps 仪表板、图表和报表上的常见问题解答。
为 Azure DevOps 启用 AI 帮助
为了提高 Azure DevOps 工作流的工作效率，请使用 Azure DevOps MCP 服务器为项目数据启用 AI 帮助。 通过对 AI 助手的自然语言查询，获取日常站立、冲刺规划、代码评审、项目报告、拉取请求分析和工作项管理的智能见解。 有关详细信息和安装说明，请参阅 Azure DevOps MCP 服务器概述。
项目和团队仪表板
仪表板属于团队或项目。
- 使用项目仪表板在项目级别显示信息，并控制谁可以编辑仪表板。
- 使用团队仪表板显示专为团队定制的信息;团队成员通常编辑这些仪表板。
注意
- 创建项目仪表板的用户将成为其所有者，并且可以设置编辑器权限。 删除项目仪表板需要项目集合管理员组中的成员身份。
- 团队管理员拥有团队仪表板;团队成员通常可以根据团队设置编辑它们。
- 如果小组件是团队范围的，并且缺少团队选择器，仪表板将使用项目的默认团队。
创建项目时，Azure DevOps 还会创建默认团队和名为 Overview 的默认团队仪表板。 通过 添加小组件自定义该仪表板。
仪表板目录（浏览仪表板）
打开仪表板目录以浏览和管理当前项目的仪表板：
- 在项目中，选择 “概述>仪表板”。
- 使用筛选器图标按标题、说明或团队搜索仪表板。
- 使用仪表板选择器（左上角）切换仪表板或选择“ 浏览所有仪表板”。
目录按以下顺序列出仪表板：
- 上次访问的仪表板
- 收藏夹列表中的仪表板
- 你所属团队的仪表板
- 所有项目仪表板按字母顺序排列
选择并收藏仪表盘
从目录中打开仪表板，或在查看其他仪表板时使用仪表板选择器。 若要将仪表板添加到收藏夹，请执行以下操作：
- 选择目录中仪表板行中的星号，或
- 将鼠标悬停在选择器中的仪表板上，然后选择星形图标。
收藏的仪表板会显示在目录靠近顶部的位置，并出现在您的个人收藏夹列表中。
添加仪表板
可以随时添加仪表板（受项目限制的约束）。
注意
每个项目有 500 个仪表板的限制。 如果达到限制，请删除未使用的仪表板或将挂件合并至较少数量的仪表板中。
创建仪表板的步骤：
- 在仪表板目录中，选择蓝色加号图标（新建仪表板）。 或者从任何仪表板中打开仪表板选择器，然后选择“ 新建仪表板”。
- 提供名称和可选说明。
- 在 “仪表板类型”下，选择 “项目仪表板 ”或 “团队仪表板”，如果需要，请选择团队。
- 选择 创建。
如果未看到 “新建仪表板”，则可能无权为所选团队创建仪表板。 将上下文切换到团队管理员所在的团队，或请求团队管理员权限。 有关帮助，请参阅 创建或添加团队。
重命名、删除和自动刷新
重命名或更新设置：
- 打开要更改的仪表板。
- 选择 更多操作 (⋯) >仪表板设置。
- 更改名称、说明或自动刷新设置，然后选择“ 保存”。
自动刷新：
- 启用后，仪表板会自动刷新（通常每 5 分钟刷新一次）。 对于接近实时的小组件使用自动刷新。 跨多个仪表板的频繁刷新可能会增加大型组织的组件/API 活动。
删除仪表板：
- 打开 “概述>仪表板 ”以显示仪表板目录。
- 在目录中，选择以下任一项：
- 将鼠标悬停在仪表板行上，打开“更多操作”(⋯) >删除，或
- 打开仪表板，然后在仪表板上打开更多操作 (⋯)，然后选择删除。
- 请在对话框中确认删除操作。
重要
- 若要删除项目仪表板，你必须是“项目集合管理员”组的成员。
- 若要删除 团队仪表板，您必须具有适当的团队/仪表板权限（例如团队管理员或显式授予的删除权限）。
以下屏幕截图显示了仪表板目录中的“删除”操作项。 在使用屏幕截图之前，请按照前面的步骤导航至目录或仪表板本身。
添加、移动、调整大小或删除小组件
小组件在仪表板上显示数据、图表和操作。
编辑小组件：
- 打开仪表板。
- 选择 “编辑” 以打开小组件目录。
- 将小组件拖到画布上以添加它。
- 使用小组件工具栏配置、调整大小或删除小组件。
- 选择 “完成编辑 ”以保存布局更改。
- 通过在编辑模式下将磁贴拖动到新位置来重新排列小部件。
- 通过选择“ 删除”从其菜单中删除小组件。
提示
使用明确的仪表板名称和说明，以便人们能够发现正确的仪表板。 将相关小组件组合在一起，避免添加太多频繁刷新的小组件。
扩展性和自动化
开发人员可以创建自定义小组件并实现仪表板操作的自动化：
- 使用仪表板小组件扩展模型创建或扩展小组件： 添加仪表板小组件。
- 使用 Dashboards REST API 以编程方式管理仪表板。
Troubleshooting
- 无法创建仪表板：检查你是否选择了正确的团队上下文，以及你是否具有团队管理员或项目级权限。
- 我看不到或编辑仪表板：验证项目成员身份、团队成员资格和仪表板权限（打开 “更多选项>安全性”）。
- 小组件数据已过时或为空：验证小组件的数据源和任何所需权限（查询、分析视图或服务连接）。
- 自动刷新未更新：请确认自动刷新已启用，并且每个小部件的来源支持刷新；尝试手动刷新页面。
- 无法删除项目仪表板：必须属于项目集合管理员才能删除项目仪表板。
有关仪表板权限或小组件所有权的程序化视图，可以使用仪表板 REST API 或通过检查审核日志来实现。
最佳做法
- 使仪表板保持专注：针对每个方案（状态、分类、冲刺健康）创建一个仪表板。
- 限制包含高成本小组件或复杂查询的仪表板的刷新频率。
- 使用描述性名称和简短说明使仪表板可发现。
- 通过在团队 Wiki 页面中添加链接或在团队频道中固定链接来共享仪表板。
Accessibility
设计无障碍仪表板
- 对小组件和图表使用有意义的文本标签。
- 确保有足够的颜色对比度，避免单独通过颜色传达信息。
- 添加文本说明到支持它们的小组件中。