子作業項目の値を親サンプルレポートにロールアップする

[アーティクル]
11/21/2024

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

ロールアップでは、作業項目の数またはストーリーポイント、残存作業時間、またはその他の子項目のユーザー設定フィールドの合計を表示するサポートが提供されます。この記事では、子作業項目を含むエピック、フィーチャー、またはユーザーストーリーの表形式ロールアップレポートを生成する方法の例をいくつか示します。次の図は、親フィーチャー用にロールアップされたストーリーポイントの例を示しています。

機能ロールアップマトリックスレポートのスクリーンショット。

ロールアップとロールアップを表示するオプションの詳細については、「 Azure Boards でのロールアップの進行状況または合計を表示する」を参照してください。

Note

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

前提条件

Access:少なくとも Basic アクセス権を持つプロジェクトのメンバーである必要があります。
Permissions: 既定では、プロジェクトメンバーには 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 'Feature'"
            &" and State ne 'Cut'"
            &" and startswith(Area/AreaPath,'{areapath}')"
            &" and Descendants/any()"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'User Story')"
                &"/aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)"
            &")", 
        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 'Feature'
        and State ne 'Cut'
        and startswith(Area/AreaPath,'{areapath}')
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'User Story')
        /aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)
        )

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

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

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

クエリの内訳

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

クエリパーツ

説明

$filter=WorkItemType eq 'Feature'

戻り値の特徴。

and State ne 'Cut'

終了したバグを省略します。

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

特定のエリアパスの下にある作業項目を返 Area/AreaPath eq '{areapath}' 置き換えると、特定のエリアパスにあるアイテムが返されます。チーム名でフィルター処理するには、filter ステートメント Teams/any(x:x/TeamName eq '{teamname})'を使用します。

and Descendants/any()

ユーザーストーリーのない機能であっても、すべての機能を含めます。子ユーザーストーリーがないフィーチャーを省略するには、"any(d:d/WorkItemType eq 'User Story')" に置き換えます。

&$select=WorkItemId, Title, WorkItemType, State

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

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

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

Descendants(

Descendants句を展開します。

$apply=filter(WorkItemType eq 'User Story')

子孫をフィルター処理して、ユーザーストーリーのみを含めます (タスクとバグは省略されます)。

/aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)

フィルター句に一致するすべての子孫について、それらをカウントし、 StoryPoints プロパティを合計します。

)

Descendants()を終了します。

Teams に基づく子ユーザーストーリーの機能をポイントするロールアップストーリー

次のクエリは、エリアパスではなくチーム名でフィルター処理するロールアップレポートを生成する方法を示しています。

Power BI クエリ
OData クエリ

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
            &"$filter=WorkItemType eq 'Feature'"
            &" and State ne 'Cut'"
            &" and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname})"
            &" and Descendants/any()"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'User Story')"
                &"/aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)"
            &")", 
        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 'Feature'
        and State ne 'Cut'
        and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname})
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'User Story')
        /aggregate($count as CountOfUserStories, StoryPoints with sum as TotalStoryPoints)
        )

ストーリーポイントをエピックに重ね合わせる

次のクエリを使用して、ストーリーポイントをエピックにロールアップできます。

Power BI
OData

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
            &"$filter=WorkItemType eq 'Epic'"
            &" and State ne 'Cut'"
            &" and startswith(Area/AreaPath,'{areapath}')"
            &" and Descendants/any(d:d/WorkItemType eq 'User Story')"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'User Story')"
                &"/aggregate(StoryPoints with sum as TotalStoryPoints)"
            &")", 
        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 'Epic'
        and State ne 'Cut'
        and startswith(Area/AreaPath,'{areapath}')
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'User Story')
        /aggregate(StoryPoints with sum as TotalStoryPoints)
        )

作業の残りと完了した作業をユーザーストーリーにロールアップする

次のクエリは、階層のユーザーストーリーに子タスクに割り当てられた作業と Completed Work をロールアップする方法を示しています。これらのクエリでは、指定した Area Path 内のユーザーストーリーの子としてタスクが割り当てられていることを前提としています。

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 State ne 'Removed'"
            &" and startswith(Area/AreaPath,'{areapath}')"
            &" and Descendants/any()"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'Task')"
                &"/aggregate(RemainingWork with sum as TotalRemainingWork, CompletedWork with sum as TotalCompletedWork)"
            &")", 
        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 State ne 'Removed'
        and startswith(Area/AreaPath,'{areapath}')
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'Task')
        /aggregate(RemainingWork with sum as TotalRemainingWork, CompletedWork with sum as TotalCompletedWork)
        )

