Relatório de amostra de rollup de rastreamento de requisitos

Artigo
10/16/2024

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

O relatório Rollup de rastreamento de requisitos se baseia no relatório de rastreamento de requisitos e mostra como agregar métricas para um roll-up de um nível. Por exemplo, se você estiver acompanhando requisitos com Histórias de Usuário, poderá agregar dados para Recursos usando as consultas fornecidas neste artigo.

Um exemplo é mostrado na imagem a seguir.

Captura de tela do relatório de rollup de visão geral do Power BI Stories.

Este relatório exibe as seguintes informações para cada requisito listado:

Porcentagem de trabalho concluído: barra de progresso que mostra a porcentagem de trabalho concluído com base no acúmulo de horas concluídas para todas as tarefas vinculadas ao requisito.
Testes aprovados: o número de casos de teste executados que foram aprovados com base na execução de teste mais recente.
Testes com falha: o número de casos de teste executados com falha com base na execução de teste mais recente.
Executar testes: o número de execuções de teste executadas.
Bugs ativos: o número de bugs vinculados em um estado Ativo.
Bugs fechados: o número de bugs vinculados em um estado Fechado, Concluído ou Concluído.

Observação

O rastreamento de requisitos é suportado apenas para casos de teste vinculados por meio de um conjunto de testes baseado em requisitos. A associação entre um item de trabalho de requisito — História do Usuário (Agile), Item de Lista de Pendências do Produto (Scrum), Requisito (CMMI) ou Problema (Básico) — e a execução de teste manual só é formada quando o caso de teste é vinculado por meio de um conjunto de testes baseado em Requisitos.

Perguntas que o relatório responde

Os relatórios de rastreamento de requisitos são úteis para responder aos seguintes tipos de perguntas.

Progresso do trabalho

A quantidade de trabalho que resta para cada requisito corresponde às suas expectativas?
Os requisitos mais bem classificados estão sendo implementados primeiro?
Quantos testes são definidos para cada requisito? Quantos testes estão passando?
Quais requisitos estão sendo implementados que não têm casos de teste definidos para eles?

Progresso da qualidade

Quantos casos de teste foram executados para cada requisito e quantos foram aprovados?
Quantos bugs ativos cada requisito tem?
Bugs estão sendo encontrados para requisitos que estão sendo testados?
Os bugs estão sendo resolvidos ou permanecem ativos?

Avaliação de risco

Quais requisitos estão em risco?
Quais requisitos não são suficientemente estáveis para lançamento?
Quais requisitos podemos enviar hoje?

Importante

A integração do Power BI e o acesso ao feed OData do Serviço de Análise estão em disponibilidade geral para Azure DevOps Services e Azure DevOps Server 2020 e versões posteriores. As consultas de exemplo fornecidas neste artigo são válidas somente em Azure DevOps Server 2020 e versões posteriores e dependem da versão prévia v3.0 ou posterior. Incentivamos você a usar essas consultas e nos fornecer comentários.

Pré-requisitos

Acesso: ser membro de um projeto com pelo menos acesso básico.
Permissões: por padrão, os membros do projeto têm permissão para consultar o Analytics e criar exibições.
Para obter mais informações sobre outros pré-requisitos relacionados à ativação de serviços e recursos e atividades gerais de rastreamento de dados, consulte Permissões e pré-requisitos para acessar o Analytics.

Observação

Este artigo pressupõe que você leia Visão geral dos relatórios de exemplo usando consultas OData e tenha uma compreensão básica do Power BI.

Para que o relatório gere dados úteis, você precisa ter executado as seguintes tarefas:

Você definiu itens de trabalho de requisito e os atribuiu aos caminhos de área e iteração de interesse. Para obter informações sobre como definir caminhos de área e iteração, consulte Definir caminhos de área e Definir caminhos de iteração.
Para obter a porcentagem de horas concluídas, você precisa preencher os campos Trabalho Concluído e Trabalho Restante de tarefas ou bugs vinculados a requisitos com o tipo de link Filho .
Para obter o status de execução dos casos de teste, você terá criado conjuntos de testes baseados em requisitos em Planos de Teste correspondentes a esses requisitos. Os testes embutidos adicionados por meio do quadro atendem a esse pré-requisito, no entanto, os requisitos vinculados aos testes não. Para obter mais informações, consulte Criar planos de teste e conjuntos de testes.
Para obter o status dos bugs, você terá criado e vinculado bugs a requisitos com o tipo de link Filho .

Consultas de exemplo

Para gerar o relatório, você deve adicionar três consultas do Power BI ao Power BI Desktop e vinculá-las. Cada consulta executa o WorkItems conjunto de entidades ou TestPoints .

Observação

Os snippets de consulta do Power BI fornecidos nas seções a seguir incluem as transformações de dados necessárias para expandir colunas e alterar o tipo de dados.

Área de consulta e caminhos de iteração

Para definir o escopo do relatório para um determinado caminho de Área e Iteração, você pode filtrar a consulta usando AreaSK e IterationSK. Para obter detalhes, consulte Definir consultas básicas usando o OData Analytics.

