通过

确定通知电子邮件的收件人

  • 项目

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

许多因素决定了事件与订阅匹配时电子邮件通知的收件人。 如果你不知道，这些因素可能会导致收件箱收到过多或太少的电子邮件。 了解订阅的类型、其传递设置、传递首选项以及其他因素如何确定收件人集。

注意

本文中介绍的许多概念适用于早期版本的 Azure DevOps，尽管用户界面可能已更改。

自定义个人订阅

使用自定义个人订阅，电子邮件将传递到拥有订阅的用户的首选电子邮件地址，或传递到订阅上配置的电子邮件地址。

注意

对于本地Azure DevOps Server，请为团队成员配置 SMTP 服务器，以便从其组织或用户配置文件菜单中查看“通知”选项并接收通知。

个人订阅上的首选电子邮件地址（默认）

首选电子邮件地址的屏幕截图。

个人订阅上的自定义电子邮件地址

自定义电子邮件地址的屏幕截图。

团队和组的传递设置

当团队或组是通知的收件人时，传递设置控制默认传递行为。 订阅配置了一个传递选项，用于查看收件人的传递设置。

可以在团队级别或组织级别管理订阅和传递设置。

组织级别设置

  1. 在组织设置中，选择“全局通知>订阅服务器>”你的团队>交付设置。

    显示团队交付设置的屏幕截图。

  1. 从以下设置中进行选择：

  • 传递到电子邮件地址： 通知将传递到特定电子邮件地址。

  • 传递到单个成员： 通知将传递到组或团队的每个成员。 此设置通常是默认选项。 有关默认选项的详细信息，请参阅 团队扩展。

  • 不传递： 默认情况下不会传递通知。

    显示“团队交付设置”对话框的屏幕截图。

如果未显式选择团队或组的传递设置，则会从 组织级别的传递设置中确定。 默认值为 “传递到单个成员 ”或 “不交付”。

提示

传递设置对话框不指示是否已显式设置当前所选内容，或者是否继承了当前选定内容。

自定义团队和组订阅收件人

自定义团队或组订阅的收件人由订阅确定。 但是，对于某些送达选项，团队的默认传递设置用于确定收件人集。

email-team-delivery-options

以下传递选项可用于组或团队订阅：

  • 按角色划分的团队成员： 收件人是具有所选角色之一的团队或组的成员（例如，工作项被分配者）
  • 团队首选项： 收件人由团队或组的传递设置确定（不送达、 首选电子邮件地址或 团队成员）
  • 自定义电子邮件地址： 收件人是指定的电子邮件地址
  • 团队成员： 收件人是团队或组的所有成员，但已选择退出订阅的成员除外。
  • SOAP：与API 管理类似，收件人通过将电子邮件地址（订阅）添加到 SOAP 服务来指定。

注意

遵守每个成员的默认传递设置，包括属于团队或组成员的组。

按角色组成的团队成员

电子邮件收件人列表由事件中具有角色的成员确定。 例如，分配工作项的用户具有分配给（新）的角色，而分配工作项的标识具有分配给（上一个）的角色。 每个事件类型的角色的完整列表显示在受支持的事件类型中。

显示电子邮件团队传递选项角色的屏幕截图。

对于大多数事件类型，“跳过发起程序”选项控制是否应从收件人集中显式排除启动事件的用户或组。 一般情况下，此选项应为“打开”，因为大多数用户不想收到有关他们所做的操作的通知。

团队首选项

传递选项取自团队的交付设置，可以是以下选项之一：

  • 传递到电子邮件地址： 电子邮件将传递到团队的首选电子邮件地址。
  • 传递到单个成员： 请参阅以下选项： team_的成员。
  • 不送达： 未送达任何电子邮件。

显示电子邮件团队传递选项首选项的屏幕截图。

团队的送达设置值显示在地址标签之后，无法更改。

自定义电子邮件地址

通知将发送到多个自定义电子邮件地址，这些地址由分号分隔。

显示自定义电子邮件团队交付选项的屏幕截图。

团队成员

将展开团队或组成员身份以确定电子邮件收件人。 在简单情况下，团队或组扩展到个人列表，每个组都包含在生成的电子邮件的“To：”行中。 但是，此扩展的结果可能很复杂，并在团队和组扩展部分更详细地解释。

显示电子邮件传递团队名称的屏幕截图。

默认订阅收件人

默认订阅的传递选项通常是一个或多个角色。 你不能更改这些值。 角色和 Skip 发起程序 选项因事件类型而异。 有关详细信息和可用于每个事件类型的角色列表，请参阅 支持的事件类型。

显示默认订阅收件人的屏幕截图。

注意

Skip 发起程序选项不适用于所有事件类型。

电子邮件收件人的团队和组扩展

当团队或组收到通知，并且订阅或传递首选项针对所有成员时，团队必须“展开”以确定电子邮件收件人的实际集。 这是一个可能递归的过程，首先查看团队的直接成员。

只有未选择退出订阅的成员才会被视为最终收件人列表。 作为单个用户的任何成员都会添加到收件人列表中。

仅保留 Azure DevOps Services 组。 对于每个组，将检查组的传递首选项：

  • “不交付”：不会对此组执行进一步评估，并评估下一个成员组
  • “传递到电子邮件地址”：电子邮件地址将添加到最终收件人列表中
  • “传递到单个成员”：组已展开（如其父组），并遵循评估其成员的相同规则

方案

让我们看看几个方案。 我们使用以下符号来表示成员的类型：

  • I：单个用户
  • T：嵌套团队或组
  • A：已启用邮件的 Microsoft Entra 组。
场景 示例
具有“不传递首选项”的成员 团队有成员 I1， I2而且 T1。 T1“传递首选项” 不是送达。 会发生什么情况：仅I1I2通过其首选电子邮件地址收到通知。 不会通知其 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未展开（因为它的传递首选项是“不传递”），并且仅I1I2通过其首选电子邮件地址获得通知。
属于 Microsoft Entra 组的成员 团队有成员 I1， I2而且 A1。 会发生什么情况：仅I1I2通过其首选电子邮件地址收到通知。 A1不会收到通知的成员，因为 Azure DevOps 在传送通知时不会扩展 AD 组。