共享项目视觉,查看项目活动

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

每个项目都提供 摘要 或主页,用于共享信息并展示最新的项目活动。 使用此页执行以下一个或多个任务。

项目管理员任务

项目成员任务

  • 添加简短项目说明
  • 为项目信息选择自述文件或 Wiki
  • 邀请人员参与你的项目
  • 设置项目标记
  • 为项目信息选择自述文件或 Wiki
  • 邀请人员参与你的项目
  • 查看项目信息
  • 查看项目活动
  • 收藏项目
  • Email或启动与团队成员的聊天
  • 跨项目启动搜索
  • 查看项目信息
  • Email或启动与团队成员的聊天
  • 查看项目活动

备注

可以将托管项目指定为 “专用 ”或“ 公共”。 对于公共项目,匿名用户可以查看项目 摘要,但 “成员 ”部分除外。 此外, “赞 ”和 “收藏夹 ”图标对匿名用户不可见。 若要了解有关公共项目的详细信息,请参阅 什么是公共项目?

摘要页的屏幕截图。

摘要页 TFS-2018 的屏幕截图。

备注

如果要为项目摘要信息使用项目 Wiki,请先 为项目创建 Wiki。 然后,可以 更改项目摘要页以指向 Wiki

先决条件

  • 必须是 项目管理员 的成员,或者将 “编辑项目级信息 ”权限设置为 “允许 ”执行以下操作:
    • 在项目页上编辑信息
    • 更改用于共享项目信息的存储库
    • 管理项目成员身份
  • 若要编辑页面,你必须是存储库或分支的参与者,或者将 “参与 ”权限设置为 “允许”。
  • 若要查看项目 摘要,您必须是项目的有效成员。 有关详细信息,请参阅 关于安全性、成员身份和权限;有效的用户组
  • 若要添加或编辑项目 标记,必须将项目级 “管理属性 ”权限设置为 “允许”。 此权限控制项目属性 REST API。 项目属性 REST API 用于驱动产品中的项目标记体验。

提示

如果没有编辑页面或使用功能的权限,则不可见相应的图标和链接。

打开项目摘要

在 Web 浏览器中,选择 “概述>摘要”。 如果还没有项目, 请创建一个项目

如果尚未设置项目摘要,你将看到以下欢迎页面:

打开项目摘要,新建导航

选择要开始的以下任务之一:

打开项目主页

在 Web 浏览器中,打开团队项目下拉菜单,然后选择主页。 如果没有项目, 请创建团队项目

打开项目摘要

若要为项目定义自述文件,请参阅 初始化 Git 存储库的自述文件初始化 TFVC 存储库的自述文件

更新页面

摘要 ”页显示项目存储库中定义的 自述 文件或项目 Wiki 的主页。 如果要使用项目 Wiki 主页,请先按照 为项目创建 Wiki 中所述进行设置。

  1. 编辑页面:

    • 如果是第一次编辑页面,请选择 “添加项目说明”。
      摘要页的屏幕截图,首次编辑。

    • 如果在设置页面后编辑页面,请选择 “编辑项目信息”。 此图标仅对有权编辑项目 摘要 页的成员可见。

  2. “说明 ”框中提供项目用途的简要说明。

    关于此项目对话框。

  3. (可选)为项目添加一个或多个 标记 。 这些标记类似于 工作项标记。 可以使用逗号或分号分隔符一次添加多个标记。 标记必须符合以下规则:

    • 标记必须为 40 个字符或更少
    • 标记不能包含正斜杠 (/) 字符或以连字符结尾 (-)
    • 不能将超过 15 个标记添加到项目中
    • 标记不区分大小写,不允许重复标记或空标记。

    备注

    搜索和筛选函数不能用于搜索或筛选项目标记。

  4. 选择是引用 自述 文件还是项目 Wiki 主页作为摘要页面内容的其余部分。

    提示

    在创建项目时,在存储库中添加了默认自述文件。 可以选择此自述文件,或为此创建另一个存储库和自述文件。

    如果选择 自述文件,请选择自述文件存储库。 将显示自述文件当前文本预览。

    关于此项目对话框,选择并选择自述存储库。

    如果选择 Wiki,请注意,将引用 Wiki 主页,并且必须是 Wiki TOC 中的第一个文件。 无法更改该引用。

  5. 若要更新引用的自述文件或 Wiki 的内容,请编辑相应的文件。 有关详细信息,请参阅 为存储库创建自述文件添加和编辑 Wiki 页面

    请考虑在 “摘要 ”页中包含以下类型的信息:

    • 用户可以参与项目的方式
    • 要与谁联系以提升权限或添加扩展
    • 路线图信息
    • 有关设置其开发和测试环境的说明的链接
    • 有关协作处理代码、跟踪工作、生成管道、部署发布的说明的链接
    • 指向模板的链接,用于提交 bug、问题或请求
    • 指向通讯组列表的链接,用于通过电子邮件发送问题或在 Slack 或 Teams 频道上发布问题。

邀请人员参与你的项目

