要求跟踪汇总示例报告

项目
10/16/2024

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

“要求跟踪汇总”报表基于要求跟踪报表生成，并演示如何聚合一级汇总的指标。例如，如果要跟踪用户情景的要求，则可以使用本文中提供的查询聚合功能的数据。

下图中显示了一个示例。

Power BI 故事概述汇总报表的屏幕截图。

此报表显示它列出的每个要求的以下信息：

已完成工时百分比：进度栏，显示所有链接到要求的任务的已完成工时的汇总百分比。
通过的测试：基于最新测试运行通过的测试用例数。
失败的测试：基于最新测试运行失败的测试用例数。
运行测试：已执行的测试运行数。
活动 bug：处于活动状态的链接 bug 数。
已关闭的 bug：处于“已关闭”、“完成”或“已完成”状态的链接 bug 数。

注意

仅支持通过 基于要求的测试套件链接的测试用例进行要求跟踪。要求工作项（User Story（Agile）、产品积压工作项（Scrum）、要求（CMMI）、要求（基本）和手动测试执行之间的关联仅在测试用例通过基于要求的测试套件链接时形成。

报告解答的问题

要求跟踪报告可用于回答以下类型的问题。

工作进度

每个要求剩余的工作量是否与预期相对应？
是否首先实施排名靠前的要求？
为每个要求定义了多少个测试？通过多少个测试？
正在实施哪些要求，这些要求没有为其定义测试用例？

质量进度

针对每个要求运行了多少个测试用例，以及已通过了多少个测试用例？
每个要求有多少个活动 bug？
是否发现针对正在测试的要求的 bug？
bug 是否正在解决，或者它们是否处于活动状态？

风险评估

哪些要求面临风险？
哪些要求不足以稳定发布？
我们今天可以交付哪些要求？

重要

Power BI 集成和对分析服务的 OData 源的访问权限通常用于 Azure DevOps Services 和 Azure DevOps Server 2020 及更高版本。本文中提供的示例查询仅适用于 Azure DevOps Server 2020 及更高版本，具体取决于 v3.0-preview 或更高版本。我们鼓励你使用这些查询并提供反馈。

先决条件

Access：至少是具有基本访问权限的项目的成员。
权限： 默认情况下，项目成员有权查询 Analytics 和创建视图。
有关服务和功能启用和常规数据跟踪活动的其他先决条件的详细信息，请参阅访问 Analytics 的权限和先决条件。

注意

本文假设你阅读了使用 OData 查询的示例报表概述，并基本了解 Power BI。

要使报表生成有用的数据，需要执行以下任务：

你已定义要求工作项，并将其分配给感兴趣的区域和迭代路径。有关如何定义区域和迭代路径的信息，请参阅 “定义区域路径 ”和 “定义迭代路径”。
若要获取工时完成百分比，需要填写与子链接类型要求的任务或 bug 的“完成工时”和 “剩余工时”字段。
若要获取测试用例的执行状态，需要在与这些要求相对应的测试计划中创建 基于要求的测试套件 。通过开发板添加的内联测试满足此先决条件，但链接到测试的要求并不满足。有关详细信息，请参阅创建测试计划和测试套件。
若要获取 bug 的状态，你将创建 bug 并将其链接到子链接类型的要求。

示例查询

若要生成报表，必须将三个 Power BI 查询添加到 Power BI Desktop，然后链接它们。每个查询执行 WorkItems 或 TestPoints 实体集。

注意

以下部分中提供的 Power BI 查询片段包括扩展列和更改数据类型所需的数据转换。

查询区域和迭代路径

若要将报表的范围限定为特定的区域和迭代路径，可以使用 AreaSK 和 IterationSK. 有关详细信息，请参阅使用 OData Analytics 定义基本查询。

注意

若要确定用于筛选或报表的可用属性，请参阅Azure Boards元数据参考。可以使用提供的 EntitySet或 NavigationPropertyBinding Path 值下EntityType的任何Property值筛选查询或返回属性。每个对应 EntitySet 一个 EntityType。有关每个值的数据类型的详细信息，请查看为相应 EntityType值提供的元数据。

查询满足要求的小时数百分比

注意

根据 WorkItemType 所使用的过程更改。 Scrum 模板支持功能，基本模板分别支持 Epic 作为汇总工作项类型。

Power BI 查询
OData 查询

