搭配 Microsoft Teams 使用 Azure Repos
Azure DevOps Services
如果您使用
在本文中，瞭解如何執行下列工作：
- 在 Microsoft Teams 中將 Azure Repos 應用程式新增至您的小組
- 將 Azure Repos 應用程式連線到您的存放庫
- 管理您在頻道中對於儲存庫相關事件的訂閱
- 使用擴充功能搜尋和分享PR資訊
- 預覽 PR URL
- 從通道移除訂用帳戶和存放庫
先決條件
- 管理您的訂閱，讓您能在每當程式碼被推送或簽入，或者提取要求（PR）建立、更新或合併時，在您的頻道中收到通知。 若要建立存放庫相關事件的訂用帳戶，請成為 專案管理員 群組或小組管理員的成員。 若要新增，請參閱 變更專案層級許可權 或 新增小組系統管理員。
- 若要接收通知，請透過 Azure DevOps 組織的 OAuth 設定，啟用
第三方應用程式存取權。 請參閱 變更組織的應用程式存取原則。
注意
- 目前直接訊息中不支援通知功能。
- 您只能將適用於 Microsoft Teams 的 Azure Repos 應用程式連結到 Azure DevOps Services 上裝載的專案。
將 Azure Repos 應用程式新增至 Microsoft Teams 中的小組
請前往 Microsoft Teams 中的 Azure Repos 應用程式，Microsoft Teams > Azure Repos。
選取 新增，或者如果您已經下載應用程式，請選取 開啟旁的下拉功能表，然後選取 新增至小組。
輸入小組或頻道名稱，然後選取 [設定 Bot。
將 Azure Repos 應用程式連線到您的存放庫
在小組中安裝應用程式之後，請在回復欄位中輸入下列文字：
@azure repos signin如果您的 Microsoft Teams 和 Azure Boards 位于不同的租戶中，請選擇 [使用不同電子郵件登入。
若要監視專案中的所有 Git 存放庫，請在通道中輸入
@azure repos subscribe [project url]。 請務必新增專案 URL。 專案 URL 可以是您專案內的任何頁面（除了指向儲存庫的 URL 之外）。您也可以使用：
@azure repos subscribe [repo url]監視特定存放庫。儲存庫 URL 可以指向儲存庫中包含儲存庫名稱的任何頁面，例如，
@azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepo或對於 TFVC 儲存庫：@azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl。subscribe命令可讓您開始使用預設訂用帳戶。 針對 Git 存放庫，信道會訂閱「拉取請求已建立」事件（目標分支 = main）。 針對 TFVC 存放庫，通道會訂閱 事件中的Code 簽入。 
管理訂用帳戶
若要檢視、新增和移除頻道的訂閱，請輸入下列文字：@azure repos subscriptions。
您會看到通道的所有目前訂用帳戶清單，而且您可以新增訂用帳戶或移除現有的訂用帳戶。 使用各種篩選條件來自訂通知，如下一節所述。
注意
小組管理員無法移除或修改 Project 系統管理員所建立的訂用帳戶。
使用篩選只取得您想要的通知
當您使用 @azure repos subscribe訂閱存放庫時，會建立預設的訂用帳戶，且未套用任何篩選。
使用者通常需要自定義這些訂用帳戶，只有在符合特定條件時才會收到通知。
下列螢幕擷取畫面顯示只在我們的團隊位於 PR 的審查者名單中時才設定通知的範例。
在頻道中輸入下列文字：
@azure repos subscriptions。在訂用帳戶清單中，如果有您不想要或必須修改的訂用帳戶，請選取 [移除 將其刪除。
選取 [新增訂用帳戶] 按鈕。
選擇事件類型，然後選擇 下一步。
選擇存放庫，然後選擇 下一步。
選取適當的篩選條件來自訂您的訂閱，然後選取 [提交]。
注意
- 所有篩選通常為下拉式清單。 不過，如果下拉式清單有100個項目以上，您必須手動輸入值。
- 針對在 事件中籤入的 TFVC
程式代碼，在路徑 下 的篩選必須是 格式 。
使用撰寫延伸模組搜尋和共用提取要求資訊
為了協助用戶搜尋並共用提取要求的相關信息，適用於 Microsoft Teams 的 Azure Repos 應用程式支援撰寫延伸模組。 您可以依識別碼或名稱搜尋提取要求。 若要讓延伸模組能夠運作，請輸入 @azure repos signin 或直接登入 compose 擴充套件，以登入 Azure Repos 專案。
預覽拉取請求 URL
當您貼上 PR 的 URL 時，會顯示出如以下圖片中的預覽，有助於保持 PR 相關討論的上下文和準確性。 請登入，然後您可以預覽 Team 中所有頻道中 URL 的 PR。
從通道移除訂用帳戶和存放庫
若要刪除與專案中任何存放庫相關的所有訂用帳戶，並從頻道移除存放庫，請在 Teams 中輸入下列文字：@azure repos unsubscribe all [project url]。 請務必輸入專案 URL。 只有專案管理員可以執行這項工作。
線程通知
若要連結一組相關的通知，以及減少通道中通知所佔用的空間，通知會進行線程處理。 連結至特定提取要求的所有通知都會連結在一起。
線程通知的精簡檢視
線程通知的展開檢視
命令參考
下表列出您可以在Teams頻道中使用的所有 azure repos 命令。
| 命令 | 功能性 |
|---|---|
@azure repos subscribe [repo url/ project url] |
訂閱專案中的存放庫或所有存放庫，以接收通知 |
@azure repos subscriptions |
新增或移除此通道的訂用帳戶 |
@azure repos signin |
登入您的 Azure Repos 組織 |
@azure repos signout |
從您的 Azure Repos 組織登出 |
@azure repos feedback |
回報問題或建議功能 |
@azure repos unsubscribe all [project url] |
從頻道移除所有屬於專案的儲存庫及相關的訂閱 |
多租用戶支援
如果您在 Microsoft Teams 和 Azure DevOps 使用不同的電子郵件或租用戶，請根據您的具體使用情況按以下步驟登入。
| 用例 | 電子郵件帳號 + Microsoft Teams 租戶 | 電子郵件地址 + Azure DevOps 租戶 | 步驟 |
|---|---|---|---|
| 1 | email1@abc.com（租戶1） | email1@abc.com（租戶 1） | 選取 [登入]。 |
| 2 | email1@abc.com（租戶 1） | email1@abc.com（租戶2） | 登入 Azure DevOps。 在相同的瀏覽器中，打開新的索引標籤，然後移至 https://teams.microsoft.com/。 執行 sign-in 命令，然後選擇 登入。 |
| 3 | email1@abc.com （租使用者 1） | email2@pqr.com（租戶 2） | 選取 [使用不同的電子郵件位址登入]，然後在電子郵件標識碼選擇器中使用 email2 登入 Azure DevOps。 |
| 4 | email1@abc.com （租戶 1） | email2@pqr.com （非預設租戶 3） | 不支援此情境。 |
疑難排解
如果您在使用 Azure Repos 應用程式時遇到下列錯誤，請遵循本節中的程式。
很抱歉，發生錯誤。 請再試一次。
Azure Repos 應用程式會使用 OAuth 驗證通訊協定，而且需要透過 OAuth 第三方應用程式存取，才能啟用組織。 若要啟用此設定，請流覽至 [組織設定]>[安全性>原則]，然後透過 OAuth 為組織設定 第三方應用程式存取， 設定 為 [開啟]。
，透過 OAuth 啟用第三方應用程式存取權
設定失敗。 請確定組織 『{organization name}』 存在，而且您有足夠的許可權。
使用瀏覽器瀏覽至 https://aka.ms/VsSignout，以註銷 Azure DevOps。
開啟 在私人 或 無痕模式 瀏覽器視窗，瀏覽至 https://aex.dev.azure.com/me 並登入。 在左側個人資料圖示下方的下拉清單中，選擇包含您要訂閱的存放庫的組織所屬的目錄。
在 相同的瀏覽器中，啟動新分頁並登入 https://teams.microsoft.com/。 執行 @Azure Repos signout 命令，然後在安裝適用於 Microsoft Teams 的 Azure Repos 應用程式通道中執行 @Azure Repos signin 命令。
選取 [Sign in] 按鈕，系統會將您重新導向至同意頁面，如下列範例中的同意頁面。 請確定電子郵件旁顯示的目錄與上一個步驟中所選擇的目錄相同。 接受並完成登入過程。
如果這些步驟無法解決您的驗證問題，請在 Developer Community與我們連絡。