判斷通知電子郵件的收件者
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
當事件符合訂用帳戶時,許多因素會決定電子郵件通知的收件者。 如果您不知道,這些因素可能會導致收件匣收到太多或太少的電子郵件。 瞭解訂用帳戶的類型、其傳遞設定、傳遞喜好設定,以及其他因素如何決定收件者集。
注意
本文中解決的許多概念都適用於舊版的 Azure DevOps,不過使用者介面可能已變更。
自訂用帳戶
使用自定義個人訂用帳戶時,電子郵件會傳遞至 擁有訂用帳戶的使用者慣用電子郵件位址 ,或傳送至訂用帳戶上設定的電子郵件位址。
注意
針對內部部署 Azure DevOps Server,請為小組成員設定 SMTP 伺服器,以查看其組織或使用者配置檔功能表中的 [通知] 選項,以及接收通知。
個人訂用帳戶上慣用的電子郵件地址(預設)
個人訂用帳戶上的自訂電子郵件位址
小組和群組的傳遞設定
當小組或群組是通知的收件者時,傳遞設定會控制預設傳遞行為。 訂用帳戶已設定傳遞選項,可查看收件者的傳遞設定。
您可以在小組層級或組織層級管理訂用帳戶和傳遞設定。
組織層級設定
在 [組織設定] 中,選取 [全域通知>訂閱者>您的小組>傳遞設定]。
- 從下列設定中選取:
傳遞至電子郵件位址: 通知會傳遞至特定電子郵件位址。
傳遞至個別成員: 通知會傳遞至群組或小組的每個成員。 此設定通常是預設選項。 如需預設選項的詳細資訊,請參閱 Team 擴充。
不傳遞: 預設不會傳遞通知。
如果您未明確選擇小組或群組的 傳遞設定,則會從組織層級傳遞設定中判斷。 默認值為 [傳遞至個別成員 ] 或 [不要傳遞]。
提示
[傳遞設定] 對話框不會指出目前選取專案是否已明確設定,或是否已繼承。
自定義小組和群組訂用帳戶收件者
自訂小組或群組訂用帳戶的收件者會由訂用帳戶決定。 但是,使用特定傳遞選項,小組的預設傳遞設定可用來判斷收件者集。
下列傳遞選項適用於群組或小組訂用帳戶:
- 依角色分組的小組成員: 收件者是具有其中一個所選角色的小組或群組成員(例如工作專案被指派者)
- 小組喜好設定: 收件者取決於小組或群組的傳遞設定(不要傳遞、 慣用的電子郵件位址或 小組成員)
- 自訂電子郵件位址: 收件者是指定的電子郵件位址
- 小組成員: 收件者是小組或群組的所有成員,但已退出退出訂用帳戶的成員除外。
- SOAP:類似於 API 管理,收件者會藉由將電子郵件地址(訂閱)新增至SOAP服務來指定。
注意
系統會接受每個成員的預設傳遞設定,包括屬於小組或群組成員的群組。
依角色的小組成員
電子郵件收件者清單是由事件中具有角色的成員所決定。 例如,指派工作項目的使用者具有指派給的角色(新),而獲指派工作專案的身分識別具有指派給 (上一個) 角色。 每個事件類型的角色完整清單會顯示在支援的事件類型中。
針對大多數事件類型出現的 Skip 啟動器選項,可控制啟動事件的使用者或群組是否應該從收件者集合中明確排除。 一般而言,此選項應該是「開啟」,因為大部分使用者都不想收到有關其所執行之動作的通知。
小組喜好設定
傳遞選項取自小組的傳遞設定,可以是下列其中一個選項:
- 傳遞至電子郵件地址: 電子郵件會傳遞至小組慣用的電子郵件位址。
- 傳遞至個別成員: 請參閱下列選項: team_的成員。
- 不傳遞: 未傳送電子郵件。
小組的傳遞設定值會顯示在 [位址 ] 卷標之後,且無法變更。
自訂電子郵件位址
通知會傳送至多個自定義電子郵件位址,並以分號分隔。
小組成員
小組或群組成員資格會展開,以判斷電子郵件收件者。 在簡單案例中,小組或群組會展開至個人清單,且每個群組都包含在 結果電子郵件的 [收件者: ] 行中。 不過,此擴充的結果可能會很複雜,而且會在小組和群組擴充一節中更詳細地說明。
默認訂閱收件者
默認訂用帳戶的傳遞選項通常是一或多個角色。 您無法變更這些值。 角色和 Skip 啟動器 選項會根據事件類型而有所不同。 如需詳細資訊和每個事件類型可用的角色清單,請參閱 支援的事件類型。
注意
Skip 啟動器選項不適用於所有事件類型。
電子郵件收件者的小組和群組擴充
當小組或群組收到通知,而且訂用帳戶或傳遞喜好設定適用於所有成員時,小組必須「展開」,才能判斷實際的一組電子郵件收件者。 這是一個可能遞歸的程式,從查看小組的直接成員開始。
只有未退出退出訂用帳戶的成員才會被視為最終收件者清單。 任何屬於個別用戶的成員都會新增至收件者清單。
只有 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 未展開 (因為它的傳遞喜好設定是「不要傳遞」),而只會I2 I1 透過其慣用的電子郵件位址收到通知。 |
屬於 Microsoft Entra 群組的成員 | 小組有成員 I1 、 I2 和 A1 。 發生什麼事:僅 I1 透過 I2 慣用的電子郵件位址收到通知。 A1 的成員不會收到通知,因為 Azure DevOps 不會在傳遞通知時擴充 AD 群組。 |