Copiar ou clonar os planos de teste, os conjuntos de testes e os casos de teste

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Há várias ferramentas que fornecem suporte a operações de cópia, clonagem ou importação de itens de teste, como os planos de teste, os conjuntos de testes e os casos de teste. Os casos de teste descrevem as etapas que devem ser seguidas a fim de executar um teste e validar uma implementação de recurso ou correção de bug. Os conjuntos de testes agrupam os casos de teste e, opcionalmente, outros conjuntos de testes, em uma ordem específica. Os planos de teste definem uma coleção de conjuntos de testes que devem ser executados para uma iteração ou liberação específica.

Cada caso de teste é elaborado para confirmar um comportamento específico. Os casos de teste podem pertencer a um ou mais conjuntos de testes; no entanto, os conjuntos de testes podem pertencer apenas a um plano de teste.

Em geral, você deve criar um plano de teste para cada marco importante do projeto. As operações para copiar, clonar ou importar os itens de teste fornecem suporte aos cenários a seguir.

Definir um plano de teste para um novo sprint ou versão com base em um plano de teste existente
Importar os conjuntos de testes de um plano de teste para outro plano de teste dentro do mesmo projeto ou de outro projeto
Copiar casos de teste para usar em diferentes conjuntos de testes e planos de teste
Compartilhar os objetos de teste entre projetos
Mover os objetos de teste de um projeto para outro, possivelmente para fornecer suporte à consolidação dos projetos em um único projeto

Para obter mais informações, consulte Visão geral de termos e objetos de teste.

Pré-requisitos

Categoria	Requisitos
Níveis de Acesso	- Pelo menos acesso Básico, com permissões para exibir itens de trabalho no Caminho da Área correspondente. – Para adicionar planos de teste e pacotes de teste, exclua os artefatos de teste e defina as configurações de teste: acesso Básico + Planos de Teste. Ou uma das seguintes assinaturas do Visual Studio : - Empresa - Profissional de Teste - Plataformas MSDN
Permissões	- Para adicionar ou modificar planos de teste, conjuntos de teste, casos de teste ou outros tipos de itens de trabalho baseados em teste: a permissão de edição de itens de trabalho nesse nó está definida como Permitir no Caminho de Área correspondente . - Para modificar as propriedades do plano de teste, como as configurações de compilação e de teste: defina a permissão Gerenciar planos de teste como Permitir no Caminho da Área correspondente. – para criar e excluir conjuntos de testes, adicionar e remover casos de teste de conjuntos de testes, alterar as configurações de teste associadas a conjuntos de testes e organizar uma hierarquia de conjuntos de testes (mover um conjunto de testes): Gerenciar conjuntos de testes permissão definida como Permitir sob o Caminho de Áreacorrespondente.

Categoria

Requisitos

Níveis de Acesso

- Pelo menos acesso Básico, com permissões para exibir itens de trabalho no Caminho da Área correspondente.
– Para adicionar planos de teste e pacotes de teste, exclua os artefatos de teste e defina as configurações de teste: acesso Básico + Planos de Teste.
Ou uma das seguintes assinaturas do Visual Studio :
- Empresa
- Profissional de Teste
- Plataformas MSDN

Permissões

- Para adicionar ou modificar planos de teste, conjuntos de teste, casos de teste ou outros tipos de itens de trabalho baseados em teste: a permissão de edição de itens de trabalho nesse nó está definida como Permitir no Caminho de Área correspondente .
- Para modificar as propriedades do plano de teste, como as configurações de compilação e de teste: defina a permissão Gerenciar planos de teste como Permitir no Caminho da Área correspondente.
– para criar e excluir conjuntos de testes, adicionar e remover casos de teste de conjuntos de testes, alterar as configurações de teste associadas a conjuntos de testes e organizar uma hierarquia de conjuntos de testes (mover um conjunto de testes): Gerenciar conjuntos de testes permissão definida como Permitir sob o Caminho de Áreacorrespondente.

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

Pré-requisitos para a ferramenta de linha de comando do TCM

Categoria Requisitos

Ferramentas Visual Studio 2017 Professional ou versão anterior. Acesse o TCM pelo prompt de comando e os seguintes diretórios:
- %programfiles(x86)%\Microsoft Visual Studio\2017\Professional\Common7\IDE
- %programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE
- %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
– Para executar um comando TCM, especifique os parâmetros /collection e /teamproject e /login conforme necessário. Veja também a tabela a seguir de parâmetros obrigatórios e opcionais.

