tcm: Ejecutar pruebas partiendo de un plan de pruebas usando la utilidad de línea de comandos
Puede ejecutar pruebas automáticas que forman parte de un plan de prueba desde la línea de comandos.Esto le permite iniciar una ejecución de pruebas mediante un archivo por lotes para que pueda programar una ejecución.También puede administrar las ejecuciones de pruebas desde la línea de comandos.Si desea exportar una ejecución de pruebas para que un desarrollador pueda ver los resultados de las pruebas utilizando Visual Studio, puede utilizar tcm para lograrlo.También puede publicar resultados de ejecución de pruebas desde un archivo de prueba Visual Studio (.trx) utilizando tcm.Puede especificar qué resultados de este archivo de ejecución de pruebas desea volver a publicar en su plan de pruebas.Puede utilizar los siguientes comandos tcm para llevar a cabo las tareas siguientes:
tcm run /create
tcm run /list
tcm run /execute
tcm run /abort
tcm run /delete
tcm run /export
tcm run /publish
El archivo tcm.exe se encuentra en <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE en cualquier equipo que tenga instalado Visual Studio Ultimate, Visual Studio Premium o Visual Studio Test Professional.
Para obtener más información acerca de cómo importar pruebas automáticas en el proyecto de prueba y configurar su plan de prueba para ejecutar estas pruebas, consulte Crear casos de prueba a partir de un ensamblado de pruebas automatizadas y Cómo: Ejecutar pruebas automatizadas desde la línea de comandos usando 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 /execute /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]
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 |
Descripción |
|---|---|
/collection:CollectionURL |
Especifica el URI de la colección de proyectos de equipo.El formato del identificador URI es el siguiente: http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección Si no se utiliza ningún directorio virtual, el formato del identificador URI es el siguiente: http://NombreServidor:Puerto/NombreColección |
/teamproject:project |
El nombre del proyecto de equipo que contiene el plan de pruebas en el que desea importar las pruebas automatizadas. |
/title: title |
Especifica el título que desea utilizar para la ejecución que crea o si se publica un archivo de ejecución de pruebas. |
/planid:id |
Especifica el plan que contiene las pruebas que desea ejecutar o el plan que está asociado a las ejecuciones de pruebas que desea enumerar. |
/suiteid:id |
Especifica los conjuntos de pruebas que desea ejecutar. También puede especificar el conjunto de pruebas a utilizar cuando se publica una ejecución de pruebas. .gif "Nota") Nota
Para encontrar el Id. del conjunto, puede mostrar los conjuntos de pruebas de un plan de pruebas.Para obtener más información, vea tcm: Enumerar planes de pruebas, conjuntos de pruebas y entornos.
Sugerencia
Para ejecutar más de un conjunto de pruebas, puede utilizar el parámetro /querytext.
|
/configid:configid |
Especifica la configuración de prueba que desea ejecutar para sus conjuntos de prueba. También puede especificar la configuración de prueba a utilizar cuando se publica una ejecución de pruebas. Sugerencia
Para ejecutar más de una configuración de pruebas, puede utilizar el parámetro /querytext.
|
/querytext:query |
Especifica la consulta que desea utilizar para devolver las ejecuciones de pruebas o la consulta que desea utilizar para seleccionar las pruebas que desea ejecutar. Sugerencia
Puede utilizar el parámetro /querytext para ejecutar más de un conjunto de pruebas.Por ejemplo:querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)”
|
/settingsname:name |
Opcional.Especifica la configuración de prueba que desea utilizar para esta ejecución de pruebas.Si no selecciona la configuración de prueba con este parámetro, se utiliza la configuración de prueba predeterminada para las pruebas automatizadas en el plan de pruebas. |
/owner:owner |
Opcional.Especifica el propietario de la ejecución de pruebas. |
/runowner:owner |
Opcional.Especifica el propietario de la ejecución de pruebas. |
/builddir:directory |
Opcional.Especifica el directorio de compilación que se desea utilizar para buscar los ensamblados de prueba de la prueba automatizada.Si no se especifica, la ubicación de compilación se utiliza según la compilación que está actualmente asignada al plan de pruebas. |
/testenvironment:name |
Opcional.Especifica el entorno de prueba que desea utilizar para esta ejecución de pruebas.Si no selecciona un entorno de prueba con este parámetro, se utiliza el entorno de prueba predeterminado para las pruebas automatizadas en el plan de pruebas. |
/id:id |
Especifica el identificador de ejecución que desea eliminar, anular o exportar. |
/resultsfile:path |
Especifica la ubicación que se desea utilizar para exportar una ejecución de pruebas o para encontrar la ejecución de pruebas para publicarla.Por ejemplo, "c:\temp\ResultsForDeveloper.trx". |
/attachment:attachmentname |
Especifica el nombre de los datos adjuntos de la ejecución de pruebas que exporta. |
/resultowner:owner |
Especifica el propietario de los resultados de pruebas. |
/build:buildnumber |
Opcional.Especifica el número de compilación que se va a utilizar para publicar una ejecución de pruebas.Este parámetro se debe utilizar con /builddefinition. |
/builddefinition:builddefinition |
Opcional.Especifica la definición de compilación que se va a utilizar para publicar una ejecución de pruebas.Este parámetro se debe utilizar con /build. |
/flavor:flavor |
Opcional.Especifica el tipo de compilación.Por ejemplo, Versión.Este parámetro solo puede utilizarse si se utiliza el parámetro /build. |
/platform:platform |
Opcional.Especifica la plataforma de compilación.Por ejemplo, x86.Este parámetro solo puede utilizarse si se utiliza el parámetro /build. |
/assignfailurestouser:user |
Opcional.Especifica a quién se desea asignar cualquier prueba con error en la ejecución de pruebas. |
/buildverification |
Opcional.Especifica que esta ejecución de pruebas contiene pruebas de comprobación de la compilación que comprueban la funcionalidad básica de su compilación. |
/include |
Opcional.Especifica que se incluyan todas las pruebas que se han seleccionado para la ejecución de pruebas, aunque las pruebas no estén establecidas actualmente al estado activo. |
/noprompt |
Opcional.Especifica que no se solicita al usuario que confirme la eliminación de una ejecución de pruebas. |
/login:username,[password] |
Opcional.Especifica el nombre y contraseña de un usuario que ha iniciado sesión en el servidor de capa de aplicación de Team Foundation Server y que tiene permisos para ejecutar el comando.Usaría esta opción si sus credenciales de Windows no tienen los permisos adecuados, o está usando autenticación básica o no está conectado a un dominio. |
Se pueden añadir parámetros de /collection y /teamproject al archivo XML de tcm.exe.config que se encuentra en el mismo directorio que tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE.Si los agrega al archivo, no es necesario escribirlos en la línea de comandos cada vez que ejecute un comando tcm.Puede agregar estas claves y sus valores al archivo, como sigue, en la sección appSettings:
<appSettings>
<add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
<add key ="TeamProject" value="DinnerNow"/>
</appSettings>
Ejecutar pruebas y administrar ejecuciones de pruebas
Los ejemplos siguientes asumen que ha iniciado un símbolo del sistema de Visual Studio .
Para ello, elija Inicio, seleccione Todos los programas, elija Microsoft Visual Studio 2012, seleccione Herramientas de Visual Studio y, por último, elija Símbolo del sistema de desarrollador.
El símbolo del sistema se abre en la carpeta: <drive>:\Program Files\Microsoft Visual Studio 11.0\VC
Cambie el directorio a la carpeta que contiene el ensamblado compilado a partir de su proyecto de prueba.
.gif "Nota importante") Importante |
|---|
Para ejecutar pruebas automatizadas desde la línea de comandos utilizando tcm.exe, debe tener sus casos de prueba asociados a las pruebas automatizadas.También debe configurar su plan de pruebas correctamente para utilizar una compilación a fin de localizar las pruebas automatizadas que desea ejecutar si no especifica la información de compilación en la línea de comandos.Para obtener más información sobre cómo hacerlo, vea Cómo: Crear casos de prueba a partir de un ensamblado de pruebas automatizadas usando tcm.exe. |
Para obtener los identificadores necesarios para los siguientes comandos, puede que deba utilizar tcm para mostrar los artefactos de prueba y sus identificadores.Para obtener más información sobre cómo hacerlo, vea tcm: Enumerar planes de pruebas, conjuntos de pruebas y entornos y Cómo: Ejecutar pruebas automatizadas desde la línea de comandos usando Tcm.
El comando siguiente ejecuta pruebas mediante una consulta de punto de prueba:
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>
El comando siguiente ejecuta pruebas mediante un conjunto de pruebas y una configuración específicos:
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>
El siguiente comando ejecuta pruebas mediante un identificador concreto:
Tcm run /execute /id:1207 /collection:<CollectionURL> /teamproject:<Team Project name>
El comando siguiente muestra las ejecuciones de pruebas de un plan de pruebas específicas:
tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>
El siguiente comando elimina una ejecución de pruebas específica:
tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>
El siguiente comando exporta una ejecución de pruebas a un archivo .trx:
tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
El comando siguiente publica una ejecución de pruebas de un conjunto de pruebas y configuración de prueba específicos y reasigna el propietario.Esto actualiza los puntos de prueba existentes de los casos de prueba del conjunto de pruebas emparejado con esta configuración respecto a los resultados del archivo .trx:
tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
Vea también
Referencia
tcm: Enumerar planes de pruebas, conjuntos de pruebas y entornos
Otros recursos
tcm: Importar y ejecutar pruebas automatizadas para un plan de pruebas desde la línea de comandos