Использование @упоминание в рабочих элементах и запросах на вытягивание

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

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

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

Примечание.

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

Если ваша организация использует существующий html-edtitor, добавьте следующий html-код:: <div><a href="#" data-vss-mention="version:2.0,{user id}">@John Doe</a> Testing mentioning</div>

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

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

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

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

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

Примечание.

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

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

Когда вы оставляете комментарий кода в запросе на вытягивание, введите@, чтобы активировать средство выбора @упоминание людей. В средстве выбора людей вы увидите список пользователей, которые вы недавно упоминание. Чтобы выполнить поиск в каталоге, выберите имя или введите имя пользователя, который вы ищете.

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

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

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

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

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

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

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

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

Примечание.

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

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

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

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

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

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

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

Внимание

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

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

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

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

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