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 資料的連結:
打開 Power BI Desktop 並建立一份新報告:
- 在你的電腦上啟動 Power BI 桌面
- 如果出現啟動畫面,請選擇 「取得資料」
- 如果你已經在 Power BI Desktop 中,請在功能區中選擇「首頁」>取得資料
尋找 Azure DevOps 連接器
- 在 「取得資料 」對話框中,選擇 線上服務
- 找找你的 Azure DevOps 實例
- 選擇正確的連接器,然後選擇 連接
如果你在 Online Services 類別中看不到 Azure DevOps 連接器:
- 請確保你安裝的是最新版本的 Power BI Desktop。
- 在「取得資料」對話框頂端的搜尋框中搜尋「Azure DevOps」
- 請查看 其他 分類,如果它不在線上服務中
線上到分析檢視
請遵循下列步驟來連線到分析檢視:
開啟 Power BI Desktop。
登入服務。 第一次存取需要您登入並驗證您的認證。 Power BI Desktop 會儲存您的認證,因此您只需要登入一次。
注意
Azure DevOps 不支援使用開放式授權 (OAuth) 的跨租使用者案例。 請改用服務主體和受控識別。
選取 Connect。
選取 取得資料>線上服務,然後針對雲端服務選取 Azure DevOps (僅限 Boards) 或針對內部部署伺服器選取 Azure DevOps Server (僅限 Boards)。 選取 Connect。 分析檢視僅支持針對工作項目和測試案例的查詢。
指定要連線到數據的基本參數。
-
集合 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/Device, Fabrikam-Fiber-Git 就是項目名稱,而 Device 是小組名稱。成功登入之後,Power BI 會確認您的認證具有存取指定專案所需的許可權。 如需常見問題的解決方案,請參閱 疑難排解。
-
集合 URL:輸入裝載 Azure DevOps Server 實例的 URL。 範例 URL 是
選取 [分析] 檢視
請遵循下列步驟來選取 [分析] 檢視:
展開 共享檢視。 數據連接器會顯示可用的 分析檢視清單。 每個檢視都代表一組您可以提取至 Power BI 的數據。 您也可以 建立自定義分析檢視。
下圖顯示預設的 Analytics 檢視。 您的檢視清單可能會根據用來建立專案的程式模型而有所不同。 列出的所有檢視,除了附加於 今日的檢視之外,都會提供歷史趨勢數據。
選取 [工作專案 - 過去 30 天 ] 檢視,並等候預覽載入。 此檢視會使用篩選來顯示專案中所有工作項目的過去 30 天歷程記錄。
注意
如果您在建立檢視時檢查它,檢視應該會載入。 如果檢視未載入,很可能是因為數據集太大。 返回入口網站中的 [分析檢視 ] 頁面,然後開啟要編輯的檢視。 調整篩選以減少數據集的大小。
選取 [故事 - 過去 30 天 ] 檢視旁的複選框,然後選取 [ 載入]。 等候數據載入。 透過數據表名稱下顯示的狀態消息來監視其進度。 如需常見問題的解決方案,請參閱 疑難排解。
檢閱數據模型。 當模型載入時,請檢閱 Power BI資料連接器的數據集設計。
建立報表和儀表板
成功載入 Analytics 資料後,您可以建立各種報表和視覺效果:
開始建立報表
- 探索您的數據: 審查導入的字段並了解數據結構
- 規劃您的可視化: 識別您想要追蹤的關鍵指標和 KPI
- 創建初始報告: 從簡單的圖表開始,逐漸增加複雜性
- 測試和迭代: 與利益相關者一起驗證您的報告並根據需要進行改進
常見報表類型
- 工作專案趨勢:追蹤錯誤報告、使用者劇本和功能進度隨時間變化
- 短期衝刺燒毀圖表:監視短期衝刺進度和小組速度
- 團隊績效指標: 分析吞吐量、週期時間和完成率
- 待辦事項分析:視覺化工作分佈和優先順序對齊
如需詳細範例和範本,請參閱 以 Analytics 檢視為基礎的範例報表。
最佳做法
若要充分利用 Power BI 和分析整合:
效能優化
- 篩選 Analytics 資料檢視,只包含必要的資料
- 使用適當的日期範圍來限制資料量
- 定期重新整理資料,但避免過度重新整理頻率
- 考慮符合您報告需求的資料重新整理排程
報表設計
- 從簡單開始,逐漸增加複雜性
- 在報表中使用一致的格式和品牌
- 包含指標的內容和說明
- 使用不同的使用者角色進行測試以確保可用性
數據控管
- 記錄您的 Analytics 檢視及其用途
- 建立資料重新整理原則和擁有權
- 監控報表使用情況和效能
- 維護安全性和存取控制
故障排除
常見錯誤案例
Azure DevOps 連接器無法顯示
問題:在 Power BI Desktop 的資料來源列表中找不到「Azure DevOps」
多個原因與解決方案:
過時的 Power BI 桌面版本:
- 下載並安裝 最新版本的 Power BI 桌面
- Azure DevOps 連接器則在後續版本中加入
找錯分類:
- 先檢查 線上服務 類別
- 如果找不到,請使用搜尋框搜尋「Azure DevOps」
- 試著查看其他類別作為備選
區域供應情況:
- 確保你的 Power BI 區域支援 Azure DevOps 連接器
- 如果透過組織授權使用 Power BI,請聯絡你的管理員
Power BI 授權:
- 確認你有適當的 Power BI 授權
- 接頭可能會因授權等級而有限制
查詢結果超過大小上限
錯誤訊息:「查詢結果超過大小上限。 透過套用更多過濾器來減少記錄數量。」
原因:您的 Analytics 檢視傳回超過 250,000 筆記錄。
解決方案:
- 縮小 Analytics 檢視中的時間範圍
- 套用更多篩選器來限制工作項目類型或狀態
- 使用多個較小的視圖,而不是一個大型視圖
- 考慮在更高層級彙總資料
拒絕存取或驗證錯誤
錯誤訊息:「使用者未獲授權」或驗證失敗
可能的原因及解決方案:
- 檢查專案許可權:確認您有權存取 Azure DevOps 專案
- 驗證分析權限: 確保您擁有 分析訪問權限
- 檢閱憑證:與您的管理員合作解決憑證問題
- Microsoft Entra 驗證:確認您的帳戶已正確設定
禁止 Analytics 存取
錯誤訊息:「禁止存取資源」
解決方案:請聯絡您的專案管理員,以授與 「檢視分析 」權限。 如需詳細資訊,請參閱 Analytics 安全性 。
找不到專案
錯誤訊息:「專案'X'不存在,或您沒有存取它的權限」
常見原因:
- 專案名稱不正確:確保您使用的是專案名稱,而不是團隊名稱
- URL 混淆:對於 ,請
https://dev.azure.com/fabrikam/MyProject/MyTeam使用 “MyProject” 而不是 “MyTeam” - 缺少權限:確認您有權存取指定的專案
讀取錯誤訊息
當您針對 Power BI 資料連接器問題進行疑難排解時,請執行下列工作:
- 尋找根本原因:在錯誤訊息中搜尋 [DataSource.Error]
- 忽略包裝文字:專注於核心錯誤描述
- 檢查建議的動作:錯誤訊息通常包含解決步驟
- 驗證先決條件:確保滿足所有要求