Referencia de elementos LinkTypes
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Importante
En este tema se proporciona una referencia de los tipos de vínculo definidos para Azure DevOps Services y TFS. Para el modelo de proceso XML local, puede agregar tipos de vínculo personalizados. Los tipos de vínculo personalizados no se admiten para los modelos de proceso de herencia o XML hospedado. Para obtener información general sobre los modelos de proceso y las personalizaciones admitidas, consulte Personalización de la experiencia de seguimiento de trabajo.
Se utilizan tipos de vínculo distintos para formar relaciones de vínculo entre distintos tipos de elemento de trabajo (WIT). Hay tres categorías de tipos de vínculo: definidos por el sistema, definidos por el proceso y definidos por el usuario o personalizados. Los tipos de vínculo definidos en los procesos predeterminados admiten relaciones de vínculo entre los WIT de administración de pruebas.
Cada tipo de vínculo define las etiquetas de vínculo, el tipo de topología y las restricciones que se utilizan cuando se crean vínculos entre elementos de trabajo. Por ejemplo, el tipo de vínculo principal-secundario define dos etiquetas (Principal y Secundario), admite una topología de árbol jerárquico y evita la creación de referencias circulares entre elementos de trabajo.
Puede personalizar un tipo de vínculo existente o crear uno nuevo que cumpla los requisitos de seguimiento del proyecto. Antes de empezar a agregar o modificar un tipo de vínculo, debe evaluar los tipos de vínculo disponibles y cómo se usan en el proyecto. Consulte Administración de dependencias, vinculación de elementos de trabajo. Los vínculos se agregan mediante el formulario de elemento de trabajo, que contiene el control de vínculos. Vea Vincular controles, restricciones y campos.
Nota:
No puede personalizar los tipos de vínculo definidos por el sistema que corresponden a los vínculos Relacionado, Primario-secundario y Sucesor-predecesor.
Puede modificar o crear un tipo de vínculo por uno de estos motivos:
- Cambiar las etiquetas de vínculo que se usan para hacer coincidir las convenciones de nomenclatura de su equipo.
- Agregar un tipo de vínculo para realizar el seguimiento de una relación determinada que es única para el proceso de su equipo.
El tipo de vínculo se especifica en un archivo XML de definición de tipo que se importa a una colección de proyectos. Para personalizar o crear un tipo de vínculo, use witadmin importlinktype para importar el archivo de definición de tipo de vínculo a la colección de proyectos que hospeda el proyecto. Con la herramienta de línea de comandos witadmin, puede desactivar, eliminar, exportar, importar, enumerar y reactivar los tipos de vínculo. Consulte Administración de tipos de vínculo.
Estructura de sintaxis
Puede definir tipos de vínculo adicionales agregándolos a los tipos de vínculo definidos para una colección de proyectos.
Puede definir tipos de vínculo válidos para usar en su proceso en base a la estructura que proporciona el esquema de definición del tipo de vínculo. Un tipo de vínculo se define mediante la siguiente sintaxis XML en el archivo XML de tipos de vínculo.
<LinkTypes>
<LinkType ReferenceName="LinkTypeName" ForwardName="ForwardName" ReverseName="ReverseName" Topology="TopologyType" />
</LinkTypes>
Las descripciones de la tabla siguiente se aplican a la sintaxis anterior:
| Atributo | Descripción |
|---|---|
| ReferenceName | Nombre del tipo de vínculo. Este nombre se utiliza internamente al crear un vínculo entre dos elementos de trabajo. |
| ForwardName | Nombre del vínculo en el elemento de trabajo de origen. Este nombre aparece al agregar vínculos al elemento de trabajo de origen. |
| ReverseName | Nombre del vínculo en el elemento de trabajo de destino. Este nombre aparece cuando se muestra una lista de los vínculos en el elemento de trabajo de destino. |
| TopologyType | Especifica la topología DirectedNetwork,Network, Treeo Dependency. Las primeras tres topologías son direccionales y se utilizan para definir relaciones subordinadas o secuenciales. La red se usa para definir relaciones entre pares o donde no existe ninguna subordinación implícita. |
La direccionalidad del vínculo viene determinada por las asignaciones realizadas a los atributos ForwardNamey ReverseName. Si crea un vínculo personalizado y asigna el mismo nombre a los nombres hacia delante e inverso, debe establecer el tipo de vínculo en Red porque es la única topología no direccional.
Requisitos
Cada tipo de vínculo tiene un nombre de referencia y dos nombres descriptivos opcionales, o etiquetas de nombre, que deben ser únicos dentro de la colección de proyectos. Cada nombre de tipo de vínculo debe cumplir los requisitos siguientes:
- Los nombres pueden tener hasta 254 caracteres Unicode
- Los nombres no deben estar vacíos
- Los nombres no pueden tener espacios en blanco iniciales o finales
- Los nombres no pueden contener caracteres de barra diagonal inversa (\)
- Los nombres no pueden contener dos espacios en blanco consecutivos.
Topologías y restricciones de tipo de vínculo
Los tipos de topología descritos en la tabla siguiente determinan las restricciones aplicadas acerca del uso de cada tipo de vínculo.
Tipo de topología
Ilustración
Dependencia:puede usar vínculos de dependencia para crear relaciones entre elementos de trabajo que tengan direccionalidad y para restringir las relaciones circulares. El nombre del vínculo es distinto en los dos puntos finales.
Ejemplo de uso:use un vínculo de dependencia para registrar las características que deben completarse para proporcionar un requisito de usuario. No se puede crear un vínculo dependiente entre dos elementos de trabajo vinculados a los mismos elementos de trabajo a través de vínculos dependientes.
Red dirigida:puede usar vínculos de red dirigidos para crear relaciones entre elementos de trabajo que indiquen direccionalidad. El nombre del vínculo es distinto en los dos puntos finales. Se permiten las relaciones circulares.
Ejemplo de uso:use un vínculo de red dirigido para registrar una relación entre dos características que podrían compartir dependencias y que desea distinguir entre sí de alguna manera.
Red:puede usar vínculos de red para crear relaciones básicas entre elementos de trabajo que no sean restrictivas. El vínculo es el mismo en los dos puntos finales. Se permiten las relaciones circulares.
Uso deejemplo: use un vínculo de red, como Relacionado, para registrar una relación entre dos características que podrían compartir dependencias.
Árbol:puede usar vínculos de árbol para crear relaciones jerárquicas entre elementos de trabajo. Los vínculos de árbol admiten las vistas jerárquicas de varios niveles, tienen direccionalidad y restringen las relaciones circulares. El nombre del vínculo es distinto en los dos puntos finales. Los vínculos de árbol son el único tipo de vínculo admitido por la consulta Árbol de elementos de trabajo. Con vínculos de elementos primarios y secundarios, no se pueden asignar dos elementos primarios a un elemento secundario.
Uso deejemplo: use un vínculo de árbol para registrar tareas y subtareas del equipo que deben completarse para entregar un caso de usuario o un elemento de trabajo pendiente. O bien, asigne elementos de trabajo pendiente a características y características a epopeyas.
Creación de un tipo de vínculo personalizado
Nota:
Disponibilidad de características:la creación de un tipo de vínculo personalizado solo se admite para el modelo de proceso XML local. No se pueden agregar tipos de vínculo personalizados cuando se usa el modelo de proceso XML hospedado.
Para crear un tipo de vínculo personalizado, defina el archivo de definición XML del tipo de vínculo según la sintaxis proporcionada anteriormente en este tema y, a continuación, impórtelo mediante witadmin importlinktype. Cada tipo de vínculo definido por el proceso está asociado a un archivo de definición XML. Estos archivos se definen en la carpeta WorkItem Tracking\LinkTypes del conjunto de procesos de archivos y WorkItem Tracking\LinkTypes.
Por ejemplo, la sintaxis siguiente define el tipo de vínculo Microsoft.VSTS.Common.TestedBy proporcionado a través del TestedBy.xml archivo:
<?xml version="1.0" encoding="utf-8"?>
<LinkTypes>
<LinkType ReferenceName="Microsoft.VSTS.Common.TestedBy" ForwardName="Tested By" ReverseName="Tests" Topology="Dependency" />
</LinkTypes>
Al crear o actualizar un proyecto, las definiciones de tipo de vínculo definidas para el proceso de referencia se importan en la colección de proyectos.
Vínculos de administración de pruebas
Mediante el portal web o Test Manager, puede ver qué casos de prueba se definen para un conjunto de pruebas y qué conjuntos de pruebas se definen para un plan de pruebas. Sin embargo, estos objetos no están vinculados entre sí a través de tipos de vínculo.
Personalización del control de vínculos
Además de definir tipos de vínculos, puede personalizar la definición del tipo de elemento de trabajo para aceptar o prohibir vínculos concretos según el tipo de vínculo. El elemento se usa para definir las opciones que controlan qué vínculos se pueden agregar a un elemento de trabajo y a qué LinksControlOptions tipos de elemento de trabajo. Asimismo, puede especificar las columnas predeterminadas que desea que aparezcan para la lista de vínculos en un elemento de trabajo. Para obtener más información, vea Definir controles de vínculo para restringir las relaciones de vínculo.
Artículos relacionados
- Referencia al tipo de vínculo
- Vincular elementos de trabajo para realizar un seguimiento de las dependencias
- Personalización de la experiencia de seguimiento de trabajo
Para interactuar mediante programación con los tipos de vínculo, consulte Artifact Link Types API.