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 でバグの毎日の傾向を示すレポートを作成する手順に従います。

Power BI クエリを作成する
Power BI 変換を作成する
Open Bugs 傾向レポートを作成する

前提条件

Power BI レポートを作成するには、次の条件を満たす必要があります。

プロジェクトのメンバーである必要があります。まだプロジェクトがない場合は、プロジェクトを作成します。「無料でサインアップする」を参照してください。
プロジェクトメンバーとして追加されていない場合は、今すぐ追加します。プロジェクトへのアクセス権を持つすべてのユーザー (利害関係者を除く) は、Analytics ビューを表示できます。
[分析の表示] アクセス許可を [許可] に設定します。「Analytics にアクセスするためのアクセス許可を付与する」を参照してください。
ボード を有効にする必要があります。再度有効にするには、「 Azure DevOps サービスを有効または無効にする」を参照してください。
Power BI DesktopOctober 2018 Update 以降のバージョンがインストールされています。このクライアントアプリケーションは、公式のPower BI Desktopダウンロードページからダウンロードできます。
傾向レポートを生成する作業項目を一定期間追跡しました。

プロジェクトのメンバーである必要があります。まだプロジェクトがない場合は、プロジェクトを作成します。
プロジェクトメンバーとして追加されていない場合は、今すぐ追加します。プロジェクトへのアクセス権を持つすべてのユーザー (利害関係者を除く) は、Analytics ビューを表示できます。
Analytics を有効またはインストール済みであること。拡張機能を追加したり、サービスを有効にしたりするには、アカウント所有者または Project Collection Administrators グループのメンバーである必要があります。
ボード を有効にする必要があります。再度有効にするには、「 Azure DevOps サービスを有効または無効にする」を参照してください。
[分析の表示] アクセス許可を [許可] に設定します。「Analytics にアクセスするためのアクセス許可を付与する」を参照してください。
Power BI DesktopOctober 2018 Update 以降のバージョンがインストールされています。このクライアントアプリケーションは、公式の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 取り込まれたエンティティは、潜在的に複数のフィールドを含むレコードを返します。エンティティをフィールドにフラット化するには、レコードを展開する必要があります。このようなエンティティの例は、次のとおりです。 AssignedToIterationArea

詳細エディターを閉じた後、Power Query エディターでメインし直しながら、フラット化する必要があるエンティティの展開ボタンを選択します。

たとえば、[領域] の展開ボタンを選択し、展開するプロパティを選択して、[OK] を選択します。ここでは、フラット化を選択 AreaName します AreaPath 。このプロパティはAreaName、[ノード名] フィールドに似ています。

Note

選択できるプロパティは、クエリで返すように要求されたプロパティによって異なります。プロパティを指定しない場合は、すべてのプロパティを使用できます。これらのプロパティの詳細については、次のメタデータ参照を参照してください。
テーブルにエンティティフィールドが含まれるようになりました。
展開が必要なエンティティを表すすべてのフィールドについて、手順 1 から 3 を繰り返します。これらは、展開されていないときにテーブル列に表示されるレコードと共に表示されます。