Используйте @mentions в рабочих элементах и пул-реквестах

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Элемент управления @mention позволяет быстро добавить пользователя или группу в рабочий элемент или обсуждение запроса на вытягивание. Используя средство выбора людей в элементе управления @mention , можно выбрать члена проекта или группу из списка поиска. Упомянутый пользователь или группа получает уведомление по электронной почте о вашем комментарии.

Для организаций, которые управляют своими пользователями и группами с помощью идентификатора Microsoft Entra, средства выбора людей поддерживают поиск всех пользователей и групп в идентификаторе Microsoft Entra. Вы можете искать пользователей и группы за пределами этих пользователей, добавленных в проект. Дополнительные сведения см. в разделе Ограничение видимости пользователей для проектов и не только.

Примечание.

Вы можете разместить @mention через API. Чтобы получить идентификатор пользователя Azure DevOps, см. получение идентификатора пользователя Azure DevOps.

• Если ваша организация использует существующий редактор HTML, добавьте следующий КОД HTML:

  <div><a href="#" data-vss-mention="version:2.0,{userID}">@John Doe</a> Testing mentioning</div>
  

• Если ваша организация использует новый редактор Markdown для комментариев, используйте следующий код:

  @<userID>
  

Используйте элемент управления @mention, чтобы начать или продолжить обсуждение в следующих областях:

• Обсуждения по рабочим задачам или любые поля форматированного текста
• Обсуждения pull requestов
• Комментарии к коммиту
• Комментарии к изменениям или shelveset

Необходимые условия

Категория	Требования
Доступ к проекту	член проекта.

Выбор поиска идентификации

1. Введите @ в комментарии кода в pull request, чтобы активировать инструмент выбора @mention людей.
2. Просмотрите список пользователей, которые вы недавно упомянули.
3. Выполните поиск в каталоге, выбрав имя из списка или введя имя нужного пользователя.

Предупреждение

Если у вас есть разрешение на приглашение пользователей в организацию, независимо от того, отключена ли политика ограничения приглашений , вы можете @mention пользователя, который не является частью вашей организации. Это действие приглашает этого пользователя в организацию. Дополнительные сведения см. в разделе "Ограничение новых приглашений пользователей" от администраторов проектов и команд.

Чтобы отфильтровать список, введите имя пользователя или псевдоним, пока не найдете совпадение.

Имена упомянутых пользователей отображаются в синем тексте. Выберите имя ссылки @mention, чтобы открыть контактные данные пользователя, предоставляя дополнительные сведения о том, почему они были добавлены в беседу.

Кроме того, можно использовать упоминания о группах. Введите имя команды или группы безопасности, выберите "Поиск", а затем выберите из перечисленных параметров.

Примечание.

Не копируйте и не вставляйте @mention пользователей из предыдущего комментария. Хотя форматирование может выглядеть идентично правильно введенной ссылке, оно не регистрируется как истинное упоминание и не отправляет уведомление по электронной почте.

После завершения выбора и ввода текста пользователь @mention получает электронное письмо с уведомлением об упоминании.

Используйте элемент управления @mention в обсуждениях pull request, комментариях к коммитам, комментариях к изменениям и комментариях к наборам на полках.

Совет

Поскольку прямого @CreatedBy макроса не существует, вы можете использовать @Me макрос в сочетании с полем "Создано" для фильтрации рабочих элементов, созданных вами. Например, чтобы пометить создателя элементов пустыми описаниями, можно выполнить запрос для идентификации таких элементов, а затем вручную пометить создателей в разделе комментариев каждого рабочего элемента с просьбой обновить описание.

Ограниченные идентичности в выборе параметров поиска

Инструменты для выбора пользователей обычно ищут и выбирают любого пользователя или группу, добавленных в Microsoft Entra ID организации.

Для организаций, использующих идентификатор Microsoft Entra для управления пользователями и группами, средства выбора людей поддерживают поиск всех пользователей и групп в каталоге. Чтобы ограничить поиск и выбор только теми пользователями и группами, которые добавлены в конкретный проект, включите функцию ограничения видимости и совместной работы пользователей для определенных проектов предварительной версии для вашей организации.

Если для организации включена предварительная функция "Ограничить видимость пользователей и их совместную работу с определенными проектами", список идентичностей, которые можно выбрать из средства выбора пользователей, ограничен следующими способами:

• Пользователи, добавленные в группу "Пользователи с привязкой к проекту", могут выбирать только из списка идентификаторов, который содержит пользователей и группы, явно добавленные в проект, к которому они подключены.
• Если все члены проекта добавляются в группу "Пользователи с областью проекта" , выбор людей ограничен только теми пользователями и группами, которые добавлены в проект. Все участники проекта могут выбирать только удостоверения, соответствующие пользователям и группам, явно добавленным в проект, к которому они подключены.

Предупреждение

При использовании этой функции предварительной версии следует учитывать следующие ограничения:

• Функции ограниченной видимости, описанные в этом разделе, применяются только к взаимодействиям через веб-портал. С помощью команд REST API или azure devops CLI члены проекта могут получить доступ к ограниченным данным.
• Пользователи в ограниченной группе могут выбирать только пользователей, которые явно добавляются в Azure DevOps, а не пользователи, имеющие доступ через членство в группе Microsoft Entra.
• Гостевые пользователи, являющиеся членами ограниченной группы с доступом по умолчанию в идентификаторе Microsoft Entra ID, не могут искать пользователей с помощью средства выбора людей.

Связанные статьи

• Элементы управления формами рабочих элементов
• Запросы на внесение изменений