Personalizar una plantilla de proceso

Una plantilla de proceso corresponde a un conjunto interdependiente de archivos que se utilizan para crear un proyecto de equipo de Team Foundation Server (TFS). Un proyecto de equipo es una herramienta de planeación central que se utiliza para realizar el seguimiento de información y para organizar el código fuente, las compilaciones, las pruebas y los planes del equipo. Además de para crear un proyecto de equipo, puede utilizar una plantilla de proceso de TFS para actualizar un proyecto de equipo existente tras una actualización a un TFS local.

Si busca plantillas de proyecto para el desarrollo de software, consulte Crear plantillas de Visual Studio. Este tema trata sobre las plantillas de proceso para la creación de proyectos de equipo de TFS.

Una plantilla de proceso de TFS define varias configuraciones predeterminadas, así como los siguientes artefactos que su equipo utiliza para colaborar, compartir información, y planear y realizar un seguimiento del trabajo.

Artefactos de plantilla de proceso Agile de TFS 2013

Artefactos de plantilla de proceso Agile de TFS 2013

Muchos de estos artefactos dependen de la creación y la definición de los objetos que se definen para el seguimiento del trabajo. Por ejemplo, los campos de datos definidos en la definición de los tipos de elementos de trabajo (como característica, error, caso de usuario o tarea) también se utilizan para definir los informes y las consultas de elementos de trabajo. Además de estos artefactos, también puede definir áreas e hitos iniciales del proyecto, la configuración de seguridad y otras configuraciones predeterminadas compatibles con el control de versiones y la administración de pruebas.

Después de crear un proyecto de equipo, puede cambiar las configuraciones y personalizar los artefactos. Sin embargo, al personalizar la plantilla de proceso antes de crear los proyectos de equipo, todos los proyectos de equipo resultantes que cree a partir de dicha plantilla coincidirán con un conjunto estándar de procesos del equipo. Entre las principales razones por las que podría interesarle personalizar una plantilla de proceso se incluyen:

  • Tiene previsto crear varios proyectos de equipo y desea reducir al mínimo las tareas repetitivas que tendrá que implementar más adelante en cada proyecto de equipo que cree.

  • Desea asegurarse de que todos los equipos cumplen con ciertos estándares proporcionando las plantillas y las estructuras en el conjunto de herramientas que utilizarán los equipos de desarrollo de software.

  • Necesita actualizar una plantilla de proceso personalizada para que sea compatible con el uso del Asistente para configurar características tras una actualización de TFS.

Si trabaja con un único proyecto de equipo, podría considerar simplemente crear el proyecto de equipo y personalizar uno o más objetos más adelante.

¿Por dónde debo empezar?

Antes de empezar a personalizar una plantilla de proceso, le conviene familiarizarse con lo que puede configurar y personalizar y, a continuación, planear los cambios según corresponda.

Archivos de plantilla de proceso y áreas funcionales que puede personalizar

Las plantillas de proceso constan de nueve complementos. Cada complemento define el conjunto de tareas que se ejecutarán y las pantallas que aparecerán cuando se inicie el Asistente para nuevo proyecto de equipo. Las tareas establecen los permisos, crean las carpetas, activan los sitios o establecen otras variables configurables. Los complementos también especifican las dependencias que una tarea tiene para la finalización correcta de otras tareas.

Complementos de plantilla de procesos

Para personalizar una plantilla de proceso, debe personalizar uno o más archivos asociados a un área funcional. Aunque personalizar un objeto es bastante simple, debe asegurarse de no romper las interdependencias al proceder a dicha personalización.

Imagen conceptual de trabajo en equipo

Equipos y clasificaciones predeterminadas:

Seguimiento de elementos de trabajo:

Imagen conceptual de control de versiones

Control de versiones, compilación, y administración de laboratorio y pruebas:

Imagen conceptual de informes

Informes y portal del proyecto:

Dado que la plantilla de proceso afecta a muchos componentes de un proceso de equipo, es aconsejable planificar, coordinar y realizar un seguimiento de los cambios que va a realizar. En concreto, es posible que desee consultar a jefes de proyecto, jefes de pruebas, jefes de desarrollo y administradores de versiones antes de cambiar la configuración predeterminada de un área.

Pasos para personalizar una plantilla de proceso

Personalizar una plantilla de proceso es un proceso iterativo. Necesitará una colección de proyectos de equipo que esté definida en un servidor que ejecute Team Foundation Server, donde pueda probar la plantilla de proceso para asegurarse de que se ha personalizado correctamente.

Para personalizar una plantilla de proceso, primero descargue una plantilla de proceso existente, modifique o agregue archivos, cargue los archivos de la plantilla de proceso y, a continuación, compruebe los cambios.

Flujo de trabajo de personalización de plantillas de procesos

Paso

Tarea

Paso 1

Descargar una plantilla de proceso. Antes de poder personalizar una plantilla de proceso, debe descargarla a su equipo local.

Para reducir al mínimo las modificaciones que debe realizar, seleccionar la plantilla que mejor coincida con los procesos de su equipo. En general, elija una plantilla de proceso basada en los tipos de elementos de trabajo y flujo de trabajo.