将以下 Power BI 查询直接复制并粘贴到 “获取数据>空白查询” 窗口中。有关详细信息，请参阅使用 OData 查询的示例报告概述。

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems? 
$filter=( 
    IterationSK eq {iterationSK}
    and AreaSK eq {areaSK}
    and WorkItemType eq 'Feature'
)
&$expand=Descendants( 
    $apply=filter( CompletedWork ne null or RemainingWork ne null ) 
    /aggregate( 
        iif(CompletedWork ne null, CompletedWork, 0) with sum as SumCompletedWork, 
        iif(RemainingWork ne null, RemainingWork, 0) with sum as SumRemainingWork 
    ) 
    /compute( 
        (SumCompletedWork add SumRemainingWork) as TotalWork, 
        SumCompletedWork as SumCompleted 
    ) 
    /compute( 
        iif(TotalWork gt 0,(SumCompleted div cast(TotalWork, Edm.Double) mul 100), 0) as PercCompletedWork 
    ) 
)
&$select=WorkItemId, Title", null, [Implementation="2.0"]),
    #"Expanded Descendants" = Table.ExpandTableColumn(Source, "Descendants", {"SumCompletedWork", "SumRemainingWork", "TotalWork", "SumCompleted", "PercCompletedWork"}, {"Descendants.SumCompletedWork", "Descendants.SumRemainingWork", "Descendants.TotalWork", "Descendants.SumCompleted", "Descendants.PercCompletedWork"}),
    #"Changed Type" = Table.TransformColumnTypes(#"Expanded Descendants",{{"Descendants.SumCompletedWork", type number}, {"Descendants.SumRemainingWork", type number}, {"Descendants.TotalWork", type number}, {"Descendants.SumCompleted", type number}, {"Descendants.PercCompletedWork", type number}})
in
    #"Changed Type"

在 Power BI 中使用查询之前，可以使用以下 OData 查询代码对其进行修改或测试。有关详细信息，请参阅使用 Power BI 和 OData 查询进行连接。

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems? 
$filter=( 
    IterationSK eq {iterationSK}
    and AreaSK eq {areaSK}
    and WorkItemType eq 'Feature'
)
&$expand=Descendants( 
    $apply=filter( CompletedWork ne null or RemainingWork ne null ) 
    /aggregate( 
        iif(CompletedWork ne null, CompletedWork, 0) with sum as SumCompletedWork, 
        iif(RemainingWork ne null, RemainingWork, 0) with sum as SumRemainingWork 
    ) 
    /compute( 
        (SumCompletedWork add SumRemainingWork) as TotalWork, 
        SumCompletedWork as SumCompleted 
    ) 
    /compute( 
        iif(TotalWork gt 0,(SumCompleted div cast(TotalWork, Edm.Double) mul 100), 0) as PercCompletedWork 
    ) 
)
&$select=WorkItemId, Title

查询要求的测试执行状态

注意

若要确定用于筛选器或报表目的的可用属性，请参阅测试计划分析的元数据参考。可以使用提供的 EntitySet或 NavigationPropertyBinding Path 值下EntityType的任何Property值筛选查询或返回属性。每个对应 EntitySet 一个 EntityType。有关每个值的数据类型的详细信息，请查看为相应 EntityType值提供的元数据。

Power BI 查询
OData 查询

将以下 Power BI 查询直接复制并粘贴到 “获取数据>空白查询” 窗口中。有关详细信息，请参阅使用 OData 查询的示例报告概述。

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/TestPoints? 
	$apply=filter(
	    (TestSuite/RequirementWorkItem/IterationSK eq {iterationSK}
    and TestSuite/RequirementWorkItem/AreaSK eq {areaSK}
    and TestSuite/RequirementWorkItem/Processes/any(p:p/BacklogType eq 'RequirementBacklog')
    and TestSuite/RequirementWorkItem/Processes/all(p:p/IsBugType eq false)
	))
	/compute(iif(TestSuite/RequirementWorkItem/Parent ne null, TestSuite/RequirementWorkItem/Parent/WorkItemId, 0) as ParentWorkItemId, 
	iif(TestSuite/RequirementWorkItem/Parent ne null, TestSuite/RequirementWorkItem/Parent/Title, 'Unparented') as ParentWorkItemTitle
	)/groupby(
	    (ParentWorkItemId, ParentWorkItemTitle), 
	    aggregate(
	        $count as TotalCount, 
	        cast(LastResultOutcome eq 'Passed', Edm.Int32) with sum as PassedCount, 
	        cast(LastResultOutcome eq 'Failed', Edm.Int32) with sum as FailedCount, 
            cast(LastResultOutcome eq 'Blocked', Edm.Int32) with sum as BlockedCount,
            cast(LastResultOutcome eq 'NotApplicable', Edm.Int32) with sum as NotApplicableCount,
	        cast(LastResultOutcome eq 'None', Edm.Int32) with sum as NotRunCount, 
	        cast(LastResultOutcome ne 'None', Edm.Int32) with sum as RunCount)
)", null, [Implementation="2.0"]),
    #"Changed Type" = Table.TransformColumnTypes(#"Source",{{"TotalCount", type number}, {"PassedCount", type number}, {"FailedCount", type number}, {"BlockedCount", type number}, {"NotApplicableCount", type number}, {"NotRunCount", type number}, {"RunCount", type number}})
