Compartilhar via

Campos personalizados

  • Artigo

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 do Azure DevOps. O administrador do projeto pode gerenciar (adicionar/excluir) o conjunto de campos personalizados.

Gerenciar os campos personalizados

Há duas maneiras de gerenciar os campos personalizados: por meio da API REST ou do administrador do projeto, o administrador pode fazer isso por meio das configurações do Project ao escolher Gerenciamento de teste 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 personalizados e os valores 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/ou resultado, você deve primeiro encontrar a identificação da execução de teste ou 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.