Partilhar via

Criar uma consulta com base em campos de integração de compilação e teste

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Use campos de item de trabalho que ofereçam suporte à integração de compilação e teste para melhorar a rastreabilidade, analisar tendências de qualidade e automatizar fluxos de trabalho relacionados a testes. Os cenários típicos incluem:

  • Associe erros às compilações específicas em que foram descobertos ou resolvidos.
  • Pesquisar erros por versão para identificar tendências e priorizar correções.
  • Marque casos de teste como Manual ou Automatizado e rastreie metadados de automação.
  • Defina etapas de ação e validação para casos de teste e etapas compartilhadas para que as equipes possam executar e verificar testes de forma confiável.

Este artigo explica como usar esses campos e oferece exemplos de consultas e dicas.

Pré-requisitos

Area Permissão/função O que permite
Nível do projeto Contribuidores Crie e edite consultas.
Nível do projeto Leitores Ver consultas (não é possível criar ou editar).
Nível do projeto Administradores de projetos Controle total sobre as configurações do projeto, incluindo consultas.
Artefatos de teste Gerenciar planos de teste Crie, edite e elimine planos de teste.
Artefatos de teste Gerenciar suítes de teste Crie, edite e exclua conjuntos de testes.
Artefatos de teste Editar itens de trabalho neste nó Adicione ou edite itens de trabalho específicos do teste, como casos de teste e conjuntos de testes.

Observação

  • Algumas permissões de teste estão delimitadas no plano de teste ou no nó da área; os administradores de projeto podem atribuir essas permissões.
  • Para executar ou automatizar consultas entre projetos, certifique-se de ter as permissões necessárias entre projetos ou use uma conta de serviço com o acesso apropriado.

Operadores e macros suportados

A maioria dos campos de integração de compilação e teste usa tipos de dados String, PlainText ou HTML. Use os seguintes operadores e macros ao especificar cláusulas de consulta para campos de texto ou rich-text.

Tipo de dados

Operadores e macros suportados

Rich-text (HTML) e
Texto com várias linhas (PlainText)

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty.

Texto de linha única (String)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, , In, Not In, In GroupNot In Group, Was Ever.
Macros: [Any] (válido com Tipo de Item de Trabalho); @Project (válido com Projeto de Equipe). O sistema define automaticamente o projeto atual como padrão quando apropriado. Consulte Consulta entre projetos para obter exemplos entre projetos.

Filtros úteis

Filtrar por

Inclua estas cláusulas de consulta

Casos de teste automatizados

Work Item Type = Test Case E AINDA Automation Status = Automated

Conjuntos de testes baseados em consultas

Work Item Type = Test Suite E AINDA Test Suite Type = Query Based

Conjuntos de testes baseados em requisitos

Work Item Type = Test Suite E AINDA Test Suite Type = Requirement Based

Listar erros e os casos de teste que os testam

Crie uma nova consulta, defina o tipo de consulta como Itens de trabalho e links diretos. Filtre bugs no nível superior e adicione um filtro de itens de trabalho vinculados para casos de teste.

Captura de tela que mostra bugs e seus casos de teste vinculados.

Observação

Não é possível construir uma consulta que mostre uma exibição hierárquica de Planos de Teste, Conjuntos de Testes e Casos de Teste porque esses artefatos não estão conectados por tipos de link pai-filho. Para exibir essa hierarquia, abra a > página Planos de teste (consulte Criar um plano de teste).

Criar e testar campos de dados

A tabela a seguir descreve os campos que aparecem em um ou mais tipos de item de trabalho relacionados ao teste. Para obter informações sobre tipos de dados e atributos de campo, consulte Campos e atributos de item de trabalho.

Para personalizar um campo ou uma lista de opções, consulte Adicionar ou modificar um campo para dar suporte a consultas, relatórios e fluxo de trabalho.

Nome do campo

Descrição

Tipo de item de trabalho

Status de automação1

O estado de um caso de teste. Valores: Automatizado, Não Automatizado, Planejado. Para executar testes automatizados, consulte Executar testes automatizados a partir de planos de teste.
Nome de referência=Microsoft.VSTS.TCM.AutomationStatus, Tipo de dados=String

Caso de Teste

Encontrado em2

Número de compilação do produto (revisão) no qual um bug foi encontrado. Nome de referência=Microsoft.VSTS.Build.FoundIn, Tipo de dados=String.

