Referencia de elementos XML de plantilla de proceso

Artículo
11/18/2015

El archivo raíz de una plantilla de proceso se puede personalizar para agregar o quitar archivos de complemento. En el archivo raíz se definen todos los complementos y las tareas que se usan para crear un proyecto de equipo en Visual Studio Online o en un servidor local de Team Foundation Server. El archivo raíz, denominado ProcessTemplate, está ubicado en la carpeta de contenedor de los archivos de la plantilla de proceso. Para obtener más información, vea Información general sobre los archivos de plantillas de procesos.

El elemento primario del archivo del complemento raíz es el elemento ProcessTemplate, que solo debe tener definidos un elemento metadata y un elemento groups. Asigne un nombre único a cada plantilla de proceso incluido en una colección de proyectos de equipo; este nombre no puede tener más de 124 caracteres Unicode.

Nota

En Visual Studio Online: si importa una plantilla de proceso con el mismo nombre y el mismo GUID que un proceso existente, el proceso existente se actualiza al igual que todos los proyectos de equipo que hacen referencia a ese proceso.

En TFS local: si carga una plantilla de proceso con el mismo nombre que una plantilla existente, se sobrescribirá esta última.

En este tema

Estructura de sintaxis de ProcessTemplate
Referencia del elemento metadata
Referencia del elemento groups

Estructura de sintaxis de ProcessTemplate

El complemento raíz de las plantillas de proceso debe especificarse en su propio archivo del elemento contenedor ProcessTemplate; asimismo, debe ajustarse al esquema de plantillas de proceso que se define en los archivos ProcessTemplate.xsd y ProcessTemplateItem.xsd. Puede descargar los archivos de esquema para plantillas de proceso de la siguiente página del sitio web de Microsoft: Plantilla de proceso y esquemas de elementos de trabajo para Visual Studio Team Foundation.

En el siguiente ejemplo se muestra la estructura del elemento ProcessTemplate. Si quiere un ejemplo más extenso, vea el tema sobre Definir las tareas raíz mediante el archivo de complemento de plantilla de proceso.

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
   <metadata> . . . </metadata>
   <groups> . . .</groups>
</ProcessTemplate>

Referencia del elemento metadata

En la sintaxis siguiente se muestra la estructura del elemento metadata y sus elementos secundarios.

<metadata>
    <name>ProcessTemplateName</name>
    <description>ProcessTemplateDescription </description>
    <version type="ID" major="Number1" minor="Number2" />
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />
. . .
    </plugins>
</metadata>

Elemento	Sintaxis	Descripción
description	`<description>ProcessTemplateDescription</description>`	Elemento secundario necesario de metadata. Define el texto de la descripción que aparece en el Asistente para nuevo proyecto de equipo de la plantilla de proceso.
metadata	`<metadata> <name> . . . </name> <description> . . . </description> <version type="ID" major="Number1" minor="Number2/> <plugins> . . . </plugins> </metadata>`	Elemento secundario necesario de ProcessTemplate. Elemento contenedor en el que se especifica la información necesaria para que el Asistente para nuevo proyecto de equipo pueda procesar el complemento.
name	`<name>ProcessTemplateName</name>`	Elemento secundario necesario de metadata. Define el nombre de la plantilla de proceso, que debe ser único en toda la colección de proyectos de equipo. La longitud máxima del nombre es de 124 caracteres.
plugin	`<plugin name="Microsoft.ProjectCreationWizard.PluginName wizardPage="true \| false" />`	Elemento secundario necesario de plugins. Especifica el nombre de un archivo de complemento que se incluirá en la creación de la plantilla de proceso e indica también si el complemento debe tener una página visible en el Asistente para nuevo proyecto de equipo.
plugins	`<plugins> <plugin> . . . </plugin> </plugins>`	Elemento secundario necesario de metadata. Elemento contenedor que define los complementos para la plantilla de proceso.
version	`<version type="ID" major="Number1" minor="Number2 " />`	Elemento secundario necesario de metadata. Especifica un identificador único y los números de revisión principal y secundario que identifican a la versión de la plantilla de proceso.

Referencia del elemento groups

En la sintaxis siguiente se muestra la estructura del elemento groups y sus elementos secundarios.

<groups>
   <group id="groupId" description="GroupDescription" completionMessage="SuccessMessage">
      <dependencies> 
         <dependency groupId="dependentGroupId" />
. . .
      </dependencies>
      <taskList filename="RelativePathAndFileName" />
   </group>
. . .
</groups>

Elemento	Sintaxis	Descripción
dependencies	`<dependencies> <dependency>. . . </dependency> </dependencies>`	Elemento secundario necesario de group. Especifica las dependencias que el grupo tiene en otros grupos.
dependency	`<dependency groupId="groupId" />`	Elemento secundario opcional de dependencies. Especifica el identificador de otro grupo de tareas de la que depende este grupo. El otro grupo debe finalizar sus tareas antes de que este grupo de tareas pueda iniciarse.
group	`<group id="TaskGroupId" description="TaskGroupDescription" completionMessage="SuccessMessage" failureMessage="FailureMessage"> <dependencies> . . . <dependencies> <taskList> . . . </taskList> </group>`	Elemento secundario necesario de groups. Identifica un conjunto de tareas para un complemento que se ejecutarán durante la creación del proyecto. Los valores válidos para cada atributo son los siguientes: id: especifica un nombre que identifica el grupo de tareas. Si existe otro grupo de tareas que depende de este grupo, hace referencia a este identificador. El identificador debe tener un valor único en el archivo de complemento. description: especifica el mensaje que indicará, durante la creación del proyecto de equipo, que se está procesando el grupo de tareas. completionMessage: especifica el mensaje que indicará, durante la creación del proyecto de equipo, que el grupo de tareas se completó correctamente. La longitud máxima es de 256 caracteres. failureMessage: especifica el mensaje que indicará, durante la creación del proyecto de equipo, que el grupo de tareas no se pudo completar correctamente.
groups	`<groups> <group> . . . </group> </groups>`	Elemento secundario necesario de ProcessTemplate. Elemento contenedor que define el conjunto de grupos de tareas que se ejecutarán durante la creación del proyecto.
tasklist	`<taskList filename="filePath" />`	Especifica un archivo XML que contiene la lista de tareas que se ejecutarán. La lista de tareas de un grupo debe incluirse siempre en un archivo XML independiente. Para obtener más información sobre cómo especificar estos archivos, vea Definir las tareas para procesar un complemento.

Vea también

Conceptos

Información general sobre los archivos de plantillas de procesos

Definir las tareas para procesar un complemento

Definir dependencias para grupos de tareas y tareas en archivos de complemento

Personalizar un proceso

Definir las tareas raíz mediante el archivo de complemento de plantilla de proceso

Compartir a través de