Níveis de Acesso - Vínculo válido com um ou mais projetos que você deseja acessar e as permissões necessárias com base nos comandos que você executa. Para obter mais informações, consulte Acesso e permissões de teste manual.
- Mesmos níveis de acesso para adicionar planos de teste e pacotes de teste para clonar ou importar objetos de teste.

Categoria	Requisitos
Ferramentas	Visual Studio 2017 Professional ou versão anterior. Acesse o TCM pelo prompt de comando e os seguintes diretórios: - `%programfiles(x86)%\Microsoft Visual Studio\2017\Professional\Common7\IDE` - `%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE` - `%programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE` – Para executar um comando TCM, especifique os parâmetros `/collection` e `/teamproject` e `/login` conforme necessário. Veja também a tabela a seguir de parâmetros obrigatórios e opcionais.
Níveis de Acesso	- Vínculo válido com um ou mais projetos que você deseja acessar e as permissões necessárias com base nos comandos que você executa. Para obter mais informações, consulte Acesso e permissões de teste manual. - Mesmos níveis de acesso para adicionar planos de teste e pacotes de teste para clonar ou importar objetos de teste.

Parâmetro	Descrição
/collection`:CollectionURL`	Obrigatório. Especifica o URI da coleção de projetos de equipe. O formato do URI é o seguinte: - Para o Azure DevOps Services: `http://dev.azure.com/OrganizationName` - Para o Azure DevOps Server: `http://ServerName:Port/VirtualDirectoryName/CollectionName`. Se nenhum diretório virtual for usado, o formato do URI será o seguinte:`http://ServerName:Port/CollectionName`.
/teamproject:`project`	Obrigatório. O nome do projeto que contém os objetos de teste que você quer clonar ou para os quais quer importar os testes automatizados.
/login:`username,[password]`	Opcional. Especifica o nome e a senha de um usuário válido do Azure DevOps e quem tenha as permissões para executar o comando. Use essa opção se suas credenciais do Windows não tiverem as permissões apropriadas, se você estiver usando a autenticação básica ou se não estiver conectado a um domínio.

Ferramentas compatíveis para copiar, clonar e importar

Dependendo da versão do Azure DevOps que usa, você pode utilizar os clientes ou ferramentas listados na tabela a seguir para copiar, clonar ou importar os planos de teste, os conjuntos de testes ou os casos de teste.

Cliente/ferramenta

#Planos de Teste

Conjuntos de Testes

Casos de Teste

Portal da Web¹

✔️ Copiar

✔️ Importar

✔️ Copiar ✔️ Exportar/importar em massa

Portal da Web (Grade)

✔️ Copiar e colar

Formulário de item de trabalho

✔️ Copiar

CLI do TCM²

✔️ Clone

✔️ Importação automatizada

API REST³

✔️ Clone

Observação

Com o lançamento do Azure DevOps Server 2020, o portal da Web do Azure Test Plans foi atualizado de forma substancial. Muitos novos recursos foram adicionados para oferecer suporte para fins de copiar, clonar, importar e exportar. Para obter uma visão geral, consulte Navegar pelos planos de teste.
A ferramenta de linha de comando do TCM (Gerenciamento de Casos de Teste) é instalada quando você instala o Visual Studio 2017 ou versões anteriores. Os exemplos fornecidos neste artigo refletem as opções disponíveis com a versão do Visual Studio 2017. Versões anteriores podem fornecer suporte a um número menor de opções. Para obter detalhes, consulte Trabalhar com a ferramenta de linha de comando do TCM..
Os comandos da API REST para fornecer suporte a clonagem de planos de teste e conjuntos de testes foram adicionados com a versão 5.0, correspondente ao Azure DevOps 2019.

Listar planos de teste ou conjuntos de testes

Quando você executa operações de cópia, clonagem ou importação relacionadas a planos de teste ou conjuntos de testes, é essencial ter acesso à ID exclusiva. Esse identificador permite que você direcione com precisão o plano ou conjunto específico com o qual quer trabalhar. Ao saber a ID atribuída, você pode simplificar os processos de teste e garantir a replicação ou a transferência precisa dos dados relacionados ao teste.

Navegador
TCM CLI

Execute as etapas a seguir para gerar uma lista de planos de teste, conjuntos de testes ou outros objetos de teste.

Selecione Quadros>Consultas, no seu projeto.
Insira o parâmetro Work Item Type=Test Plan no Editor de consultas. Você pode listar todos os planos de teste definidos para o projeto de equipe.
Marque a caixa de seleção Consulta entre vários projetos. A consulta lista todos os planos de teste definidos para todos os projetos. Para obter mais informações, confira Definir uma consulta de item de trabalho.
Execute a consulta.

Dica

