Procesar archivos de plantilla y complemento

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.

Puede personalizar la configuración inicial de los proyectos personalizando uno o varios archivos de plantilla de proceso. Puede personalizar varios tipos de archivos de plantilla, que incluyen el archivo XML raíz, archivos de complemento y archivos de definición XML. Mediante la personalización de estos archivos, puede definir la configuración inicial de todos los proyectos creados a partir de la plantilla de proceso.

Para obtener información sobre las plantillas de proceso predeterminadas, vea Elegir un proceso. Para obtener información sobre cómo personalizar una plantilla de proceso, consulte Personalización de una plantilla de proceso.

Compatibilidad de cliente para la creación de proyectos

En función de si trabaja desde Azure DevOps Services o TFS, puede crear un proyecto desde el portal web o desde Visual Studio/Team Explorer.

Remoto Azure DevOps Services TFS 2018 y TFS 2017 TFS 2015 y versiones anteriores
Portal web ✔️ ✔️
Visual Studio/Team Explorer ✔️ ✔️

(✔️: compatible; ❌ - No compatible)

Al crear un proyecto desde el portal web, se omiten los siguientes archivos de complemento.

  • Compilación: los permisos de seguridad predeterminados se definen para las funciones de compilación.
  • Lab Management: las herramientas nativas de administración de versiones y compilación reemplazan a las herramientas de administración de laboratorio anteriores. Para más información, consulte Uso de compilación y versión en lugar de Lab Management para pruebas automatizadas.
  • Informes: consulte Agregar informes a un proyecto para agregar SQL informes después de crear el proyecto.
  • Control de versiones: los permisos de seguridad predeterminados y las directivas de protección de TFVC se definen para las funciones de GIT y TFVC.
  • Windows SharePoint Services: TFS 2018 y versiones posteriores ya no admiten la integración nativa con SharePoint productos. Consulte Acerca SharePoint integración para obtener información sobre las opciones disponibles. Para TFS 2017 y versiones anteriores, debe usar Visual Studio/Team Explorer para agregar SharePoint Integration.
  • Complementos personalizados: no admitidos.

Para obtener más información, consulte Descripciones de archivos de complemento y compatibilidad con PCW.

Archivo de plantilla de proceso raíz

Se personaliza el archivo XML raíz, ProcessTemplate.xml, para definir la secuencia de archivos de complemento que se van a procesar así como las dependencias de cada complemento. El ProcessTemplate.xml contiene todos los grupos de tareas que deben ejecutarse para crear correctamente un proyecto. Cada grupo de tareas hace referencia a un archivo de complemento XML subordinado (a menudo, en una subcarpeta) donde se definen las tareas concretas. Para obtener más información, vea Definir las tareas raíz.

Descripciones de archivos de complemento y compatibilidad con PCW

Cada archivo de complemento configura un área funcional específica mediante la definición de una o varias tareas. Las tareas especifican para cargar un archivo, establecer permisos para un grupo o configurar alguna otra área funcional. Por ejemplo, el complemento Seguimiento de elementos de trabajo configura los tipos de elementos de trabajo, las consultas, las categorías y la configuración de procesos de un proyecto.

En la tabla siguiente se describe cada archivo de complemento y si se admite o no al crear un proyecto desde Visual Studio/Team Explorer o el portal web. El orden en que se llama a los complementos viene determinado por el archivo de plantilla de proceso raíz. A excepción del complemento Clasificación, los complementos también se pueden eliminar de la plantilla de proceso.

(✔️: compatible; ❌ - No compatible)

Carpeta y archivo del complemento

Cliente

Portal web

Descripción

Build
Build.xml

✔️

Define los permisos de seguridad iniciales que usa Team Foundation Build y carga los archivos de plantilla de compilación.

Para Azure DevOps Services y TFS 2017.3 y versiones posteriores, este complemento se omite y solo se definen los permisos predeterminados.

Clasificaciones
Classification.xml

✔️

✔️

Configura el área inicial y las rutas de acceso de iteración o sprint. También carga el archivo de Microsoft Project asignación (FileMapping.xml) que define cómo se asignan los campos de seguimiento de trabajo a Office Project campos.

Grupos y permisos
GroupsandPermissions.xml

✔️

✔️

Define los grupos de seguridad iniciales, los equipos, los miembros del equipo y sus permisos.

Lab Management
Lab.xml

✔️

Define los permisos de seguridad iniciales que se asignan a las identidades para Visual Studio Lab Management.

Para Azure DevOps Services y TFS 2017.3 y versiones posteriores, este complemento se omite y solo se definen los permisos predeterminados. En el futuro, las herramientas nativas de administración de versiones y compilación reemplazan a las herramientas de administración de laboratorio anteriores. Para más información, consulte Uso de compilación y Release Management en lugar Lab Management para pruebas automatizadas.

Informes
ReportsTasks.xml

✔️

Crea el Administrador de informes para el proyecto y carga los Reporting Services informes. Solo se admite para TFS local.

Para TFS 2017.3 y versiones posteriores, solo puede crear proyectos a través del portal web que omite este complemento. Para agregar informes después de crear un proyecto, vea Agregar informes a un proyecto.

Administración de pruebas
TestManagement.xml

✔️

✔️

