Actualizar un proyecto de equipo basado en una plantilla de proceso de MSF v4.2

Si ha actualizado desde Visual Studio Team System 2008 Team Foundation Server a Team Foundation Server 2013, puede actualizar el proyecto de equipo manualmente. Si el proyecto de equipo se basa en una plantilla de proceso de la versión 4.2 de Microsoft Solutions Framework (MSF), siga los procedimientos descritos en este tema. Después de aplicar estas actualizaciones, podrá obtener acceso a las nuevas características que se describen en Configurar características después de una actualización de TFS, así como interactuar con Microsoft Test Manager.

Tareas de actualización necesarias para tener acceso a las nuevas características:

1. Cambiar el nombre de campos del sistema

2. (Solo Agile) Cambiar el nombre de Escenario a Caso de usuario

3. Descargar la versión más reciente de la plantilla de proceso de MSF

4. Importar tipos de vínculo

5. (Opcional) Aplicar personalizaciones necesarias

6. Importar tipos de elemento de trabajo

7. Importar el archivo de categorías

8. Importar los archivos de configuración de proceso

9. Comprobar el acceso a las nuevas características

Tareas adicionales necesarias para interactuar con Microsoft Test Manager:

1. Especificar el tipo de error que se va a crear en Microsoft Test Manager

2. Conceder permisos para probar miembros del equipo

3. Iniciar Microsoft Test Manager

Requisitos

• Para descargar plantillas de proceso, debe ser miembro del grupo Administradores de la colección de proyectos. Si los permisos de seguridad necesarios se establecen explícitamente, el permiso Administrar plantilla de proceso para la colección de proyectos de equipo debe establecerse en Permitir.

• Para ejecutar las herramientas de línea de comandos witadmin y tcm, debe ser miembro de uno de los siguientes grupos: Administradores de Team Foundation, Administradores de la colección de proyectos o Administradores de proyectos para el proyecto de equipo.

• Para conceder permisos, debe ser miembro del grupo administrativo en el nivel del grupo que desea cambiar. Por ejemplo, si desea cambiar los permisos para un grupo o usuario en el nivel de colección de proyectos de equipo, debe ser miembro del grupo Administradores de la colección de proyectos para esa colección o tener el permiso Editar información en el nivel de colección establecido en Permitir.

  Para obtener más información, vea Referencia de permisos para Team Foundation Server.

1.Cambiar el nombre de campos del sistema

Dado que se cambió el nombre de varios campos del sistema en Visual Studio Team Foundation Server 2010, deberá cambiar manualmente los nombres de estos campos en la colección de proyectos de equipo. Los campos del sistema cuyo nombre se cambió incluyen System.AreaID, System.IterationID, System.HyperLinkCount, System.ExternalLinkCount y System.AttachedFileCount.

Realice esta tarea para cada colección de proyectos de equipo definida en su Team Foundation Server actualizado.

1. Abra una ventana del símbolo del sistema donde esté instalado Visual Studio 2012 o Team Explorer 2012 y escriba:

   cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE
   

   En una edición de 64 bits de Windows, reemplace %programfiles% por %programfiles(x86)%.

2. Escriba los comandos siguientes, sustituyendo los datos por los argumentos que se muestran y, a continuación, elija la tecla ENTRAR.

   witadmin changefield /collection:CollectionURL /n:System.AreaId /name:"Area Id"
   witadmin changefield /collection:CollectionURL /n:System.AttachedFileCount /name:"Attached File Count"
   witadmin changefield /collection:CollectionURL /n:System.ExternalLinkCount /name:"External Link Count"
   witadmin changefield /collection:CollectionURL /n:System.HyperLinkCount /name:"Hyperlink Count"
   witadmin changefield /collection:CollectionURL /n:System.RelatedLinkCount /name:"Related Link Count"
   

   Utilice este formato para CollectionURL: http://ServerName:Port/VirtualDirectoryName/CollectionName, por ejemplo: http://srvalm:8080/tfs/DefaultCollection.

   Volver al principio

2.(Agile solamente) Cambiar el nombre del tipo de elemento de trabajo Escenario

Para minimizar la cantidad de personalizaciones que necesita realizar y para adaptarse a las actualizaciones futuras de la plantilla de proceso Agile, debe cambiar el nombre del tipo de elemento de trabajo Escenario al nombre Caso de usuario.