Embora os planos de teste, os conjuntos de testes e os casos de teste estejam relacionados entre si, você não pode exibir as relações por meio de uma consulta de item de trabalho. Os tipos de link não vinculam os planos de teste, os conjuntos de testes e os casos de teste. Somente as etapas e os parâmetros compartilhados são vinculados aos casos de teste. Além disso, os casos de teste são vinculados às histórias dos usuários ou a outros itens de trabalho que eles testarem.

Captura de tela que mostra o Editor de Consultas.

O TCM tem suporte para listagem de planos de teste e conjuntos de testes. As listas especificam a ID de trabalho para cada plano de teste ou conjunto de testes. Essa ID é a mesma que uma ID de plano ou de conjunto.

Listar planos de teste | Listar conjuntos de testes

Listar planos de teste

Use tcm plans /list para determinar a ID de um plano de teste. A ID corresponde à ID do item de trabalho definido quando o plano de teste foi criado.

tcm plans /list [/planid:id  |  /querytext:query] /collection:teamprojectcollectionurl
           /teamproject:project [/login:username,[password]]

Parâmetro	Descrição
/querytext:`query`	Opcional. Especifica a consulta que deve ser usada para listar um subconjunto de planos de teste.

Para obter as descrições dos parâmetros /collection, /teamproject e /login consulte Trabalhar com a ferramenta de linha de comando do TCM.

Exemplo

O comando a seguir lista os planos de teste definidas do projeto Fabrikam Fiber hospedado na organização fabrikamprime. A ID e o Nome correspondem à ID e ao Título do item de trabalho definidos para o plano de teste. Por exemplo, o plano de teste 86 tem o título Hello World Test.

tcm plans /list /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber"

Id        Name
------***----------------------------------------------------------------
66        Sprint 1
72        All sprints
77        Sprint 2
86        Hello World Test

Listar conjuntos de testes

Use tcm suites /list para listar os conjuntos de testes com suas IDs de itens de trabalho. Quando nenhum parâmetro opcional é especificado, todas os conjuntos de testes são listados para o projeto de equipe.

tcm suites /list [/planid:id  |  /querytext:query] /collection:teamprojectcollectionurl
           /teamproject:project [/login:username,[password]]

Parâmetro	Descrição
/planid:`id`	Opcional. Especifica a ID do plano para fazer referência aos conjuntos de testes que devem ser listados.
/querytext:`query`	Opcional. Especifica a consulta que deve ser usada para listar um subconjunto de conjuntos de testes.

Para obter as descrições dos parâmetros /collection, /teamproject e /login consulte Trabalhar com a ferramenta de linha de comando do TCM.

Exemplo

O comando a seguir lista os conjuntos de testes definidos do projeto Fabrikam Fiber hospedado na organização fabrikamprime. A ID corresponde à ID do item de trabalho definido para o conjunto de testes. Na coluna Nome, a primeira entrada indica o plano de teste sob o qual o conjunto de testes está definido. Após - > (seta) está o Título do conjunto de testes ou o Título de um conjunto de testes pai. Por exemplo, o conjunto de testes 75, Sub-conjunto 01, é um conjunto de subtestes do Conjunto 01 definido para o plano de teste Todos os sprints .

tcm suites /list /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber" 

Id        Name
------***----------------------------------------------------------------
67        Sprint 1
68        Sprint 1 -> 33 : Change initial view
69        Sprint 1 -> 34 : Welcome back page
70        Sprint 1 -> 43 : Cancel order form
73        All sprints
74        All sprints -> Suite 01
75        All sprints -> Suite 01 -> Sub Suite 01
78        Sprint 2
87        Hello World Test

Copiar ou clonar os planos de teste

Quando você cria um novo plano de teste por sprint ou versão, uma abordagem útil é clonar o plano de teste do ciclo anterior. Com ajustes mínimos, o plano de teste copiado se torna adequado ao novo ciclo. Essa prática simplifica o processo de planejamento e assegura a consistência entre as iterações.

Clonar é especialmente útil quando você precisa ramificar o aplicativo em duas versões. Depois de clonar, você pode modificar os testes de forma independente para cada versão sem afetar a outra. É uma maneira eficiente de gerenciar os esforços de teste, o que mantém a separação entre as diversas variantes de aplicativos.

Imagem conceitual, clonar plano de teste.

Navegador
TCM CLI

