Использование @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,{user id}">@John Doe</a> Testing mentioning</div>
  • Если ваша организация использует новый редактор Markdown для комментариев, используйте следующий код: 
    @<UserID>

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

Для организаций, которые управляют своими пользователями с помощью Active Directory, средства выбора людей поддерживают поиск всех пользователей в Active Directory, а не только тех пользователей, которые добавлены в проект.

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

  • Обсуждения рабочих элементов или любые поля с форматированным текстом
  • Обсуждения запросов на вытягивание
  • Комментарии к фиксации
  • Примечания с набором изменений или набором полок
  • Обсуждения рабочих элементов
  • Обсуждения запросов на вытягивание
  • Комментарии к фиксации
  • Примечания с набором изменений или набором полок

Примечание.

Для локального сервера Azure DevOps настройте SMTP-сервер для участников группы, чтобы просмотреть параметр "Уведомления" из меню "Организация" или "Профиль пользователя" и получать уведомления.

Выбор поиска удостоверений

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

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

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

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

Снимок экрана: средство выбора людей

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

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

Снимок экрана: раздел обсуждения с упоминанием.

Примечание.

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

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

Снимок экрана: сообщение электронной почты, отправленное в Outlook.

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

Совет

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

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

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

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

Внимание

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

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

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

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

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