in
    #"Changed Type"

在 Power BI 中使用查询之前，可以使用以下 OData 查询代码对其进行修改或测试。有关详细信息，请参阅使用 Power BI 和 OData 查询进行连接。

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/TestPoints? 
$apply=filter(
    (TestSuite/RequirementWorkItem/IterationSK eq {iterationSK}
and TestSuite/RequirementWorkItem/AreaSK eq {areaSK}
and TestSuite/RequirementWorkItem/Processes/any(p:p/BacklogType eq 'RequirementBacklog')
and TestSuite/RequirementWorkItem/Processes/all(p:p/IsBugType eq false)
))
/compute(iif(TestSuite/RequirementWorkItem/Parent ne null, TestSuite/RequirementWorkItem/Parent/WorkItemId, 0) as ParentWorkItemId, 
iif(TestSuite/RequirementWorkItem/Parent ne null, TestSuite/RequirementWorkItem/Parent/Title, 'Unparented') as ParentWorkItemTitle
)/groupby(
    (ParentWorkItemId, ParentWorkItemTitle), 
    aggregate(
        $count as TotalCount, 
        cast(LastResultOutcome eq 'Passed', Edm.Int32) with sum as PassedCount, 
        cast(LastResultOutcome eq 'Failed', Edm.Int32) with sum as FailedCount, 
        cast(LastResultOutcome eq 'Blocked', Edm.Int32) with sum as BlockedCount,
        cast(LastResultOutcome eq 'NotApplicable', Edm.Int32) with sum as NotApplicableCount,
        cast(LastResultOutcome eq 'None', Edm.Int32) with sum as NotRunCount, 
        cast(LastResultOutcome ne 'None', Edm.Int32) with sum as RunCount
    )
)

注意

该 TestSuite/RequirementWorkItem/... 条目指示工作项必须通过 基于要求的测试套件链接到测试套件 ，如先决条件中所述。

查询链接到要求的 bug 的状态

注意

根据 WorkItemType 所使用的过程更改。 Scrum 模板支持功能，基本模板分别支持 Epic 作为汇总工作项类型。

Power BI 查询
OData 查询

将以下 Power BI 查询直接复制并粘贴到 “获取数据>空白查询” 窗口中。有关详细信息，请参阅使用 OData 查询的示例报告概述。

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $filter=(
        IterationSK eq {iterationSK}
        and AreaSK eq {areaSK}
        and WorkItemType eq 'Feature'
    )
&$expand=Descendants(
    $apply=filter(
        WorkItemType eq 'Bug'
    )
    /groupby(
        (State),
        aggregate($count as Count)
    )
)
&$select=WorkItemId,Title", null, [Implementation="2.0"]),
    #"Expanded Descendants" = Table.ExpandTableColumn(Source, "Descendants", {"State", "Count"}, {"Descendants.State", "Descendants.Count"}),
    #"Filtered Rows" = Table.SelectRows(#"Expanded Descendants", each [Descendants.Count] <> null and [Descendants.Count] <> ""),
    #"Pivoted Column" = Table.Pivot(#"Filtered Rows", List.Distinct(#"Filtered Rows"[Descendants.State]), "Descendants.State", "Descendants.Count", List.Sum),
    #"Changed Type" = Table.TransformColumnTypes(#"Pivoted Column",{{"Active", type number}, {"Closed", type number}})
in
    #"Changed Type"

在 Power BI 中使用查询之前，可以使用以下 OData 查询代码对其进行修改或测试。有关详细信息，请参阅使用 Power BI 和 OData 查询进行连接。

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $filter=(
        IterationSK eq {iterationSK}
        and AreaSK eq {areaSK}
        and WorkItemType eq 'Feature'
    )