Observação

Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para Azure Boards. Você pode filtrar suas consultas ou retornar propriedades usando qualquer um dos Property valores em um EntityType ou NavigationPropertyBinding Path valores disponíveis com um EntitySet. Cada EntitySet corresponde a um EntityType. Para obter mais informações sobre o tipo de dados de cada valor, examine os metadados fornecidos para o EntityType.

Consulta de porcentagem de horas de conclusão para requisitos

Observação

Altere o WorkItemType com base no processo que você está usando. O modelo Scrum dá suporte a Recurso e o modelo Básico dá suporte a Épico como o tipo de item de trabalho acumulado, respectivamente.

Consulta do Power BI
Consulta OData

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Consulta em Branco de Dados>. Para obter mais informações, consulte Visão geral de relatórios de exemplo usando consultas 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"

Você pode usar o código de consulta OData a seguir para modificar ou testar a consulta antes de usá-la no Power BI. Para obter mais informações, consulte Conectar-se usando consultas do Power BI e 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

Consultar o status de execução de teste dos requisitos

Observação

Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para Análise de Planos de Teste. Você pode filtrar suas consultas ou retornar propriedades usando qualquer um dos Property valores em um EntityType ou NavigationPropertyBinding Path valores disponíveis com um EntitySet. Cada EntitySet corresponde a um EntityType. Para obter mais informações sobre o tipo de dados de cada valor, examine os metadados fornecidos para o EntityType.

Consulta do Power BI
Consulta 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"

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
    )
)

Observação

A TestSuite/RequirementWorkItem/... entrada indica que o item de trabalho deve ser vinculado ao conjunto de testes por meio de conjuntos de testes baseados em requisitos, conforme discutido nos pré-requisitos.

Consulta de status de bugs vinculados aos requisitos

Observação

Consulta do Power BI
Consulta 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"

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

Cadeias de caracteres de substituição e detalhamento de consulta

Substitua as cadeias de caracteres a seguir pelos valores. Não inclua colchetes {} com sua substituição. Por exemplo, se o nome da sua organização for "Fabrikam", substitua por {organization}Fabrikam, não {Fabrikam}.

{organization} - Nome da sua organização
{project} - O nome do seu projeto
{iterationSK} - O GUID associado ao Caminho de Iteração de interesse. Para pesquisar o GUID, consulte [.. /extend-analytics/wit-analytics.md#iterationsk](Retorna o IterationSK para um caminho de iteração específico)
{areaSK} - O GUID associado ao Caminho da Área de interesse. Para pesquisar o GUID, consulte [.. /extend-analytics/wit-analytics.md#areask](Retorna o AreaSK para um Caminho de Área específico).

Detalhamento da consulta

A tabela a seguir descreve cada parte da consulta.

Parte da consulta

Descrição

$filter=( IterationSK eq {iterationSK} and AreaSK eq {areaSK} e WorkItemType eq 'Feature' )'

Retorna dados somente para Recursos na Iteração e Área especificadas.

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)))

Retorne dados apenas para itens de requisito de lista de pendências selecionados na Iteração e Área especificadas.

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

Expanda os itens filho de Recursos e retorne dados de Trabalho Concluído e Trabalho Restante para os itens de trabalho.

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

Expanda os itens filho de Recursos e filtre por bug, agrupe os dados de retorno por Estado e solte a contagem total de itens filho.

/aggregate($count as TotalCount,

Agregue dados entre os pontos de teste filtrados com contagem como 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)

Ao agregar, some os valores dos pontos de teste com base no resultado de execução mais recente de Aprovado, Com Falha, Bloqueado, Não Aplicável e Nenhum. Além disso, some os valores dos pontos de teste cujo resultado mais recente não é igual a Nenhum para obter o total RunCount.

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

Agregue dados de Trabalho Concluído e Trabalho Restante nos itens de trabalho filtrados.

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

Calcule o acúmulo total de Trabalho Concluído e Trabalho Restante.

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

Calcule a porcentagem de trabalho concluído.

Criar o relatório Tabela

Na guia Modelagem , escolha Gerenciar relacionamentos e vincule os três resultados da consulta por WorkItemId coluna.
Em Visualizações, escolha Tabela.
Adicione as colunas nas quais você está interessado nas três consultas do Power BI.
Selecione Soma como agregação para colunas aditivas, como Testes aprovados etc.

Aqui, os cenários de autenticação são um recurso pai de duas histórias de usuário.

Captura de tela do relatório de rollup de visão geral das histórias de exemplo do Power BI.

Compartilhar via

Relatório de amostra de rollup de rastreamento de requisitos

Perguntas que o relatório responde

Pré-requisitos

Consultas de exemplo

Área de consulta e caminhos de iteração

Consulta de porcentagem de horas de conclusão para requisitos

Consultar o status de execução de teste dos requisitos

Consulta de status de bugs vinculados aos requisitos

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

Criar o relatório Tabela

Comentários

Recursos adicionais

Compartilhar via

Relatório de amostra de rollup de rastreamento de requisitos

Perguntas que o relatório responde

Pré-requisitos

Consultas de exemplo

Área de consulta e caminhos de iteração

Consulta de porcentagem de horas de conclusão para requisitos

Consultar o status de execução de teste dos requisitos

Consulta de status de bugs vinculados aos requisitos

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

Criar o relatório Tabela

Artigos relacionados

Comentários

Recursos adicionais