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

  • Artigo

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

Os campos de item de trabalho que suportam a integração de compilação e teste suportam as seguintes ações:

  • Associe bugs às compilações onde foram encontrados ou corrigidos
  • Consulta de bugs associados a uma compilação
  • Marque os casos de teste como manuais ou automatizados e armazene informações para dar suporte a casos de teste automatizados
  • Para casos de teste e etapas compartilhadas, defina as etapas de ação e validação e os dados que são usados para executar testes.

Operadores e macros suportados

A maioria dos campos de integração de compilação e teste tem um tipo de dados de String, PlainText ou HTML. As cláusulas de consulta que especificam um campo de texto ou rich-text podem usar os operadores e macros listados na tabela a seguir.

Tipo de dados

Operadores e macros suportados

Rich-text (HTML) e
Cadeias de texto de várias linhas (PlainText)

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty.
Os operadores e Is Not Empty têm suporte para o Is Empty Azure DevOps Server 2019 RC2 e versões posteriores.

Texto único (String)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, , Does Not Contain, Not InIn, In Group, Not In Group,Was Ever
Macros: , válidas com o campo Tipo de Item de Trabalho e @Project, válidas com o campo Projeto de Equipe. [Any] O sistema assume automaticamente como padrão a filtragem com base no projeto atual. Para obter mais informações, veja Consultas entre projetos.

Filtros úteis

Filtrar para

Inclua estas cláusulas de consulta

Casos de teste automatizados

        Work Item Type = Test Case And Automation Status = Automated

Conjuntos de testes baseados em consultas

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

Conjuntos de testes baseados em requisitos

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

Listar bugs e os casos de teste que os testam

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

Listar bugs e os casos de teste que os testam

Nota

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. Esses itens não são vinculados usando tipos de link pai-filho. Você pode exibir a hierarquia por meio da >página Planos de teste de teste.

Criar e testar campos de dados

A tabela a seguir descreve os campos definidos em um ou mais WITs de 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ção 1

O status de um caso de teste. Pode especificar os seguintes valores:

Caso de Teste

Encontrado em 2

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

Nota

Você também pode usar o tipo de link Encontrado na compilação para vincular um item de trabalho a uma compilação. Esse tipo de link está disponível no Azure DevOps e só funciona com os processos de compilação atuais (não com compilações XAML).

Erro

Integração Build 2

Número de compilação do produto que incorpora o código ou corrige um bug.
Nome de referência=Microsoft.VSTS.Build.IntegrationBuild, Tipo de dados=String

Nota

Você também pode usar o tipo de link Integrado na compilação para vincular um item de trabalho a uma compilação. Esse tipo de link está disponível no Azure DevOps e só funciona com os processos de compilação atuais (não com compilações XAML).

Todos

Problema

Indica que as Etapas Compartilhadas estão associadas a um resultado esperado. Os valores permitidos são Sim e Não. Nome de referência=Microsoft.VSTS.Common.Issue, Tipo de dados=String

Etapas compartilhadas

Parâmetros

Contém os parâmetros a serem usados ao executar um teste manual.
Microsoft.VSTS.TCM.Parameters, Tipo de dados=HTML

Parâmetros compartilhados, etapas compartilhadas, caso de teste

Passos

As etapas de ação e validação necessárias para executar o teste. Microsoft.VSTS.TCM.Steps, Tipo de dados=HTML

Etapas compartilhadas, caso de teste

Informação do Sistema

Informações sobre o software e a configuração do sistema que são relevantes para o teste.
Microsoft.VSTS.TCM.SystemInfo, Tipo de dados=HTML

Bug, Resposta de feedback

Etapas de reprodução (ou etapas para reproduzir)

As etapas necessárias para reproduzir um comportamento inesperado. Capture informações suficientes para que outros membros da equipe possam entender o impacto total do problema e se corrigiram o bug. Isso inclui ações tomadas para localizar ou reproduzir o bug e o comportamento esperado. Nome de referência=Microsoft.VSTS.TCM.ReproSteps, Tipo de dados=HTML

Erro

Test Suite Tipo 1

A categoria do conjunto de testes. Os valores permitidos são:

  • Baseado em consulta: Use para agrupar casos de teste que têm uma característica específica - por exemplo, todos os testes que têm Prioridade = 1. O conjunto inclui automaticamente todos os casos de teste retornados pela consulta que você definir.
  • Baseado em requisitos: use para agrupar casos de teste projetados para controlar o status de teste de itens da lista de pendências. Cada caso de teste que você adiciona a um conjunto de testes baseado em requisitos é automaticamente vinculado ao item da lista de pendências.
  • Estático: Use para agrupar casos de teste com quaisquer características ou conjuntos de testes.
    Para obter mais informações, consulte Criar um plano de teste.
    Nome de referência=Microsoft.VSTS.TCM.TestSuiteType, Tipo de dados=String

Conjunto de Testes

Nota

  1. Não personalize a lista de opções para esses campos. O sistema aceita apenas os valores listados.
  2. Ao adicionar um GLOBALLIST elemento à FIELD definição, você pode fornecer um menu suspenso de compilações que os usuários podem escolher. Para saber como, consulte Compilações e preenchimento automático de listas globais mais adiante neste artigo.

Outros domínios

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

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

AutomatedTestId

A ID do teste que automatiza o caso de teste.

