Trabajar con tipos de vínculos

Artículo
08/10/2011

Los tipos de vínculos se usan para definir las etiquetas de vínculo, el tipo de topología y las restricciones que se utilizan al construir los vínculos entre los elementos de trabajo. Por ejemplo, el tipo de vínculo primario-secundario define dos etiquetas (Primario y Secundario), admite una topología jerárquica o en árbol, y evita que se creen referencias circulares entre los elementos de trabajo.

Para personalizar o crear un tipo de vínculo, importe un archivo XML a la colección de proyectos de equipo que contiene la definición del tipo de vínculo. Los tipos de vínculo se agregan al conjunto de tipos de vínculo que se definen para la colección. Los tipos de vínculo existentes se sobrescriben con la nueva información basada en el nombre de referencia que especifique.

Contenido del tema

Estructura de sintaxis
Requisitos para los tipos de vínculo
Tipos de vínculos definidos por el sistema
Tipos de vínculos definidos por las plantillas de proceso de MSF
Restricciones y topologías de los vínculos
Definición del esquema de tipos de vínculos

Estructura de sintaxis

Puede definir tipos de vínculo adicionales si los agrega a los tipos de vínculos definidos para una colección de proyectos de equipo. Puede definir los tipos de vínculos válidos para su uso en el proceso basándose en la estructura proporcionada por el esquema de definición de tipos de vínculos. Un tipo de vínculo se define con la sintaxis XML siguiente en el archivo XML de tipos de vínculos:

<LinkTypes>
   <LinkType ReferenceName="LinkTypeName" ForwardName="ForwardName" ReverseName="ReverseName" Topology="TopologyType" />
</LinkTypes>

Las descripciones en la tabla siguiente se aplican a la sintaxis anterior:

Atributo	Descripción
ReferenceName	Nombre del tipo de vínculo. Este es el nombre que se usa 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 aparece una lista de los vínculos en el elemento de trabajo de destino.
TopologyType	Especifica la topología DirectedNetwork, Network, Tree o Dependency. Las primeras tres topologías son direccionales y se usan para definir relaciones subordinadas o secuenciales. Puede usar Network para definir las relaciones del mismo nivel o para aquellas en las que no existe ninguna subordinación implícita.

Las asignaciones realizadas en los atributos ReverseName y ForwardName determinan la direccionalidad del vínculo. Si crea un vínculo personalizado y asigna el mismo nombre a los nombres de vínculo hacia delante e inversos, debe establecer el tipo de vínculo en Network porque es la única topología no direccional.

Requisitos para los tipos de vínculo

LINKTYPES es un conjunto de elementos LINKTYPE que están almacenados y son utilizados por una colección de proyectos de equipo.

Cada tipo de vínculo tiene un nombre de referencia y dos nombres descriptivos opcionales, o etiquetas de nombre, que deben ser únicos en 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 ni finales.
Los nombres no pueden contener caracteres de barra diagonal inversa (\).
Los nombres no pueden contener dos espacios en blanco consecutivos.

Tipos de vínculos definidos por el sistema

En la tabla siguiente se resumen los tipos de vínculos definidos por el sistema. Estos tipos de vínculos no se deben sobrescribir o modificar de forma alguna.

Nombre de vínculo hacia delante	Nombre de vínculo inverso	Nombre de referencia del tipo de vínculo	Topología
Sucesor	Predecesor	System.LinkTypes.Dependency	Dependencia
Elemento secundario	Primario	System.LinkTypes.Hierarchy	Árbol
Relacionado	Relacionado	System.LinkTypes.Related	Red

Tipos de vínculos definidos por las plantillas de proceso de MSF

En la tabla siguiente se muestran los tipos de vínculos que se producen al crear un proyecto de equipo mediante una plantilla de proceso de Microsoft Solutions Framework (MSF). Estos tipos de vínculos se han diseñado específicamente para admitir la interacción con el seguimiento de los elementos de trabajo en Team Foundation y Microsoft Test Manager.

Nombre de vínculo hacia delante	Nombre de vínculo inverso	Nombre de referencia del tipo de vínculo	Topología
Prueba realizada por	Pruebas	Microsoft.VSTS.Common.TestedBy	Dependencia
Caso de prueba	Pasos compartidos	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Dependencia

