Compartilhar via

Executar testes automatizados da linha de comando usando o tcm

  • Artigo

 

Publicado: abril de 2016

É possível executar casos de teste com automação associada na linha de comando usando tcm.exe em vez da interface de usuário fornecida pelo Microsoft Test Manager. Isso permite que você inicie automaticamente execuções de um arquivo em lotes. Por exemplo, você pode decidir agendar o arquivo em lotes para que seja executado sempre que uma compilação for concluída.

Para executar esses casos de testes automatizados de modo que os resultados do teste façam parte do seu plano de teste, você deve usar um ambiente de laboratório. Quando você inicia a execução a partir da linha de comando, use tcm.exe. Você deve especificar as configurações de teste que contêm o conjunto de funções que você precisa para executar seus testes e um ambiente que contenha esse conjunto de funções. Para obter mais informações sobre ambientes e configurações de teste, consulte Configurando máquinas de teste para executar testes ou coletar dados.

Dica

Se desejar executar testes automatizados que interajam com a área de trabalho, configure o agente para ser executado como um processo em vez de um serviço.Para obter mais informações, consulte Como configurar o Test Agent para executar testes que interajam com a área de trabalho.

Você pode usar uma consulta para especificar o caso de teste e o emparelhamento de configuração*,* denominados pontos de teste ou você pode especificar pacotes e configurações de teste que você deseja executar em seu plano de teste. É necessário saber as IDs do seu plano de teste, dos seus conjuntos de testes e das configurações. Você pode usar o tcm.exe para listá-los, se for necessário.

Use os seguintes procedimentos para reunir informações que você precisa ter para executar seus testes automatizados de linha de comando e executar testes:

  • Listar todas as configurações em seu projeto de equipe

  • Listar todos os planos de teste em seu projeto de equipe

  • Listar todos os ambientes de teste em seu projeto de equipe

  • Listar todos os pacotes de teste em seu plano de teste

  • Crie um ensaio usando uma consulta de ponto de teste

  • Crie um ensaio para um pacote de teste e uma configuração específica

  • Visualizar e atualizar os resultados de teste

Parâmetros comuns para os procedimentos

Parâmetro

Descrição

/collection:CollectionURL

Especifica o URI da coleção de projeto de equipe. O formato para a URI é a seguinte: http://ServerName:Port/VirtualDirectoryName/CollectionName

Se nenhum diretório virtual for usado, então o formato do URI será o seguinte:

http://ServerName:Port/CollectionName

Se você não souber o caminho correto, contate o administrador de sistema do Team Foundation.

/teamproject: TeamProjectName

O projeto de equipe que você deseja usar. Esse projeto de equipe deve ser definido na coleção de projeto que você especificou usando o parâmetro /collection.

/login: Nome de usuário, senha

Opcional. Especifica o nome e a senha de um usuário que está conectado ao servidor de camada de aplicativo para Team Foundation Server e que tenha permissões para executar o comando.

Você usa esta opção se suas credenciais do Windows não possuem as permissões apropriadas, ou quando você estiver usando a autenticação básica, ou quando não estiver conectado em um domínio.

Para fazer logon ao Visual Studio Online, você também precisará usar /allowalternatecredentials listados abaixo.

/allowalternatecredentials

Esse sinalizador deve ser especificado, além de /login parâmetro ao conectar-se ao Visual Studio Online. (Esse sinalizador só está disponível se você tiver o Visual Studio 2013 atualização 4 ou superior.)

/build

Opcional. Especifica o número da compilação que será associado à execução de teste. Se a opção /buildDir não for especificada, o local de recebimento desta compilação será usado para selecionar binários de teste.

/buildDefinition

Nome da definição de compilação à qual a compilação pertence.

/flavor

Tipo de compilação a ser usado, caso a compilação tenha mais de um.

/platform

Plataforma da Compilação a ser usada, caso a compilação tenha mais de uma.

/? ou help

Exibe ajuda sobre o comando na janela Prompt de comando.

Procedimentos

Listar todas as configurações em seu projeto de equipe

