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

  • 项目

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

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

对于使用 Azure Active Directory (Azure AD) 管理其用户和组的组织，人员选取器支持搜索添加到 Azure AD 的所有用户和组，而不仅仅是那些添加到项目中的用户和组。 若要将集限制为项目成员和组，请参阅 管理组织、限制标识搜索和选择。

注意

可以通过 API 发布 。@mention 获取 Azure DevOps 用户 ID，然后添加以下 html 代码：<div><a href="#" data-vss-mention="version:2.0,{user id}">@John Doe</a> Testing mentioning</div> 有关详细信息，请参阅 Microsoft Power Automate 社区论坛文章。

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

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

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

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

注意

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

标识搜索选择

在拉取请求中留下代码注释时，输入 @ 以触发 @提及 人员选取器。 在人员选取器中，可以看到最近提到的用户列表。 若要执行目录搜索，请选择一个名称或输入要查找的用户的名称。

警告

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

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

人员选取器屏幕截图

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

若要 @提及以前从未选择过的用户，请继续输入整个名称以针对完整目录进行搜索。

提及的用户的姓名以蓝色文本显示。 选择 @提及 链接名称以打开用户的联系信息。 联系信息提供了更多上下文，说明将他们添加到对话的原因。

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

Web 门户，可访问提及用户联系人信息

注意

请勿复制/粘贴上一批注释中的 @提及 用户。 虽然生成的格式看起来与正确输入的提及相同，但它不会注册为真正的提及也不会发送电子邮件通知。

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

Outlook 中发送Email的屏幕截图。

发送到提及用户组织的Email

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

搜索选择中的有限标识

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

对于使用 Azure Active Directory (Azure AD) 管理其用户和组的组织，人员选取器支持搜索添加到 Azure AD 的用户和组。 对于希望将搜索和选择限制为仅添加到特定项目的那些用户和组的组织，可以通过为其组织启用 将用户可见性和协作限制到特定项目的 预览功能来执行此操作。

重要

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

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

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

警告

为组织启用 “将用户可见性和协作限制为特定项目 ”预览功能时，项目范围的用户无法搜索通过 Azure Active Directory 组成员身份（而不是显式用户邀请）添加到组织的用户。 这是一种意外的行为，正在处理解决方法。 若要自行解决此问题，请禁用组织的 “将用户可见性和协作限制为特定项目 ”预览功能。