tcm: listando planos de teste, conjuntos de testes, configurações de teste e ambientes
Publicado: abril de 2016
Para executar seus testes de linha de comando usando tcm.exe ou importar os casos de teste em um conjunto de testes específico, você precisa dos nomes e identificações dos artefatos que são necessários para executar os testes. Você pode obter uma lista de artefatos de teste de linha de comando usando os seguintes comandos tcm:
tcm plans /list
tcm suites /list
tcm configs /list
tcm testenvironments /list
TCM.exe está localizado em <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE em qualquer computador que tenha o Visual Studio Enterprise ou o Visual Studio Test Professional.
Sintaxe
tcm plans /list [/querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm suites /list [/planid: id | /querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm configs /list [/querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm testenvironments /list /collection:CollectionURL /teamproject:project [/login:username,[password]]
Parâmetros
Parâmetro |
Descrição |
|---|---|
/querytext:query |
Especifica a consulta a ser usada para retornar os artefatos de teste. |
/planid:id |
Especifica que somente os pacotes de teste deste plano de teste serão listados. |
/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 |
/teamproject:project |
O nome do projeto da equipe que contém o plano de teste que você deseja importar testes automatizados. |
/login:username,[password] |
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.) |
Você pode adicionar parâmetros para /collection e /teamproject ao arquivo XML de tcm.exe.config que está localizado no mesmo diretório que tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE. Se você adicionar estes ao arquivo, você não precisará inseri-los na linha de comando sempre executar um comando do tcm. Você pode adicionar essas teclas e seus valores para o arquivo, como segue, na seção de appSettings:
<appSettings>
<add key="TeamFoundationServer" value=""http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
<add key ="TeamProject" value="DinnerNow"/>
</appSettings>
Exemplos
Listar itens de teste
Os exemplos a seguir supõem que você iniciou um prompt de comando do Visual Studio.
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 abre na pasta: <drive>:\Program Files\Microsoft Visual Studio 11.0\VC
O comando a seguir lista as configurações de teste no projeto de equipe da DinnerNow:
tcm configs /list /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
O comando a seguir lista somente o plano de teste Sprint 1 no projeto de equipe da DinnerNow de forma que você possa exibir sua ID:
tcm plans /list /querytext:"SELECT * FROM TestPlan WHERE PlanName=’Sprint 1’" /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
O comando a seguir lista os pacotes de teste no plano de teste com a ID 3 no projeto de equipe da DinnerNow:
tcm suites /list /planid:3 /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
Consulte também
tcm: executando testes a partir de um plano de teste usando o utilitário de linha de comando
Usando o tcm para importar e executar testes automatizados para um plano de teste da linha de comando