Azure DevOps Services |Azure DevOps Server 2022 |Azure DevOps Server 2020
Open Data Protocol (OData) クエリを使用して、Power BI レポートを生成できます。 Azure DevOps のさまざまなサービスでは、サンプル クエリを使用して多数の一般的なレポートを生成できます。 この記事では、サンプルレポートの概要を提供し、それをどのように始めるかを示します。
サンプル レポート
次の記事では、サンプル レポートを生成するためのクエリと手順について説明します。
Azureボード
Azure テスト計画
- 未解決のバグ
- バグの傾向
- ロールアップ
- 機能の進行状況
- 作業項目と直接リンク
- リリース バーンダウン
- スプリント バーンダウン
- 累積フロー図 (CFD)
- リード タイムとサイクル タイム
Azure パイプライン
Azure Pipelines テスト
すべてのサンプル レポート記事には、次のセクションと情報が記載されています。
- サンプル クエリ - Power BI クエリと、他のサンプル クエリと共に Power BI にデータをプルするために使用される生の OData クエリ
- Power BI でのデータ変換に関するセクション - 列を展開するか列のデータ型を変更して、データをレポート可能な形式に変換する手順
- レポートの作成 - データから基本的なレポートを作成する手順
| カテゴリ | 要求事項 |
|---|---|
| アクセス レベル |
-
プロジェクト メンバー。 - 少なくともベーシックアクセス。 |
| アクセス許可 | 既定では、プロジェクト メンバーには Analytics にクエリを実行してビューを作成する権限があります。 サービスと機能の有効化と一般的なデータ追跡アクティビティに関するその他の前提条件の詳細については、「 Analytics にアクセスするためのアクセス許可と前提条件を参照してください。 |
Power BI クエリを実行する
Power BI クエリへの OData クエリの埋め込みを開始するには、次の手順を実行します。 Power BI の詳細エディターにクエリを直接貼り付けることができます。
Power BI で、[ データの取得] を選択し、[ 空のクエリ] を選択します。
![Power BI Desktop の空のレポートのスクリーンショット。リボンの [データの取得] が展開されます。[データの取得] と [空のクエリ] が強調表示されています。](media/blank-query.png?view=azure-devops)
Power BI Power Query エディターで、[ 詳細エディター] を選択します。
![Power BI Power Query エディターのスクリーンショット。リボンの [クエリ] グループで、[詳細エディター] が強調表示されています。](media/advanced-editor.png?view=azure-devops)
詳細エディター ウィンドウが開きます。
![Power BI の [詳細エディター] ウィンドウのスクリーンショット。スパースに設定されたフィールドは、クエリの編集に使用できます。](media/odata-power-bi-advanced-editor.png?view=azure-devops)
内容をサンプル クエリに置き換えます。 サンプル クエリについては、この記事で前述したリンク記事を参照してください。
![Power BI の [詳細エディター] ウィンドウのスクリーンショット。クエリ フィールドには、バグのクエリが含まれています。クエリ構文にはプレースホルダーが含まれています。](media/odata-power-bi-advanced-editor-pasted.png?view=azure-devops)
クエリ内のすべてのプレースホルダー文字列を実際の値に置き換えます。
-
{organization}- 組織名。 -
{project}- チーム プロジェクト名。 複数のプロジェクトにまたがるクエリの場合は、/{project}を完全に省略します。
一部のサンプル クエリには、次の文字列など、置き換える必要がある他のプレースホルダーも含まれています。
-
{areapath}- エリア パスを次の形式で指定してください:Project\Level1\Level2。 -
{iterationpath}- あなたのイテレーション パスの形式:Project\Level1\Level2。 -
{startdate}- 傾向レポートを開始する日付を次の形式で指定します:YYYY-MM-DDZ。 たとえば、2025-04-01Zは 2025 年 4 月 1 日を表します。 日付を引用符で囲まないでください。
![[詳細エディター] ウィンドウのスクリーンショット。組織、プロジェクト、エリア パス、開始日は実際の値を使用し、強調表示されます。](media/odata-power-bi-advanced-editor-replaced.png?view=azure-devops)
-
クエリを実行するには、[ 完了] を選択します。
初めてアカウントに接続する場合、Power BI では認証が必要になります。 詳細については、「 Power BI または Excel でクライアント資格情報を入力する」を参照してください。
![Power BI の [詳細エディター] ウィンドウのスクリーンショット。クエリ フィールドには、バグのクエリが含まれています。クエリ構文にはプレースホルダーが含まれています。](media/odata-power-bi-advanced-editor-pasted.png?view=azure-devops#lightbox)
![[詳細エディター] ウィンドウのスクリーンショット。組織、プロジェクト、エリア パス、開始日は実際の値を使用し、強調表示されます。](media/odata-power-bi-advanced-editor-replaced.png?view=azure-devops#lightbox)
生の OData クエリを実行する
Power BI クエリに加えて、ほとんどのサンプル レポートでは OData クエリも提供されます。 OData クエリは、Power BI で使用する前に個別に変更およびテストできます。 この方法では柔軟性が向上しますが、追加の手順が必要です。 詳細については、「 Power BI クエリと OData クエリを使用してデータを接続する」を参照してください。
Analytics データに対して OData クエリを記述する方法の詳細については、「 サンプル レポートとクイック リファレンス インデックス」を参照してください。