Personalizar una plantilla de proceso

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

Las plantillas de proceso definen los objetos y procesos disponibles al crear un proyecto. Al personalizar una plantilla de proceso, se personaliza 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 el flujo de trabajo(Estados, motivos, 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 a las herramientas de Agile

Nota:

Si busca plantillas de proyecto para el desarrollo de software, consulte Creación de plantillas de Visual Studio. 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 de Agile define el conjunto de artefactos que se muestran en la imagen siguiente.

Artefactos de plantilla de proceso Agile

Agile process template artifacts

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 él 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 desea 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 solo 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 interdependente 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á familiarizado con las plantillas de proceso, revise primero las plantillas de proceso predeterminadas.

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

    Puede modificar los procesos del proyecto después de crearlo. A medida que trabaje 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, que incluye planes de prueba, conjuntos de pruebas y casos de prueba, consulte Personalización de la experiencia de seguimiento del trabajo. Las personalizaciones que realice modificando un archivo de definición XML para un proyecto son los mismos tipos de personalizaciones que se realizan 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 los 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 elementos 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, consulte 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 para acceder a las personalizaciones que ha realizado anteriormente, es posible que tenga que agregar personalizaciones proporcionadas con las nuevas plantillas.

  • Si está pensando en realizar personalizaciones extensas, 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 nuevo equipo Project. 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.

Process Template Plugins

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 un sitio del Administrador de informes y un portal de proyecto de SharePoint.

Si desea que estas características se creen para un proyecto en tfS local, cree el proyecto a partir de Visual Studio o Team Explorer. Para obtener más información, consulte Plantilla de proceso y archivos de complemento, Compatibilidad con el cliente para la creación de proyectos.

Los complementos Build, Portal y Reporting 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 Required
Portal Required Required Recomienda Solo se requiere para admitir los paneles básicos
Informes Required Required

Para personalizar una plantilla de proceso, debe personalizar uno o más archivos asociados a un área funcional. Aunque la personalización de un objeto es bastante sencilla, querrá asegurarse de que no interdependencias al personalizar. El archivo de complementoProcessTemplate.xml define qué complementos se van a incluir 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 de área e iteración

Seguimiento de elementos de trabajo

  • Definiciones de WIT
  • Categorías
  • Configuración de proceso
  • Tipos de vínculo
  • Elementos detrabajo 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 necesarios y las dependencias de complementos, consulte Definición de dependencias para grupos de tareas y tareas.

    Restricciones de nomenclatura y complemento

    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 colocan en 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, consulte Restricciones de nomenclatura.

    • La mayoría de los componentes de plantilla de proceso que personalice afectarán solo al proyecto que cree mediante la plantilla de proceso. Las excepciones a esta regla son listas globales, tipos de vínculo y campos de elementos 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 se limitan a 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 elementos 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 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.

    Process Template Customization Workflow

    Paso Tarea
    Step 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.
    Step 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.
    Step 3 Upload una plantilla de proceso. Una vez que haya personalizado la plantilla, cárguelo en la colección de proyectos donde creará el proyecto.

    Lo ideal es 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 está cargando 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.
    Step 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.
    Step 5 Compruebe los cambios en las plantillas de proceso. Antes de colocar 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, los terceros hacen disponibles las plantillas de proceso que han creado. Es posible que tenga que realizar un trabajo adicional después de una actualización de TFS al usar una plantilla de proceso proporcionada por un tercero, como se describe Personalización de la experiencia de seguimiento del trabajo, las 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. Consulte Cambio de permisos de nivel de colección 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.
      En función de 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 siguientes áreas:

    • 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 antiguos (anteriores 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: crear y editar 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 se pueden personalizar Office Excel informes y 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 nuevo equipo Project. Para obtener más información, consulte Personalización de TFS Project Portales.