Graph 連接器Microsoft Azure DevOps 工作專案
Azure DevOps Graph 連接器可讓您的組織在其 Azure DevOps 服務實例中為工作項目編製索引。 從 Azure DevOps 設定連接器和索引內容之後,用戶可以在 [Microsoft 搜尋] 中搜尋這些專案。
注意事項
請閱讀 Microsoft Graph 連接器 的安裝程式一文,以瞭解一般連接器設定指示。
本文適用於設定、執行及監視 Azure DevOps 連接器的任何人。 它會補充一般設定程式,並顯示僅適用於此連接器的指示。
重要事項
Azure DevOps 連接器僅支援 Azure DevOps 雲端服務。 此連接器不支援 Azure DevOps Server 2019、TFS 2018、TFS 2017、TFS 2015 和 TFS 2013。
開始之前
您必須是組織 M365 租用戶的系統管理員,以及組織 Azure DevOps 實例的系統管理員。
若要允許連接器連線到您的 Azure DevOps 組織,您必須透過 OAuth 啟用第三方應用程式存取。 若要深入瞭解,請參閱 Azure DevOps 檔以 管理安全策略 。
您需要將下列權限授與連線器設定期間使用認證的使用者帳戶:
許可權名稱 | 許可權類型 | 的必要專案 |
---|---|---|
檢視專案層級資訊 | 項目許可權 | 編目 Azure DevOps 工作專案。 此許可權是需要編製索引之專案的 必要 許可權。 |
檢視分析 | 項目許可權 | 編目 Azure DevOps 工作專案。 此許可權是需要編製索引之專案的 必要 許可權。 |
檢視此節點中的工作專案 | 區域路徑 | 在區域路徑中編目工作專案。 此許可權是 選擇性的。 只有那些區域路徑會編目用戶帳戶具有許可權的區域路徑。 |
重要事項
用戶帳戶必須具有 基本 存取層級。 若要深入瞭解 Azure DevOps 中的存取層級,請閱讀 支援的存取層級。
步驟 1:在 Microsoft 365 系統管理中心新增連接器
(如需詳細資訊,請參閱一般 設定指示)
步驟 2:命名連線
請遵循一般 設定指示。
步驟 3:設定連線設定
若要連線到您的 Azure DevOps 實例,您需要 Azure DevOps 組織 名稱、其應用程式識別碼,以及 OAuth 驗證的客戶端密碼。
註冊應用程式
在 Azure DevOps 中註冊應用程式,讓Microsoft搜尋應用程式可以存取實例。 若要深入瞭解,請參閱 Azure DevOps 檔,以瞭解如何 註冊應用程式。
下表提供如何填寫應用程式註冊窗體的指引:
必要欄位 | 描述 | 建議值 |
---|---|---|
公司名稱 | 您的公司名稱。 | 使用適當的值 |
應用程式名稱 | 識別您正在授權之應用程式的唯一值。 | Microsoft 搜尋 |
應用程式網站 | 在連接器設定期間要求存取 Azure DevOps 實例的應用程式 URL。 (必要) 。 | 針對 M365 Enterprise:https:// gcs.office。com/, For M365 Government: https:// gcsgcc.office.com/ |
授權回呼 URL | 授權伺服器重新導向的必要回呼 URL。 | 針對 M365 Enterprise:https:// gcs.office。com/v1.0/admin/oauth/callback, 適用於 M365 Government:https:// gcsgcc.office。com/v1.0/admin/oauth/callback |
授權的範圍 | 應用程式的存取範圍 | 選取下列範圍:身分識別 (讀取) 、工作專案 (讀取) 、變數群組 (讀取) 、專案和小組 (讀取) 、Graph (讀取) 、分析 (讀取) |
重要事項
您為應用程式選取的授權範圍應該與上面所列的範圍完全相符。 如果您省略清單中的其中一個授權範圍,或新增另一個範圍,授權將會失敗。
使用上述詳細數據註冊應用程式時,您會取得將用來設定連接器的 應用程式識別 碼和 客戶端密碼 。
注意事項
若要撤銷在 Azure DevOps 中註冊之任何應用程式的存取權,請移至 Azure DevOps 實例右上方的 [用戶設定]。 選取 [配置檔],然後在側邊窗格的 [安全性] 區段中選取 [授權]。 將滑鼠停留在授權的 OAuth 應用程式上,以查看應用程式詳細數據角落的 [撤銷] 按鈕。
線上設定
向 Azure DevOps 註冊 Microsoft 搜尋應用程式之後,您可以完成連線設定步驟。 輸入您的組織名稱、應用程式識別碼和客戶端密碼。
設定數據:選取專案和欄位
您可以選擇連線來為整個組織或特定項目編製索引。
如果您選擇為整個組織編製索引,組織中所有專案中的專案都會編製索引。 新專案和專案將會在建立之後的下一個編目期間編製索引。
如果您選擇個別專案,則只會編製這些專案中的工作專案索引。
注意事項
在授與 Azure DevOps 專案 檢視專案層級資訊 和 檢視分析 許可權之後,即可進行編目。
接下來,選取您想要連線到這些欄位中索引和預覽數據的欄位,再繼續進行。
步驟 4:管理搜尋許可權
Azure DevOps 連接器支援 只有具有此數據源存取權的人員 或所有人才能看見搜尋權 限。 如果您選擇 [只有具有此數據源存取權的人員],則根據 Azure DevOps 中組織、專案或區域路徑層級的使用者或群組的許可權,索引數據會出現在使用者的搜尋結果中。 如果您選擇 [ 所有人],已編製索引的數據會出現在所有使用者的搜尋結果中。
步驟 5:指派屬性標籤
請遵循一般 設定指示。
步驟 6:管理架構
請遵循一般 設定指示。
步驟 7:選擇重新整理設定
Azure DevOps 連接器支援完整和增量編目的重新整理排程。 累加編目的建議排程為一小時,而完整編目則為一天。
步驟 8:檢閱連線
請遵循一般 設定指示。
提示
默認結果類型
- Azure DevOps 連接器會在連接器發佈后自動註冊 結果類型 。 結果類型會根據步驟 3 中選取的欄位,使用動態產生 的結果配置 。
- 您可以在 Microsoft 365 系統管理中心流覽至 [結果類型],以管理結果類型。 默認結果類型會命名為 「
ConnectionId
Default」。 例如,如果您的聯機標識符為AzureDevOps
,則結果配置會命名為:“AzureDevOpsDefault” - 此外,您可以視需要選擇建立自己的結果類型。
疑難排解
發佈連線之後,您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除,請參閱 管理您的連接器。 您可以 在這裡找到常見問題的疑難解答步驟。
如果您有任何其他問題或想要提供意見反應,請寫 aka.ms/TalkToGraphConnectors 給我們。