Para listar todas as configurações em seu projeto de equipe

  1. Abra um Visual Studio prompt de comando.

    Para fazer isso, escolha Iniciar, aponte para Todos os Programas, Microsoft Visual Studio 2012, Ferramentas do Visual Studio e escolha Prompt de Comando do Desenvolvedor.

    O prompt de comando é aberto para a pasta: <unidade>:\Arquivos de programas\Microsoft Visual Studio 11.0\VC

  2. Para listar todas as configurações de seu projeto de equipe, digite o seguinte no prompt de comando:

    tcm configs /list /collection:<CollectionURL> /teamproject:<Team Project name>

    Você verá resultados semelhantes a esses:

    Id Name

    ---------------- ------------------

    1 Vista and IE 7

    25 Vista and IE 8

    Dica

    Também é possível listar planos para seu projeto de equipe usando o seguinte comando: Tcm plans /list /collection:<CollectionURL> /teamproject:<Team Project name>

Listar todos os planos de teste em seu projeto de equipe

Para listar todos os planos de teste em seu projeto de equipe

  1. Abra um Visual Studio prompt de comando.

    Para fazer isso, escolha Iniciar, aponte para Todos os Programas, Microsoft Visual Studio 2012, Ferramentas do Visual Studio e escolha Prompt de Comando do Desenvolvedor.

    O prompt de comando é aberto para a pasta: <unidade>:\Arquivos de programas\Microsoft Visual Studio 11.0\VC

  2. Para listar todos os planos de seu projeto de equipe, digite o seguinte no prompt de comando:

    tcm plans /list /collection:<CollectionURL> /teamproject:<Team Project name>

    Você verá resultados semelhantes a esses:

    Id Name

    ---------------- ------------------

    1 Beta 1 Test Plan

    22 RTM Test Plan

  3. (Opcional) Para localizar todos os pacotes de teste em um plano de teste, digite o seguinte no prompt de comando:

    tcm suites /list /planid:<your plan id> /collection:<CollectionURL> /teamproject:<Team Project name>

    Você verá resultados semelhantes a esses:

    Id Name

    ---------------- ------------------

    1 Priority 1 Test Suite

    15 Shopping Cart Test Suite

Listar todos os ambientes de teste em seu projeto de equipe

Para listar todos os ambientes de teste em seu projeto de equipe

  1. Abra um Visual Studio prompt de comando.

    Para fazer isso, escolha Iniciar, aponte para Todos os Programas, Microsoft Visual Studio 2012, Ferramentas do Visual Studio e escolha Prompt de Comando do Desenvolvedor.

    O prompt de comando é aberto para a pasta: <unidade>:\Arquivos de programas\Microsoft Visual Studio 11.0\VC

  2. Para listar todos os planos de seu projeto de equipe, digite o seguinte no prompt de comando:

    tcm testenvironments /list /collection:<CollectionURL> /teamproject:<Team Project name>

    Você verá resultados semelhantes a esses:

    Name Description

    ---------------- ------------------

    Staging Environment Use to test staging environment

    Testing Environment for Customer ABC

Listar todos os pacotes de teste em seu plano de teste

Para listar todos os conjuntos de testes em seu plano de teste

  1. Abra um Visual Studio prompt de comando.

    Para fazer isso, escolha Iniciar, aponte para Todos os Programas, Microsoft Visual Studio 2012, Ferramentas do Visual Studio e escolha Prompt de Comando do Desenvolvedor.

    O prompt de comando é aberto para a pasta: <unidade>:\Arquivos de programas\Microsoft Visual Studio 11.0\VC

  2. Para localizar todos os pacotes de teste em seu plano de teste, digite o seguinte no prompt de comando:

    tcm suites /list /planid:<your plan id> /collection:<CollectionURL> /teamproject:<Team Project name>

    Você verá resultados semelhantes a esses:

    Id Name

    ---------------- ------------------

    1 Priority 1 Test Suite

    15 Shopping Cart Test Suite

Crie um ensaio usando uma consulta de ponto de teste

