共用方式為

使用 OData 查詢的範例報表概觀

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

您可以使用開放式數據通訊協定 （OData） 查詢來產生 Power BI 報表。 針對 Azure DevOps 中的各種服務，範例查詢可用來產生許多熱門報告。 本文提供範例報表的概觀，並示範如何開始使用它們。

範例報表

下列文章提供產生範例報告的查詢和步驟。

Azure 板

Azure 測試計劃

Azure 管道

Azure Pipelines 測試

所有範例報表文章都提供下列各節和資訊：

  • 範例查詢 - Power BI 查詢和原始 OData 查詢，用來將數據提取至 Power BI 以及其他範例查詢
  • 關於在 Power BI 中轉換資料的區段 - 藉由展開數據行或變更資料行數據類型，將數據轉換成可報表格式的步驟
  • 建立報表 - 從數據建立基本報表的步驟
類別 要求
存取層級 - 專案成員。
- 至少擁有 基本 存取權限。
許可 根據預設，項目成員具有查詢分析及建立檢視的許可權。 如需有關服務與功能啟用和一般數據追蹤活動之其他必要條件的詳細資訊，請參閱 存取分析的許可權和必要條件。

執行 Power BI 查詢

若要開始在Power BI查詢中內嵌 OData 查詢，請執行下列步驟。 您可以將查詢直接貼到 Power BI 中的進階編輯器中。

  1. 在 Power BI 中，選取 [取得數據]，然後選取 [ 空白查詢]。

    Power BI Desktop 中空白報表的螢幕快照。在功能區上，[取得資料] 已展開。[取得資料] 和 [空白查詢] 反白顯示。

  2. 在 Power BI Power Query 編輯器中，選取 [ 進階編輯器]。

    Power BI Power Query 編輯器的螢幕快照。在功能區中，[查詢] 群組中的 [進階編輯器] 會反白顯示。

    [進階編輯器] 視窗隨即開啟。

    Power BI 中 [進階編輯器] 視窗的螢幕快照。疏鬆填入的欄位可用於編輯查詢。

  3. 將內容替換為示範查詢。 如需範例查詢，請參閱本文稍早所列的連結文章。

    Power BI 中 [進階編輯器] 視窗的螢幕快照。查詢欄位包含 Bug 的查詢。查詢語法包含佔位元。

  4. 以您的值取代查詢中的任何佔位元字串：

    • {organization} - 您的組織名稱。
    • {project} - 您的小組項目名稱。 對於跨越多個項目的查詢，請完全省略 /{project} 。

    某些範例查詢包含您也需要取代的其他佔位元，例如下列字串：

    • {areapath} - 您的區域路徑，格式如下： Project\Level1\Level2。
    • {iterationpath} - 您的反覆項目路徑，格式如下： Project\Level1\Level2。
    • {startdate} - 開始趨勢報表的日期，格式如下： YYYY-MM-DDZ。 例如， 2025-04-01Z 代表 2025 年 4 月 1 日。 請勿以引號括住日期。

    [進階編輯器] 視窗的螢幕快照。組織、專案、區域路徑和開始日期會使用實際值，並反白顯示。

  5. 若要執行查詢，請選取 [完成]。

    當您第一次連線到您的帳戶時，Power BI 會要求您進行驗證。 如需詳細資訊，請參閱 在Power BI或Excel中輸入客戶端認證。

執行原始 OData 查詢

除了 Power BI 查詢，大部分的範例報表也會提供 OData 查詢。 您可以在 Power BI 中使用 OData 查詢之前，先個別修改及測試 OData 查詢。 這個方法提供更多彈性，但它牽涉到額外的步驟。 如需詳細資訊，請參閱 使用 Power BI 和 OData 查詢連線至數據。

如需如何針對分析數據撰寫 OData 查詢的詳細資訊，請參閱 範例報表和快速參考索引。

相關內容

  • Last updated on