共用方式為


使用 Power BI 資料連接器連接分析

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

瞭解如何使用 Power BI 資料連接器在 Power BI 與 Azure DevOps 之間建立順暢連線。 此整合可讓您從 Azure DevOps 資料擷取有價值的深入解析,並使用 Analytics 檢視在 Power BI 中建立引人注目的報表和儀錶板。

重要

分析檢視僅支援 Azure Boards 資料(工作專案)。 分析檢視不支援其他數據類型,例如管線。 檢視提供扁平的工作項目清單,且不支援工作項目階層。 此時,沒有計劃更新連接器以支援其他類型的數據。 如需其他方法的相關信息,請參閱 關於PowerBI整合

Power BI 資料連接器提供 Azure DevOps Analytics 的直接連線,可讓您執行下列工作:

  • 將 Analytics 檢視匯入 Power BI Desktop
  • 使用即時 Azure DevOps 資料建立自訂報表
  • 為利害關係人建立互動式儀表板
  • 追蹤專案指標和團隊績效
  • 視覺化工作專案趨勢和短期衝刺進度

必要條件

在將 Power BI 連線到 Azure DevOps Analytics 之前,請確定您符合下列需求:

類別 要求
存取層級 - 項目成員
- 至少 Basic 存取層級
許可 - 分析權限
- 參與者群組 成員資格提供必要的權限
工具 - 已啟用 Azure Boards
- Power BI Desktop (建議使用最新版本)
預備 - 瞭解 Analytics 概念
- 根據您的報表需求建立的 Analytics 資料檢視
- 熟悉 Power BI 基本概念
類別 要求
存取層級 - 項目成員
- 至少 Basic 存取層級
許可 - 分析權限
- 參與者群組 成員資格提供必要的權限
工具 - 已安裝並啟用 Analytics
- 已啟用 Azure Boards
- Power BI Desktop (建議使用最新版本)
預備 - 瞭解 Analytics 概念
- 根據您的報表需求建立的 Analytics 資料檢視
- 熟悉 Power BI 基本概念

重要

Azure DevOps 不支援替代認證驗證。 如果您仍在使用替代認證,強烈建議您切換到更安全的驗證方法。

建立新報告並連接 Azure DevOps

請依照以下步驟建立新的 Power BI 報告,並建立與 Azure DevOps Analytics 資料的連結:

  1. 打開 Power BI Desktop 並建立一份新報告:

    • 在你的電腦上啟動 Power BI 桌面
    • 如果出現啟動畫面,請選擇 「取得資料」
    • 如果你已經在 Power BI Desktop 中,請在功能區中選擇「首頁」>取得資料

    Power BI Desktop 的截圖,啟動畫面和主功能區中標示了「取得資料」選項。

  2. 尋找 Azure DevOps 連接器

    • 「取得資料 」對話框中,選擇 線上服務
    • 找找你的 Azure DevOps 實例
    • 選擇正確的連接器,然後選擇 連接

    如果你在 Online Services 類別中看不到 Azure DevOps 連接器:

    • 請確保你安裝的是最新版本的 Power BI Desktop。
    • 在「取得資料」對話框頂端的搜尋框中搜尋「Azure DevOps」
    • 請查看 其他 分類,如果它不在線上服務中

    Power BI 取得資料對話對話的截圖,選取 Online Services 並標示 Azure DevOps(僅限 Boards)連接器。

線上到分析檢視

