Partilhar via

Campos personalizados

  • Artigo

Serviços de DevOps do Azure

O uso dos campos personalizados permite armazenar os dados personalizados em relação à execução do 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 - via API REST ou o administrador do projeto pode fazer isso por meio das configurações do projeto 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 retângulo vermelho.

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

Captura de ecrã de uma caixa de diálogo utilizada 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 "Test" e o outro chamado "test". O tipo pode ser um dos seguintes:

  • Pouco
  • DateTime
  • Int
  • Float
  • String
  • GUID

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

Nota

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

Armazenar dados personalizados em campos personalizados

Você pode armazenar seus dados personalizados nos campos personalizados configurados como parte da execução de teste/criação de resultados ou depois que a execução/resultado do teste foi criada. 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ê estiver criando execução de teste e/ou resultado via API REST e quiser 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 criação de resultados. Para criar uma execução de teste, chame REST API Runs - Create and to create test result call REST API Results - Add.

Quando a execução e/ou o resultado do teste não são criados via API REST, mas por outros meios, você deve primeiro encontrar a identificação da execução ou resultado do teste para o qual deseja definir (ou atualizar) os dados personalizados nos campos personalizados e, em seguida, chamar REST API Runs - Update for the test run e REST API Results - Update for the test result.

Para recuperar os dados personalizados dos campos personalizados armazenados anteriormente em relação à execução e/ou resultado do teste, você deve primeiro encontrar a identificação da execução ou resultado do teste. Em seguida, você pode chamar REST API Runs - Query para a execução de teste e REST API Results - Get 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 de campo personalizado, convém usar a API REST que fornece a matriz dos campos personalizados. Para cada campo pode encontrar o seu ID, nome, tipo e âmbito. Você também pode codificar o tipo se souber qual é o tipo do campo personalizado do nome próprio.