Personalizar una plantilla de proceso

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Importante

Este artículo se aplica a la personalización de proyectos para los modelos de proceso XML locales. Para obtener información general sobre los modelos de proceso, consulte Personalización de la experiencia de seguimiento de trabajo.

Las plantillas de proceso definen los objetos y procesos disponibles al crear un proyecto. Al personalizar una plantilla de proceso, puede personalizar uno de los objetos más. Entre los tipos comunes de personalizaciones que se pueden llevar a cabo se incluyen:

  • Agregar un nuevo campo a un tipo de elemento de trabajo existente (WIT)
  • Modificar la lista de selección de valores para un campo
  • Cambiar los estados — de flujo de trabajo, razones, transiciones, acciones — de un WIT existente
  • Editar el diseño del formulario de elemento de trabajo
  • Agregar o quitar un tipo de elemento de trabajo
  • Cambiar la configuración del proceso o los valores predeterminados asociados con las herramientas de Agile

Nota

Si busca plantillas de proyecto para el desarrollo de software, consulte Creación de Visual Studio plantillas. En este tema se describen las plantillas de proceso que se usan para crear proyectos definidos en Azure DevOps Services y TFS.

Las plantillas de proceso de TFS definen las configuraciones predeterminadas, así como los siguientes artefactos que su equipo usa para planear y realizar un seguimiento del trabajo, colaborar y compartir información.

Por ejemplo, la plantilla de proceso agile define el conjunto de artefactos que se muestran en la imagen siguiente.

Artefactos de plantilla de proceso Agile

Artefactos de plantilla de proceso Agile

Muchos de estos artefactos dependen de los WIT que se usan para realizar un seguimiento del trabajo. Por ejemplo, los campos de datos definidos en la definición de WIT como, Característica, Error, Caso de usuario o Tarea también se usan para definir consultas e informes 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, puede cambiar las configuraciones y personalizar los artefactos. Sin embargo, al personalizar la plantilla de proceso antes de crear los proyectos, todos los proyectos resultantes que cree a partir de ella coincidirán con un conjunto estándar de procesos de equipo. Entre las principales razones por las que podría interesarle personalizar una plantilla de proceso se incluyen:

  • Tiene previsto crear varios proyectos y quiere minimizar las tareas repetitivas que tendrá que implementar más adelante en cada proyecto 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 solo proyecto, puede considerar simplemente crear el proyecto y personalizar uno o varios objetos más adelante.

¿Cómo se usan las plantillas de proceso?

El uso principal de las plantillas de proceso es crear un proyecto. Para el modelo de proceso XML hospedado, también se usa para actualizar un proyecto. Un proyecto proporciona el conjunto de objetos, artefactos y configuraciones definidos en el conjunto interdependiente de archivos de plantilla. El proyecto se usa para organizar el código fuente, realizar un seguimiento del trabajo y la información, compilar software y admitir actividades de prueba.

Modelo de proceso XML hospedado

Modelo de proceso XML local

  • Crear un proyecto

¿Por dónde debo empezar?

Antes de empezar a personalizar una plantilla de proceso, querrá familiarizarse con lo que puede configurar y personalizar y, a continuación, planear los cambios en consecuencia.

  • Si no está nuevo en el proceso de plantillas, revise primero las plantillas de proceso predeterminadas.

  • Si desea familiarizarse con la estructura de archivos de una plantilla de proceso, revise una descripción de cada archivo o descargue una plantilla de proceso.

    Puede modificar los procesos del proyecto después de crearlo. A medida que trabaja con un proyecto, es posible que la configuración inicial definida por la plantilla de proceso ya no satisfaga sus necesidades.

  • Si está más interesado en personalizar los objetos usados para realizar un seguimiento del trabajo, lo que incluye planes de pruebas, conjuntos de pruebas y casos de prueba, consulte Personalización de la experiencia de seguimiento del trabajo. Las personalizaciones que realiza modificando un archivo de definición XML para un proyecto son los mismos tipos de personalizaciones que realiza en un archivo de plantilla de proceso.

    Si desea agregar o modificar tipos de elementos de trabajo,puede lograrlo sin cambiar toda la plantilla de proceso. Puede realizar y probar cambios mediante un proyecto existente. Para el modelo de proceso XML local, puede usar las herramientas de línea de comandos witadmin exportwitd e importwitd para descargar y cargar los archivos de definición XML para los tipos de elemento de trabajo.

  • Si necesita actualizar una plantilla de proceso personalizada para admitir el uso del Asistente para configurar características después de una actualización de TFS, vea Configurar características después de una actualización.

    Cuando se actualiza TFS a una versión posterior, se cargan las últimas versiones de las plantillas de proceso predeterminadas de TFS. Para usar las plantillas actualizadas disponibles y acceder a las personalizaciones que hizo anteriormente, es posible que tenga que agregar personalizaciones proporcionadas con las nuevas plantillas.

  • Si está pensando en realizar personalizaciones exhaustivas, revise cómo los cambios que realice afectarán al mantenimiento y la actualización de los proyectos.

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

Las plantillas de proceso constan de nueve complementos. Cada complemento define un conjunto de tareas que se ejecutarán y las pantallas que aparecen al iniciar el Asistente para Project nuevo 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 proceso

Importante

Al crear un proyecto desde el portal web, se omiten varios archivos de plantilla de proceso. En concreto, no se admiten los archivos que crearían Administrador de informes sitio web y SharePoint portal del proyecto.