Realice esta tarea para cada proyecto de equipo que desee actualizar.

• Escriba el comando siguiente, sustituyendo los datos por los argumentos que se muestran y, a continuación, elija la tecla ENTRAR.

  witadmin renamewitd /collection:CollectionURL /p:projectName /n:Scenario /new:"User Story"
  

  Sugerencia

  Delimite con comillas los parámetros que contengan espacios.Por ejemplo, especifique /p:"My Project X" si el nombre del proyecto contiene espacios.

Volver al principio

3.Descargar la versión más reciente de la plantilla de proceso de MSF

Consulte este artículo sobre cómo Descargar la versión más reciente de las plantillas de proceso.

Volver al principio

4.Importar tipos de vínculo

Importe los tipos de vínculo, SharedSteps y TestedBy, que se encuentran en la carpeta LinkTypes de la plantilla de proceso que descargó en la tarea 3.

Realice esta tarea para cada colección de proyectos de equipo definida en su Team Foundation Server actualizado.

• Escriba los dos comandos siguientes, sustituyendo los datos por los argumentos que se muestran y, a continuación, elija la tecla ENTRAR.

  witadmin importlinktype /collection:CollectionURL /f:"DirectoryPath\TestedBy.xml"
  witadmin importlinktype /collection:CollectionURL /f:"DirectoryPath\SharedStep.xml"
  

  Para DirectoryPath, especifique la ubicación de la carpeta LinkTypes de la plantilla de proceso que ha descargado. La ruta de acceso del directorio debe tener esta estructura: Unidad:\CarpetaPlantillasMSF\WorkItem Tracking\LinkTypes.

  Volver al principio

5.(Opcional) Aplicar personalizaciones a las versiones más recientes de los tipos de elemento de trabajo

Si ha personalizado alguno de los siguientes tipos de elemento de trabajo, debe actualizar la versión más reciente de estos tipos con sus personalizaciones. Las tablas siguientes resumen los campos que se quitan y agregan en las versiones más recientes de cada plantilla de proceso.

Tipos de elemento de trabajo de Agile

Tipos de elemento de trabajo de CMMI

Los tipos de personalizaciones que puede aplicar incluyen adiciones de campos, adiciones o cambios en listas de selección y adiciones a razones de flujo de trabajo. No cambie los estados de los flujos de trabajo, ya que se utilizan en la configuración del proceso y en las herramientas de planificación Agile. Si necesita cambiar el flujo de trabajo, hágalo cuando haya terminado la actualización y siga las instrucciones para asignar metaestados que se proporcionan en este artículo sobre cómo Configurar y personalizar herramientas de planeación ágiles para un proyecto de equipo.

Si usa otros tipos de elemento de trabajo definidos en la plantilla de proceso y desea actualizarlos a las versiones más recientes, aplique también las personalizaciones que haya realizado en ellos. Además, si ha definido un tipo de elemento de trabajo personalizado que usa para realizar un seguimiento de los casos de prueba, debe aplicar las personalizaciones de ese tipo al tipo de elemento de trabajo Caso de prueba proporcionado con la plantilla de proceso más reciente.

Para más información sobre cómo trabajar con los artefactos que proporcionan estas plantillas de procesos, vea los temas siguientes:

• Plantilla de proceso de Agile (versión 6.0)

• Plantilla de proceso de CMMI (versión 6.0)

Volver al principio

6.Importar tipos de elemento de trabajo

Importe los siguientes tipos de elemento de trabajo, según la plantilla de proceso con la que esté trabajando.

• Agile: Error, Tarea, Caso de usuario, Caso de prueba, Pasos compartidos, Solicitud de revisión de código, Respuesta de revisión de código, Solicitud de comentarios y Respuesta a comentarios

• CMMI: Error, Tarea, Requisito, Caso de prueba, Pasos compartidos, Solicitud de revisión de código, Respuesta de revisión de código, Solicitud de comentarios y Respuesta a comentarios

Realice esta tarea para cada proyecto de equipo que desee actualizar.

