TCM: Plano de testes em execução de um teste usando o utilitário de linha de comando
Você pode executar testes automatizados que fazem parte de um plano de teste a partir da linha de comando. Isso permite que você iniciar um teste executado usando um arquivo em lotes para que você pode agendar uma execução. Você também pode gerenciar a execução de teste na linha de comando. Se você quiser exportar um teste para que um desenvolvedor possa exibir os resultados de teste usando Visual Studio, você pode usar tcm para realizar essa tarefa. Você também pode publicar resultados de teste de um Visual Studio teste executado usando o arquivo (. trx) tcm. Você pode especificar o que resulta desse teste executa o arquivo que você deseja publicar o seu plano de teste. Você pode usar o seguinte tcm comandos para realizar estas tarefas:
tcm run /create
tcm run /list
tcm run /abort
tcm run /delete
tcm run /export
tcm run /publish
TCM.exe está localizado em <Drive:>\Program Files\Microsoft Visual Studio 10.0\Common7\IDE em qualquer computador que tenha Visual Studio Ultimate instalado.
Para obter mais informações sobre como importar testes automatizados para o seu projeto de teste e configurar o plano de teste para executar esses testes, consulte Create Test Cases from an Assembly of Automated Tests e Como: Execute casos de teste com a automação a partir da linha de comando usando o Tcm.
tcm run /create /title:title /planid: id /collection:CollectionURL /teamproject:project (suiteid:id /configid:configid | /querytext: query) [/settingsname:name] [/owner:owner] [/builddir:directory] [/testenvironment:name] [/login:username,[password]] [/include]
tcm run /list [/planid:id | /querytext: query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm run /abort /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm run /delete /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]] [/noprompt]
tcm run /export /id:id /resultsfile:path /collection:CollectionURL /teamproject:project [/login:username,[password]] [/attachment:attachmentname]
tcm run /publish /suiteid:id /configid:id /resultowner:owner /resultsfile:path /collection:CollectionURL /teamproject:project [/title: runtitle] [/runowner:owner] [/build:buildnumber /builddefinition:builddefinition] [/flavor:flavor [/platform:platform] [/assignfailurestouser:user] [/login:username,[password]] [/buildverification]
Parâmetros
Parâmetro |
Descrição |
|---|---|
/collection:CollectionURL |
Especifica o URI da coleção de projeto de equipe. O formato para o URI é o seguinte: http: / /Nome_do_servidor: port/VirtualDirectoryName/NomeDaColeta Se nenhum diretório virtual é usado, o formato para o URI é o seguinte: http: / /Nome_do_servidor: port / NomeDaColeta |
/teamproject:project |
O nome do projeto da equipe que contém o plano de teste que você deseja importar em testes automatizados. |
/title: title |
Especifica o título que você deseja usar para o tempo de execução que você criar ou se você publicar um arquivo de execução de teste. |
/planid:id |
Especifica o plano de testes que você deseja executar ou o plano que está associado com o teste é executado que você deseja listar. |
/suiteid:id |
Especifica os conjuntos de teste que você deseja executar. Por exemplo, se você deseja executar mais de uma suíte de testes você pode usar a sintaxe a seguir como parte do tcm comando /suiteid:2 /suiteid:3. Ele também pode especificar o conjunto de testes para usar quando você publica uma execução de teste. .gif "Observação") Observação
Para localizar a identificação do pacote, você pode listar os conjuntos de teste para um plano de teste.Para obter mais informações, consulte TCM: Listando os planos de teste, suítes de testes, configurações de teste e ambientes.
|
/configid:configid |
Especifica quais configurações de teste que você deseja executar suas suítes de teste. Por exemplo, se você desejar executar mais de uma configuração de teste, você pode usar a sintaxe a seguir como parte do tcm comando /configid:2 /configid:3. Ele também pode especificar a configuração de teste para usar quando você publica uma execução de teste. |
/querytext:query |
Especifica a usar para retornar que o teste é executado ou a consulta para usar para selecionar os testes que você deseja executar. |
/settingsname:name |
Opcional. Especifica as configurações de teste que você deseja usar para execução de teste. Se você não selecionar configurações de teste com esse parâmetro, as configurações de teste padrão para os testes automatizados no plano de teste é usado. |
/owner:owner |
Opcional. Especifica o proprietário da execução do teste. |
/runowner:owner |
Opcional. Especifica o proprietário da execução do teste. |
/builddir:directory |
Opcional. Especifica o diretório de compilação para usar para localizar os assemblies de teste para o teste automatizado. Se isso não for especificado que o local de compilação é usado com base na compilação atualmente atribuído ao plano de teste. |
/testenvironment:name |
Opcional. Especifica o ambiente de teste que você deseja usar para execução de teste. Se você não selecionar um ambiente de teste com esse parâmetro, o ambiente de teste padrão para os testes automatizados no plano de teste é usado. |
/id:id |
Especifica a id de execução que você deseja excluir, anular ou exportar. |
/resultsfile:path |
Especifica o local para usar para exportar uma execução de teste ou para localizar o execução de teste para publicá-lo. Por exemplo, "c:\temp\ResultsForDeveloper.trx". |
/attachment:attachmentname |
Especifica o nome do anexo de uma execução de teste que você exporte. |
/resultowner:owner |
Especifica o proprietário para os resultados do teste. |
/build:buildnumber |
Opcional. Especifica o número de compilação usar para publicar uma execução de teste. Este parâmetro deve ser usado com /builddefinition. |
/builddefinition:builddefinition |
Opcional. Especifica a definição de compilação usar para publicar uma execução de teste. Este parâmetro deve ser usado com /build. |
/flavor:flavor |
Opcional. Especifica o tipo de compilação. Por exemplo, a versão. Este parâmetro só pode ser usado se o /build parâmetro é usado. |
/platform:platform |
Opcional. Especifica a plataforma de compilação. Por exemplo, x86. Este parâmetro só pode ser usado se o /build parâmetro é usado. |
/assignfailurestouser:user |
Opcional. Especifica a quem atribuir quaisquer testes com falha na execução de teste. |
/buildverification |
Opcional. Especifica que a execução de teste contém testes de verificação de compilação que verificam a funcionalidade básica de sua compilação. |
/include |
Opcional. Especifica que todos os testes que estão selecionados para o execução de teste são incluídos, mesmo que os testes não estão definidos para o estado ativo. |
/noprompt |
Opcional. Especifica que o usuário não será solicitado a Confirmar exclusão de uma execução de teste. |
/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 quem tem permissão para executar o comando. Se suas credenciais do Windows não tem as permissões apropriadas, ou usando a autenticação básica, ou você não está conectado a um domínio, você usaria essa opção. |
Você pode adicionar parâmetros para /collection e /teamproject para o tcm.exe.config o arquivo XML que está localizado no mesmo diretório que tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio 10.0\Common7\IDE. Se você adicioná-los para o arquivo, você não precisará inseri-los na linha de comando cada vez que você executar uma tcm comando. Você pode adicionar essas chaves e seus valores para o arquivo, como segue, no appSettings seção:
<appSettings>
<add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
<add key ="TeamProject" value="DinnerNow"/>
</appSettings>
Execução de testes e o gerenciamento de execuções de teste
Os exemplos seguintes assumem que você iniciou um Visual Studio o prompt de comando.
Para fazer isso, clique em Iniciar, aponte para Todos os programas, aponte para 2010 do Microsoft Visual Studio, aponte para Visual Studio Toolse, em seguida, clique em Visual Studio Prompt de comando (2010).
O prompt de comando abre a pasta: <drive>:\Program Files\Microsoft Visual Studio 10.0\VC
Alterar o diretório para a pasta que contém a construção assembly a partir seu projeto de teste.
.gif "Observação importante") Importante |
|---|
Para executar testes automatizados a partir da linha de comando usando o tcm.exe, você deve ter seus casos de teste associados aos testes automatizados. Você deve também configurar o plano de teste corretamente para usar uma compilação para localizar os testes automatizados para executar se você não especificar as informações de compilação na linha de comando. Para obter mais informações sobre como fazer isso, consulte Como: Criar casos de teste a partir de um conjunto de testes automatizados usando tcm.exe. |
Para obter as identificações necessárias os seguintes comandos, talvez você precise usar tcm para listar os artefatos de teste e suas identificações. Para obter mais informações sobre como fazer isso, consulte TCM: Listando os planos de teste, suítes de testes, configurações de teste e ambientes e Como: Execute casos de teste com a automação a partir da linha de comando usando o Tcm.
O seguinte comando executa testes usando uma consulta de ponto de teste:
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>
O seguinte comando executa testes usando a suíte de testes específicos e a configuração:
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>
O comando a seguir lista as execuções de teste para um plano de teste específico:
tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>
O comando a seguir exclui uma execução de teste específico:
tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>
O comando a seguir exporta uma execução de teste para um arquivo. trx:
tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
O comando a seguir publica um teste para uma configuração de suite e o teste do teste específico e reatribui o proprietário. Isso atualiza os pontos de teste existente para os casos de teste da suíte de teste emparelhado com essa configuração, os resultados no arquivo. trx:
tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
Consulte também
Outros recursos
TCM: Listando os planos de teste, suítes de testes, configurações de teste e ambientes