OData クエリを使用したサンプルレポートの概要

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

この記事では、最も一般的なレポートのサンプルを提供します。

Azure Boards

Azure Test Plans

パイプライン

パイプラインとテスト

すべてのサンプルレポート記事には、次のセクションと情報が記載されています。

サンプルクエリ - 他のサンプルクエリと共に Power BI にデータをプルするために使用される Power BI クエリと生の OData クエリ。
Power BI でデータを変換 する - データをレポート可能な形式に変換する手順
レポートの作成 - データから簡単なレポートを作成する手順。

前提条件

Access:少なくとも Basic アクセス権を持つプロジェクトのメンバーである必要があります。
Permissions: 既定では、プロジェクトメンバーには Analytics にクエリを実行してビューを作成する権限があります。
サービスと機能の有効化と一般的なデータ追跡アクティビティに関するその他の前提条件の詳細については、「 Analytics にアクセスするためのアクセス許可と前提条件を参照してください。

Power BI クエリに OData クエリを埋め込む次の手順をすぐに開始します。クエリは、次のように Power BI の高度なクエリエディターに直接貼り付けることができます。

[データの取得] を選択し、[クエリします。
Power BI クエリエディターで、詳細エディターを選択します。
詳細エディターウィンドウが開きます。
内容を、この記事で前述したリンクされた記事で提供されているサンプルクエリのいずれかに置き換えます。
サンプルクエリには、{organization} や {project} などの値に置き換える必要がある文字列があります。
- {organization} - 組織名
- {project} - チームプロジェクト名。または、プロジェクト間クエリの場合は、"/{project}" を完全に省略します。
サンプルクエリによっては、次のような 1 つ以上の他の文字列が置き換えられる場合があります。
- {areapath} - エリアパス。形式: Project\Level1\Level2
- {iterationpath} - イテレーションパス。形式: Project\Level1\Level2
- {startdate} - 傾向レポートを開始する日付。形式: YYYY-MM-DDZ。例: 2019-04-01Z は 2019 年 4 月 1 日を表します。引用符で囲む必要はありません。
クエリを実行するには、 Done を選択します。

アカウントに接続したことがない場合は、Power BI で認証が必要になる場合があります。詳細については、「 Client 認証オプションを参照してください。

ほとんどのサンプルレポートでは、Power BI で使用する前に OData クエリを個別に変更してテストする場合に備えて、OData クエリが提供されます。この方法は柔軟性を高めますが、「Power BI クエリと OData クエリを使用した Connect」の説明に従って、Power BI で OData クエリを使用する前に他の手順が必要になります。

Analytics に対して OData クエリを記述する方法の詳細については、「 OData クエリクイックリファレンス」を参照してください。