可以通过选择 “邀请”来邀请用户参与项目的电子邮件。 若要了解详细信息,请参阅 将用户或组添加到团队或项目,从“摘要”页邀请用户

“摘要”页的屏幕截图,“邀请”按钮。

若要将用户添加到项目,请选择“ 添加 ”按钮。 若要了解详细信息,请参阅 将用户添加到团队项目或团队

“摘要”页的屏幕截图,“添加成员”按钮。

备注

对于本地 Azure DevOps,所有电子邮件操作都需要 配置 SMTP 服务器

查看项目活动

“项目统计信息 ”或 “活动” 部分中,可以查看过去 1、7 或 30 天内对项目的更新。 选择如下图所示的视图选项。

“摘要”页的屏幕截图,“统计信息”部分。

“摘要”页的屏幕截图,“活动”部分,TFS-2018。

Email或与项目成员聊天

在“ 成员 ”部分中,可以看到已添加到项目的一些成员,并通过电子邮件或与成员聊天连接到它们。

“摘要”页的屏幕截图,“成员”部分。

备注

100+ 表示已将 100 个或更多成员添加到项目中。

若要通过电子邮件或启动聊天会话,请选择显示的团队成员并选择你的选项。

“摘要”页的屏幕截图,“成员”部分,可用于连接到团队成员的选项。

备注

对于本地 Azure DevOps,所有电子邮件操作都需要 配置 SMTP 服务器

“摘要 ”页中,可以启动对代码、工作项和 Wiki 的搜索。 若要了解详细信息,请参阅 搜索入门“摘要”页的屏幕截图,搜索框。

初始化 Git 存储库的自述文件

你可以共享项目和目标,以及团队成员通过项目自述文件参与项目的方法。 对于 Git 项目,README.md 文件需要位于默认分支中每个存储库的根目录。 对于基于 Git 的项目,左窗格支持导航到其他存储库。 可以为每个存储库创建单独的欢迎页/README.md 文件。

  1. 打开 Repos>文件。 当选择用于克隆、推送、导入或初始化存储库的选项之一时,本页将指导你快速开始操作。

  2. 选中“ 添加自述文件 ”复选框后,选择 “初始化”。

    初始化自述文件(最新版本)的屏幕截图

    默认自述文件将添加到项目存储库,在本例中为 Fabrikam 测试 存储库。

  3. 返回到 概述>摘要 ,然后选择项目页的自述文件。 选择“ 编辑”。

    选择自述文件,新建导航

  4. 选择初始化自述文件的项目存储库。

    选择自述文件所在的存储库,新建导航

  5. 若要编辑自述文件,请选择自述文件链接。

    编辑自述文件,新建导航

    你被定向到自述文件 Repos>文件 页。 可以像在 Git 存储库中编辑和修改任何其他文件一样编辑和修改 README Markdown 文件。 可以使用 Markdown 语言设置自述文件的格式并添加图像。 若要了解有关添加自述文件的详细信息,请参阅为存储库和 Markdown 指南创建自述文件

  1. 打开 Project 主页。

  2. 选中“ 添加自述文件 ”复选框后,选择 “初始化”。

    初始化自述文件(新建导航)的屏幕截图

    默认自述文件将添加到项目存储库,在本例中为 Fabrikam 测试 存储库。

  3. 若要编辑项目 README.md 文件,请选择 “编辑”。

    Git 新项目摘要页

    使用 Markdown 语言格式化自述文件并添加图像。 若要了解有关添加自述文件的详细信息,请参阅为存储库和 Markdown 指南创建自述文件

初始化 TFVC 存储库的自述文件

对于为版本控制选择 TFVC 的项目,README.md 文件需要位于团队项目文件夹的根目录中 (,即 $/TeamProject/README.md) 。

  1. 打开 Repos>文件

  2. 选择 “添加项目说明”。

    欢迎页面,TFVC 新项目,创建自述文件,新建导航

  3. 选择 TFVC 存储库,然后选择 “保存”。 如果存储库中尚未创建自述文件,你将看到以下消息。

    关于此项目对话框,新建导航

  4. 若要创建自述文件,请选择 Repos>Files ,然后选择新文件以将文件添加到项目存储库。

  5. 将文件命名为 README.md

    “添加新文件”对话框,“新建导航”

  6. 以 Markdown 格式添加自述文件的内容,然后选择 “签入...”

    输入自述文件内容,新建导航

  7. 选择 “签入 ”以完成自述文件签入过程。

    签入自述文件对话框,新建导航

  8. 选择 “概述>摘要 ”以查看项目摘要页,其中显示了自述文件。

    显示自述文件的项目摘要页。

  1. 打开 Project 主页。

  2. 选择 “创建自述文件”。

    欢迎页面,TFVC 新项目,创建自述文件

    默认自述文件将添加到项目存储库,在本例中为 Fabrikam Fiber TFVC 存储库。

  3. 可以立即编辑自述文件。 完成后,选择 “签入”。

    编辑页面,新建导航
    在项目文件夹的根目录中具有 *.md 扩展名 () 的任何附加 Markdown 文件也显示在左窗格中,方便在它们之间导航,以便提供其他信息。

REST API