Compartilhar via

Criar uma consulta com base nos campos de integração de build e teste

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

Use campos de item de trabalho que dão suporte à integração de build e teste para melhorar a rastreabilidade, analisar tendências de qualidade e automatizar fluxos de trabalho relacionados ao teste. Os cenários comuns são:

  • Associe bugs às compilações específicas nas quais foram descobertos ou resolvidos.
  • Consultar bugs por versão para identificar tendências e priorizar correções.
  • Marque casos de teste como manuais ou automatizados e acompanhe os metadados de automação.
  • Defina as etapas de ação e validação para casos de teste e etapas compartilhadas para que as equipes possam executar e verificar os 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 ele permite
Project-level Contribuidores Criar e editar consultas.
Project-level Leitores Exibir consultas (não é possível criar ou editar).
Project-level Administradores do Projeto Controle total sobre as configurações do projeto, incluindo consultas.
Artefatos de teste Gerenciar planos de teste Criar, editar e excluir planos de teste.
Artefatos de teste Gerenciar pacotes de teste Criar, editar e excluir pacotes de teste.
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 têm escopo no plano de teste ou no nó de área; os administradores do projeto podem atribuir essas permissões.
  • Para executar ou automatizar consultas em projetos, verifique se você tem as permissões de projeto cruzado necessárias ou use uma conta de serviço com o acesso apropriado.

Operadores e macros com suporte

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

Tipo de dados

Operadores e macros suportados

Texto avançado (HTML) e
Texto de várias linhas (PlainText)

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

Texto de linha única (Cadeia de caracteres)

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

Filtros úteis

Filtrar por

Incluir essas cláusulas de consulta

Casos de teste automatizados

Work Item Type = Test Case E Automation Status = Automated

Conjuntos de testes baseados em consulta

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

Conjuntos de testes baseados em requisitos

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

Listar bugs 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 para 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 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 de item de trabalho e atributos.

Para personalizar um campo ou uma lista de seleção, 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 da Automação1

O status 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.
Reference name=Microsoft.VSTS.TCM.AutomationStatus, Data type=String

Caso de teste

Encontrado em2

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

Observação

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

Bug

Integração Build2

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

Observação

Use o tipo de link Integrated in build para vincular um item de trabalho a um build. Esse tipo de link funciona com processos de build atuais (Azure Pipelines e definições de build clássicas); ele não se aplica a builds XAML herdados.

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=Cadeia de caracteres.

Etapas compartilhadas

Parâmetros

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

Parâmetros compartilhados, etapas compartilhadas, caso de teste

Etapas

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

Etapas compartilhadas, caso de teste

Informações do sistema

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

Bug, Resposta de comentários

Etapas de reprodução (etapas para reproduzir)

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

Bug

Tipo de Pacote de Teste1

Categoria do conjunto de testes. Valores permitidos: Baseado em Consulta, Baseado em Requisitos, Estático. Para obter mais informações, consulte Criar um plano de teste. Nome de referência=Microsoft.VSTS.TCM.TestSuiteType, Tipo de dados=Cadeia de caracteres.

Conjunto de testes

Observação

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

Outros campos

Os campos a seguir não aparecem em formulários de item de trabalho, mas são monitorados para casos de teste ou suítes de teste. Você pode usar algumas delas 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=Cadeia de caracteres.

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=Cadeia de caracteres.

Caso de teste

AutomatedTestId

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

Caso de teste

AutomatedTestName

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

Caso de teste

LocalDataSource

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

Caso de teste

Texto da consulta

Campo usado para capturar a consulta definida para um tipo de suíte baseado em consulta. Reference name=Microsoft.VSTS.TCM.QueryText, Tipo de dado=PlainText.

Conjunto de testes

Auditoria de Conjunto de Testes

Controla as operações ao modificar um pacote de testes (por exemplo, adicionar testes ou alterar configurações). Acessível por meio da guia Histórico ou de uma consulta. Reference name=Microsoft.VSTS.TCM.TestSuiteAudit, Tipo de dado=PlainText.

Conjunto de testes

ID do tipo de conjunto de testes 1

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

Conjunto de testes

Observação

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

Campos que se integram ao Team Foundation Build e ao Azure Pipelines

O Team Foundation Build é o sistema de build local usado com versões mais antigas do Servidor do Azure DevOps. O Azure Pipelines fornece recursos de build e pipeline hospedados na nuvem no Azure DevOps Services. Ambos os sistemas integram metadados de build a itens de trabalho quando os builds são executados e quando os itens de trabalho são resolvidos em builds.

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

Você pode adicionar esses campos a uma definição de 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 Found In existe em uma definição WIT, um processo de build compatível pode criar um item de trabalho quando uma build falha e definir Found In para o número da build. Quando o Build de Integração estiver disponível, um processo de build compatível pode atualizar itens de trabalho que foram resolvidos por uma compilação com o número de build correspondente.

Compilações e preenchimento automático da lista global

Na primeira vez que você enfileira um build para um projeto usando o Team Foundation Build ou o Azure Pipelines, o sistema cria uma lista global chamada Build - <ProjectName>. Cada execução de build adiciona uma LISTITEM entrada para esse build. A lista global usa o nome de exibição do projeto e pode ser referenciada em um GLOBALLIST elemento em uma FIELD definição para fornecer uma lista suspensa 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 que se integram aos 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 os detalhes do ambiente e as 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 ao TFVC (Team Foundation Version Control)

O TFVC dá suporte à associação ou resolução de itens de trabalho durante o check-in. Quando você vincula um item de trabalho da janela de check-in e a ação tem suporte, 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 esperada.

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 consultar por caso de teste:

  • Exibições hierárquicas: você não pode 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.
  • Conjuntos de testes baseados em consulta: os pacotes baseados em consulta incluem todos os casos de teste retornados pela consulta; verifique se a consulta é 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 excessivas à API podem causar atrasos ou limitação.
  • Vinculação de caso de teste: os casos de teste não são vinculados automaticamente a outros itens de trabalho de forma a dar suporte a consultas hierárquicas complexas.

Conteúdo relacionado

  • Last updated on