Para criar uma execução de teste usando uma consulta de ponto de teste

  1. Abra um Visual Studio prompt de comando.

    Para fazer isso, escolha Iniciar, aponte para Todos os Programas, Microsoft Visual Studio 2012, Ferramentas do Visual Studio e escolha Prompt de Comando do Desenvolvedor.

    O prompt de comando é aberto para a pasta: <unidade>:\Arquivos de programas\Microsoft Visual Studio 11.0\VC

  2. Para criar uma execução de teste que usa uma consulta de ponto de teste para uma configuração de teste específico, use as informações na tabela a seguir.

    Id

    Valor

    Planid

    1

    Configid

    13

    Insira o seguinte no prompt de comando:

    tcm run /create /title:"Nightly Run" /planid:1 /querytext:"SELECT * FROM TestPoint WHERE ConfigurationId=13" /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

    Você verá resultados semelhantes a esses:

    Run created with ID: <xxx>.

    Dica

    Você deve fornecer configurações de um teste e um ambiente que corresponda ao conjunto de funções nas configurações de teste para um teste automatizado usando o tcm.exe.Para obter mais informações sobre ambientes e configurações de teste, consulte Configurando máquinas de teste para executar testes ou coletar dados.Para criar configurações de teste, consulte Criar configurações de teste para testes de sistema automatizados usando o Microsoft Test Manager.

  3. Para exibir o andamento da execução de teste, siga as etapas em Exibir e atualizar os resultados do teste.

Crie um ensaio para um pacote de teste e uma configuração específica

Para criar uma execução de teste para um pacote de teste e uma configuração específica

  1. Abra um Visual Studio prompt de comando.

    Para fazer isso, escolha Iniciar, aponte para Todos os Programas, Microsoft Visual Studio 2012, Ferramentas do Visual Studio e escolha Prompt de Comando do Desenvolvedor.

    O prompt de comando é aberto para a pasta: <unidade>:\Arquivos de programas\Microsoft Visual Studio 11.0\VC

  2. Para criar uma execução de teste para todos os testes em um pacote de teste para uma configuração específica, use as informações da tabela a seguir.

    Id

    Valor

    Planid

    1

    Suiteid

    5

    Configid

    13

    Insira o seguinte no prompt de comando:

    tcm run /create /title:"Nightly Run" /planid:1 /suiteid:5 /configid:13 /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

    Você verá resultados semelhantes a esses:

    Run created with ID: <xxx>.

    Dica

    Você deve fornecer configurações de um teste e um ambiente que corresponda ao conjunto de funções nas configurações de teste para um teste automatizado usando o tcm.exe.Para obter mais informações sobre ambientes e configurações de teste, consulte Configurando máquinas de teste para executar testes ou coletar dados.Para criar configurações de teste, consulte Criar configurações de teste para testes de sistema automatizados usando o Microsoft Test Manager.

  3. Para exibir o andamento da execução de teste, siga as etapas em Exibir e atualizar os resultados do teste.

Visualizar e atualizar os resultados de teste

Para visualizar e atualizar os Resultados de Teste

  1. Abra Microsoft Test Manager.

    Dica

    Para exibir a janela Microsoft Test Manager, selecione Iniciar e, em seguida, selecione Todos os Programas.Aponte para Microsoft Visual Studio 2012 e selecione Microsoft Test Manager.

  2. Para exibir os resultados de teste, escolha a seta para baixo no seletor de grupo central e então escolha Centro de Testes.

  3. Na barra de menus do grupo de centro, escolha Testar e então escolha Analisar Execuções de Teste.

    A atividade Analisar Execuções de Teste é exibida mostrando todas as execuções de teste para este plano de teste.

  4. Abra o teste executado com o título que você deu a da linha de comando para abrir e exibir os detalhes.

    Os detalhes de execução de teste são exibidos.

  5. (Opcional) Para atualizar o título do ensaio, digite o novo nome em Título.

  6. (Opcional) Se o seu teste falhar, você pode atualizar a razão para a falha. Escolha Resolução e selecione o motivo da falha na lista.

  7. (Opcional) Para adicionar comentários ao resultado de teste, clique no ícone Comentários. Digite seus comentários e escolha Salvar comentários.

  8. (Opcional) Para exibir os detalhes de um teste individual, selecione o teste.

    O resultado do teste exibido mostra os detalhes da execução de teste e o histórico de resultados do teste. Você pode fechar esta exibição para retornar à execução de teste.

    Dica

    Se você determinar que há um bug em sua análise, poderá criar um bug desta exibição.

  9. Para salvar essas alterações para a execução do teste, escolha Salvar na barra de ferramentas.

Consulte também

tcm: listando planos de teste, conjuntos de testes, configurações de teste e ambientes
tcm: executando testes a partir de um plano de teste usando o utilitário de linha de comando
Executando testes automatizados a partir da linha de comando
Planejar testes manuais usando o Team Web Access