バグやユーザーストーリーのサンプルレポートを開く

2025-08-26

Azure DevOps Services |Azure DevOps Server 2022 |Azure DevOps Server 2020

開いているバグやユーザーストーリーを一覧表示するレポートを生成するには、Power BI でマトリックスレポートを選択し、この記事に記載されているクエリと同様のクエリを使用します。生成するレポートには、次の図に示すように、 State フィールドと Assigned To フィールド別に分類された未開のバグまたはユーザーストーリーが一覧表示されます。

Open Bugs サンプルマトリックスレポートのスクリーンショット。

Note

この記事では、 OData クエリを使用したサンプルレポートの概要 Power BI の基本的な理解があることを前提としています。

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

サンプルクエリ

バグやユーザーストーリーをエリアパス、イテレーションパス、またはチームでフィルター処理するクエリがいくつか用意されています。これらのクエリはすべて、履歴データではなく現在のエンティティセットを返す WorkItems エンティティセットを指定します。

Note

フィルターまたはレポートの目的で使用できるプロパティを確認するには、「Azure Boardsのメタデータリファレンス」を参照してください。クエリをフィルター処理したり、で使用可能なまたは値のProperty下EntityTypeNavigationPropertyBinding Pathの値のいずれかを使用してプロパティをEntitySet返したりできます。各は EntitySet に EntityType対応します。各値のデータ型の詳細については、対応する EntityTypeに指定されたメタデータを確認してください。

次の Power BI クエリをコピーして、 Get Data>Blank クエリ ウィンドウに直接貼り付けます。詳細については、「 OData クエリを使用したサンプルレポートの概要を参照してください。

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
            &"and StateCategory ne 'Completed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

次の OData クエリコードを使用して、Power BI でクエリを使用する前にクエリを変更またはテストできます。詳細については、「 Power BI クエリと OData クエリを使用した接続」を参照してください。

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Bug'
            and StateCategory ne 'Completed'
            and startswith(Area/AreaPath,'{areapath}')
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

置換文字列とクエリの内訳

次の文字列を実際の値に置き換えます。置換に角かっこを {} 含めないでください。たとえば、組織名が "Fabrikam" の場合は、ではなく {organization}をにFabrikam置き換えます{Fabrikam}。

{organization} - 組織名
{project} - プロジェクト間クエリの場合は、チームプロジェクト名を指定するか、"/{project}" を完全に省略します
{areapath} - エリアパス。形式の例: Project\Level1\Level2

クエリの内訳

次の表では、クエリの各部分について説明します。

クエリパーツ

説明

$filter=WorkItemType eq 'Bug'

バグを返します。

and StateCategory ne 'Completed'

完了した項目をフィルターで除外します。状態カテゴリの詳細については、「ワークフローカテゴリの状態が Azure Boards のバックログとボードで使用される方法を参照してください。

and startswith(Area/AreaPath,'{areapath}')

特定のエリアパスで作業項目をフィルター処理します。チーム名でフィルター処理するには、filter ステートメント Teams/any(x:x/TeamName eq '{teamname})'を使用します。

&$select=WorkItemId, Title, WorkItemType, State, Priority, Severity, TagNames

返すフィールドを選択します。

&$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath)

展開可能なプロパティフィールド AssignedTo、 Iteration、 Areaを選択します。

チームでフィルター処理されたユーザーストーリー

エリアパスではなく、1 つ以上のチームによって開いているバグのクエリを実行できます。

Power BI クエリ
OData クエリ

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
            &"and StateCategory ne 'Completed'' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}')) "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Bug'
            and StateCategory ne 'Completed'
            and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}'))
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

特定のエリアパスと反復パス内のユーザストーリー

次のクエリでは、特定のエリアパスと反復パスに対するユーザーストーリーのフィルター処理がサポートされています。

Power BI クエリ
OData クエリ

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'User Story' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and startswith(Iteration/IterationPath,'{iterationpath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'User Story'
            and startswith(Area/AreaPath,'{areapath}')
            and startswith(Iteration/IterationPath,'{iterationpath}')
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

(省略可能)クエリの名前を変更する

既定のクエリラベル Query1 の名前を、より意味のある名前に変更できます。 [ クエリ設定] ペインから新しい名前を入力するだけです。

Power BI クエリメニューオプションのスクリーンショット。クエリの名前を変更します。

Power Query エディターの列を展開する

&$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath)句は、複数のフィールドを含むレコードを返します。レポートを作成する前に、レコードを展開して特定のフィールドにフラット化する必要があります。この例では、次のレコードを展開します。

AssignedTo
AreaPath
IterationPath

方法については、「 Transform Analytics データを使用して Power BI レポートを生成するを参照してください。

(省略可能)フィールドの名前を変更する

列を展開したら、1 つ以上のフィールドの名前を変更できます。たとえば、列 AreaPath の名前を Area Path に変更できます。方法については、「 Rename 列フィールドを参照してください。

クエリを閉じて変更を適用する

すべてのデータ変換が完了したら、Home メニューから Close & Apply を選択してクエリを保存し、Power BI の Report タブに戻ります。

マトリックスレポートを作成する

Power BI で、Visualizations で Matrix レポートを選択します。
Assigned To にを追加します。
Stateを Columns に追加します。
1WorkItemId1 を Values に追加し、1WorkItemId' を右クリックし、 Count が選択されていることを確認します。

レポートの例が表示されます。

サンプルの Open Bugs マトリックスレポートのスクリーンショット。

次の方法で共有

バグやユーザー ストーリーのサンプル レポートを開く

サンプル クエリ

エリア パスでフィルター処理されたバグ

置換文字列とクエリの内訳

クエリの内訳

チームでフィルター処理されたユーザー ストーリー

特定のエリア パスと反復パス内のユーザ ストーリー