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

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

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

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

注意

可以通过 API 发布 。@mention 获取 Azure DevOps 用户 ID

如果组织正在使用现有的 HTML edtitor，请添加以下 html 代码： <div><a href="#" data-vss-mention="version:2.0,{user id}">@John Doe</a> Testing mentioning</div>

如果组织使用新的 Markdown edtitor 进行注释，则可以使用以下代码： @<UserID>

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

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

标识搜索选择

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

警告

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

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

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

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

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

注意

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

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

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

搜索选择中的有限标识

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

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

重要

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

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

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

警告

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

相关文章

• 工作项窗体控件
• 拉取请求