Relatório de amostra de resumo de teste
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
Ao executar uma execução de pipeline e incluir tarefas de teste na definição de pipeline, você pode criar um relatório que indique o número de execuções de teste para diferentes resultados de teste: Aprovado, Com falha, Não executado, Não afetado.
A imagem a seguir mostra um exemplo de um relatório de resumo de teste.
Use as consultas fornecidas neste artigo para gerar os seguintes relatórios:
- Resumo do teste para o fluxo de trabalho de compilação
- Resumo do teste para fluxo de trabalho de lançamento
- Resumo do teste para uma ramificação específica
- Resumo do teste para um arquivo de teste específico
- Resumo do teste para um proprietário de teste específico
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.
Consultas de exemplo
Você pode usar as consultas a seguir do TestResultsDaily
conjunto de entidades para criar relatórios de resumo de teste de pipeline diferentes, mas semelhantes. O TestResultsDaily
conjunto de entidades fornece um agregado de instantâneo diário de execuções, agrupado TestResult
por Test.
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 e Referência de metadados para Azure Pipelines. 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
.
Resumo do teste para o fluxo de trabalho de compilação
Use as consultas a seguir para exibir o resumo de teste de um pipeline para um fluxo de trabalho de compilação .
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/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And DateSK ge {startdate} "
&"And Workflow eq 'Build' "
&")/aggregate("
&"ResultCount with sum as ResultCount, "
&"ResultPassCount with sum as ResultPassCount, "
&"ResultFailCount with sum as ResultFailCount, "
&"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
&"ResultNotImpactedCount with sum as ResultNotImpactedCount"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
Substitua {pipelineName}
e {startdate}
pelos valores reais da consulta.
Resumo do teste para o fluxo de trabalho de versão
Use as consultas a seguir para exibir o resumo de teste de um pipeline para um fluxo de trabalho de versão .
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
.
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/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And DateSK ge {startdate} "
&"And Workflow eq 'Release'"
&")/aggregate("
&"ResultCount with sum as ResultCount, "
&"ResultPassCount with sum as ResultPassCount, "
&"ResultFailCount with sum as ResultFailCount, "
&"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
&"ResultNotImpactedCount with sum as ResultNotImpactedCount"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
Resumo do teste filtrado por ramificação
Para exibir o resumo de teste de um pipeline para uma ramificação específica, use as consultas a seguir. Para criar o relatório, execute as etapas extras a seguir, juntamente com o que é especificado posteriormente neste artigo.
- Expandir
Branch
paraBranch.BranchName
- Selecione Segmentação de Visualização do Power BI e adicione o campo
Branch.BranchName
ao campo da segmentação de dados - Selecione o nome da ramificação na segmentação de dados para a qual você precisa ver o resumo do resultado.
Para obter mais informações sobre como usar segmentações de dados, consulte Segmentações de dados no Power BI.
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/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And DateSK ge {startdate} "
&"And Workflow eq 'Build'"
&")/groupby("
&"(Branch/BranchName),"
&"aggregate("
&"ResultCount with sum as ResultCount, "
&"ResultPassCount with sum as ResultPassCount, "
&"ResultFailCount with sum as ResultFailCount, "
&"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
&"ResultNotImpactedCount with sum as ResultNotImpactedCount"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
Resumo do teste filtrado por arquivo de teste
Para exibir o resumo de teste de um pipeline para um arquivo de teste específico, use as consultas a seguir. Para criar o relatório, execute as etapas extras a seguir, juntamente com o que é definido posteriormente neste artigo.
- Expandir
Test
paraTest.ContainerName
- Selecione Segmentação de Visualização do Power BI e adicione o campo
Test.ContainerName
ao campo da segmentação de dados - Selecione o nome do contêiner na segmentação de dados para a qual você precisa ver o resumo do resultado.
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/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And DateSK ge {startdate} "
&"And Workflow eq 'Build'"
&")/groupby("
&"(Test/ContainerName),"
&"aggregate("
&"ResultCount with sum as ResultCount, "
&"ResultPassCount with sum as ResultPassCount, "
&"ResultFailCount with sum as ResultFailCount, "
&"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
&"ResultNotImpactedCount with sum as ResultNotImpactedCount"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
Resumo do teste filtrado pelo proprietário do teste
Para exibir o resumo de teste de um pipeline para testes pertencentes a um proprietário de teste específico, use as consultas a seguir. Para criar o relatório, execute as etapas extras a seguir, juntamente com o que é definido posteriormente neste artigo.
- Expandir
Test
paraTest.TestOwner
- Selecione Segmentação de Visualização do Power BI e adicione o campo
Test.TestOwner
ao campo da segmentação de dados - Selecione o proprietário do teste na segmentação de dados para a qual você precisa ver o resumo do resultado.
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/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And DateSK ge {startdate} "
&"And Workflow eq 'Build'"
&")/groupby("
&"(Test/TestOwner),"
&"aggregate("
&"ResultCount with sum as ResultCount, "
&"ResultPassCount with sum as ResultPassCount, "
&"ResultFailCount with sum as ResultFailCount, "
&"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
&"ResultNotImpactedCount with sum as ResultNotImpactedCount"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
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}
- Nome do seu projeto de equipe.{pipelinename}
- Nome do pipeline. Exemplo:Fabrikam hourly build pipeline
.{startdate}
- A data para iniciar seu relatório. Você pode inserir as datas no formato AAAAMMDD. Por exemplo,20220815
para 15 de agosto de 2022.
Detalhamento da consulta
A tabela a seguir descreve cada parte da consulta.
Parte da consulta
Descrição
$apply=filter(
Cláusula de início filter()
.
Pipeline/PipelineName eq '{pipelineName}'
Retorne execuções de teste para o pipeline especificado.
and CompletedOn/Date ge {startdate}
O teste de retorno é executado na data especificada ou após ela.
and Workflow eq 'Build'
ou and Workflow eq 'Release'
Retorne execuções de teste somente para pipelines designados com o Build
fluxo de trabalho or Release
.
)
Cláusula de fechamento filter()
.
aggregate(
Inicie a aggregate
cláusula para todas as execuções de teste que correspondem aos critérios de filtro.
ResultCount with sum as ResultCount,
Conte o número total de execuções de teste como ResultCount
.
ResultPassCount with sum as ResultPassCount,
Conte o número total de execuções de teste aprovadas como ResultPassCount
.
ResultFailCount with sum as ResultFailCount
Conte o número total de execuções de teste com falha como ResultFailCount
.
ResultNotExecutedCount with sum as ResultNotExecutedCount,
Conte o número total de execuções de teste não executadas como ResultNotExecutedCount
.
ResultNotImpactedCount with sum as ResultNotImpactedCount
Conte o número total de execuções de teste não afetadas como ResultNotImpactedCount
.
)
Feche a aggregate()
cláusula.
(Opcional) Renomear consulta
Você pode renomear o rótulo de consulta padrão, Query1, para algo mais significativo. Basta inserir um novo nome no painel Configurações de Consulta .
(Opcional) Renomear campos de coluna
Você pode renomear campos de coluna. Por exemplo, você pode renomear a coluna Pipeline.PipelineName
para Pipeline Name
, ou TotalCount
para Total Count
. Para saber como, consulte Renomear campos de coluna.
Feche a consulta e aplique suas alterações
Depois de concluir todas as transformações de dados, escolha Fechar e Aplicar no menu Página Inicial para salvar a consulta e retornar à guia Relatório no Power BI.
Criar o relatório de gráfico de rosca
No Power BI, em Visualizações, escolha o relatório Donut .
Adicione os seguintes campos a Valores, na ordem indicada. Clique com o botão direito do mouse em cada campo e verifique se a Soma está selecionada.
ResultPassCount
ResultFailCount
ResultNotExecutedCount
ResultNotImpactedCount
Seu relatório deve ser semelhante à imagem a seguir.