Define las variables de prueba iniciales, las configuraciones, la configuración y los estados de resolución de un proyecto. Este complemento también carga la información contenida en los archivos siguientes:

  • localrun.testsettings: define la configuración de prueba predeterminada para una ejecución de prueba local.
  • testconfiguration: configura las configuraciones de prueba predeterminadas (hardware y software) que se definen para un proyecto. Una vez creado el proyecto, puede eliminar estas configuraciones y crear otras.
  • testresolutionstate: define los estados de resolución de pruebas que usan Test Runner, Microsoft Test Manager y las páginas de prueba del portal web. No se pueden cambiar estos estados después de crear el proyecto. Para cambiar los estados de resolución después de crear un proyecto para un TFS local, consulte Personalización y administración de la experiencia de prueba.
  • testsettings: especifica los archivos de configuración de prueba iniciales. Solamente se especifica un archivo, localrun.testsettings.
  • testvariable: define las variables de prueba iniciales. Una vez creado el proyecto, puede modificar estas variables y crear otras.

Control de versiones
VersionControl.xml

✔️

Define los permisos de seguridad iniciales para el control de versiones de Git y Team Foundation (TFVC), y para TFVC, las notas de la protección y si se requiere una des check-out exclusiva.

Para Azure DevOps Services y TFS 2017.3 y versiones posteriores, este complemento se omite y solo se definen los permisos y la configuración predeterminada. Después de crear un proyecto, puede administrar los permisos o directivas de protección de TFVC desde el portal web.

Windows SharePoint Services
WssTasks.xml

✔️

Define el portal del proyecto basado en una plantilla para un sitio SharePoint proyecto. Solo se admite para TFS local.

TFS 2018 y versiones posteriores ya no admiten la integración nativa con SharePoint productos. Si planea actualizar a TFS 2018, lea Acerca de la integración SharePoint para obtener información sobre las opciones disponibles. Para TFS 2017 y versiones anteriores, debe usar Visual Studio/Team Explorer para agregar SharePoint Integration. O bien, para agregar un sitio del portal de proyectos después de crear un proyecto, consulte Configuración o adición de un portal de proyectos. Al crear un proyecto desde el portal web, se omitirá WssTasks.xml complemento.

Este complemento también carga la información contenida en los siguientes archivos y carpetas:

  • Guía del proceso: carga un conjunto de archivos .htm que contienen una dirección URL que abre los temas de instrucciones del proceso cuando un usuario hace clic en el icono processGuidance WI icono icono de ayuda de la versión de cliente de un formulario de elemento de  trabajo. Estos archivos se pueden personalizar de modo que señalen a otros recursos de la guía de procesos.
  • Ejemplos y plantillas: carga uno o varios libros de Excel (archivos .xlsx) para admitir la corrección de errores y realizar un seguimiento de los problemas.
  • Documentos compartidos: carga uno o varios archivos de documento y plantilla de ejemplo como punto de partida para crear productos de trabajo.

Los archivos de plantilla de proceso no incluyen paneles ni Microsoft Excel informes. Estos archivos se agregan al proyecto, en función de las selecciones que se realizan cuando se crea un proyecto. Si no SharePoint sitio web para el proyecto, no hay paneles ni Office Excel informes disponibles. Para obtener más información sobre estos artefactos, vea los temas siguientes: Project panelesdel portal de Excel , informes de Excel (Agile)e informes de Excel (CMMI).

Seguimiento de elemento de trabajo
WorkItems.xml

✔️

✔️

Define los tipos de elementos de trabajo iniciales, las consultas y las instancias de elementos de trabajo de un proyecto. Los miembros de un equipo utilizan elementos de trabajo para realizar un seguimiento del trabajo. Un tipo de elemento de trabajo define los campos, el flujo de trabajo y el formulario que se usan para realizar el seguimiento del trabajo. Para personalizar cualquiera de estos objetos después de crear un proyecto, consulte Personalización de la experiencia de seguimiento de trabajo.

Este complemento también carga la información contenida en los siguientes archivos y carpetas:

  • Categories.xml: define el archivo de definición XML para las categorías usadas para agrupar tipos de elementos de trabajo.
  • LinkTypes:
  • SharedParameterLink.xml: define el tipo de vínculo que admite la vinculación de parámetros compartidos a casos de prueba.
  • SharedSteps: define el tipo de vínculo que admite la vinculación de pasos compartidos a casos de prueba.
  • TestedBy: define el tipo de vínculo que admite la vinculación de casos de prueba a elementos de trabajo como elementos de trabajo pendientes del producto, casos de usuario, requisitos y errores.

Se pueden definir tipos de vínculo adicionales en función de la plantilla de proceso. Para obtener una descripción de todos los tipos de vínculo, vea Vincular elementos de trabajo para admitir la rastreabilidad y administrar dependencias.

  • Proceso: define el ProcessConfiguration.xml que especifica la configuración predeterminada para los paneles y los trabajo pendientes de la herramienta Agile.
  • Consultas: define varias consultas de elementos de trabajo (definidas como archivos .wiq) dentro de la carpeta Consultas.
  • TypeDefinitions: define los 15 archivos de definición XML del tipo de elemento de trabajo o más contenidos en la carpeta TypeDefinition. Las definiciones difieren en función de la plantilla de proceso seleccionada.
  • Elementos de trabajo: define uno o varios elementos de trabajo. No se definen definiciones en las plantillas de proceso predeterminadas.

Para Azure DevOps Services y TFS 2017.3 y versiones posteriores, las definiciones de las instancias de elemento de trabajo se omitirán al crear proyectos.

La definición de esquema para las plantillas de proceso utiliza una combinación de la convención Camel y todos los elementos en mayúsculas. Si se producen errores al validar los archivos de definición de tipos, compruebe la estructura del uso de mayúsculas y minúsculas en sus elementos. También, la estructura del uso de mayúsculas y minúsculas en las etiquetas de apertura y cierre deben ajustarse a las reglas sintácticas de XML. Vea Complementos de plantilla de proceso: Indexación a definiciones de elementos XML.