通过

@mentions在工作项和拉取请求中使用

  • 项目

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

使用 @提及 控件可以快速将用户或组添加到工作项或拉取请求讨论。 使用@mention控件中的人员选取器，可以从搜索列表中选择项目成员或组。 提到的用户或组会收到有关你的评论的电子邮件通知。

对于使用 Microsoft Entra ID 管理其用户和组的组织，人员选取器支持在 Microsoft Entra ID 内搜索所有用户和组。 可以搜索添加到项目中的用户和组以外的用户。 有关详细信息，请参阅 限制标识搜索和选择。

注意

可以通过 API 发布 。@mention 若要获取 Azure DevOps 用户 ID，请参阅 “获取 Azure DevOps 用户 ID”。

  • 如果组织正在使用现有的 HTML 编辑器，请添加以下 HTML 代码：
    <div><a href="#" data-vss-mention="version:2.0,{user id}">@John Doe</a> Testing mentioning</div>
  • 如果组织使用新的 Markdown 编辑器进行注释，请使用以下代码：
    @<UserID>

使用 @提及 控件可以快速将用户添加到工作项或拉取请求讨论。 使用@mention控件中的人员选取器，可以从搜索列表中选择项目成员。 提及的用户会收到有关您的评论的电子邮件通知。

对于使用 Active Directory 管理其用户的组织，人员选取器支持搜索 Active Directory 中的所有用户，而不仅仅是添加到项目的那些用户。

使用以下@mention控件开始或继续讨论以下方面：

  • 工作项讨论或任何富文本字段
  • 拉取请求讨论
  • 提交注释
  • 更改集或搁置集注释
  • 工作项讨论
  • 拉取请求讨论
  • 提交注释
  • 更改集或搁置集注释

注意

对于本地Azure DevOps Server，请为团队成员配置 SMTP 服务器，以便从其组织或用户配置文件菜单中查看“通知”选项并接收通知。

标识搜索选择

  1. 在拉取请求中输入@代码注释以触发@mention人员选取器。
  2. 查看最近提到的用户列表。
  3. 通过从列表中选择名称或输入要查找的用户的名称来搜索目录。

警告

如果你有权邀请用户加入组织，无论是否禁用了“限制邀请”策略，都可以@提及不属于组织的用户。 此操作邀请该用户加入组织。 有关详细信息，请参阅 限制来自项目和团队管理员的新用户邀请。

若要筛选列表，请输入用户名或别名，直到找到匹配项。

人员选取器屏幕截图

提及的用户的姓名以蓝色文本显示。 选择 @mention链接名称 以打开用户的联系信息，从而提供更多上下文来说明他们为何被添加到对话中。

还可以使用组提及。 输入团队或安全组的名称，选择“搜索”，然后从列出的选项中进行选择。

讨论部分的屏幕截图，其中提及制作。

注意

  • 不要复制并粘贴 上一批注释中的 @mention用户。 尽管格式可能与正确输入的提及看起来完全相同，但它不会注册为真实提及，也不会发送电子邮件通知。
  • 如果 @mention 没有成员的组，则不会发送任何电子邮件，即使该组是其他组的成员也是如此。

完成选择和文本输入后，@提及用户将收到一封电子邮件，提醒他们提及。

Outlook 中发送Email的屏幕截图。

在拉取请求讨论、提交评论、变更集注释和搁置评论中使用 @提及 控件。

提示

由于没有直接 @CreatedBy 宏，因此可以将 @Me 宏与“创建者”字段结合使用来筛选你创建的工作项。 例如，若要标记具有空白说明的项目创建者，可以运行查询来标识此类项目，然后在每个工作项的注释部分中手动标记创建者，要求他们更新说明。

搜索选择中的有限标识

人员选取器通常会搜索并选择添加到组织Microsoft Entra ID 的任何用户或组。

对于使用 Microsoft Entra ID 管理用户和组的组织，人员选取器支持搜索目录中的所有用户和组。 若要将搜索和选择限制为仅添加到特定项目的那些用户和组，请启用“ 将用户可见性和协作限制为组织的特定项目 预览功能”。

重要

  • 本部分所述的有限可见性功能仅适用于通过 Web 门户的交互。 使用 REST API 或 azure devops CLI 命令，项目成员可以访问受限数据。
  • 在Microsoft Entra ID 中具有默认访问权限的受限组中具有成员的来宾用户无法搜索具有人员选取器的用户。 当预览功能为组织关闭或来宾用户不是受限组的成员时，来宾用户可以按预期搜索所有Microsoft Entra 用户。

为组织启用对特定项目预览功能的“限制用户可见性和协作”时，可从人员选取器中选择的标识列表会通过以下方式受到限制：

  • 添加到 “项目范围”用户组 的用户只能从标识列表中选择，其中包含显式添加到他们连接到的项目的用户和组。
  • 如果所有项目成员都添加到 “项目范围用户组 ”，则人员选取器仅限于添加到项目的那些用户和组。 所有项目成员只能选择与用户和组显式添加到他们连接到的项目匹配的标识。

警告

启用 限制用户可见性和协作到特定项目 预览功能可防止项目范围内的用户通过Microsoft Entra 组成员身份（而不是显式用户邀请）搜索添加到组织的用户。 这是一种意外行为，并且正在进行解决方案。 若要解决此问题，请禁用将 用户可见性和协作限制为组织的特定项目 预览功能。