請遵循下列步驟來連線到分析檢視:

  1. 開啟 Power BI Desktop。

  2. 登入服務。 第一次存取需要您登入並驗證您的認證。 Power BI Desktop 會儲存您的認證,因此您只需要登入一次。

    注意

    Azure DevOps 不支援使用開放式授權 (OAuth) 的跨租使用者案例。 請改用服務主體和受控識別

  3. 選取 Connect

    顯示 [Power BI 連線] 對話框的螢幕快照,其中顯示已登入的訊息,並醒目提示 [連線] 按鈕。

  4. 選取 取得資料>線上服務,然後針對雲端服務選取 Azure DevOps (僅限 Boards) 或針對內部部署伺服器選取 Azure DevOps Server (僅限 Boards)。 選取 Connect。 分析檢視僅支持針對工作項目和測試案例的查詢。

    Power BI 的螢幕快照,其中已醒目提示 [取得數據]、[在線服務] 和 [Azure DevOps 服務]。

  5. 指定要連線到數據的基本參數。

    Azure DevOps (僅限 Boards) 對話框的螢幕快照。[組織和小組] 專案欄位會反白顯示。

    Azure DevOps Server(僅限 Boards)對話框螢幕截圖,[集合 URL]、[小組專案]欄位及[確定]按鈕已被突出顯示。

    • 集合 URL:輸入裝載 Azure DevOps Server 實例的 URL。 範例 URL 是 https://fabrikam-server/AzureDevOpsServer/fabrikam-collection
    • Team 專案:只輸入項目名稱。 例如,如果 Azure DevOps Server 實例的 URL 是 ,請輸入 https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber

    重要

    請勿混淆小組名稱與項目名稱,這是常見的錯誤。 例如,如果您使用的 URL 是 https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/DeviceFabrikam-Fiber-Git 就是項目名稱,而 Device 是小組名稱。

    成功登入之後,Power BI 會確認您的認證具有存取指定專案所需的許可權。 如需常見問題的解決方案,請參閱 疑難排解

選取 [分析] 檢視

請遵循下列步驟來選取 [分析] 檢視:

  1. 展開 共享檢視。 數據連接器會顯示可用的 分析檢視清單。 每個檢視都代表一組您可以提取至 Power BI 的數據。 您也可以 建立自定義分析檢視

    下圖顯示預設的 Analytics 檢視。 您的檢視清單可能會根據用來建立專案的程式模型而有所不同。 列出的所有檢視,除了附加於 今日的檢視之外,都會提供歷史趨勢數據。

    [導覽器] 對話框的螢幕快照。[共用檢視] 資料夾被反白顯示並展開,顯示出數個預設檢視。

  2. 選取 [工作專案 - 過去 30 天 ] 檢視,並等候預覽載入。 此檢視會使用篩選來顯示專案中所有工作項目的過去 30 天歷程記錄。

    注意

    如果您在建立檢視時檢查它,檢視應該會載入。 如果檢視未載入,很可能是因為數據集太大。 返回入口網站中的 [分析檢視 ] 頁面,然後開啟要編輯的檢視。 調整篩選以減少數據集的大小。

    [導覽器] 對話框的螢幕快照。已選取並醒目提示 [工作專案 - 過去 30 天] 檢視,並顯示其預覽。

    注意

    • 根據選取的欄位數目和數據集大小,可以截斷導覽器中任何選取檢視的預覽。 數據只會針對預覽遭到截斷,而且不會影響完整的數據重新整理。
    • 分析檢視 不會套用伺服器上使用Power BI定義的篩選。 Power BI 中套用的任何篩選都會限制向使用者顯示的數據,但不會減少從 Analytics 擷取的數據量。 如果篩選的目的是要減少數據集的大小,請自定義檢視來套用它
  3. 選取 [故事 - 過去 30 天 ] 檢視旁的複選框,然後選取 [ 載入]。 等候數據載入。 透過數據表名稱下顯示的狀態消息來監視其進度。 如需常見問題的解決方案,請參閱 疑難排解

    [故事 - 過去 30 天] 檢視的 [載入] 視窗螢幕快照。部分進度環和評估訊息可見。

  4. 檢閱數據模型。 當模型載入時,請檢閱 Power BI資料連接器的數據集設計。

建立報表和儀表板

成功載入 Analytics 資料後,您可以建立各種報表和視覺效果:

開始建立報表

  1. 探索您的數據: 審查導入的字段並了解數據結構
  2. 規劃您的可視化: 識別您想要追蹤的關鍵指標和 KPI
  3. 創建初始報告: 從簡單的圖表開始,逐漸增加複雜性
  4. 測試和迭代: 與利益相關者一起驗證您的報告並根據需要進行改進