Selecione Test Plans>Planos de teste no projeto.
Escolha o plano de teste que deseja copiar na página Meus ou Todos.
Selecione Mais ações>Copiar plano de teste. Essa opção permite copiar ou clonar os planos de teste em um projeto.
Especifique o nome do novo plano de teste e selecione um Caminho de Área e Caminho de Iteração do plano.
- Escolha um ou outro botão de opção com base nas seguintes orientações:
  - Fazer referência aos casos de teste: escolha essa opção quando você planejar mesclar as duas ramificações eventualmente. Nesse caso, mantenha os mesmos requisitos de funcionalidade que já estiver implementada e testada.
  - Casos de teste duplicados: escolha essa opção quando quiser criar novos casos de teste mantidos separadamente, observe que os novos casos de teste serão vinculados aos requisitos.
Se você duplicar os casos de teste existentes, os casos de teste copiados receberão o Caminho da Área e o Caminho da Iteração especificados para o plano de teste clonado.

Para obter mais informações, confira Sobre caminhos de área e de iteração (sprint).

A página é atualizada para exibir o plano de teste recém-copiado.
Atualize todos os conjuntos baseados em consulta que você copiou para usar os novos caminhos de área e iteração.
Especifique um build no plano de teste de destino se você tiver clonado casos de teste automatizados.

Você pode usar a ferramenta de linha de comandos do TCM para clonar um plano de teste para o mesmo projeto ou para um outro projeto e para rastrear o status da operação de clonagem.

Listar planos de teste | Clonar um plano de teste | Rastrear status de clonagem do plano de teste

Clonar um plano de teste

Use tcm plans /clone para iniciar uma operação de clonagem de todos os casos de teste direto de um conjunto de testes para outro conjunto de destino dentro do mesmo projeto. O conjunto de destino deve estar definido e existir em um plano diferente. Todos os conjuntos e casos de teste contidos são clonados. O comando pode retornar uma ID de operação que você pode usar para rastrear o status e a conclusão da operação de clonagem. Quando a operação de clonagem for concluída rapidamente, nenhuma ID de operação será retornada.

tcm plans /clone /sourceplanid:id /destinationplanname:name
          [/overridefield:name=value [/overridefield:name=value ...]]
          [/sourcesuiteids:suiteid1,[suiteid2,...]]
          /collection:teamprojectcollectionurl /teamproject:project
          [/login:username,[password]]
          [/clonerequirements]
          [/clonechildren]

O /clone /sourceplanid /destinationplanname cria um novo plano. Se você especificar /sourcesuiteids, o comando iniciará uma operação de clonagem a fim de clonar os casos de teste para o novo plano. O comando retorna uma ID de operação que pode ser usada para rastrear o status e a conclusão da operação de clonagem.

Parâmetro	Descrição
/sourceplanid:`id`	Obrigatório. Especifica a ID do plano que deve ser copiada e a ID do conjunto no qual a nova cópia será adicionada. Se você quiser copiar um plano de teste inteiro, use a ID do conjunto na raiz do plano de teste. A ID de um conjunto é exibida no painel de detalhes quando você o seleciona no plano de teste. Você também pode obter uma lista de conjuntos usando `tcm suites /list`.
/destinationplanname:`name`	Especifica o nome do plano no qual o plano de teste clonado é copiado.
/overridefield:`name=value` /overridefield:`name=value`	Opcional. Especifique para alterar o valor de um campo em cada item de trabalho clonado. Especifique as diversas ocorrências desse parâmetro para alterar o número de campos que desejar. Essa opção é necessária quando você clona um conjunto de testes para outro projeto.
/sourcesuiteids:`suiteid1,[suiteid2,...`	Opcional. Especifica os conjuntos de testes de origem no plano de teste que devem ser copiados.
/clonerequirements	Opcional. Especifica a clonagem de itens de trabalho de categoria de requisitos que são anexados aos conjuntos de testes baseados em requisitos. Se você omitir esse parâmetro, os conjuntos de testes com base nos requisitos serão convertidos em conjuntos estáticos.
/clonechildren	Opcional. Especifique para clonar todos os conjuntos filhos dos conjuntos fornecidos.
/clonerequirements	Opcional. Especifique essa opção para clonar um conjunto baseado em requisitos para um conjunto baseado em requisitos de destino. Por padrão, um conjunto de testes com base nos requisitos é clonado em um conjunto de testes estático de destino. Só é possível especificar essa opção quando há a definição de `/sourcesuiteids`.

Para obter as descrições dos parâmetros /collection, /teamproject e /login consulte Trabalhar com a ferramenta de linha de comando do TCM.

Exemplo

O exemplo a seguir clona o plano de teste 66 em um novo plano de teste intitulado Plano de teste, Versão 3, que recebe a ID 118.

tcm plans /clone /sourceplanid:66 /destinationplanname:"Test plan, Release 3" /overridefield:"Iteration Path"="Fabrikam Fiber\Release 3" /overridefield:"Area Path"="Fabrikam Fiber\Web" /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber"
Plan created with ID: 118