&$expand=Descendants(
    $apply=filter(
        WorkItemType eq 'Bug'
    )
    /groupby(
        (State),
        aggregate($count as Count)
    )
)
&$select=WorkItemId,Title

替换字符串和查询明细

将以下字符串替换为值。不要在替换中包含括号 {} 。例如，如果组织名称为“Fabrikam”，请将替换为 {organization}Fabrikam，而不是 {Fabrikam}。

{organization} - 组织名称
{project} - 项目的名称
{iterationSK} - 与 感兴趣的迭代路径 关联的 GUID。若要查找 GUID，请参阅 [../extend-analytics/wit-analytics.md#iterationsk]（返回特定迭代路径的 IterationSK）
{areaSK} - 与感兴趣的区域路径关联的 GUID。若要查找 GUID，请参阅 [../extend-analytics/wit-analytics.md#areask]（返回特定区域路径的 AreaSK）。

查询明细

下表描述了查询的每个部分。

查询部件

描述

$filter=( IterationSK eq {iterationSK} and AreaSK eq {areaSK} 和 WorkItemType eq “Feature” ）”

仅返回指定迭代和区域下的功能的数据。

filter( (TestSuite/RequirementWorkItem/IterationSK eq {iterationSK} and TestSuite/RequirementWorkItem/AreaSK eq {areaSK} and TestSuite/RequirementWorkItem/Processes/any(p:p/BacklogType eq 'RequirementBacklog') and TestSuite/RequirementWorkItem/Processes/all(p:p/IsBugType eq false)))

仅返回指定迭代和区域下所选积压工作要求项的数据。

&$expand=Descendants( $apply=filter( CompletedWork ne null or RemainingWork ne null )

展开功能子项，并返回 工作项的已完成工时 和 剩余工时 数据。

&$expand=Descendants( $apply=filter( WorkItemType eq 'Bug' ) /groupby( (State), aggregate($count as Count) )

展开功能子项并筛选 bug，按 State 和 sun 将返回数据分组为子项的总计数。

/aggregate($count as TotalCount,

聚合筛选的测试点中的数据，其计数为 TotalCount。

cast(LastResultOutcome eq 'Passed', Edm.Int32) with sum as PassedCount, cast(LastResultOutcome eq 'Failed', Edm.Int32) with sum as FailedCount, cast(LastResultOutcome eq 'Blocked', Edm.Int32) with sum as BlockedCount, cast(LastResultOutcome eq 'NotApplicable', Edm.Int32) with sum as NotApplicableCount, cast(LastResultOutcome eq 'None', Edm.Int32) with sum as NotRunCount, cast(LastResultOutcome ne 'None', Edm.Int32) with sum as RunCount)

聚合时，根据测试点的最新执行结果对测试点的值求和，结果为 Passed、Failed、Blocked、NotApplicable 和 None。此外，求和其最新结果不等于 None 的测试点的值以获取总计 RunCount。

/aggregate( iif(CompletedWork ne null, CompletedWork, 0) with sum as SumCompletedWork, iif(RemainingWork ne null, RemainingWork, 0) with sum as SumRemainingWork

跨筛选的工作项聚合 已完成工时 和 剩余工时 数据。

)/compute( (SumCompletedWork add SumRemainingWork) as TotalWork, SumCompletedWork as SumCompleted

计算已完成工时和剩余工时的总汇总。

)/compute( iif(TotalWork gt 0,(SumCompleted div cast(TotalWork, Edm.Double) mul 100), 0) as PercCompletedWork )

计算已完成的 wor 百分比。

创建表报表

在“建模”选项卡中，选择管理关系并按列链接三个WorkItemId查询结果。
在“可视化效果”下，选择“表”。
从三个 Power BI 查询中添加感兴趣的列。
选择 Sum 作为累加列（例如 通过的测试 等）的聚合。

在这里， 身份验证方案 是两个用户情景的父功能。

Power BI 示例情景概述汇总报表的屏幕截图。

通过

要求跟踪汇总示例报告

报告解答的问题

先决条件

示例查询

查询区域和迭代路径

查询满足要求的小时数百分比

查询要求的测试执行状态

查询链接到要求的 bug 的状态

替换字符串和查询明细

查询明细

创建表报表

相关文章

反馈

其他资源