使用 OData 查詢建立 Power BI 報表
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
使用 Power BI Desktop,您可以輕鬆地開始在 Azure DevOps 中建立項目的報表。
如果您沒有 Power BI Desktop,您可以 免費下載 並安裝。
請遵循步驟,在Power BI Desktop 中建立報表,以顯示 每日Bug的趨勢。
- 建立 Power BI 查詢
- 建立 Power BI 轉換
- 建立開放式 Bug 趨勢報告
必要條件
若要建立 Power BI 報表,您必須符合下列準則:
- 您必須是項目的成員。 如果您還沒有專案,請建立一個專案。 請參閱 免費註冊。
- 如果您尚未新增為項目成員, 請立即新增 。 具有專案存取權的任何人都可以檢視分析檢視,但項目關係人除外。
- 將 [檢視分析] 權限設定為 [允許]。 請參閱 授與存取分析的許可權。
- 必須啟用面板 。 若要重新啟用它,請參閱 開啟或關閉 Azure DevOps 服務。
- 已安裝Power BI Desktop 2018年10月更新或更新版本。 您可以從官方 Power BI Desktop 下載頁面下載此用戶端應用程式。
- 已追蹤工作專案一段時間,以產生趨勢報告。
- 您必須是項目的成員。 如果您還沒有專案, 請建立一個專案。
- 如果您尚未新增為項目成員, 請立即新增 。 具有專案存取權的任何人都可以檢視分析檢視,但項目關係人除外。
- 已啟用 或安裝 Analytics。 您必須是帳戶擁有者或專案集合管理員群組的成員,才能新增延伸模組或啟用服務。
- 必須啟用面板 。 若要重新啟用它,請參閱 開啟或關閉 Azure DevOps 服務。
- 將 [檢視分析] 權限設定為 [允許]。 請參閱 授與存取分析的許可權。
- 已安裝Power BI Desktop 2018年10月更新或更新版本。 您可以從官方 Power BI Desktop 下載頁面下載此用戶端應用程式。
- 已追蹤工作專案一段時間,以產生趨勢報告。
建立 Power BI 查詢
建立 Power BI 查詢以將數據提取至 Power BI,如下所示:
選擇 [ 取得數據],然後選擇 [ 空白查詢]。
從 Power BI 查詢編輯器中,選擇 [進階編輯器]。
[進階編輯器] 視窗隨即開啟。
將內容取代為下列查詢。
let Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/WorkItemSnapshot? " $apply=filter( WorkItemType eq 'Bug' AND StateCategory ne 'Completed' AND startswith(Area/AreaPath,'{areapath}') AND DateValue ge {startdate} )/ groupby((DateValue,State,WorkItemType,Area/AreaPath), aggregate($count as Count)) &$orderby=DateValue" ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) in Source
在範例查詢中取代您的值。
範例查詢具有字串,您必須以您的值取代:
{organization}
- 您的組織名稱{project}
- 您的小組項目名稱。 或完全省略/{project}
跨項目查詢{areapath}
- 您的區域路徑。 格式:Project\Level1\Level2{startdate}
- 開始趨勢報告的日期。 格式:YYYY-MM-DDZ。 範例:2022-09-01Z
代表 2022 年 9 月 1 日。 不要以引號括住。
選擇 [完成] 以執行查詢。
如果您從未連線到您的帳戶,Power BI 可能會要求您進行驗證。 如需詳細資訊,請參閱 客戶端驗證選項。
展開 [區域]、[反復專案]、[AssignedTo] 數據行
此查詢會傳回數個您需要展開的數據行,才能在Power BI中使用這些數據行。 使用語句提取的任何實體,會傳回具有可能數個 $expand
欄位的記錄。 您必須展開記錄,以將實體扁平化為其欄位。 這類實體的範例包括: AssignedTo
、 Iteration
和 Area
。
關閉 進階編輯器 後,並在 Power Query 編輯器 中保留時,選取您需要扁平化之實體上的展開按鈕。
例如,選擇 [區域] 的展開按鈕、選取您要展開的屬性,然後選擇 [確定]。 在這裡,我們選擇
AreaName
和AreaPath
扁平化。 屬性類似於 [AreaName
節點名稱] 欄位。數據表現在包含實體欄位(s)。
針對代表需要擴充之實體的所有字段重複步驟 1 到 3。 這些出現在 未展開的數據表數據行中所列的 Record 。
重新命名字段和查詢,然後關閉和套用
完成後,您可以選擇重新命名數據行。
以滑鼠右鍵按鍵按鍵列標頭,然後選取 [ 重新命名...
您也可以將查詢從預設 Query1 重新命名為更有意義的專案。
完成後,選擇 [關閉及套用 ] 以儲存查詢並返回 Power BI。
建立報表
Power BI 會顯示您可以回報的欄位。
注意
下列範例假設沒有人重新命名任何數據行。
針對簡單的報表,請執行下列步驟:
- 選取 [Power BI 視覺效果 折線圖]。
- 將欄位 “DateValue” 新增至 Axis
- 以滑鼠右鍵按兩下 [DateValue],然後選取 [DateValue],而不是 [日期階層]
- 將欄位 「State」 新增至 Legend
- 將欄位 “Count” 新增至 [值]
- 以滑鼠右鍵按兩下 [WorkItemId] 字段,並確定已選取 [加總]
範例報表: