Especificar el tipo de error que se va a archivar en Microsoft Test Manager

Artículo
08/10/2011

Puede habilitar la creación automática de un elemento de trabajo cuando un evaluador encuentre un defecto de código al utilizar Microsoft Test Manager. La herramienta de la línea de comandos tcm bugfieldmapping admite la importación y exportación de un archivo de asignación al proyecto de equipo. El archivo de asignación define el tipo de elemento de trabajo que se desea crear y los tres campos de datos que debe rellenar Microsoft Test Manager. Los tres campos son pasos reproducibles, información del sistema y la versión de compilación en la que se detectó el defecto. Cuando un evaluador ejecuta una prueba y encuentra un defecto, pueden crear un error en el que se rellenen automáticamente los tres campos.

Nota

Si su proyecto de equipo se creó con una plantilla de proceso que se basaba en la versión 5.0 de Microsoft Solutions Framework (MSF), el tipo de elemento de trabajo de error ya estará habilitado. Sin embargo, si está agregando otro tipo de elemento de trabajo a la categoría de error o está trabajando con una plantilla de proceso personalizada, puede que deba utilizar el comando tcm.

La herramienta de línea de comandos tcm se encuentra en Unidad::\Archivos de programa\Microsoft Visual Studio 10.0\Common7\IDE en el equipo cliente que ejecuta Team Explorer.

Para obtener más información acerca de las opciones adicionales de la línea de comandos de tcm, vea tcm: Importar y ejecutar pruebas automatizadas para un plan de pruebas desde la línea de comandos.

Para obtener más información sobre el tipo de error del elemento de trabajo, vea Error (Agile) o Error (CMMI).

Permisos necesarios

Para el proyecto de equipo donde se definen los tipos de elemento de trabajo, debe ser miembro del grupo de seguridad Team Foundation Administrators o del grupo de seguridad Project Administrators. Para obtener más información, vea Permisos de Team Foundation Server.

Nota

Incluso si ha iniciado sesión con permisos administrativos, debe abrir una ventana de símbolo del sistema con privilegios elevados para ejecutar esta función en un servidor que ejecute Windows Server 2008. Para abrir una ventana de símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, vea la siguiente página del sitio web de Microsoft: Control de cuentas de usuario.

tcm bugfieldmapping /export /mappingfile:path /collection:CollectionURL /teamproject:Project [/login:username,[password]]

tcm bugfieldmapping /import /mappingfile:path /collection:CollectionURL /teamproject:Project [/login:username,[password]]

Parámetros

Parámetro	Descripción
/export	Especifica la exportación del archivo de asignación de campos de error. Este archivo define el tipo de elemento de trabajo que se debe crear cuando se encuentra un defecto de código utilizando Microsoft Test Manager. También especifica los campos de elemento de trabajo que se rellenarán con datos que se definen en Microsoft Test Manager, como los pasos de reproducción, información del sistema y la compilación en la que se encontró el defecto de código. Para obtener más información, vea Contenido del archivo de asignaciones de campos de error más adelante en este tema.
/import	Especifica la importación del archivo de asignación de campos de error.
/mappingfile:Path	La ruta de acceso y el nombre de archivo del archivo de definición XML que contiene las asignaciones de campos de error. Nota Si usa Windows Vista, es posible que no tenga permisos para determinadas carpetas.Si intenta exportar el tipo de elemento de trabajo a una ubicación para la que no tiene permisos, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual.Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos.Para obtener más información sobre la virtualización del Registro, vea las páginas siguientes en el sitio web de Microsoft: Registry Virtualization y Common file and registry virtualization issues in Windows Vista.
/collection:CollectionURL	Especifica el identificador uniforme de recursos (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:Proyecto	Especifica el nombre del proyecto de equipo para el que se aplicarán las asignaciones de campos de error. Este proyecto de equipo se debe definir en la colección de proyectos de equipo especificada por el parámetro /collection.
/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 y que tiene permisos para ejecutar el comando. Utilizaría esta opción si sus credenciales de Windows no tienen los permisos adecuados, está utilizando la autenticación básica o no está en un dominio.
/? o help	Muestra ayuda sobre el comando en la ventana del símbolo del sistema.

Comentarios

El archivo de asignaciones de campos de error proporciona a Microsoft Test Manager el nombre del tipo de elemento de trabajo que se desea crear y los campos que se desean rellenar para los elementos de trabajo que crea.

Solo puede definir un tipo de elemento de trabajo que se va a crear al ejecutar pruebas que utilizan Microsoft Test Manager. Cada vez que ejecuta el comando tcm bugfieldmapping import, el tipo de elemento de trabajo especificado por el elemento BugFilerMappings reemplaza al tipo de elemento de trabajo especificado previamente. Por ejemplo, el siguiente código indica la creación de los elementos de trabajo basados en el tipo denominado AWBug.

<BugFilerMappings workitemtypetocreate="AWBug">

Para obtener más información, vea Cómo: Enviar un error mediante el Administrador de pruebas de Microsoft.

Contenido del archivo de asignaciones de campos de error

La siguiente sintaxis XML muestra el contenido predeterminado del archivo de asignaciones de campos de error. El archivo especifica el tipo de elemento de trabajo que se desea crear y los tres campos de elemento de trabajo que Microsoft Test Manager rellenará automáticamente, basado en los datos que se encontraron durante la ejecución de pruebas. Se deben especificar los tres campos al importar un archivo de asignaciones de campos de error.

<?xml version="1.0" encoding="utf-16"?>
<BugFilerMappings workitemtypetocreate="Bug">
   <ReproSteps>Microsoft.VSTS.TCM.ReproSteps</ReproSteps>
   <SystemInformation>Microsoft.VSTS.TCM.SystemInfo</SystemInformation>
   <BuildFoundIn>Microsoft.VSTS.Build.FoundIn</BuildFoundIn>
</BugFilerMappings>

Para obtener más información sobre los campos que se utilizan para realizar el seguimiento de información que encuentra Microsoft Test Manager, vea Integración de compilación y de pruebas.

Ejemplos

A menos que se especifique lo contrario, se aplican los siguientes valores en cada ejemplo:

Identificador URI de la colección de proyectos de equipo: http://AdventureWorksServer:8080/AWTeam/Collection1
Nombre del proyecto: AdventureWorks
Nombre de archivo de asignación de campos de error: bugfieldmappings.xml
Ubicación de la carpeta: "C:\Users\AdminUser\Documents\"

Importar el archivo de asignaciones de campos de error

El siguiente comando importa el contenido del archivo bugfieldmappings.xml al proyecto de equipo AdventureWorks que se define en Collection1 en el servidor que se denomina AdventureWorksServer.

tcm bugfieldmapping /import /mappingfile:"C:\Users\AdminUser\Documents\bugfieldmappings.xml" /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /teamproject:AdventureWorks