• Escriba el comando siguiente para cada tipo de elemento de trabajo que necesite importar, sustituyendo los datos por los argumentos que se muestran y, a continuación, elija la tecla ENTRAR.

  witadmin importwitd /collection:CollectionURL /p:projectName /f:"DirectoryPath\WITName"
  

  Sugerencia

  Especifique el nombre del archivo xml, no el nombre descriptivo del tipo de elemento de trabajo.Por ejemplo, puede especificar CodeReviewRequest.xml para el tipo de elemento de trabajo Solicitud de revisión de código.

  Para DirectoryPath, especifique la ubicación de la carpeta TypeDefinitions de la plantilla de proceso que ha descargado. La ruta de acceso del directorio debe tener esta estructura: Unidad:\CarpetaPlantillaMSF\WorkItem Tracking\TypeDefinitions.

• (Opcional) Para comprobar que los tipos de elemento de trabajo son accesibles, abra Team Explorer o Team Web Access. Puede que necesite actualizar la memoria caché para ver los cambios.

Volver al principio

7.Importar el archivo de categorías

Importe el archivo de categorías ubicado en la carpeta WorkItem Tracking de la plantilla de proceso que ha descargado. Las categorías permite la agrupación inteligente de tipos de elemento de trabajo. Para obtener más información, consulte este artículo sobre cómo Usar categorías para agrupar tipos de elementos de trabajo.

• En la ventana del símbolo del sistema, escriba el comando siguiente, sustituyendo los datos por los argumentos que se muestran y, a continuación, elija la tecla ENTRAR.

  witadmin importcategories /collection:CollectionURL /p:projectName /f:"DirectoryPath\categories.xml"
  

  Para DirectoryPath, especifique la ubicación de la carpeta WorkItem Tracking de la plantilla de proceso que ha descargado. La ruta de acceso del directorio debe tener esta estructura: Unidad:\CarpetaPlantillaMSF\WorkItem Tracking\WorkItem Tracking.

Volver al principio

8.Importar el archivo de configuración de proceso

El archivo de configuración de proceso determina el diseño y características disponibles a través de las páginas Trabajo pendiente y Panel de Team Web Access. Para usar estas páginas, debe importar el archivo de configuración de proceso.

• Importe el archivo de definición XML de la configuración de proceso.

  witadmin importprocessconfig /collection:CollectionURL /p:" ProjectName" /f:"DirectoryPath\ProcessConfiguration.xml"
  

  Para DirectoryPath, especifique la ubicación de la carpeta Process de la plantilla de proceso que ha descargado. La ruta de acceso del directorio debe tener esta estructura: Unidad:\CarpetaPlantilla\WorkItem Tracking\Process.

Volver al principio

9.Comprobar el acceso a las nuevas características

Realice las tareas que se describen en este artículo sobre cómo New features added when you update Team Foundation Server.

Volver al principio

Tareas adicionales para interactuar con Microsoft Test Manager

Realice las tareas siguientes para completar las actualizaciones necesarias para interactuar con Test Manager.

1.Especificar el tipo de error que se va a crear en Microsoft Test Manager

Si desea admitir la creación automática de un elemento de trabajo para realizar el seguimiento de defectos de código o errores que se produzcan cuando un miembro del equipo de pruebas use Test Manager, debe especificar el tipo de error que se utilizará para el proyecto de equipo existente. El comando 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 debe crear y los tres campos de datos que Test Manager rellenará. Los tres campos son pasos de reproducción, información del sistema y la compilación en la que se detectó el defecto. Cuando un evaluador ejecuta una prueba y encuentra un defecto, puede crear un error en el que esos tres campos se rellenan automáticamente.

1. Abra el Bloc de notas o un editor de texto y copie el código siguiente en el archivo:

   <?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>
   

   Nota

   Si el tipo de elemento de trabajo que se utiliza para crear los defectos de código es un valor distinto de "Error", sustituya "Bug" en el ejemplo anterior por el nombre de ese tipo de elemento de trabajo.

2. Guarde el archivo con el nombre bugfieldmappings.xml.

3. En la ventana del símbolo del sistema, escriba el comando siguiente, sustituyendo los datos por los argumentos que se muestran y, a continuación, elija la tecla ENTRAR.

   tcm bugfieldmapping /import /mappingfile:"DirectoryPath\bugfieldmappings.xml" /collection:CollectionURL /teamproject:projectName
   

   Para DirectoryPath, especifique la carpeta en la que guardó el archivo bugfieldmappings.xml.

   Para obtener más información, consulte Personalizar y administrar la experiencia de pruebas [tcm y Microsoft Test Manager].