Si desea que estas características se creen para un proyecto en el TFS local, cree el proyecto desde Visual Studio o Team Explorer. Para obtener más información, consulte Plantilla de proceso y archivos de complemento, Soporte técnico de cliente para la creación de proyectos.

Los complementos de compilación, portal e informes requieren que se hayan instalado y configurado los siguientes recursos.

Complemento Team Foundation Build Productos de SharePoint SQL Server Analysis Services SQL Server Reporting Services
Build Obligatorio
Portal Obligatorio Obligatorio Recomienda Solo se requiere para admitir los paneles básicos
Generación de informes Obligatorio Obligatorio

Para personalizar una plantilla de proceso, debe personalizar uno o más archivos asociados a un área funcional. Aunque personalizar un objeto es bastante sencillo, querrá asegurarse de que no se interrumpirán las interdependencias al personalizar. El ProcessTemplate.xml complemento define qué complementos se incluirán en la plantilla. Este archivo contiene todos los grupos de tareas que desea ejecutar para crear un proyecto. Cada grupo de tareas hace referencia a un archivo de complemento XML subordinado donde se definen las tareas concretas.

Teams, grupos, permisos, rutas de acceso & área de trabajo e iteración

Seguimiento de elementos de trabajo

  • Definiciones de WIT
  • Categorías
  • Configuración de proceso
  • Tipos de vínculo
  • Elementos de trabajo o consultas de elementos de trabajo
  • Control de versiones, compilación, laboratorio y administración de pruebas

    Informes y portal de proyectos

    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.

    Dependencias del complemento

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

    Por ejemplo, las consultas de elemento 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 elemento 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 y las dependencias de complementos necesarios, consulte Definición de dependencias para grupos de tareas y tareas.

    Restricciones de complementos y nomenclatura

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

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

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

    • 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 con todos los tipos de elementos de trabajo definidos para una colección de proyectos. 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 tienen como ámbito una colección de proyectos. Si personaliza cualquiera de estos objetos, el cambio se reflejará en todos los proyectos definidos en la colección y en los tipos de elemento de trabajo que contienen ese campo de elemento 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.

    Pasos para personalizar una plantilla de proceso

    Personalizar una plantilla de proceso es un proceso iterativo. Necesitará una colección de proyectos 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 Descargue una plantilla de proceso. Antes de poder personalizar una plantilla de proceso, debe descargarla a su equipo local.

    Para minimizar las modificaciones que debe realizar, seleccione una plantilla que coincida más estrechamente con los procesos del equipo. En general, elija una plantilla de proceso basada en los tipos de elemento de trabajo y flujo de trabajo.
    Paso 2 Modifique o agregue 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 Upload una plantilla de proceso. Después de personalizar la plantilla, cárbala en la colección de proyectos donde creará el proyecto.

    Idealmente, debe usar una colección de proyectos que otros proyectos no usen. 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, querrá que la colección de proyectos admita los mismos recursos a los que desea acceder, como un portal de proyectos 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, realizó un cambio y ahora carga la plantilla, debe cambiar su nombre o eliminar la plantilla de proceso existente de la colección de proyectos.

    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 Cree un proyecto. Para probar nuevas plantillas de proceso, debe crear un proyecto. Para crear un proyecto, acceda al Asistente para nuevo equipo Project desde Team Explorer.

    Si se produce algún error, vea el registro para la creación del proyecto. 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 proyectos innecesarios mediante la herramienta de línea de comandos TFSDeleteProject.
    Paso 5 Compruebe los cambios realizados en las plantillas de proceso. Antes de poner la plantilla de proceso en modo de producción y usarla como base para varios proyectos, 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 ha introducido ningún conflicto de esquema.

    A veces, terceros hacen disponibles las plantillas de proceso que han creado. Es posible que deba realizar un trabajo adicional después de una actualización de TFS cuando use una plantilla de proceso proporcionada por un tercero, como se describe Personalización de la experiencia de seguimiento de trabajo, Implicaciones de mantenimiento y actualización (TFS).

    Permisos necesarios

    Para descargar o cargar plantillas de proceso, debe ser miembro del grupo administradores de recopilación de Project o el permiso Administrar plantilla de proceso debe establecerse en Permitir. Vea Agregar cuentas para administrar colecciones de proyectos.

    Herramientas que admiten la personalización de una plantilla de proceso

    Puede personalizar una plantilla de proceso mediante una de las siguientes herramientas:

    • Cualquier editor de texto o editor XML para modificar archivos XML.

    • TFS Team Project Manager,un cliente de código abierto disponible en GitHub.

    • Herramienta Editor de procesos.
      Según la versión de Visual Studio que haya instalado, obtenga la herramienta Editor de procesos de una de las siguientes extensiones.

    La herramienta Editor de procesos proporciona una interfaz de usuario que puede usar para personalizar las áreas siguientes:

    • Seguimiento de elementos de trabajo:
      • Crear y editar definiciones de WIT, incluida la adición de campos, el cambio de flujos de trabajo y la modificación de formularios de elementos de trabajo de estilo antiguo (anterior a TFS 2017)
      • 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
    • Project clasificaciones y jerarquías:
      • 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 para Microsoft Project
    • Grupos de seguridad: creación y edición de grupos de 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

    No puede personalizar los informes Office Excel paneles a través de los archivos de plantilla de proceso. Estos artefactos se crean para un proyecto en función de las selecciones que realice en el Asistente para Project equipo. Para obtener más información, vea Personalización de TFS Project Portales.