Paso 2

Modificar o agregar archivos. Personalice una plantilla de proceso modificando, eliminando o agregando archivos definidos para una plantilla de proceso. Personalice un complemento o un archivo de definición modificando su contenido XML. Cada archivo de complemento y el archivo de definición de tipos deben cumplir con la definición del esquema XML.

La primera vez que personalice una plantilla de proceso, realice un cambio pequeño. Si realiza muchos cambios sin saber bien cómo afectarán los cambios a la plantilla, se arriesga a que se produzcan errores que resultarán difíciles de depurar.

Asegúrese de que el nombre de la plantilla de proceso es único. Si descarga una plantilla de proceso, realiza cambios en ella y la carga, debe cambiar su nombre o, de lo contrario, sobrescribirá la plantilla de proceso de la colección de proyectos.

Paso 3

Cargar una plantilla de proceso. Una vez personalizada la plantilla, cárguela en la colección de proyectos de equipo en la que creará el proyecto de equipo.

Idealmente, debe utilizar una colección de proyectos de equipo que no utilicen otros proyectos de equipo. Al trabajar en una colección de proyectos de prueba, evita introducir cambios que podrían entrar en conflicto con los procesos de equipo que todavía están en desarrollo. Además, le interesará que la colección de proyectos de equipo admita los mismos recursos a los que tendrán acceso los miembros del equipo, por ejemplo un portal del proyecto y un sitio de informes.

Asegúrese de que el nombre de la plantilla de proceso es único. Si descargó una plantilla de proceso de una colección de proyectos de equipo, realizó algún cambio y ahora va a cargar la plantilla, debe cambiar su nombre o, de lo contrario, eliminará la plantilla de proceso de la colección de proyectos de equipo.

El proceso de carga realiza una comprobación para asegurarse de que el XML es válido. Si recibe algún error al intentar cargar la plantilla de proceso, los cambios realizados son los causantes del error. Revise los cambios y corrija los errores de sintaxis XML que encuentre.

Paso 4

Crear un proyecto de equipo. Para probar nuevas plantillas de proceso, debe crear un proyecto de equipo. Para crear un proyecto de equipo se utiliza el Asistente para nuevo proyecto de equipo de Team Explorer.

Si se produce algún error, examine el registro de creación del proyecto de equipo. Contiene una lista de las tareas que intentó ejecutar y muestra qué tareas generaron un error. Puede asignar tareas con errores al XML para determinar la causa de los errores.

Puede limpiar los proyectos de equipo innecesarios con la herramienta de línea de comandos TFSDeleteProject.

Paso 5

Comprobar los cambios a las plantillas de proceso. Antes de poner la plantilla de proceso en modo de producción y usarla como base para varios proyectos de equipo, debe comprobar que está bien definida. Esta tarea se hace sistemáticamente comprobando que cada objeto y artefacto funcionan como se esperaba.

Si ha agregado un informe, asegúrese de que aparece en Team Explorer. Si ha agregado un campo, asegúrese de que no presente conflictos de esquema.

Preguntas y respuestas

P: ¿Puedo utilizar plantillas de proceso que no sean las plantillas predeterminadas que ofrece TFS?

R: Sí. En ocasiones están disponibles las plantillas de procesos creadas por terceros. Tal vez tenga que trabajar un poco más tras una actualización de TFS si utiliza una plantilla de proceso proporcionada por terceros, tal y como se describe aquí.

Puede hacer una búsqueda en CodePlex.com para determinar si se han cargado plantillas de proceso.

P: ¿Qué permisos necesito para personalizar plantillas de proceso?

R: Para descargar o cargar plantillas de proceso, debe ser un miembro del grupo Administradores de colección de proyectos, o bien el permiso de Administrar plantilla de proceso debe estar establecido en Permitir. Consulte Agregar cuentas para administrar colecciones de proyectos.

P: ¿Qué herramientas puedo usar para personalizar una plantilla de proceso?

R: Puede utilizar cualquier editor de texto o un editor XML para modificar archivos XML. También puede utilizar el Editor de procesos, una herramienta avanzada para Visual Studio para personalizar archivos de plantillas de proceso. Para descargarla, acceda a Herramientas avanzadas de Team Foundation Server.

El Editor de procesos proporciona una interfaz de usuario que puede utilizar para personalizar las siguientes áreas:

  • Seguimiento de elementos de trabajo:

    • Crear y editar las definiciones de tipos de elementos de trabajo, incluida la adición de campos, el cambio de los flujos de trabajo y los formularios del elemento de trabajo

    • Agregar o editar las categorías para agrupar los tipos de elementos de trabajo

    • Editar la configuración de procesos para las herramientas de planeación de Agile

    • Crear y editar consultas de elementos de trabajo y organizar las consultas en carpetas de consulta

    • Crear y editar tipos de vínculo

  • Clasificaciones y jerarquías de proyecto:

    • Crear y editar las rutas de acceso del área de producto

    • Crear y editar versiones hito o rutas de acceso de iteración

    • Modificar el archivo de asignación de Microsoft Project

  • Grupos de seguridad: crear y editar grupos TFS y sus permisos

  • Control de versiones:

    • Editar configuración de desprotección

    • Crear y editar notas de protección

    • Crear y editar grupos TFS y sus permisos

  • Portal e informes:

    • Revisar los archivos que se cargarán y su estructura de carpetas

    • Agregar los archivos que se cargarán