Observação

Use o tipo de ligação Encontrado no build para ligar um item de trabalho a um build. Esse tipo de link funciona com processos de compilação atuais (Azure Pipelines e definições de compilação clássicas); ele não se aplica a compilações XAML herdadas.

Inseto

Integração Build2

Número de compilação do produto que incorpora a correção. Nome de referência=Microsoft.VSTS.Build.IntegrationBuild, Tipo de dados=String.

Observação

Use o tipo de link Integrado na compilação para vincular um item de trabalho a uma compilação. Esse tipo de link funciona com processos de compilação atuais (Azure Pipelines e definições de compilação clássicas); ele não se aplica a compilações XAML herdadas.

Todos

Questão

Indica se as Etapas Compartilhadas estão associadas a um resultado esperado. Valores permitidos: Sim, Não. Nome de referência=Microsoft.VSTS.Common.Issue, Tipo de dados=String.

Etapas compartilhadas

Parâmetros

Contém parâmetros usados ao executar um teste manual. Nome de referência=Microsoft.VSTS.TCM.Parameters, Tipo de dados=HTML.

Parâmetros compartilhados, etapas compartilhadas, caso de teste

Passos

Etapas de ação e validação necessárias para executar o teste. Nome de referência=Microsoft.VSTS.TCM.Steps, Tipo de dados=HTML.

Etapas compartilhadas, caso de teste

Informação do Sistema

Informações sobre o sistema e o ambiente relevantes para o ensaio. Nome de referência=Microsoft.VSTS.TCM.SystemInfo, Tipo de dados=HTML.

Erro, Resposta de comentários

Repro Steps (Passos para reproduzir)

Etapas necessárias para reproduzir um comportamento inesperado. Capture informações suficientes para que outras pessoas reproduzam e validem correções. Nome de referência=Microsoft.VSTS.TCM.ReproSteps, Tipo de dados=HTML.

Inseto

Tipo de Test Suite1

Categoria do conjunto de testes. Valores permitidos: Baseado em consulta, Baseado em requisitos, Estático. Para saber mais, consulte Criar um plano de teste. Nome de referência=Microsoft.VSTS.TCM.TestSuiteType, Tipo de dados=String.

Conjunto de testes

Observação

  1. Não personalize a lista de opções para esses campos — o sistema e as integrações esperam os valores listados.
  2. Ao adicionar um GLOBALLIST elemento a uma FIELD definição, você pode fornecer um menu suspenso de compilações. Consulte Compilações e preenchimento automático de listas globais.

Outros domínios

Os campos a seguir não aparecem em formulários de item de trabalho, mas são rastreados para casos de teste ou conjuntos de testes. Você pode usar alguns deles para filtrar consultas e criar relatórios. (Esses campos não são adicionados ao data warehouse nem indexados.)

Nome do campo

Descrição

Tipo de item de trabalho

Armazenamento de teste automatizado

O assembly que contém o teste que automatiza o caso de teste. Nome de referência=Microsoft.VSTS.TCM.AutomatedTestStorage, Tipo de dados=String.

Caso de Teste

Tipo de teste automatizado

O tipo de teste que automatiza o caso de teste. Nome de referência=Microsoft.VSTS.TCM.AutomatedTestType, Tipo de dados=String.

Caso de Teste

ID de Teste Automatizado

A ID do teste automatizado. Nome de referência=Microsoft.VSTS.TCM.AutomatedTestId, Tipo de dados=String.

Caso de Teste

AutomatedTestName

O nome do teste automatizado. Nome de referência=Microsoft.VSTS.TCM.AutomatedTestName, Tipo de dados=String.

Caso de Teste

LocalDataSource

A fonte de dados local usada pelo teste. Nome de referência=Microsoft.VSTS.TCM.LocalDataSource, Tipo de dados=HTML.

Caso de Teste

Texto da consulta

Campo usado para capturar a consulta definida para um tipo de suíte baseado em consulta. Nome de referência=Microsoft.VSTS.TCM.QueryText, Tipo de dados=PlainText.

Conjunto de testes

Auditoria do conjunto de testes

Rastreia operações ao modificar um conjunto de testes (por exemplo, adicionar testes ou alterar configurações). Visível através do separador Histórico ou de uma consulta. Nome de referência=Microsoft.VSTS.TCM.TestSuiteAudit, Tipo de dados=PlainText.

