Definir dependencias para grupos de tareas y tareas en archivos de 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.

Cuando agregue un grupo de tareas o una tarea a un archivo de complemento, debe hacerlo en la secuencia correcta y declarar cualquier dependencia que el grupo o la tarea tenga para la realización correcta de otras tareas o grupos de tareas. Una tarea puede depender de otras tareas, siendo necesario terminar otras tareas antes de ejecutar la primera. Por ejemplo, la tarea para crear las consultas de elemento de trabajo no se puede ejecutar hasta que no se hayan completado satisfactoriamente todas las tareas para crear los tipos de elemento de trabajo. Por consiguiente, la tarea de cargar las consultas de elementos de trabajo depende de la tarea de cargar los tipos de elementos de trabajo.

Complementos necesarios y dependencias de complemento

En la ilustración siguiente se muestran las relaciones dependientes que se definen para las plantillas de Team Foundation Server (TFS). Como se muestra en la ilustración, el complemento para el seguimiento de elementos de trabajo depende de la finalización correcta del complemento para grupos y permisos, que depende de la finalización correcta del complemento para las clasificaciones. Los complementos de Administración de pruebas y Control de versiones dependen de la finalización de los tres primeros complementos. Los complementos de Compilación, Laboratorio, Informes y Portal dependen de la finalización del complemento para control de versiones.

Dependencias de complemento de plantilla deproceso

Sugerencia

Si define las tareas y los grupos de tareas en cada archivo de complemento en el mismo orden que sus dependencias, facilitará la lectura del archivo y la eliminación de los problemas de dependencia.

Las dependencias se pueden usar para indicar el orden en que se ejecutan los complementos en el Asistente para Project equipo nuevo. Algunos complementos siempre dependen de otros complementos. Además, no todos los complementos son necesarios para una plantilla de proceso.

En la tabla siguiente se identifican los complementos que dependen de otros complementos. Solo se requiere el complemento para clasificaciones. El resto de complementos son opcionales. Para obtener más información sobre cada complemento, vea Información general sobre los archivos de plantilla de proceso.

Complemento Complementos dependientes
Build Groups, VersionControl
Clasificaciones Ninguno
Grupos Clasificaciones
Laboratorio Build, Classifications, Groups, WorkItemTracking
Portal Classifications, Reporting, VersionControl y WorkItemTracking
Generación de informes Classifications, VersionControl y WorkItemTracking
TestManagement Classifications, Groups y WorkItemTracking
VersionControl Classifications, Groups y WorkItemTracking
WorkItemTracking Classifications y Groups

Definición de dependencias del grupo de tareas

Utilice el elemento de dependencia en tareas y grupos para indicar cuando hay dependencia. El siguiente ejemplo muestra cómo se utiliza el elemento de dependencia para especificar que un grupo de tareas WorkItemTracking depende de los grupos de tareas Clasificación y Grupos.

<group id="WorkItemTracking" description="Workitem definitions uploading." completionMessage="Workitem definitions uploaded.">  
   <dependencies>
      <dependency groupId="Classification"/>
      <dependency groupId="Groups"/>
   </dependencies>  
   <taskList filename="WorkItem Tracking\WorkItems.xml"/>  
</group>  

Nota

El elemento groupId hace referencia al valor del elemento id del otro grupo.

En la tabla siguiente se describen los elementos que se usan para definir las dependencias del grupo de tareas. Para obtener más información sobre cómo definir grupos de tareas, vea Referencia de elementos XML de plantilla de proceso.

Elemento Descripción y sintaxis
dependencies Elemento secundario requerido del grupo. Especifica otros grupos de los que depende un grupo.
<dependencies>
<dependency>. . . </dependency>
</dependencies>
Dependencia Elemento secundario opcional de dependencias. 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.
<dependency groupId="groupId" />

Definir las dependencias entre tareas

En el ejemplo siguiente se muestra cómo usar el elemento de dependencia para especificar que la tarea WorkItems depende de la tarea con un identificador de "WIT".

<task id="WIs" name="WorkItems" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work items uploaded"  completionDescription="Processing the actual work items used by work item tracking">  
   <dependencies>
      <dependency taskId="WITs" />
   </dependencies>  

En la tabla siguiente se describen los elementos que se usan para definir las dependencias de tareas. Para obtener más información sobre cómo definir tareas, vea Definir las tareas para procesar un complemento.

Elemento Descripción y sintaxis
dependencies Elemento secundario opcional de la tarea. Especifica las otras tareas de las que depende una tarea.
<dependencies>
<dependency>. . . </dependency>
</dependencies>
Dependencia Elemento secundario opcional de dependencias. Especifica el identificador de otra tarea de la que depende esta tarea. La otra tarea debe finalizar sus tareas antes de que esta tarea pueda iniciarse.
<dependency taskId="taskId" />