Clone operation is complete.

Rastrear o status da operação de clonagem do plano de teste

Use tcm plans /clone /status para recuperar o status da operação de clonagem feita com tcm suites /clone. Os conjuntos de testes que contêm um grande número de casos de teste podem levar um tempo considerável para serem clonados.

tcm plans /clone
           /status:cloneoperationid
           /collection:teamprojectcollectionurl /teamproject:project
           [/login:username,[password]]

Parâmetro	Descrição
/status:`cloneoperationid`	Obrigatório. Especifica a ID da operação de clonagem retornada quando há a execução de `tcm plans /clone`.

Para obter as descrições dos parâmetros /collection, /teamproject e /login consulte Trabalhar com a ferramenta de linha de comando do TCM.

Importar ou clonar os conjuntos de testes

Quando cria o plano de teste para um novo sprint, você geralmente quer repetir alguns dos testes de sprints anteriores, a fim de assegurar que a funcionalidade que você já implementou ainda funcione.

Imagem conceitual, copiar conjuntos de testes.

Observação

Quando você importar (Web) ou clona (TCM) um conjunto de testes para um novo projeto, o novo conjunto conterá as cópias de todos os casos de teste no conjunto de código-fonte. No entanto, ele não reterá nenhum dado histórico, como a execuções de teste anteriores, os bugs relacionados, os resultados antigos.
As etapas compartilhadas referenciadas pelos casos de teste também serão clonadas e criadas no projeto de destino.
Não é possível clonar casos de teste de e para o mesmo plano de teste, mesmo em um conjunto diferente. Para alcançar esse cenário, você deve primeiro mover os casos de teste para outro plano de teste temporário. Em seguida, use o plano de teste temporário como o plano de origem e clone os casos de teste de volta para o plano de teste de origem, inserindo a ID no local do plano de teste de destino. As etapas compartilhadas presentes nos casos de teste também serão duplicadas nesse processo.

Quando trabalhar com o Azure Test Plans, você poderá importar um conjunto de testes de um plano de teste para outro plano de teste no projeto atual. Não importa se os planos de teste estão no mesmo projeto. Esse processo envolve copiar ou clonar o conjunto de testes, o que resulta na criação de um novo conjunto de testes. Além disso, todos os conjuntos de subtestes também são duplicados. Os casos de teste referenciados pelos conjuntos de testes não são duplicados, contudo, eles são referenciados pelos conjuntos de testes clonados.

Você pode usar tcm suites /list para listar todos os conjuntos de testes definidos para um projeto.

Para usar os mesmos casos de teste em diferentes conjuntos e planos, copie e cole os casos de teste usando o modo de exibição Grade.

Navegador
TCM CLI

Selecione Test Plans>Planos de teste.
Escolha o plano de teste para o qual você deseja importar um conjunto de testes da página Meus ou Todos.
Selecione Mais ações>Copiar plano de teste. Essa opção permite copiar ou clonar os planos de teste em um projeto.
Na caixa de diálogo aberta, selecione o projeto se o plano de teste residir em um outro projeto. Caso contrário, insira o Nome ou a ID do Plano de Teste e o Nome ou a ID do Conjunto de Testes. Você também pode selecionar o nome ou a ID nos menus suspensos.
Crie a importação. Você só pode importar um conjunto de um plano de teste por vez.

A mensagem abaixo exibe:
Quando a operação de importação for concluída, a mensagem a seguir será exibida. Selecione Atualizar para atualizar o navegador.

É exibido o conjunto de testes recém-adicionado.

Você pode usar a ferramenta de linha de comandos do TCM para clonar um plano de teste para o mesmo projeto ou para um outro projeto e para rastrear o status da operação de clonagem.

Listar conjuntos de testes | Clonar um conjunto de testes | Rastrear status de clonagem do conjunto de testes

Clonar um conjunto de testes

Por padrão, use tcm suites /clone para iniciar uma operação de clonagem de todos os casos de teste direto de um conjunto de testes para outro conjunto de destino no projeto. O conjunto de destino deve estar definido e existir em um plano diferente. Todos os conjuntos e casos de teste contidos são clonados. O comando retorna uma ID de operação que você pode usar para rastrear o status e a conclusão da operação de clonagem.

As opções seguintes fornecem suporte para operações de clone opcionais:

/destinationteamproject: clone um conjunto para um projeto diferente.
/destinationworkitemtype: especifique o tipo de item de trabalho que deve ser usado quando se clona os casos de teste. Especifique essa opção quando for clonar os casos de teste em um tipo de item de trabalho personalizado.
/overridefield: substitua os valores de campos específicos, como Caminho da Área e Caminho de Iteração, o que é necessário ao clonar para um projeto diferente. Ou substitua o valor de outros campos para distinguir os casos de teste clonados direto do original.
/clonerequirements: especifique essa opção para clonar um conjunto baseado em requisitos para um conjunto baseado em requisitos de destino.

tcm suites /clone
           /suiteid:id /destinationsuiteid:id
           [/overridefield:name=value [/overridefield:name=value ...]]
           [/destinationteamproject:projectname]
           [/destinationworkitemtype:workitemtype]
           /collection:teamprojectcollectionurl /teamproject:project
           [/login:username,[password]] [/clonerequirements]

Parâmetro	Descrição
/suiteid:`id`	Especifica a ID do conjunto que deve ser copiado e a ID do conjunto no qual será adicionada a nova cópia. Se você quiser copiar um plano de teste inteiro, use a ID do conjunto na raiz do plano de teste. A ID de um conjunto é exibida no painel de detalhes quando você o seleciona no plano de teste. Você também pode obter uma lista de conjuntos usando `tcm suites /list`.
/overridefield:`name=value` /overridefield:`name=value`	Opcional. Especifique para alterar o valor de um campo em cada item de trabalho clonado. Especifique as diversas ocorrências desse parâmetro para alterar o número de campos que desejar. Essa opção é necessária quando você clona um conjunto de testes para outro projeto.
/destinationsuiteid:`id`	Especifica a ID do conjunto no qual será adicionada a nova cópia. Se você quiser copiar um plano de teste inteiro, use a ID do conjunto na raiz do plano de teste. A ID de um conjunto é exibida no painel de detalhes quando você o seleciona no plano de teste. Você também pode obter uma lista de conjuntos usando `tcm suites /list`.
/destinationteamproject:`projectname`	Opcional. Especifique quando deseja clonar o conjunto de testes para outro projeto, mas na mesma organização ou coleção de projetos. Quando especificado, você deve especificar valores de campo de substituição para os campos Caminho da Área e Caminho da Iteração.
/destinationworkitemtype:`workitemtype`	Opcional. Especifique quando você deseja clonar o conjunto de testes para outro tipo de item de trabalho no projeto de destino.
/clonerequirements	Opcional. Especifique essa opção para clonar um conjunto baseado em requisitos para um conjunto baseado em requisitos de destino. Por padrão, um conjunto de testes com base nos requisitos é clonado em um conjunto de testes estático de destino.

Para obter as descrições dos parâmetros /collection, /teamproject e /login consulte Trabalhar com a ferramenta de linha de comando do TCM.

Entender o que é clonado

Quando você clona um conjunto de testes, os objetos a seguir são copiados do plano de teste de origem para o plano de teste de destino.

Objeto do plano de teste	Observações
Caso de teste	Cada novo caso de teste mantém as etapas compartilhadas. É definido um link entre a origem e os novos casos de teste. Os novos casos de teste não têm execuções de teste, bugs, resultados de teste nem informações de build.
Etapas compartilhadas	As etapas compartilhadas referenciadas pelos casos de teste clonados são copiadas.
Conjunto de testes	Os conjuntos de testes que são copiados mantêm os seguintes dados: <br<br- Nomes e estrutura hierárquica dos conjuntos de testes<br- Ordem dos casos de testes<br- Testadores que receberam atribuição de casos de testes<br- Configurações
Gravações	As gravações de ação vinculadas de um caso de teste clonado são copiadas.
Links e anexos	Todos os links e anexos são copiados para todos os itens de teste que são copiados.
Configuração de teste	A configuração de teste que foi definida para o plano de teste de origem é copiada e aplicada ao plano de teste de destino.

As informações de teste abaixo não são copiadas:

Configurações de teste: a configuração de teste do plano de teste de origem não é copiada. Contudo, aplicam-se as configurações de teste do plano de teste de destino.
Execuções de teste e resultados de teste : nenhum resultado de teste é copiado. Como as execuções de teste se aplicam somente ao plano de teste de origem, elas não são copiadas.

Quando não se especifica /clonerequirements e os conjuntos de testes com base nos requisitos são copiados:

Os conjuntos de testes baseados em requisitos são copiados e vinculados a uma nova versão do item de trabalho de requisito.
Os itens de trabalho de requisitos (itens da lista de pendências do produto ou histórias de usuário) associados a um conjunto clonado baseado em requisitos são clonados.
Os itens de trabalho de Bug são clonados em um projeto que usa o modelo de processo Scrum ou em qualquer projeto no qual o tipo de item de trabalho de Bug esteja na categoria de item de trabalho Requisitos. Caso contrário, os bugs não são clonados.

