在 @mentions 工作專案和提取要求中使用

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

@mention控件可讓您快速將使用者或群組新增至工作專案或提取要求討論區。 您可以使用@mention控件內的人員選擇器,從搜尋清單中選取項目成員或群組。 提及的使用者或群組會收到有關您批注的電子郵件通知。

對於使用 Microsoft Entra 識別碼來管理其使用者和群組的組織,人員選擇器支援搜尋Microsoft Entra 識別碼內的所有使用者和群組。 您可以在新增至專案的使用者和群組之外搜尋使用者和群組。 如需詳細資訊,請參閱 限制身分識別搜尋和選取

注意

您可以透過 API 張貼 @mention 。 若要取得 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 控件,在下列區域中啟動或繼續討論:

  • 工作項目討論或任何 RTF 文字欄位
  • 提取要求討論
  • 認可批注
  • 變更集或擱置集批注
  • 工作項目討論
  • 提取要求討論
  • 認可批注
  • 變更集或擱置集批注

注意

針對內部部署 Azure DevOps Server,請為小組成員設定 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 群組成員資格搜尋新增至組織的使用者,而不是透過明確的用戶邀請。 這是非預期的行為,且解決方案正在進行中。 若要解決此問題,請停用將 用戶可見性和共同作業限製為組織的特定專案 預覽功能。