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

  • 發行項

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

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

對於使用 Microsoft Entra 識別元管理其使用者和群組的組織，人員選擇器支援搜尋新增至 Microsoft Entra 識別碼的所有使用者和群組，而不只是新增至您專案的使用者和群組。 若要將設定限制為項目成員和群組，請參閱 管理您的組織、限制身分識別搜尋和選取。

注意

您可以透過 API 張貼 @mention 。 取得 Azure DevOps 用戶識別碼

如果您的組織使用現有的 HTML edtitor，請新增下列 html 程式代碼： <div><a href="#" data-vss-mention="version:2.0,{user id}">@John Doe</a> Testing mentioning</div>

如果您的組織使用新的 Markdown edtitor 進行批注，您可以使用下列程式代碼： @<UserID>

@mention控件可讓您快速將使用者新增至工作專案或提取要求討論區。 您可以使用@mention控件的人員選擇器，從搜尋清單中選取項目成員，並收到一封電子郵件，通知他們您的批注。

對於使用 Active Directory 管理其使用者的組織，人員選擇器可支援搜尋新增至 Active Directory 的所有使用者，而不只是新增至專案的使用者。

使用 @mention 控件，在下列區域中啟動或繼續討論：

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

注意

針對內部部署 Azure DevOps Server，請為小組成員設定 SMTP 伺服器，以查看其組織或使用者配置檔功能表中的 [通知] 選項，以及接收通知。

身分識別搜尋選取專案

當您在提取要求中留下程式代碼批注時，請輸入 @ 以觸發 @mention 人員選擇器。 從人員選擇器中，您會看到您最近提及的使用者清單。 若要進行目錄搜尋，請選擇名稱或輸入您要尋找的用戶名稱。

警告

如果您有邀請使用者加入組織的許可權，不論 [限制邀請] 原則是否已停用，您都可以@mention不屬於您組織的使用者。 此動作會邀請該使用者加入您的組織。 如需詳細資訊，請參閱 限制來自專案和小組系統管理員的新用戶邀請。

若要篩選清單，請輸入使用者名稱或別名，直到找到相符項目為止。

人員選擇器螢幕快照

您也可以使用群組提及。 輸入小組或安全組的名稱，選擇 [搜尋]，然後從列出的選項中選取 。

若要 @mention 您先前從未選取過的使用者，請繼續輸入整個名稱，對完整目錄執行搜尋。

提及的用戶名稱會以藍色文字顯示。 選擇@mention連結名稱，以開啟使用者的連絡資訊。 連絡資訊提供更多內容，說明他們新增至交談的原因。

討論區段的螢幕快照，其中已提及。

注意

請勿從先前的批註複製/貼上 @mention 使用者。 雖然產生的格式設定看起來與正確輸入的提及相同，但它不會註冊為 true 提及，也不會傳送電子郵件通知。

完成選取專案和文字輸入后，您的 @mention 使用者會收到一封電子郵件，提醒他們提及。

Outlook 中傳送電子郵件的螢幕快照。

在 提取要求討論、認可批注、變更集批注和擱置集批注中使用@mention 控件。

搜尋選取範圍中的有限身分識別

一般而言，人員選擇器會搜尋並選取新增至組織 Microsoft Entra 識別碼的任何使用者或群組。

對於使用 Microsoft Entra 識別元管理其使用者和群組的組織，人員選擇器支援搜尋新增至 Microsoft Entra 識別碼的使用者和群組。 對於想要將搜尋和選取範圍限制為僅限新增至特定專案之使用者和群組的組織，他們可以藉由啟用 將用戶可見性和共同作業限制為其組織的特定專案 預覽功能來執行此動作。

重要

  • 本節所述的有限可見度功能僅適用於透過入口網站進行互動。 使用 REST API 或 azure devops CLI 命令，項目成員可以存取受限制的數據。
  • 在 Microsoft Entra ID 中具有預設存取權之有限群組中的來賓使用者，無法搜尋具有人員選擇器的使用者。 當組織的預覽功能關閉，或來賓使用者不是有限群組的成員時，來賓使用者可以如預期般搜尋所有 Microsoft Entra 使用者。

針對組織啟用 [將使用者可見度和共同作業限制為特定專案預覽功能] 時，您可以從人員選擇器選取的身分識別清單受限於下列其中一種方式：

  • 新增至 專案範圍使用者 群組的使用者只能從身分識別清單中選取，其中包含明確新增至他們所連線之專案的使用者和群組。
  • 如果所有專案成員都會新增至 專案範圍使用者 群組，則人員選擇器僅限於新增至專案的那些使用者和群組。 所有項目成員只能選取符合明確新增至其所連線專案之使用者和群組的身分識別。

警告

當組織啟用 [將用戶可見度和共同作業限制為特定專案預覽功能] 時，專案範圍用戶無法透過 Microsoft Entra 群組成員資格搜尋已新增至組織的使用者，而不是透過明確的用戶邀請。 這是非預期的行為，且正在處理解決方案。 若要自行解決此問題，請停用將 用戶可見性和共同作業限製為組織的特定專案 預覽功能。