Quando /clonerequirements não é especificado e quando os conjuntos de testes baseados em Requisitos são copiados:

Os conjuntos de testes com base nos requisitos são convertidos em conjuntos de testes estáticos no plano de teste de destino.
Os casos de teste clonados são referenciados no conjunto de testes estáticos.
Os casos de teste clonados não incluem links para seus itens de trabalho de requisitos originais.

Exemplo

O exemplo a seguir ilustra o conjunto de testes de clonagem97 definido para o projeto Fabrikam Fiber para o projeto Fabrikam Git. Como o conjunto de testes continha um conjunto que se baseava em consulta, uma mensagem de aviso foi listada para examinar e revisar a respectiva consulta nos conjuntos de testes de origem e destino.

tcm suites /clone /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber" /destinationteamproject:"Fabrikam Git" /suiteid:97 /destinationsuiteid:104 /overridefield:"Iteration Path"="Fabrikam Git" /overridefield:"Area Path"="Fabrikam Git"

Started clone operation with id 4.
Use /status:4 to get progress and completion information of the operation.
Warning: You have cloned the following query based suites as part of this clone operation. You are advised to fix their respective queries in the source and destination suites, after the clone operation completes.
1. Sprint 3 -> Sprint 3 query-based suite

Rastrear o status da operação de clonagem do conjunto de testes

Use tcm suites /clone /status para recuperar o status da operação de clonagem feita com tcm suites /clone. Os conjuntos de testes que contêm um grande número de casos de teste podem levar um tempo considerável para serem clonados.

tcm suites /clone
           /status:cloneoperationid
           /collection:teamprojectcollectionurl /teamproject:project
           [/login:username,[password]]

Parâmetro	Descrição
/status:`cloneoperationid`	Obrigatório. Especifica a ID da operação de clonagem retornada quando há a execução de `tcm suites /clone`.

Para obter as descrições dos parâmetros /collection, /teamproject e /login consulte Trabalhar com a ferramenta de linha de comando do TCM.

Exemplo

tcm suites /clone /status:4 /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber"

Clone operation 4 has succeeded. Summary information:
Started on:           10-Nov-21 5:00:28 PM
Started by:           Jamal Hartnett
Source suite id:      97
Destination suite id: 114
Test cases cloned:    9
Shared steps cloned:  0
Requirements cloned:  0
Completed on:         10-Nov-21 5:00:30 PM

Copiar caso de teste

No portal da Web, você pode copiar casos de teste de dentro de um projeto ou outro projeto para um conjunto de testes ou pode usar o modo de exibição Grade para copiar e colar casos de teste de um conjunto para outro. Opcionalmente, você pode importar e exportar casos de teste em massa.

Dica

Não copie os casos de teste quando quiser testar com outras configurações ou outros dados.

Você tem a flexibilidade de copiar os casos de teste de um projeto ou de outro projeto da organização ou coleção. Além disso, você pode optar por incluir todos os links e anexos durante o processo para copiar.

Selecione Test Plans>Planos de teste.
Escolha o Plano de Teste que contiver um ou mais casos de teste que você queira copiar da página Meus ou Todos.
Selecione um conjunto de testes que contenha um ou mais casos de teste que você queira copiar.
Na página Definir, marque a caixa de seleção para todos os casos de teste que você queira copiar.
Selecione Mais ações>Copiar caso de teste.
Escolha o Projeto no menu suspenso e depois insira o Nome ou a ID do Plano de Teste e o Nome ou a ID do Conjunto de Testes. Você também pode selecionar o nome ou a ID nos menus suspensos.
(Opcional) Marque as caixas de seleção para incluir links e incluir anexos.
Crie a cópia.

A operação de cópia em segundo plano depende da quantidade e da complexidade dos casos de teste que você tiver selecionado. Depois da conclusão, será enviada uma notificação para você confirmando o sucesso da operação junto com um link para o conjunto de testes no qual residem os casos de teste copiados.

Copiar e colar o caso de teste (modo de exibição Grade)

Quando você estiver gerenciando os casos de teste, copiar e colar serve como uma técnica valiosa para reutilizar os mesmos testes em vários conjuntos e planos. Por exemplo, considere um cenário em que você tem um conjunto de testes abrangente e quer criar um subconjunto de testes com maior foco em outro conjunto. O modo de exibição Definir>Grade oferece suporte tanto para a edição de casos de teste quanto para copiá-los para diferentes conjuntos de testes. Para obter mais informações, consulte Criar casos de teste, Usar o modo de exibição Grade para editar casos de teste.

