使用 OData 查詢建立 Power BI 報表

發行項
01/10/2024

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 Desktop2018年10月更新或更新版本。您可以從官方 Power BI Desktop 下載頁面下載此用戶端應用程式。
已追蹤工作專案一段時間，以產生趨勢報告。

您必須是項目的成員。如果您還沒有專案，請建立一個專案。
如果您尚未新增為項目成員，請立即新增。具有專案存取權的任何人都可以檢視分析檢視，但項目關係人除外。
已啟用或安裝 Analytics。您必須是帳戶擁有者或 Project Collection 管理員 istrators 群組的成員，才能新增延伸模組或啟用服務。
必須啟用面板 。若要重新啟用它，請參閱開啟或關閉 Azure DevOps 服務。
將 [檢視分析] 權限設定為 [允許]。請參閱授與存取分析的許可權。
已安裝Power BI Desktop2018年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

Screenshot of Power BI, Advanced Editor, Pasted Query.

在範例查詢中取代您的值。

範例查詢具有字串，您必須以您的值取代：
- {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 。