Importação ou exportação em massa de casos de teste

2025-02-11

Azure DevOps Services

Os usuários dos Planos de Teste do Azure podem importar ou exportar casos de teste em massa usando formatos de arquivo do CSV ou do Microsoft Excel. A operação de importação dá suporte à criação de novos casos de teste em um determinado conjunto de testes ou atualiza casos de teste existentes fornecendo a ID do caso de teste. A operação de exportação permite que os usuários exportem casos de teste para o arquivo CSV ou do Microsoft Excel (XLSX). Embora você possa continuar a usar a importação e as atualizações em massa, você pode usar a funcionalidade nativa baseada no portal da Web para copiar, clonar e atualizar os casos de teste. Para obter mais informações, consulte Copiar ou clonar planos de teste, conjuntos de testes e casos de teste.

Para obter uma visão geral de objetos de teste e terminologia, consulte Testar objetos e termos.

Pré-requisitos

Categoria	Requisito
Acesso ao Projeto	Membro do projeto.
Níveis de Acesso	Para solicitar ou fornecer feedback: pelo menos acesso de Stakeholder.
Permissões	- Para adicionar ou modificar bugs ou outros tipos de item de trabalho: Editar itens de trabalho neste nó permissão definida para Permitir no caminho de área correspondente . - Para adicionar novas marcações: permissão Criar definição de marcação definida como Permitir. Para obter mais informações, consulte Definir permissões e acesso para testar.

Exportar casos de teste

Na página Planos de Teste>, escolha o plano de teste com o conjunto de testes que contém os casos de teste que você deseja exportar.
(Opcional) Selecione Opções de coluna para adicionar campos a serem incluídos no arquivo de download.
Para exportar todos os casos de teste para a suíte de testes, selecione Exportar casos de teste para CSV ou Exportar casos de teste paraXLSX.
Para exportar um subconjunto de casos de teste do test suite, selecione os casos de teste a serem exportados, escolha Mais opçõese selecione Exportar caso(s) de teste para CSV ou Exportar caso(s) de teste para XLSX.
O arquivo CSV exportado aparece em sua pasta Downloads.

Importar casos de teste

Na página Planos de Teste>Planos de teste, escolha o plano de teste com o pacote de testes para o qual você deseja importar os casos de teste.
Escolha o arquivo a ser importado na caixa de diálogo que é aberta e escolha Importar.
Escolha Confirmar na caixa de diálogo Confirmar importação exibida. Se você especificar casos de teste que já estão definidos no conjunto de testes, alguns elementos poderão ser substituídos durante a importação.

Atualizar casos de teste existentes

Para atualizar itens de trabalho, crie uma exibição de coluna que contenha todas as colunas que você deseja exportar e, possivelmente, edite. Após aplicar colunas relevantes à sua visualização, você deve exportar os casos de teste para um arquivo CSV ou XLSX. Selecione Exportar para o CSV ou exportar para o XLSX para salvar o arquivo no computador local.
Edite os casos de teste. Você não deve alterar os campos de ID e de tipo de item de trabalho . Todos os outros campos que você deseja incluir são opcionais.
Salve o arquivo e importe-o de volta para o pacote de testes (consulte a seção sobre importação).

Importar casos de teste automatizados (TCM)

Para importar casos de teste automatizados para um conjunto de testes, use tcm testcase /import. Você deve especificar um arquivo .dll para o assembly de teste que contém seus testes.

tcm testcase /import /collection:teamprojectcollectionurl /teamproject:project
             /storage:path
             [/maxpriority:priority]
             [/minpriority:priority]
             [/category:filter]
             [/syncsuite:id [/include]]
             [/login:username,[password]]

Parâmetro	Descrição
/storage:`path`	Especifica o caminho e o nome do assembly de teste que contém seus testes automatizados que você deseja importar.
/maxpriority:`priority`	Opcional. Especifica quais testes importar com base na prioridade máxima do método de teste. Por exemplo, se o parâmetro for `/maxpriority:1`, somente os testes com um atributo de prioridade para o método de teste menor ou igual a 1 serão importados como casos de teste do assembly.
/minpriority:`priority`	Opcional. Especifica quais testes importar com base na prioridade mínima do método de teste. Por exemplo, se o parâmetro for `/minpriority:2`, somente os testes com um atributo de prioridade para o método de teste igual ou maior que 2 serão importados como casos de teste do assembly.
/category:`filter`	Opcional. Especifica quais testes importar com base na categoria de cada método de teste no assembly de teste. Você pode usar esse parâmetro junto com `/syncsuite` para importar testes com uma determinada categoria em um conjunto de testes específico. Para obter mais informações sobre categorias de teste, consulte Executar testes de unidade com o Gerenciador de Testes.
/syncsuite:`id`	Opcional. Especifica a ID do pacote de testes no plano de teste ao qual você deseja adicionar os casos de teste importados. Este pacote não pode ser um pacote dinâmico ou um pacote baseado em consulta. Se você especificar uma suíte de testes para sincronizar para atualizar testes, os testes sem suporte serão removidos da suíte de testes, mas não dos próprios planos de teste.

