Определение получателей сообщений электронной почты уведомлений

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

Многие факторы определяют получателей уведомления по электронной почте при совпадении события с подпиской. Если вы не знаете, эти факторы могут привести к получению слишком большого или слишком большого количества сообщений электронной почты. Узнайте, как тип подписки, параметры доставки, настройки доставки и другие факторы определяют набор получателей.

Примечание.

Многие понятия, описанные в этой статье, применимы к более ранним версиям Azure DevOps, хотя пользовательский интерфейс, возможно, изменился.

Пользовательские личные подписки

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

Примечание.

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

Предпочтительный адрес электронной почты для личной подписки (по умолчанию)

Снимок экрана: предпочтительный адрес электронной почты.

Пользовательский адрес электронной почты в личной подписке

Снимок экрана: пользовательский адрес электронной почты.

Параметры доставки для команд и групп

Параметры доставки управляют поведением доставки по умолчанию, когда команда или группа является получателем уведомления. Подписка настроена с параметром доставки, который смотрит на параметры доставки получателей.

Вы можете управлять подписками и параметрами доставки на уровне команды или организации.

Параметры уровня организации

  1. В параметрах организации выберите глобальные уведомления подписчиков>> вашей команды>доставки.

    Снимок экрана: параметры доставки команды.

  1. Выберите из следующих параметров:
  • Доставка по адресу электронной почты: уведомления доставляются по определенному адресу электронной почты.

  • Доставка отдельным членам: уведомления доставляются каждому участнику группы или команды. Обычно этот параметр является параметром по умолчанию. Дополнительные сведения о параметре по умолчанию см. в разделе "Расширение команды".

  • Не доставляйте: уведомления по умолчанию не доставляются.

    Снимок экрана: диалоговое окно

Если вы явно не выбираете параметры доставки для команды или группы, она определяется из параметра доставки на уровне организации. Значение по умолчанию — "Доставка отдельным членам" или "Не доставляйте".

Совет

Диалоговое окно параметров доставки не указывает, был ли текущий выбор явно задан или был ли он унаследован.

Пользовательские получатели подписки группы и группы

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

Параметры доставки электронной почты для команды

Для группы или группы доступны следующие варианты доставки:

  • Участники команды по ролям: получатели являются членами команды или группы, у которых есть одна из выбранных ролей (например, назначаемый рабочий элемент)
  • Предпочтения группы: получатели определяются параметром доставки группы или группы (не доставить, предпочитаемый адрес электронной почты или члены команды).
  • Пользовательский адрес электронной почты: получатель — указанный адрес электронной почты
  • Члены команды: получатели являются всеми членами команды или группы, за исключением членов, которые отказались от подписки.
  • SOAP: аналогично Управление API, получатели указываются путем добавления своих адресов электронной почты (подписок) в службу SOAP.

Примечание.

Параметр доставки по умолчанию каждого члена учитывается, включая группы, которые являются членами команды или группы.

Участник команды по роли

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

Снимок экрана: роль параметра доставки группы электронной почты.

Параметр Skip Initiator, который отображается для большинства типов событий, определяет, должен ли пользователь или группа, запущенная событие, явным образом исключить из набора получателей. Как правило, этот параметр должен быть включен, так как большинство пользователей не хотят получать уведомление о том, что они сделали.

Предпочтения команды

Вариант доставки взят из параметра доставки команды и может быть одним из следующих вариантов:

  • Доставка по адресу электронной почты: электронная почта доставляется в предпочтительный адрес электронной почты команды.
  • Доставить к отдельным членам: см. следующий параметр: "Члены" team_.
  • Не доставляйте: сообщение электронной почты не доставлено.

Снимок экрана, показывающий вариант доставки электронной почты.

Значение параметра доставки команды отображается после метки адреса и не может быть изменено.

Пользовательский адрес электронной почты

Уведомление отправляется нескольким пользовательским адресам электронной почты, разделенным точкой с запятой.

Снимок экрана: параметры доставки пользовательской группы электронной почты.

Члены команды

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

Снимок экрана: имя команды для доставки электронной почты.

Получатели подписки по умолчанию

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

Снимок экрана: получатели для подписок по умолчанию.

Примечание.

Параметр инициатора пропуска недоступен для всех типов событий.

Расширение группы и группы для получателей электронной почты

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

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

Остаются только группы Azure DevOps Services. Для каждой группы предпочтения доставки группы проверяются:

  • "Не доставляйте": дальнейшая оценка не выполняется в этой группе, а следующая группа-член оценивается
  • "Доставка по адресу электронной почты": адрес электронной почты добавляется в окончательный список получателей.
  • "Доставка отдельным членам": группа расширяется (например, ее родительская группа) и применяются те же правила для оценки его членов.

Сценарии

Рассмотрим несколько сценариев. Для обозначения типов элементов мы используем следующие символы:

  • I: отдельный пользователь
  • T: вложенная команда или группа
  • A: группа Microsoft Entra с поддержкой почты.
Сценарий Пример
Участник с параметром "Не предоставлять предпочтения" У команды есть члены I1, I2и T1. T1Предпочтения доставки — не доставляйте. Что происходит: только I1 и I2 получать уведомления по их предпочитаемым адресам электронной почты. T1 Члены не уведомляют.
Участник с предпочтениями "Доставить к отдельным членам" У команды есть члены I1, I2и T1. T1Предпочтения доставки — доставить отдельным членам. T1 имеет члены I2 и I3. Что происходит: T1 расширяется (из-за его предпочтения доставки) и поэтому I1, I2и I3 получать уведомления по их предпочитаемым адресам электронной почты.
Вложенная группа У команды есть члены I1, I2и T1. T1 имеет члены I2, I3и T2. T1Предпочтения доставки — не доставляйте. T2 имеет члены I4 и I5. T2Предпочтения доставки — доставить отдельным членам. Что происходит: так как не расширяется (так как T1 его предпочтение доставки — "не доставить"), только I1 и I2 получать уведомления по их предпочитаемым адресам электронной почты.
Участник, который является группой Microsoft Entra У команды есть члены I1, I2и A1. Что происходит: только I1 и I2 получать уведомления по их предпочитаемым адресам электронной почты. A1 Участники не получают уведомления, так как Azure DevOps не расширяет группы AD при доставке уведомлений.