Compartir a través de

Definir las tareas para procesar un complemento

  • Artículo

Se usa el elemento tasks y sus elementos secundarios para definir los artefactos que se van a cargar o los elementos específicos que se van a crear para un complemento. Una tarea define el trabajo que se debe realizar para configurar algo concreto en el proceso de un nuevo proyecto de equipo. Varias de las tareas que se definen cargan los tipos de elementos de trabajo, consultas de elementos de trabajo, documentos e informes para un proyecto de equipo. Otras tareas que puede definir configuran otras áreas de Visual Studio Application Lifecycle Management, como Team Foundation Build, Visual Studio Lab Management, Test Manager y control de versiones de Team Foundation.

En este tema

  • Estructura de la sintaxis de las tareas

  • Referencia de los elementos de tareas

  • Índice de los elementos de taskXML por función

  • Ejemplo: definir los tipos de elementos de trabajo

Estructura de la sintaxis de las tareas

Puede especificar varias tareas dentro de un complemento y estas tareas pueden tener dependencias en sí. Las tareas que se definen para cada complemento deben cumplir la definición de esquema para tasks, definido en el archivo Tasks.xsd y se especifican en su propio archivo utilizando el elemento contenedor tasks.

En la sintaxis siguiente se muestra la estructura de alto nivel del elemento tasks y sus elementos secundarios.

<tasks>
   <task>
      <dependencies>
        <dependency />
        . . .    
      </dependencies />
      <taskXml>
        . . .    
      </taskXml>
   <task/>
</tasks>

Volver al principio

Referencia de los elementos de tareas

En la tabla siguiente se describe cada elemento que puede definir tareas para un complemento.

Elemento

Sintaxis

Descripción

dependencies

 
<dependencies>
<dependency>. . . </dependency>
</dependencies>

Elemento secundario opcional de task.

Especifica otros grupos de los que depende un grupo.

dependency

 
<dependency taskId="taskId" />

Elemento secundario opcional de dependencies.

Especifica el identificador de otra tarea de la que depende esta tarea. La otra tarea debe finalizar antes de iniciar esta tarea.

ProcessTemplate

 
<ProcessTemplate Type="FileType" Filename="LocalPathAndFileName" 
   Description="FileDescription" 
   ServerPath="UploadLocation" />

Donde se define cada atributo como sigue:

  • Type: tipo de archivo que se está cargando. Los valores válidos son: Default y Upgrade para los archivos de plantilla de compilación y Custom para los archivos de la plantilla de laboratorio.

  • Filename: ruta de acceso al directorio local y nombre del archivo que se va a cargar.

  • Description: cadena de texto corta que describe el archivo que se va a cargar.

  • ServerPath: ruta de acceso del servidor que está ejecutando Team Foundation Server donde el archivo se debe cargar. La única ubicación válida de carga es $/$$PROJECTNAME$$/BuildProcessTemplates.

Elemento secundario opcional del elemento taskXml para los complementos de compilación y de laboratorio.

Especifica el nombre, la ubicación y el destino de un archivo que se va a cargar para admitir los procesos de compilación para un proyecto de equipo.

task

 
<task id="task id" name="name of task" 
   plugin="Microsoft.ProjectCreationWizard.<PluginName>" 
   completionMessage="SuccessfulCompletionMessage" 
   completionDescription="InProcessMessage">
    <dependencies>. . . </dependencies>
    <taskXml>. . . </taskXml>
</task>

Elemento secundario necesario de tasks.

Especifica el trabajo que se debe realizar para configurar algo concreto en el proceso de un nuevo proyecto de equipo.

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

  • name: describe lo que hace la tarea.

  • plugin: identifica qué complemento debe ejecutar esta tarea.

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

  • completionDescription: especifica el mensaje que se mostrará durante la creación del proyecto de equipo para indicar que la tarea está en proceso. La longitud mínima es de 1 carácter.

tasks

 
<tasks>
    <task>. . . </task>
</tasks>

Elemento secundario necesario de taskXml.

Contiene una colección de elementos task, cada uno de los cuales especifica el trabajo que debe realizarse para configurar algo concreto para el proceso en un nuevo proyecto de equipo.

taskXml

 
<taskXml> . . . </taskXml>

Elemento raíz necesario de un archivo de complemento.

Describe el trabajo que se necesita para finalizar esta tarea. El XML varía dentro de este bloque de elementos y es específico para cada complemento.

Nota

El procesador XML no intenta validar el contenido de este elemento.

Volver al principio

Índice de los elementos de taskXML por función

Para obtener más información sobre las características específicas de los elementos de marcado XML que puede especificar para cada complemento, vea uno de los temas siguientes:

Volver al principio

Ejemplo: definir los tipos de elementos de trabajo

En el ejemplo siguiente se muestra una tarea que crea seis tipos de elemento de trabajo haciendo referencia a los archivos de definición de cada tipo:

<task
   id="WITs"
   name="WorkItemType definitions"
   plugin="Microsoft.ProjectCreationWizard.WorkItemTracking"
   completionMessage="WorkItemTypes created"         
   completionDescription = "Processing work item types used by work item tracking">
   <taskXml>
   <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
   </WORKITEMTYPES>
   </taskXml>
</task>

Volver al principio

Vea también

Conceptos

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

Información general sobre los archivos de plantillas de procesos