Conjunto de testes

Test Suite Tipo ID 1

Valor atribuído pelo sistema que corresponde à categoria do conjunto de testes: 1 (Estático), 2 (Baseado em consulta), 3 (Baseado em requisitos). Nome de referência=Microsoft.VSTS.TCM.TestSuiteTypeId, Tipo de dados=Inteiro.

Conjunto de testes

Observação

  1. Não personalize a lista de opções para esses campos — o sistema e as integrações esperam os valores listados.

Campos que se integram com o Team Foundation Build e o Azure Pipelines

Team Foundation Build é o sistema de compilação local usado com versões mais antigas do Azure DevOps Server. O Azure Pipelines fornece recursos de compilação e pipeline hospedados na nuvem nos Serviços de DevOps do Azure. Ambos os sistemas integram metadados de compilação com itens de trabalho quando as compilações são executadas e quando os itens de trabalho são resolvidos em compilações.

Os dois campos comumente usados para integração de compilação são Found In e Integration Build. Quando presentes em uma definição WIT, eles permitem que um sistema de compilação associe itens de trabalho com os números de compilação relevantes.

Você pode adicionar estes campos a uma definição WIT:

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
</FIELD>
<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
</FIELD>

Quando o campo Encontrado em existe em uma definição WIT, um processo de compilação compatível pode criar um item de trabalho quando uma compilação falha e definir Encontrado em para o número de compilação. Quando a compilação de integração existe, um processo de compilação compatível pode atualizar itens de trabalho que foram resolvidos por uma compilação com o número de compilação correspondente.

Compilações e preenchimento automático de listas globais

Na primeira vez que você enfileirar uma compilação para um projeto usando o Team Foundation Build ou o Azure Pipelines, o sistema criará uma lista global chamada Build - <ProjectName>. Cada execução de compilação adiciona uma LISTITEM entrada para essa compilação. A lista global usa o nome de exibição do projeto e pode ser referenciada em um elemento GLOBALLIST dentro de uma definição FIELD para proporcionar um menu suspenso de builds.

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
        <SUGGESTEDVALUES expanditems="true" filteritems="excludegroups">
          <GLOBALLIST name="Builds - TeamProjectName" />
        </SUGGESTEDVALUES>
</FIELD>

Campos incorporados nos Planos de Teste

Os Planos de Teste podem criar um bug ou outro item de trabalho quando um teste falha. Quando você adiciona um item de trabalho dessa forma, o sistema de teste captura detalhes do ambiente e etapas de reprodução nos campos Informações do sistema e Etapas de reprodução .

<FIELD name="System Info" refname="Microsoft.VSTS.TCM.SystemInfo" type="HTML" />
<FIELD name="Repro Steps" refname="Microsoft.VSTS.TCM.ReproSteps" type="HTML" />

Campos que se integram com o Controle de Versão do Team Foundation (TFVC)

O TFVC suporta a associação ou resolução de itens de trabalho durante o check-in. Quando você vincula um item de trabalho na janela de check-in e a ação é suportada, o TFVC aplica a transição de estado configurada ao item de trabalho.

Observação

Ao usar a ação Checkin, defina os estados de e para apropriados para a transição que espera.

Para obter mais informações, consulte Automatizar atribuições de campo com base em Estado, Transição ou Motivo.

Limitações

Principais limitações ao efetuar consultas por caso de teste:

  • Exibições hierárquicas: não é possível construir uma consulta que mostre uma exibição hierárquica de Planos de Teste, Conjuntos de Testes e Casos de Teste porque esses artefatos não estão conectados por tipos de link pai-filho.
  • Pacotes de teste baseados em consulta: os pacotes baseados em consulta incluem todos os casos de teste retornados pela consulta; Certifique-se de que sua consulta seja precisa para evitar inclusões não intencionais.
  • Limitações de campo: alguns resultados de execução detalhados não estão disponíveis como campos padrão e podem exigir relatórios personalizados ou uso de API.
  • Limites de desempenho e taxa: o Azure DevOps impõe limites de solicitação e recursos; consultas não otimizadas ou chamadas de API excessivas podem causar atrasos ou limitação.
  • Vinculação de casos de teste: os casos de teste não são vinculados automaticamente a outros itens de trabalho de uma forma que ofereça suporte a consultas hierárquicas complexas.

Conteúdo relacionado

  • Last updated on