Cada uno de los tipos de vínculos enumerados anteriormente en este tema se agrega a la colección de proyectos de equipo al usar una plantilla de proceso de MSF para crear un proyecto de equipo. Los archivos de definición de tipo de vínculo se definen en la carpeta WorkItem Tracking\LinkTypes del archivo Template.zip. La definición siguiente para el tipo de vínculo Microsoft.VSTS.Common.TestedBy se define en el archivo TestedBy.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinkTypes>
   <LinkType ReferenceName="Microsoft.VSTS.Common.TestedBy" ForwardName="Tested By" ReverseName="Tests" Topology="Dependency" />
</LinkTypes>

Al crear el proyecto de equipo mediante la plantilla de proceso correspondiente, la definición del tipo de vínculo se importa a la colección de proyectos.

Restricciones y topologías de los vínculos

La topología asignada a un tipo de vínculo determina las restricciones que se agregan para su uso. En la tabla siguiente, puede ver los diferentes tipos de topología:

Tipo de topología	Ilustración
Red: puede utilizar los vínculos de red para crear relaciones básicas entre los elementos de trabajo que no sean restrictivas. El vínculo es el mismo en ambos extremos. Se permiten las relaciones circulares. Ejemplo de uso: utilice un vínculo de red, como, por ejemplo, Relacionado, para grabar una relación entre dos características que podrían compartir dependencias.
Red dirigida: puede usar los vínculos de red dirigidos para crear relaciones entre los elementos de trabajo que indiquen la direccionalidad. El nombre de vínculo es diferente en los extremos. Se permiten las relaciones circulares. Ejemplo de uso: utilice un vínculo de red dirigido para grabar una relación entre dos características que podrían compartir dependencias y que desea distinguir entre sí de alguna manera.
Dependencia: puede usar los vínculos de dependencia para crear relaciones entre los elementos de trabajo que tengan direccionalidad y restrinjan las relaciones circulares. El nombre de vínculo es diferente en los extremos. En la ilustración, no puede crear un vínculo dependiente a un elemento de trabajo que contiene las relaciones de vínculo dependientes para los mismos elementos de trabajo. Ejemplo de uso: utilice un vínculo de dependencia para grabar las características que se deben completar para entregar un requisito del usuario.
Árbol: puede usar los vínculos de árbol para crear relaciones jerárquicas de varios niveles entre los 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 de vínculo es diferente en los extremos. Los vínculos de árbol son el único tipo de vínculo admitido por la consulta Árbol de elementos de trabajo. En la ilustración, no puede asignar dos elementos primarios a un elemento secundario. Ejemplo de uso: utilice un vínculo de árbol para grabar las tareas y subtareas de su equipo que se deben completar para entregar una característica.

Definición del esquema de tipos de vínculos

En el código siguiente se hace una lista de la definición de esquema para los tipos de vínculos:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema 
  id="WorkItemLinkTypeDefinition" 
  elementFormDefault="unqualified" 
  attributeFormDefault="unqualified" 
  xmlns:xs="http://www.w3.org/2001/XMLSchema" 
  targetNamespace="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd" 
  xmlns="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd" 
  xmlns:mstns="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd" 
  xmlns:typelib="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib"
  version="1.0">
   <xs:import namespace="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib"/>
  <xs:simpleType name="TopologyTypes">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Network" />
      <xs:enumeration value="DirectedNetwork" />
      <xs:enumeration value="Dependency" />
      <xs:enumeration value="Tree" />
    </xs:restriction>
  </xs:simpleType>
  <xs:complexType name="LinkTypeType">
    <xs:attribute name="ReferenceName" type="typelib:ReferenceName" use="required" />
    <xs:attribute name="Topology" type="TopologyTypes" use="optional" />
    <xs:attribute name="ForwardName" type="typelib:FriendlyName" use="optional" />
    <xs:attribute name="ReverseName" type="typelib:FriendlyName" use="optional" />
  </xs:complexType>
  <xs:complexType name="LinkTypesType">
    <xs:sequence>
       <xs:element name="LinkType" type="LinkTypeType" minOccurs="1" maxOccurs="unbounded" />
      </xs:sequence>
      </xs:complexType>
   <xs:element name="LinkTypes" type="LinkTypesType" />
</xs:schema>