機能のロールアップのバグ数

次のクエリは、フィーチャーに割り当てられたバグの数をロールアップする方法を示しています。これらのクエリでは、指定した Area Path のフィーチャーの子としてバグが定義されていることを前提としています。

Power BI
OData

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
            &"$filter=WorkItemType eq 'Feature'"
            &" and State ne 'Removed'"
            &" and startswith(Area/AreaPath,'{areapath}')"
            &" and Descendants/any()"    
        &"& $select=WorkItemId,Title,WorkItemType,State,AreaSK"
        &"& $expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),"        
            &"Descendants("
                &"$apply=filter(WorkItemType eq 'Bug')"
                &"/aggregate($count as CountOfBugs)"
            &")", 
        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 'Feature'
        and State ne 'Removed'
        and startswith(Area/AreaPath,'{areapath}')
        and Descendants/any()
    &$select=WorkItemId,Title,WorkItemType,State,AreaSK
    &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath),
        Descendants(
        $apply=filter(WorkItemType eq 'Bug')
        /aggregate($count as CountOfBugs)
        )

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

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

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

Power BI で列を展開する

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

AssignedTo
AreaPath
IterationPath

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

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

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

ロールアップフィールドの null 値を置き換える

作業項目に子がない場合、ロールアップ値は null になる可能性があります。たとえば、フィーチャーに子ユーザーストーリーがない場合、 Descendants.CountOfUserStories は "null" になります。

レポートを簡単にするために、次の手順に従って、すべての null を 0 に置き換えます。

列ヘッダーをクリックして列を選択します。
Transform メニューを選択します。
[値 置き換えを選択します。 [値の配置] ダイアログが表示されます。
Value to Find に「null」と入力します。
Replace Withに「0」と入力します。
OK を選択します。

すべてのロールアップ列に対して繰り返します。

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

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

テーブルレポートを作成する

Power BI で、Visualizations で Table レポートを選択します。
次のフィールドを Columns 指定された順序で追加します。
- WorkItemIをクリック [集計しない を選択して、必要に応じて ID を表示します
- WorkItemType
- Title
- State
- Count of User Stories
- Total Story Points.

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

サンプル機能ロールアップマトリックスレポートのスクリーンショット。

次の方法で共有

子作業項目の値を親サンプルレポートにロールアップする

前提条件

サンプルクエリ

エリアパスに基づく子ユーザーストーリーの機能をポイントするロールアップストーリー

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

クエリの内訳

Teams に基づく子ユーザーストーリーの機能をポイントするロールアップストーリー

ストーリーポイントをエピックに重ね合わせる

作業の残りと完了した作業をユーザーストーリーにロールアップする

機能のロールアップのバグ数

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

Power BI で列を展開する

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

ロールアップフィールドの null 値を置き換える

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

テーブルレポートを作成する

フィードバック

その他のリソース

次の方法で共有

子作業項目の値を親サンプル レポートにロールアップする

前提条件

サンプル クエリ

エリア パスに基づく子ユーザー ストーリーの機能をポイントするロールアップ ストーリー

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

クエリの内訳

Teams に基づく子ユーザー ストーリーの機能をポイントするロールアップ ストーリー

ストーリーポイントをエピックに重ね合わせる

作業の残りと完了した作業をユーザー ストーリーにロールアップする

機能のロールアップ のバグ数

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

Power BI で列を展開する

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

ロールアップ フィールドの null 値を置き換える

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

テーブル レポートを作成する

関連記事

フィードバック

その他のリソース

子作業項目の値を親サンプルレポートにロールアップする

サンプルクエリ

エリアパスに基づく子ユーザーストーリーの機能をポイントするロールアップストーリー

Teams に基づく子ユーザーストーリーの機能をポイントするロールアップストーリー

作業の残りと完了した作業をユーザーストーリーにロールアップする

機能のロールアップのバグ数

ロールアップフィールドの null 値を置き換える

テーブルレポートを作成する