Perguntas frequentes

P: Posso importar novos casos de teste e atualizar casos existentes no mesmo arquivo CSV/XLSX?

R: Absolutamente! Deixe o campo ID do caso de teste vazio para os novos itens de trabalho. Para casos de teste existentes que você deseja atualizar, forneça os respectivos valores "ID do caso de teste" e "Tipo de item de trabalho".

P: Como saber se meu arquivo importado tem erros?

Quaisquer problemas com a formatação do arquivo CSV/XLSX aparecem na visualização de importação no portal web. Não é possível importar os itens de trabalho até que a formatação e a sintaxe estão corretas.

Captura de tela da caixa de diálogo de erro ao importar casos de teste.

P: A operação de importação dá suporte a todos os tipos de item de trabalho?

R: Não, não há suporte para todos os itens de trabalho. A importação de caso de teste só dá suporte aos seguintes tipos de item de trabalho:

Caso de teste

Importante para referenciar etapas compartilhadas em caso de teste usando a funcionalidade de importação:

Um item de trabalho de etapas compartilhadas já deve existir e sua ID pode ser referenciada no CSV. A funcionalidade de importação CSV ou XLSX não dá suporte à criação de um novo item de trabalho de etapas compartilhadas se ele for referenciado sem uma ID e a importação falhará com um erro de "coluna inválida".
Você pode criar um novo item de trabalho com etapas compartilhadas na interface do usuário de um item de trabalho de caso de teste e usar a opção para criar etapas compartilhadas nele.
Depois que o item de trabalho de etapas compartilhadas for criado, você poderá consultar a ID da etapa compartilhada no CSV.

Captura de tela da referência de etapa compartilhada em CSV.

Observe que, se a referência de item de trabalho de etapas compartilhadas for fornecida junto com as etapas no CSV ou XLSX, ela atualizará o item de trabalho de etapas compartilhadas. Portanto, se você quiser fornecer apenas uma referência às etapas compartilhadas, não adicione etapas a ela no CSV ou XLSX.

O Azure Boards tem uma funcionalidade de importação em massa separada usando arquivos CSV. Para obter mais informações, consulte Importar ou atualizar em massa (CSV).

P: Quais são os cabeçalhos obrigatórios a serem incluídos no arquivo Import CSV/XLSX?

R: Verifique se cada arquivo de importação tem os seguintes cabeçalhos (com a ortografia exata):

ID: a ID do item de trabalho que você está tentando importar. Para a criação de novos casos de teste, deixe esse campo em branco.
Tipo de Item de Trabalho: o método de importação de casos de teste dá suporte apenas a 'Caso de teste' e 'Etapas Compartilhadas'. Use essas palavras-chave exatas ao fornecer informações de tipo de item de trabalho.
Título: O título do caso de teste que você deseja criar ou atualizar, que pode ser um valor alfanumérico.
Etapa de Teste: as etapas definidas em um caso de teste estão em uma lista ordenada. Você precisa fornecer o número da ordem de cada etapa de teste.
Ação de Etapa: define as ações que um testador manual precisa realizar ao executar a etapa de teste.
etapa esperada: o resultado esperado de uma determinada ação.

P: Quais são as limitações para importar ou exportar operações?

R: Certifique-se de seguir as limitações abaixo:

A coluna de estado do caso de teste deve estar no estado Design.
O comprimento do título do caso de teste não deve exceder 128 caracteres.
Há um limite de 20 MB em objetos JSON criados durante a importação e exportação. Se a importação falhar, tente a operação com um pequeno subconjunto dos casos de teste.
O usuário que está executando a importação deve ter permissões nos caminhos da área e da iteração do plano de teste e do pacote de testes que está planejando importar ou exportar.
As operações Copiar e Importar falharão se a contagem de vínculos relacionadas exceder 1000 para o caso de teste.

Próximas etapas

executar testes manuais