共用方式為


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 檔以 管理安全策略

透過 OAuth 存取第三方應用程式

您需要將下列權限授與連線器設定期間使用認證的使用者帳戶:

許可權名稱 許可權類型 的必要專案
檢視專案層級資訊 項目許可權 編目 Azure DevOps 工作專案。 此許可權是需要編製索引之專案的 必要 許可權。
檢視分析 項目許可權 編目 Azure DevOps 工作專案。 此許可權是需要編製索引之專案的 必要 許可權。
檢視此節點中的工作專案 區域路徑 在區域路徑中編目工作專案。 此許可權是 選擇性的。 只有那些區域路徑會編目用戶帳戶具有許可權的區域路徑。

重要事項

用戶帳戶必須具有 基本 存取層級。 若要深入瞭解 Azure DevOps 中的存取層級,請閱讀 支援的存取層級

步驟 1:在 Microsoft 365 系統管理中心新增連接器

新增 Azure DevOps 連接器

(如需詳細資訊,請參閱一般 設定指示)

步驟 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 系統管理中心流覽至 [結果類型],以管理結果類型。 默認結果類型會命名為 「ConnectionIdDefault」。 例如,如果您的聯機標識符為 AzureDevOps,則結果配置會命名為:“AzureDevOpsDefault”
  • 此外,您可以視需要選擇建立自己的結果類型。

疑難排解

發佈連線之後,您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除,請參閱 管理您的連接器。 您可以 在這裡找到常見問題的疑難解答步驟。

如果您有任何其他問題或想要提供意見反應,請寫 aka.ms/TalkToGraphConnectors 給我們。