Compartir a través de


Referencia de elementos XML ProcessTemplate

Puede personalizar el archivo raíz para que una plantilla de proceso agregue o quite los archivos de complementos.El archivo raíz define todos los complementos y las tareas que el Asistente para nuevo proyecto de equipo va a procesar.Para las plantillas de proceso para Microsoft Solutions Framework (MSF), el archivo raíz se denomina ProcessTemplate y se encuentra en la carpeta del contenedor de archivos de la plantilla de proceso.Para obtener más información, vea Trabajar con archivos de plantilla de proceso.

El elemento primario del archivo de complemento raíz es el elemento ProcessTemplate, que debe tener un solo metadata y un elemento groups definido.El nombre de cada plantilla de proceso debe ser único dentro de una colección de proyectos de equipo y cada nombre no debe contener más de 124 caracteres Unicode.

Nota de precauciónPrecaución

Si descarga una plantilla con el mismo nombre de una plantilla existente, se sobrescribirá esta última.

En este tema

  • Estructura de la sintaxis de ProcessTemplate

  • Referencia del elemento Metadata

  • Referencia del elemento Groups

Estructura de la sintaxis de ProcessTemplate

El complemento raíz para las plantillas de proceso se debe especificar en su propio archivo en el elemento contenedor ProcessTemplate y 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 las plantillas de proceso de la siguiente página del sitio web de Microsoft: Process Template and Work Item Schemas for Visual Studio Team Foundation.

En el siguiente ejemplo se muestra la estructura general del elemento raíz ProcessTemplate.Para obtener un ejemplo más completo, vea 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>

Volver al principio

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>
    <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 para la plantilla de proceso.

metadata

<metadata>
    <name> . . . </name>
    <description> . . . </description>
    <plugins> . . . </plugins>
</metadata>

Elemento secundario necesario de ProcessTemplate.

Elemento contenedor que especifica la información necesaria para que el complemento sea procesado por el Asistente para nuevo proyecto de equipo.

name

<name>ProcessTemplateName</name>

Elemento secundario necesario de metadata.

Define el nombre de la plantilla de proceso, que debe ser única en 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 para incluir en la creación de la plantilla de proceso y especifica 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 opcional de metadata.

Especifica un identificador único y números de revisión primario y secundario para identificar la versión de la plantilla de proceso.

Volver al principio

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 del grupo con 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 que un complemento debe ejecutar durante la creación de un proyecto.Los valores válidos para cada atributo son:

  • id.: especifica un nombre que identifica el grupo de tareas.Si otro grupo de tareas depende de este, hace referencia a este identificador.Debe asignar un valor único para el identificador dentro del archivo de complemento.

  • description: especifica el mensaje para indicar, durante la creación del proyecto de equipo, que se está procesando el grupo de tareas.

  • completionMessage: especifica el mensaje que se mostrará durante la creación del proyecto de equipo para indicar que el grupo de tareas se ha completado correctamente.La longitud máxima es de 256 caracteres.

  • failureMessage: especifica el mensaje que se mostrará durante la creación del proyecto de equipo para indicar que el grupo de tareas no se ha completado 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 van a ejecutar.La lista de tareas para un grupo siempre debe estar en un archivo XML independiente.Para obtener más información acerca de cómo especificar estos archivos, vea Definir las tareas para procesar un complemento.

Volver al principio

Vea también

Conceptos

Trabajar con archivos de plantilla de proceso

Definir las tareas para procesar un complemento

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

Personalizar plantillas de procesos

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