Campos personalizados

Azure DevOps Services

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 de DevOps do Azure. 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 Project ao escolher Gerenciamento de teste em Pipelines. Nessa página, um novo campo personalizado pode ser adicionado clicando no botão + Adicionar novo .

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 ele se aplica.

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". 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 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 resultado ou depois que a execução/resultado de 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 personalizados e os valores armazenados neles na interface do usuário do Azure DevOps (adicionaremos essa capacidade no futuro).

Quando você estiver criando a execução de teste e/ou o 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 chamada de execução de teste, Execuções da API REST - Criar e criar resultados de teste, chame Resultados da API REST - Adicionar.

Quando a execução de teste e/ou o resultado não é criado via API REST, mas por outros meios, você deve primeiro encontrar a identificação da execução ou resultado de teste para o qual deseja definir (ou atualizar) os dados personalizados nos campos personalizados e, em seguida, chamar Execuções da API REST - Atualização para a execução de teste e Resultados da API REST - Atualização 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 localizar a identificação da execução ou resultado do teste. Em seguida, você pode chamar REST API Runs - Query for the test run 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 é objeto do tipo que corresponde ao tipo configurado para o campo personalizado. Para entender o tipo do campo personalizado, convém usar a API REST que fornece a matriz dos campos personalizados. Para cada campo você pode encontrar lá seu ID, nome, tipo e escopo. Você também pode codificar o tipo se souber qual é o tipo do campo personalizado de nome próprio.