Compartir a través de

Definir las tareas para procesar un complemento

  • Artículo

El elemento tasks y sus elementos secundarios se usan para definir los artefactos que se cargan o elementos específicos que se crean para un complemento. Una tarea define el trabajo que debe realizarse para configurar algo específicamente para el proceso en un nuevo proyecto de equipo. El número de tareas que defina carga los tipos de elemento de trabajo, las consultas de elementos de trabajo, los documentos y los informes de un proyecto de equipo. Otras tareas que se pueden 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 tasks

  • Referencia del elemento tasks

  • Índice de los elementos taskXML por función

  • Ejemplo: definir tipos de elementos de trabajo

Estructura de la sintaxis de tasks

Puede especificar varias tareas en un complemento y estas tareas pueden tener dependencias entre sí. Las tareas que se definen para cada complemento deben ajustarse a la definición de esquema de tasks, establecida en el archivo Tasks.xsd, y especificarse en su propio archivo con el elemento contenedor tasks.

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

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

Volver al principio

Referencia del elemento tasks

En la tabla siguiente se describen todos los elementos que pueden definir las 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 completarse para que esta tarea pueda iniciarse.

ProcessTemplate

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

Donde cada atributo se define como sigue:

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

  • Filename: la ruta de acceso del directorio local y el nombre del archivo para cargar.

  • Description: una cadena de texto breve que describe el archivo que quiere cargar.

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

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

Especifica el nombre, la ubicación y el destino de un archivo que se va a cargar para admitir procesos de compilación en 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.

Define el trabajo que debe realizarse para configurar algo específicamente para el proceso en un nuevo proyecto de equipo.

  • id: especifica un nombre que identifica la tarea. 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.

  • 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 completó 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 se está procesando. La longitud mínima es 1 carácter.

tasks

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

Elemento secundario necesario de taskXml.

Contiene una colección de elementos de task que especifican el trabajo que debe realizarse para configurar algo específicamente para el proceso en un nuevo proyecto de equipo.

taskXml

 
<taskXml> . . . </taskXml>

Elemento raíz necesario para un archivo de complemento.

Describe el trabajo necesario para completar esta tarea. El XML dentro de este bloque del elemento varía y es específico para cada complemento.

Nota

El procesador XML no intenta validar el contenido del elemento.

Volver al principio

Índice de los elementos taskXML por función

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

Volver al principio

Ejemplo: definir tipos de elementos de trabajo

En el ejemplo siguiente se muestra una tarea que crea los seis tipos de elementos 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