P: ¿Qué recursos son necesarios para admitir complementos específicos?

R: Los complementos Compilación, Portal e Informes requieren estos recursos.

Complemento

Team Foundation Build

Productos de SharePoint

SQL Server 2008 Analysis Services

SQL Server 2008 Reporting Services

Compilar

Obligatorio

Portal

Obligatorio

Obligatorio Se recomienda

Solo se requiere para admitir los paneles básicos

Informes

Obligatorio Obligatorio

P: ¿Existen artefactos que no se pueden personalizar en la plantilla de proceso?

R: Sí. No se pueden personalizar los informes de Microsoft Excel ni los paneles a través de los archivos de plantilla de proceso. Estos artefactos se crean para un proyecto de equipo en función de las selecciones que se realicen en el Asistente para nuevo proyecto de equipo. Para obtener más información, consulte Customizing Team Foundation Server Project Portals.

P: ¿Cómo se utiliza el archivo de complemento ProcessTemplate.xml?

R: Use el archivo de complemento ProcessTemplate.xml para definir qué complementos se van a incluir en la plantilla. Este archivo contiene todos los grupos de tareas que desea ejecutar para crear correctamente un proyecto de equipo. Cada grupo de tareas hace referencia a un archivo de complemento XML subordinado donde se definen las tareas concretas. Haga clic aquí para obtener más información.

P: ¿Qué necesito saber acerca de las dependencias?

R: Muchos objetos se basan en la definición de otros objetos dentro de una plantilla de proceso.

Por ejemplo, las consultas de elementos de trabajo definidas para la plantilla de procesos de Agile usan los nodos de iteración definidos en el archivo Classification.xml. Si cambia las definiciones del nodo de iteración, debe modificar las consultas de elementos de trabajo en que se basan. Puede encontrar estas consultas buscando las siguientes macros en los archivos. wiq:

  • Iteración 1 = @@Iteration%201@@

  • Iteración 2 = @@Iteration%202@@

  • Iteración 3 = @@Iteration%203@@

Para obtener información general sobre los complementos necesarios y las dependencias de complementos, consulte Definir dependencias para grupos de tareas y tareas en archivos de complemento.

P: ¿Hay restricciones que deba tener en cuenta?

R: Sí. Cuando se agregan objetos a una plantilla de proceso, conviene asegurarse de que se etiqueten correctamente para evitar errores de validación de XML.

Revise las siguientes notas y sugerencias:

  • Se aplican restricciones a los nombres o etiquetas de la mayoría de objetos Team Foundation. Para obtener información general sobre las restricciones que se aplican a las plantillas de proceso, grupos de seguridad, nodos de área y de iteración, tipos de elementos de trabajo y campos de elementos de trabajo de nomenclatura, consulte Restricciones de nomenclatura en Team Foundation.

  • La mayoría de los componentes de plantilla de proceso que personalice afectarán solo al proyecto de equipo que cree con la plantilla de proceso. Las excepciones a esta regla son las listas globales, los tipos de vínculo y los campos de elementos de trabajo que se definen para los tipos de elementos de trabajo. Estos objetos se definen para una colección de proyectos de equipo.

  • Cada campo de elemento de trabajo tiene un nombre de referencia de campo asociado que identifica de forma única cada campo. No se puede cambiar el nombre de referencia después de su asignación.

    Además, un campo de elemento de trabajo puede tener un nombre de informe asignado. El nombre del informe debe coincidir en todos los tipos de elementos de trabajo definidos para una colección de proyectos de equipo. En caso contrario, podrían producirse errores de validación al cargar la plantilla de proceso, o conflictos en las bases de datos del almacén de datos.

    Los nombres de campo de elemento de trabajo, los nombres de tipo de vínculo y las listas globales se limitan a una colección de proyectos de equipo. Si personaliza cualquiera de estos objetos, el cambio se reflejará en todos los proyectos de equipo que se definen en la colección y en los tipos de elementos de trabajo que contienen ese campo de elemento de trabajo.

    Para obtener más información, vea Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.

  • El tamaño máximo de una plantilla de proceso es de dos gigabytes. Al personalizar una plantilla de proceso, asegúrese de que los cambios no aumentan su tamaño por encima de ese valor.

P: ¿Existe una referencia para cada elemento XML?

R: Los archivos de plantilla de proceso hacen referencia a dos definiciones de esquema principal. Los archivos de complemento se basan en los esquemas de plantilla de procesos y las definiciones de tipos para los elementos de trabajo se basan en el esquema del seguimiento del trabajo.

P: ¿Dónde puedo obtener más información sobre el Asistente para configurar características?

R: Vea Actualizar un proyecto de equipo actualizado para tener acceso a nuevas características.

P: ¿Dónde puedo ir si tengo más preguntas?

R: Visite el foro de Microsoft sobre las plantillas de proceso de Team Foundation Server.