Agregar definiciones de tipos de vínculos a una plantilla de proceso
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.
Puede definir tipos de vínculos adicionales que los miembros del equipo pueden crear entre elementos de trabajo para un proyecto. Un tipo de vínculo define las etiquetas y las reglas que rigen las relaciones o vínculos entre los elementos de trabajo de ese tipo. Los tipos de vínculos que especifique el objeto complementan los tipos predeterminados de los vínculos jerárquicos, dependientes, y relacionados.
Especifique el archivo de definición para cada tipo de vínculo en un archivo independiente o puede especificarlos todos en un archivo. A continuación, agregue entradas al elemento taskxml del complemento WorkItemTracking para cada archivo de definición que se va a cargar.
Las plantillas de proceso predeterminadas definen varios tipos de vínculo a los que hacen referencia las definiciones de tipo de elemento de trabajo (WIT). Además de los tipos de vínculo definidos por el sistema. Para obtener más información, vea LinkTypes.
Las definiciones de tipos para los vínculos se deben cargar antes que las definiciones de tipos para los elementos de trabajo. Para obtener más información, vea Definir dependencias para grupos de tareas y tareas.
Una vez creado un proyecto, puede agregar, quitar, cambiar el nombre y cambiar los tipos de vínculos de una colección de proyectos mediante la herramienta de línea de comandos witadmin. Para obtener más información, vea Administrar tipos de vínculo.
Definir tipos de vínculos
Especifique un tipo de vínculo mediante el elemento LinkType.
En el ejemplo siguiente se muestra la estructura de sintaxis que define el tipo de vínculo TestedBy.
<?xml version="1.0" encoding="utf-8"?>
<LinkTypes>
<LinkType ReferenceName="Microsoft.VSTS.Common.TestedBy" ForwardName="Tested By" ReverseName="Tests" Topology="Dependency" />
</LinkTypes>
Puede personalizar o agregar una definición de tipo de vínculo en la carpeta LinkTypes. Para obtener más información sobre cómo definir un tipo de vínculo, vea Definir un tipo de vínculo personalizado.
Especificar las definiciones de los tipos de vínculos que se van a cargar
Para cargar una definición de tipo de vínculo en la plantilla de proceso, especifique el elemento LINKTYPE dentro del elemento taskxml. El atributo filename es una ruta de acceso relativa del archivo de definición de los tipos de vínculos. Por ejemplo, la sintaxis siguiente especifica que se cargará el archivo TestedBy.xml.
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
En el ejemplo siguiente se muestra cómo especificar una tarea que crea los dos tipos de vínculos definidos en la plantilla de proceso agile. Estos tipos corresponden a los tipos de vínculo SharedStepy TestedBy.
<task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
<taskXml>
<LINKTYPES>
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedStep.xml" />
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
</LINKTYPES>
</taskXml>
</task>
Referencia del elemento LINKTYPES
En la tabla siguiente se describen los elementos que se utilizan para cargar las definiciones de tipos de vínculos. Estos elementos se especifican dentro de un elemento contenedor taskXml en el archivo de complemento WorkItemTracking.
Nota
Especifique el archivo que define los tipos de vínculo que se cargarán mediante el elemento LINKTYPE (WorkItemTracking). Especifique el nombre de un tipo de vínculo que se va a definir mediante el elemento LinkType (Definition).
| Elemento | Descripción y sintaxis |
|---|---|
| LINKTYPE | Elemento secundario requerido de LINKTYPES. Especifica la ruta de acceso y el nombre de un archivo que contiene una definición de tipo de vínculo que se cargará.<LINKTYPE fileName="LinkTypeFilePathName" /> |
| LINKTYPES | Elemento secundario opcional del complemento WorkItemTracking. Contiene una colección de elementos LINKTYPE que especifican cada uno un archivo de definición para cargar. |