Nome de referência=Microsoft.VSTS.TCM.AutomatedTestId, Tipo de dados=String

Caso de Teste

AutomatedTestName

O nome do teste que é usado para automatizar o caso de teste.

Nome de referência=Microsoft.VSTS.TCM.AutomatedTestName, Tipo de dados=String

Caso de Teste

LocalDataSource

A fonte de dados local que suporta o teste.

Nome de referência=Microsoft.VSTS.TCM.LocalDataSource, Tipo de dados=HTML

Caso de Teste

Texto de Consulta

Campo usado para capturar a consulta definida para um tipo de conjunto baseado em consulta.

Nome de referência=Microsoft.VSTS.TCM.QueryText, Tipo de dados=PlainText

Conjunto de Testes

Auditoria do conjunto de testes

Rastreia outras operações executadas ao modificar um conjunto de testes, por exemplo: adicionar testes a um conjunto de testes ou alterar configurações. Este campo pode ser visualizado através do separador Histórico ou através de uma consulta separada. Há uma exibição de histórico combinada, incluindo alterações feitas no campo de itens de trabalho e alterações resultantes de artefatos relacionados, como pontos de teste e configurações.

Nome de referência=Microsoft.VSTS.TCM.TestSuiteAudit, Tipo de dados=Texto sem formatação

Conjunto de Testes

Test Suite Tipo ID 1

Um valor atribuído pelo sistema que corresponde à categoria do conjunto de testes e aplicável apenas aos conjuntos de testes. Os valores atribuídos são:

  • 1 (Estática)

  • 2 (baseado em consultas)

  • 3 (Baseado em requisitos)

Nome de referência=Microsoft.VSTS.TCM.TestSuiteTypeId, Tipo de dados=Inteiro

Conjunto de Testes

Nota

  1. Não personalize a lista de opções para esses campos. O sistema aceita apenas os valores listados.

Campos que se integram com o Team Foundation Build

Team Foundation Build é o sistema de compilação local que você pode usar com o Azure DevOps Server e TFS. Você pode configurar seu processo de compilação usando Team Foundation Build, e Team Foundation Build pode gerar itens de trabalho quando uma compilação falha. Ele também pode adicionar informações de compilação a itens de trabalho que foram resolvidos em uma compilação específica. Para que isso funcione, Team Foundation Build requer que os dois campos a seguir sejam adicionados à definição de tipo de item de trabalho: Found In e Integration Build.

Os campos Found In e Integrated in Build são definidos para Bugs nos processos padrão. Esses campos associam bugs às compilações onde foram encontrados ou corrigidos.

Você pode usar o trecho de código a seguir para adicionar esses 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 está presente em uma definição WIT, Team Foundation Build cria um item de trabalho quando uma compilação falha e define o campo Encontrado em para o número de compilação da compilação que falhou. Se o campo Encontrado em estiver faltando, Team Foundation Build não cria um item de trabalho para a compilação com falha e tudo o resto funciona conforme o esperado.

Quando o campo Integration Build está presente na definição WIT, Team Foundation Build identifica itens de trabalho que foram resolvidos com cada compilação e, em seguida, atualiza esses itens de trabalho para definir o número de compilação no qual eles foram resolvidos no campo Integration Build . Se o campo Integration Build estiver faltando, Team Foundation Build não armazena o número de compilação nos itens de trabalho e tudo o resto funciona conforme o esperado.

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

A primeira vez que você enfileirar uma compilação para um projeto usando o Team Foundation Build, o TFS adiciona automaticamente uma lista global rotulada Build - ProjectName. Cada vez que uma compilação é executada, um LISTITEM é adicionado a essa lista global com o nome da compilação.

Ao adicionar um elemento GLOBALLIST à definição FIELD , você pode fornecer um menu suspenso de compilações que os usuários podem escolher. Por exemplo:

<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 com planos de teste

Com os Planos de Teste, você pode automatizar a criação de um bug ou outro tipo de item de trabalho quando um teste falha. Para obter mais informações, consulte Adicionar descobertas a bugs existentes com testes exploratórios.

Quando um item de trabalho é criado dessa maneira, as informações sobre o sistema e as etapas para reproduzir o bug são capturadas nos campos Informações do sistema e Etapas de reprodução.

Você pode adicionar esses campos aos tipos de item de trabalho criados para rastrear defeitos usando o trecho de código a seguir.

<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

Um dos recursos disponíveis no controle de versão do Team Foundation (TFVC) permite que você associe ou resolva itens de trabalho quando você faz check-in de código. Você pode ter trabalhado em um item de trabalho específico quando faz uma alteração de código e pode definir essa associação de dentro da janela de check-in do controle do código-fonte quando terminar de trabalhar no código.

A capacidade do controle de versão do Team Foundation para resolver um item de trabalho requer que os itens de trabalho contenham uma ação específica. Em seguida, o sistema de controle do código-fonte consulta o controle do item de trabalho para determinar se o item de trabalho dá suporte a essa ação e, se ele dá suporte a essa ação, também consulta os estados de origem e destino da transição. Se a ação for encontrada, o sistema de controle do código-fonte pode fazer a transição do item de trabalho de acordo com a transição definida quando ele verifica o código.

Nota

Ao usar a ação Check-in, você deve definir os estados apropriados de e para refletir a transição de estado desejada.

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