Dica

Não copie os casos de teste quando quiser testar com outras configurações ou outros dados.

Nos navegadores Internet Explorer, Microsoft Edge ou Chrome, você pode copiar casos de teste do modo de exibição Grade de um plano de teste e um conjunto de testes para outro plano de teste e conjunto de testes.

Na página do Test Plans>Planos de teste, escolha o conjunto de testes que contiver um ou mais casos de teste que você queira copiar. Na guia Definir, selecione modo de exibição Grade.
Destaque as linhas que você queira copiar e digite CTRL+C.
Selecione um conjunto de testes diferente do mesmo plano ou de um plano diferente e cole usando CTRL+V. Se você não selecionar outro conjunto, nada acontecerá quando você colar, pois cada conjunto só pode ter apenas uma referência a qualquer caso de teste.
Escolha Salvar casos de teste.

Os novos casos de teste são salvos com novas IDs atribuídas.

Importar ou exportar casos de teste em massa

No portal da Web, você pode executar uma importação ou exportação em massa dos casos de teste de/para um conjunto de testes. Os casos de teste são definidos em um arquivo CSV (valores separados por vírgula).

Exportar casos de teste

Na página do Test Plans>Planos de teste, escolha o plano de teste com o conjunto de testes que contiver os casos de teste que você queira exportar.
Opcional. Escolha Opções de coluna para adicionar os campos que serão incluídos no arquivo de download.
Para exportar todos os casos de teste para o conjunto de testes, escolha Exportar casos de teste para CSV.

Para exportar um subconjunto de casos de teste para o conjunto de testes, selecione os casos de teste que serão exportados, escolha Mais opções e selecione Exportar caso(s) de teste para CSV.
O arquivo CSV exportado é mostrado na pasta Downloads.

Importar casos de teste

Na página do Test Plans>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 que deve ser importado na caixa de diálogo aberta e selecione Importar.
Selecione Confirmar. Se você especificar os casos de teste que já estão definidos no conjunto de testes, alguns elementos poderão ser substituídos durante o processo de importação.

Importar casos de teste automatizados (TCM)

Para importar os 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 os testes automatizados que você queira importar.
/maxpriority:`priority`	Opcional. Especifica os testes que devem ser importados 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 priority para o método de teste menor ou igual a 1 serão importados como casos de teste do assembly.
/minpriority:`priority`	Opcional. Especifica os testes que devem ser importados 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 priority para o método de teste igual ou maior a 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 os testes com uma determinada categoria para um conjunto de testes específico. Para saber mais sobre as categorias de teste, consulte Executar testes de unidade com o Gerenciador de Testes.
/syncsuite:`id`	Opcional. Especifica a ID do conjunto de testes no plano de teste no qual você quiser incluir os casos de teste importados. Esse conjunto não pode ser um conjunto dinâmico ou um conjunto com base na consulta. Se você especificar um conjunto de testes que será sincronizado a fim de atualizar os testes adicionados, os testes que não forem importados serão removidos do conjunto de testes, mas não do plano de teste propriamente dito.

Para obter as descrições dos parâmetros /collection, /teamproject e /login consulte Trabalhar com a ferramenta de linha de comando do TCM.

Limitações

A coluna de estado do caso de teste deve estar no estado Design.
O comprimento do título do caso de testes não deve ultrapassar 128 caracteres.
Há um limite de 20 MB em objetos JSON criados durante a importação e a exportação. Se ocorre falha na importação, 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.
Ocorre falha nas operações Copiar e Importar se a contagem de links relacionados ultrapassar 1.000 casos de teste.

APIs REST

Você pode copiar e clonar os planos de teste e os conjuntos de testes usando as APIs REST a seguir.

Próximas etapas

Executar testes manuais

Comentários

Esta página foi útil?

Last updated on 2025-12-17

Compartilhar via

Copiar ou clonar os planos de teste, os conjuntos de testes e os casos de teste

Pré-requisitos

Pré-requisitos para a ferramenta de linha de comando do TCM

Ferramentas compatíveis para copiar, clonar e importar

Listar planos de teste ou conjuntos de testes

Copiar ou clonar os planos de teste

Importar ou clonar os conjuntos de testes

Copiar caso de teste

Copiar e colar o caso de teste (modo de exibição Grade)

Importar ou exportar casos de teste em massa

Exportar casos de teste

Importar casos de teste

Importar casos de teste automatizados (TCM)

Limitações

APIs REST

Próximas etapas

Conteúdo relacionado

Comentários

Recursos adicionais