Personalización del proceso XML local

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

El modelo de proceso XML local proporciona compatibilidad para personalizar objetos de seguimiento de trabajo y herramientas de Agile para un proyecto. Con este modelo, puede actualizar la definición XML de los tipos de elementos de trabajo, la configuración del proceso, las categorías, etc. También puede actualizar los atributos de los campos.

Personaliza la experiencia de seguimiento del trabajo para satisfacer sus necesidades empresariales e informes. Las personalizaciones más comunes incluyen agregar un campo personalizado, modificar un formulario de elemento de trabajo o agregar un tipo de elemento de trabajo personalizado.

Nota:

Para obtener instrucciones sobre cómo configurar y personalizar el proyecto y los equipos para satisfacer sus necesidades empresariales, revise Configuración y personalización de Azure Boards.

Para Azure DevOps Server 2019 y versiones posteriores, tiene la opción de elegir modelos de proceso. Al crear una colección de proyectos, deberá elegir entre el modelo de proceso XML local y el modelo de proceso de herencia. Para más información, consulte Personalización del seguimiento del trabajo, Elija el modelo de proceso para la colección de proyectos.

Team Foundation Server usa el modelo de proceso XML local para admitir personalizaciones. Este modelo se basa en la actualización e importación de archivos XML mediante la herramienta de línea de comandos witadmin .

Importante

Para personalizar un proyecto de Azure DevOps Services, consulte Acerca de la personalización de procesos y los procesos heredados. Este artículo solo se aplica a las implementaciones locales.

Personalizaciones compatibles

Puede realizar las siguientes tareas al trabajar con el modelo de proceso XML local.

Ámbito

Asistencia para la personalización

Campos

Seleccionar listas

tipos de elemento de trabajo

Trabajos pendientes y configuración de procesos

Plantilla de proceso

Tipos de vínculo

Secuencia de personalización

Al administrar una implementación local, se realizan la mayoría de las personalizaciones mediante la siguiente secuencia. Esta secuencia admite la actualización de la definición XML para WIT, listas globales, configuración de procesos y categorías. Esta secuencia admite actualizaciones individuales a través de la importación de sus respectivos archivos de definición XML modificados. Se recomienda mantener los archivos de definición XML en un repositorio para el control de versiones.

Export XML definition fileEdit XML definition fileImport WIT definition fileRefresh and verify changes

Además, puede usar la herramienta witadmin para enumerar objetos, cambiar el nombre de LAS WIT, quitar wit de forma permanente, etc.

Sugerencia

Con witadmin, puede importar y exportar archivos de definición. Otras herramientas que puede usar incluyen el Editor de procesos (requiere que haya instalado una versión de Visual Studio). Instale el editor de plantillas de proceso desde Visual Studio Marketplace.

O bien, puede usar tfS Team Project Manager, un cliente de código abierto disponible en GitHub.

Sugerencia

Con witadmin, puede importar y exportar archivos de definición. Otras herramientas que puede usar incluyen el Editor de procesos (requiere que haya instalado una versión de Visual Studio). Instale el editor de plantillas de proceso de TFS desde Visual Studio Marketplace. Puede usar esta versión del Editor de procesos para modificar los formularios de elementos de trabajo de estilo antiguo. No se puede usar para editar formularios asociados a los nuevos formularios web.

O bien, puede usar tfS Team Project Manager, un cliente de código abierto disponible en GitHub.

Implicaciones de mantenimiento y actualización

Antes de personalizar, debe comprender cómo las personalizaciones pueden afectar al proyecto al actualizar el servidor de nivel de aplicación.

Las actualizaciones a una implementación local pueden introducir nuevas características que requieren actualizaciones de los objetos usados para realizar un seguimiento del trabajo. Entre estos objetos se incluyen los tipos de elemento de trabajo, las categorías y la configuración de procesos. Minimizar los cambios en el flujo de trabajo de un WIT o la configuración del proceso puede ayudar a minimizar el trabajo que debe realizar al actualizar la implementación.