常見報表類型

  • 工作專案趨勢:追蹤錯誤報告、使用者劇本和功能進度隨時間變化
  • 短期衝刺燒毀圖表:監視短期衝刺進度和小組速度
  • 團隊績效指標: 分析吞吐量、週期時間和完成率
  • 待辦事項分析:視覺化工作分佈和優先順序對齊

如需詳細範例和範本,請參閱 以 Analytics 檢視為基礎的範例報表

Power BI Desktop 的螢幕擷取畫面,顯示具有各種圖表和計量的分析型報表。

最佳做法

若要充分利用 Power BI 和分析整合:

效能優化

  • 篩選 Analytics 資料檢視,只包含必要的資料
  • 使用適當的日期範圍來限制資料量
  • 定期重新整理資料,但避免過度重新整理頻率
  • 考慮符合您報告需求的資料重新整理排程

報表設計

  • 從簡單開始,逐漸增加複雜性
  • 在報表中使用一致的格式和品牌
  • 包含指標的內容和說明
  • 使用不同的使用者角色進行測試以確保可用性

數據控管

  • 記錄您的 Analytics 檢視及其用途
  • 建立資料重新整理原則和擁有權
  • 監控報表使用情況和效能
  • 維護安全性和存取控制

故障排除

常見錯誤案例

Azure DevOps 連接器無法顯示

問題:在 Power BI Desktop 的資料來源列表中找不到「Azure DevOps」

多個原因與解決方案

  1. 過時的 Power BI 桌面版本

  2. 找錯分類

    • 先檢查 線上服務 類別
    • 如果找不到,請使用搜尋框搜尋「Azure DevOps」
    • 試著查看其他類別作為備選
  3. 區域供應情況:

    • 確保你的 Power BI 區域支援 Azure DevOps 連接器
    • 如果透過組織授權使用 Power BI,請聯絡你的管理員
  4. Power BI 授權

    • 確認你有適當的 Power BI 授權
    • 接頭可能會因授權等級而有限制

查詢結果超過大小上限

錯誤訊息:「查詢結果超過大小上限。 透過套用更多過濾器來減少記錄數量。」

原因:您的 Analytics 檢視傳回超過 250,000 筆記錄。

解決方案:

  1. 縮小 Analytics 檢視中的時間範圍
  2. 套用更多篩選器來限制工作項目類型或狀態
  3. 使用多個較小的視圖,而不是一個大型視圖
  4. 考慮在更高層級彙總資料

螢幕擷取畫面顯示查詢大小限制錯誤,以及建議的解決步驟。

拒絕存取或驗證錯誤

錯誤訊息:「使用者未獲授權」或驗證失敗

可能的原因及解決方案:

  • 檢查專案許可權:確認您有權存取 Azure DevOps 專案
  • 驗證分析權限: 確保您擁有 分析訪問權限
  • 檢閱憑證:與您的管理員合作解決憑證問題
  • Microsoft Entra 驗證:確認您的帳戶已正確設定

螢幕擷取畫面顯示驗證錯誤,並提供疑難排解指引。

禁止 Analytics 存取

錯誤訊息:「禁止存取資源」

解決方案:請聯絡您的專案管理員,以授與 「檢視分析 」權限。 如需詳細資訊,請參閱 Analytics 安全性

顯示 Analytics 禁止存取錯誤的螢幕擷取畫面。

找不到專案

錯誤訊息:「專案'X'不存在,或您沒有存取它的權限」

常見原因:

  • 專案名稱不正確:確保您使用的是專案名稱,而不是團隊名稱
  • URL 混淆:對於 ,請 https://dev.azure.com/fabrikam/MyProject/MyTeam使用 “MyProject” 而不是 “MyTeam”
  • 缺少權限:確認您有權存取指定的專案

屏幕截圖顯示未找到項目錯誤,並解釋項目與團隊名稱。

讀取錯誤訊息

當您針對 Power BI 資料連接器問題進行疑難排解時,請執行下列工作:

  1. 尋找根本原因:在錯誤訊息中搜尋 [DataSource.Error]
  2. 忽略包裝文字:專注於核心錯誤描述
  3. 檢查建議的動作:錯誤訊息通常包含解決步驟
  4. 驗證先決條件:確保滿足所有要求