Volver al principio

2.Conceder permisos para probar miembros del equipo

Debe conceder permisos a los miembros del equipo que van a administrar entornos de prueba y configuraciones de pruebas, crear y ver ejecuciones de pruebas y realizar otras tareas.

En la tabla siguiente se describen los permisos que controlan el acceso a las funciones de prueba y permiten interactuar con el proyecto de equipo para realizar pruebas. También se indican las asignaciones predeterminadas que se realizan en la versión 5.0 de las plantillas de proceso MSF, además de los permisos que se recomienda conceder a los evaluadores manuales y jefes de pruebas.

Permiso	Descripción	Ámbito	Lectores	Contributors	Generadores	Recomendado para el personal de pruebas manuales	Recomendado para los jefes de pruebas
Ver información de nivel de proyecto	Se puede ver la pertenencia a grupos de nivel de proyecto y los permisos de esos miembros.	A nivel del proyecto
Ver series de pruebas	Se pueden ver los planes de pruebas en este nodo.	A nivel del proyecto
Crear series de pruebas	Se pueden agregar y quitar resultados de pruebas y agregar o modificar ejecuciones de pruebas del proyecto de equipo.	A nivel del proyecto
Administrar configuraciones de prueba	Se pueden crear y eliminar las configuraciones de prueba del proyecto de equipo.	A nivel del proyecto
Administrar entornos de prueba	Se pueden crear y eliminar los entornos de prueba del proyecto de equipo.	A nivel del proyecto
Eliminar series de pruebas	Se puede eliminar una prueba programada para el proyecto de equipo.	A nivel del proyecto
Ver este nodo	Se puede ver la configuración de seguridad de un nodo de área.	Nodo de área
Administrar planes de pruebas	Se pueden crear y editar los planes de pruebas asignados a un nodo de área. Si no se han ejecutado planes de pruebas, también se pueden eliminar.	Nodo de área
Administrar controladores de pruebas	Se pueden registrar y eliminar del registro controladores de pruebas para la colección de proyectos de equipo.	Colección de proyectos

Puede conceder permisos siguiendo los procedimientos que se indican para el ámbito específico:

• Puede establecer permisos de nivel de proyecto o de nodo de área desde la página de administración de Team Web Access. Consulte Administrar permisos y Agregar y modificar rutas de acceso de área e iteración.

• Puede establecer permisos para la colección de proyectos desde Team Explorer (seleccione Equipo, Configuración de la colección de proyectos de equipo, Seguridad), o abriendo y utilizando la consola de administración de Team Foundation, o mediante las herramientas de línea de comandos TFSSecurity y tf. Para obtener más información, consulte Grupos de nivel de colección.

Para obtener más información, consulte Cambiar los permisos de un grupo o usuario.

Volver al principio

3.Iniciar Microsoft Test Manager

Una vez realizadas las tareas de actualización que se describen anteriormente en este tema, puede iniciar Microsoft Test Manager, conectarse al proyecto y empezar a planificar sus trabajos de pruebas. Para más información, vea Probar la aplicación.

Volver al principio

Información adicional sobre los cambios realizados al actualizar TFS

Al actualizar desde Visual Studio Team System 2008 Team Foundation Server a TFS 2012, recibirá las actualizaciones que se han aplicado a TFS 2010 y TFS 2012. Se han producido varios cambios de arquitectura con la versión TFS 2010. Para obtener más información acerca de los cambios realizados por la actualización a la versión más reciente de TFS desde Visual Studio Team System 2008 Team Foundation Server, consulte los siguientes recursos:

• Conceptos clave de Team Foundation Server 2010 (entrada de blog en inglés)

• Actualizar un proyecto de equipo actualizado para tener acceso a nuevas características (artículo de VS ALM 2010)

• Encontrar informes después de actualizar a Team Foundation Server 2010 (artículo de VS ALM 2010)

• Cambios y adiciones al esquema para el cubo de Analysis Services (artículo de VS ALM 2010)

• Changes made to team projects and default process templates during upgrade of Team Foundation Server (artículo de VS ALM 2012)

Vea también

Conceptos

Configurar características después de una actualización de TFS

Otros recursos

witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo