Compartilhar via


Campos personalizados

Azure DevOps Services

O uso dos campos personalizados permite armazenar os dados personalizados em relação à execução de teste e/ou ao resultado do teste. Pode haver até 100 campos personalizados definidos para um único projeto de Azure DevOps. O administrador do projeto pode gerenciar (adicionar/excluir) o conjunto de campos personalizados.

Pré-requisitos

Categoria Requisitos
Acesso ao Project Membro do projeto
Níveis de Acesso Pelo menos acesso básico para ver itens de trabalho relacionados ao teste. Usuários com acesso Stakeholder não podem acessar Azure Test Plans.

Para adicionar planos de teste e conjuntos de testes, excluir artefatos de teste ou definir configurações de teste, você precisa de acesso Basic + Planos de Teste ou de uma assinatura do Visual Studio: Enterprise, Test Professional ou MSDN Platforms.
Permissões Caminho da área:
- Edite itens de trabalho neste nó: Adicionar ou modificar planos de teste, conjuntos de testes, casos de teste ou outros itens de trabalho baseados em teste.
- Gerenciar planos de teste: modifique as propriedades do plano de teste, como configurações de build e teste.
- Gerenciar conjuntos de testes: crie e exclua conjuntos de testes, adicione e remova casos de teste de conjuntos de testes, altere as configurações de teste e mova os conjuntos de testes.

Project-level:
- Gerenciar configurações de teste e gerenciar ambientes de teste: gerenciar configurações de teste ou ambientes de teste.
- Excluir permanentemente itens de trabalho: exclua permanentemente itens de trabalho baseados em teste.

Para obter mais informações, consulte Acesso e permissões de teste manual.

Gerenciar os campos personalizados

Existem duas maneiras de gerenciar os campos personalizados: através da API REST ou o administrador do projeto pode fazer isso nas Configurações do Projeto ao escolher Gerenciamento de Testes em Pipelines. Nessa página, um novo campo personalizado pode ser adicionado clicando no botão + Adicionar novo .

Captura de tela das configurações do projeto com as configurações de gerenciamento de teste selecionadas e o botão para adicionar um novo campo personalizado marcado por um retângulo vermelho.

Escolha + Adicionar novo para adicionar um novo campo personalizado. Cada campo customizado deve ter um nome, tipo configurado e indicar a que tipo de artefato ele se aplica.

Captura de tela de uma caixa de diálogo usada para adicionar um novo campo personalizado.

O nome do campo personalizado não pode ter mais de 50 caracteres (espaços, números e caracteres especiais não são permitidos) e deve ser exclusivo no projeto. Os nomes não diferenciam maiúsculas de minúsculas, portanto, você não pode ter um campo personalizado chamado "Teste" e o outro chamado "teste". Tipo pode ser um dos seguintes:

  • bit
  • Datetime
  • Int
  • Float
  • String
  • Guid

Os campos personalizados existentes podem ser editados (somente o nome pode ser alterado) ou removidos.

Observação

Depois de remover o campo personalizado, você não poderá usar seu nome por cerca de um dia. O processo em segundo plano que está removendo os campos personalizados excluídos permanentemente é executado uma vez por dia.

Armazenar dados personalizados em campos personalizados

Você pode armazenar seus dados personalizados nos campos personalizados configurados como parte da criação da execução de teste/resultado ou após a criação da execução/resultado de teste. Ambos podem ser feitos usando a API REST por enquanto. No futuro, permitiremos que os dados personalizados sejam coletados do arquivo de resultados do teste. Para obter os valores armazenados em seus campos personalizados para a execução/resultado de teste existente, você deve usar a API REST. No momento, não exibimos os campos e valores personalizados armazenados neles na interface do usuário do Azure DevOps (adicionaremos essa capacidade no futuro).

Quando você está criando a execução de teste e/ou o resultado por meio da API REST e deseja armazenar dados personalizados no campo personalizado existente, a melhor opção para você é enviar os dados personalizados como parte da execução de teste e/ou da criação do resultado. Para criar uma execução de teste, chame a API REST Runs - Criar e para criar o resultado do teste, chame a API REST Resultados - Adicionar.

Quando a execução de teste e/ou o resultado não é criado por meio da API REST, mas por outros meios, você deve primeiro encontrar a identificação da execução de teste ou do resultado para o qual deseja definir (ou atualizar) os dados personalizados nos campos personalizados e, em seguida, chamar Execuções da API REST - Atualizar para a execução de teste e Resultados da API REST - Atualizar para o resultado do teste.

Para recuperar os dados personalizados dos campos personalizados armazenados anteriormente em relação à execução de teste e ao resultado, você deve primeiro encontrar a identificação da execução de teste ou do resultado. Em seguida, você pode chamar Execuções da API REST - Consultar para a execução de teste e Resultados da API REST - Obter para o resultado do teste.

Os dados personalizados para os campos personalizados são enviados ou recebidos em uma matriz. Cada item dessa matriz contém duas propriedades "fieldname" e "value" e você pode ver um exemplo disso aqui. O valor é o objeto do tipo que corresponde ao tipo configurado para o campo personalizado. Para entender o tipo do campo personalizado, você pode usar a API REST que fornece a matriz dos campos personalizados. Para cada campo, você pode encontrar seu ID, nome, tipo e escopo. Você também pode codificar o tipo se souber qual é o tipo do campo personalizado do nome fornecido.