在 @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,{userID}">@John Doe</a> Testing mentioning</div>- 如果您的組織使用新的 Markdown 編輯器進行批注，請使用下列程式代碼：
@<userID>
@mention控件可讓您快速將使用者新增至工作專案或提取要求討論區。 您可以使用@mention控件內的人員選擇器，從搜尋清單中選取項目成員。 提及的使用者會收到有關您的批注的電子郵件通知。
對於使用 Active Directory 管理其使用者的組織，人員選擇器支援搜尋 Active Directory 內的所有使用者，而不只是新增至專案的使用者。
使用 @mention 控件，在下列區域中啟動或繼續討論：
- 工作項目討論或任何豐富格式文字欄位
- 提取要求討論
- 提交註釋
- 變更集或擱置集註解
注意
針對內部部署 Azure DevOps Server，請為小組成員設定 SMTP 伺服器，以查看其組織或使用者配置檔功能表中的 [通知] 選項，以及接收通知。
先決條件
| 類別 | 要求 |
|---|---|
| 專案存取權限 | 項目成員。 |
身份搜尋選擇
- 在提取要求中的程式代碼批註中輸入 @ ，以觸發 @mention 人員選擇器。
- 檢視您最近提及的使用者清單。
- 從清單中選取名稱或輸入您要尋找的用戶名稱，以搜尋目錄。
警告
如果您有邀請使用者加入組織的許可權，不論限制邀請原則是否已停用，您都可以@mention不屬於您組織的使用者。 此動作會邀請該使用者加入您的組織。 如需詳細資訊，請參閱 限制來自專案和小組系統管理員的新用戶邀請。
若要篩選清單，請輸入使用者名稱或別名，直到您找到相符項目為止。
提及的用戶名稱會以藍色文字顯示。 選擇@mention連結名稱以開啟使用者的聯絡資訊，並提供更多背景資訊，以說明他們為何被加入交談。
您也可以使用群組標記。 輸入小組或安全組的名稱，選擇 
[搜尋]，然後從列出的選項中選取 。
注意
請勿從先前的評論複製並貼上 @mention 使用者。 雖然格式設定看起來可能與正確輸入的提及相同，但它不會註冊為真實提及，也不會傳送電子郵件通知。
當您完成專案選取和文字輸入後，您的 @mention 使用者會收到提醒他們被提及的電子郵件。
在 提取要求討論、認可批注、變更集批注和擱置集批注中使用@mention 控件。
提示
由於沒有直接 @CreatedBy 巨集，因此您可以使用 @Me 巨集搭配 [建立者] 字段來篩選您建立的工作專案。 例如，若要以空白描述標記專案的建立者，您可以執行查詢來識別這類專案，然後在每個工作專案的批註區段中手動標記建立者，要求他們更新描述。
搜尋選擇中的受限身份識別
人員選擇器通常會搜尋並選取新增至組織 Microsoft Entra ID 的任何使用者或群組。
對於使用 Microsoft Entra 識別碼來管理使用者和群組的組織，人員選擇器支援搜尋目錄中的所有使用者和群組。 若要將搜尋和選取範圍限制為僅新增至特定專案的那些使用者和群組，請啟用 限制用戶可見性和共同作業至組織的特定專案 預覽功能。
針對組織啟用 [將使用者可見度和共同作業限制為特定專案預覽功能] 時，您可以從人員選擇器選取的身分識別清單受限於下列方式：
- 新增至 專案限定使用者 群組的使用者只能從包含專案明確指定的使用者和群組的識別清單中選擇。
- 如果所有項目成員都新增至 專案範圍使用者 群組，人員選擇器僅限於新增至專案的那些使用者和群組。 所有專案成員只能選擇與已明確新增到其所連接專案的使用者和群組相符的身分。
警告
使用此預覽功能時，請考慮下列限制：
- 本節所述的有限可見度功能僅適用於透過入口網站進行互動。 使用 REST API 或
azure devopsCLI 命令，項目成員可以存取受限制的數據。 - 受限群組中的使用者只能選取明確新增至 Azure DevOps 的使用者，而不能選取可透過 Microsoft Entra 群組成員資格存取的使用者。
- 在具有 Microsoft Entra ID 預設存取權的有限群組中，來賓使用者無法使用人員選擇器搜尋其他使用者。