Para minimizar la cantidad de trabajo manual que deberá realizar después de una actualización, comprenda qué personalizaciones admiten una ruta de actualización sencilla y que no lo hacen.

Compatible con la actualización rápida

Con las siguientes personalizaciones, puede usar el Asistente para configurar características para aplicar automáticamente los cambios en el proyecto necesarios para las nuevas características.

  • Campos: agregar campos personalizados, personalizar una lista de selección, agregar o modificar rutas de acceso de área e iteración y agregar reglas a un campo.
  • WIT: agregar WIT personalizados y cambiar el diseño del formulario.
  • Categorías: agregar categorías personalizadas.
  • Herramientas ágiles: personalización de las columnas en el panel Kanban, personalización del panel de adición rápida
  • Integración de Office: agregar o cambiar cómo se asignan los campos de Project a los campos de TFS.

Para obtener más información sobre el Asistente para configurar características, consulte Configurar características después de una actualización.

Compatible, pero puede requerir actualizaciones manuales

El Asistente para configurar características requiere que existan campos, estados de flujo de trabajo y tipos de elementos de trabajo específicos en el proyecto. Al realizar las siguientes personalizaciones, es posible que tenga que modificar el proceso personalizado para que se ejecute el asistente o que tenga que actualizar el proyecto manualmente.

  • Campos: cambie los atributos de un campo existente, quite los campos a los que se hace referencia en la configuración del proceso.
  • WIT: cambiar el flujo de trabajo.
  • Herramientas ágiles: cambie los WIT definidos para la categoría de requisitos, la categoría de tarea o la categoría de características.
  • Herramientas ágiles: cambie la asignación de metastate definida en la configuración del proceso.
  • Herramientas ágiles: cambie un campo especificado para en TypeField la configuración del proceso.

Además, los cambios que realice en los WIT o el flujo de trabajo podrían requerir actualizaciones de otros artefactos proporcionados con el proceso, como Excel o informes de SQL Server Reporting Services.

Personalizaciones que evitar

Debe evitar realizar las siguientes personalizaciones porque pueden provocar conflictos de esquema en el almacenamiento de datos o causar problemas al actualizar proyectos después de una actualización de TFS.

  • Campos:
    • Cambiar el nombre descriptivo de un campo (un campo especificado en un archivo de definición WIT)
    • Cambie uno o varios atributos de informes o el atributo para sincronizar los nombres de persona con Active Directory de un campo predeterminado.
  • WIT: cambiar el nombre o eliminar los WIT
  • Categorías: cambie el nombre de las categorías predeterminadas o cambie los WIT especificados en las categorías predeterminadas.

Para obtener más información sobre los atributos de informes, consulte Adición o modificación de campos de elementos de trabajo para admitir informes.

  • Identifique las opciones mejores para personalizar los WIT que admiten los requisitos de seguimiento. Al cambiar objetos que realizan un seguimiento de los elementos de trabajo, debe identificar cómo afectarán estos cambios a los proyectos existentes y futuros.
  • Coloque los procesos y todos los archivos de definición XML bajo control de versiones. No implemente objetos que haya definido pero que no haya almacenado en un repositorio.
  • Pruebe los objetos personalizados del mismo modo que probaría el software.
  • Minimice el número de campos personalizados que incluya. Minimice el número de campos que defina para informes.

Reemplazar la ruta de acceso del área de equipo por un campo de equipo

La configuración predeterminada para los proyectos asocia cada equipo a una ruta de acceso de área. Si la organización tiene varios equipos que trabajan en muchas áreas de producto a partir de un trabajo pendiente común, es posible que esta configuración no se ajuste al modo en que desea organizar el trabajo. Si agrega un campo personalizado que represente los equipos de la organización, podrá volver a configurar las herramientas y las páginas de planeación de Agile para que ayuden a los equipos y desacoplen la asignación a equipos y rutas de acceso de área.

Usar campos de equipo en lugar de rutas de acceso de área para admitir equipos describe cómo cambiar la configuración predeterminada.