Referencia de elemento de tipo de vínculo

Artículo
11/18/2015

Se utilizan tipos de vínculo distintos para formar relaciones de vínculo entre distintos tipos de elemento de trabajo (WIT). Existen tres categorías de tipos de vínculo: definidos por el sistema, definidos por la plantilla de proceso y definidos por el usuario. Los tipos de vínculo definidos en las plantillas de proceso predeterminadas admiten las 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.

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 su proyecto de equipo.

Estructura de sintaxis

Puede definir tipos de vínculo adicionales agregándolos a los tipos de vínculo que ha definido para una colección de proyectos de equipo. 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 sintaxis XML siguiente 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, Tree o Dependency. Las primeras tres topologías son direccionales y se utilizan para definir relaciones subordinadas o secuenciales. Se utiliza Network para definir relaciones entre elementos del mismo nivel o cuando no existe ninguna subordinación implícita.

La direccionalidad de vínculos la determinan las asignaciones hechas a los atributos ForwardName y ReverseName. Si se crea un vínculo personalizado y se asigna el mismo nombre a los nombres directo e inverso, debe establecerse el tipo de vínculo en Network porque es la única topología no direccional.

Requisitos

LINKTYPES es un conjunto de elementos LINKTYPE almacenados y 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 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 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ínculo definidos por el sistema

La tabla siguiente resume los tipos de vínculo definidos por el sistema. Estos tipos de vínculo no se pueden modificar.

Nombre directo	Nombre inverso	Nombre de referencia	Topología
Sucesor	Predecesor	System.LinkTypes.Dependency	Dependency
Secundario	Primario	System.LinkTypes.Hierarchy	Árbol
Relacionado	Relacionado	System.LinkTypes.Related	Red

Además, existen tipos de vínculo adicionales que se utilizan para vincular elementos de trabajo con otros objetos en el proyecto de equipo u otros elementos, como una página web o una ubicación de red. Por ejemplo, el tipo de vínculo Storyboard vincula elementos de trabajo con guiones gráficos o con cualquier archivo que esté ubicado en un recurso compartido de red. Para obtener más información, vea Administrar dependencias, vincular elementos de trabajo para admitir la rastreabilidad.

Tipos de vínculo definidos por plantilla de proyecto

Al crear un proyecto de equipo utilizando una de las plantillas de proceso predeterminadas que TFS proporciona, se agregan los tipos de vínculo siguientes al proyecto de equipo. Estos tipo de vínculo están específicamente diseñados para admitir la interacción con el seguimiento de los elementos de trabajo en Team Foundation y Microsoft Test Manager.

Tipos de elementos de trabajo de administración de pruebas

Nombre directo	Nombre inverso	Nombre de la referencia al tipo de vínculo	Topología
Afecta a (vea la nota 1)	Afectado por	Microsoft.VSTS.Common.Affects	Dependency
Referenciado por (vea la nota 2)	Referencias	Microsoft.VSTS.TestCase.SharedParameterReferencedBy	Dependency
Probado por	Pruebas	Microsoft.VSTS.Common.TestedBy	Dependency
Caso de prueba	Pasos compartidos	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Dependency

Notas

El tipo de vínculo Afecta a/Afectado por vincula Solicitudes de cambio a Requisitos. Este tipo de vínculo únicamente se agrega a proyectos de equipo creados con una plantilla de proceso de CMMI.
El tipo de vínculo Referenciado por/Hace referencia a vincula Parámetro compartido con Caso de prueba para admitir la ejecución de pruebas con datos distintos. Este tipo de vínculo se agrega a un proyecto de equipo cuando se actualiza el proyecto de equipo usando el asistente Configurar características o cuando se crea un proyecto de equipo basado en una plantilla de proceso de TFS 2013.2 o una versión posterior.

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 usando la plantilla de proceso correspondiente, la definición del tipo de vínculo se importa en la colección de proyectos.

Topologías y restricciones 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
Red: Puede utilizar vínculos de red para crear relaciones básicas entre elementos de trabajo que no son no restrictivos El vínculo es el mismo en los dos puntos finales. Se permiten las relaciones circulares. Uso de ejemplo: Use un vínculo de red, como Relacionado, para registrar una relación entre dos características que pueden compartir dependencias.
Red dirigida: puede usar vínculos de red dirigida para crear relaciones entre elementos de trabajo que indican direccionalidad. El nombre del vínculo es distinto en los dos puntos finales. Se permiten las relaciones circulares. Uso de ejemplo: Use un vínculo de red dirigida para registrar una relación entre dos características que podrían compartir dependencias y que desea que se distingan mutuamente, de alguna manera.
Dependencia: puede usar vínculos de dependencia para crear relaciones entre elementos de trabajo que tienen direccionalidad y para restringir las relaciones circulares. El nombre del vínculo es distinto en los dos puntos finales. En la ilustración, no puede crear un vínculo dependiente a un elemento de trabajo que contenga relaciones de vínculo dependiente a los mismos elementos de trabajo. Uso de ejemplo: Use un vínculo de dependencia para registrar las características que deben completarse para entregar un requisito del usuario.
Árbol: Puede usar vínculos de árbol para crear relaciones jerárquicas de varios niveles 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 de Árbol de elementos de trabajo. En la ilustración, no se pueden asignar dos principales a un secundario. Uso de ejemplo: Use un vínculo de árbol para registrar tareas y subtareas de su equipo que deben completarse para entregar una característica.

Definición de esquema de tipos de vínculo

El código siguiente enumera la definición de esquema para los tipos de vínculo:

<?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>

Preguntas y respuestas

P: ¿Cómo puedo agregar un tipo de vínculo personalizado?

R: Defina un archivo de definición XML conforme al contenido proporcionado en este tema y use witadmin importlinktype para importar el archivo de definición de tipo de vínculo a la colección de proyectos que hospeda su proyecto de equipo.

P: ¿Qué tipo de vínculo se usa para vincular casos de prueba a conjuntos de pruebas y conjuntos de pruebas a planes de pruebas?

R: Mediante el uso de Team Web Access o Test Manager puede ver qué casos de prueba están definidos para un conjunto de pruebas y qué conjuntos de pruebas están definidos para un plan de pruebas. No obstante, estos objetos no están vinculados mutuamente a través de tipos de vínculo.

Vea también

Conceptos

Personalizar los objetos de seguimiento del trabajo para admitir los procesos de su equipo

Otros recursos

Administrar dependencias, vincular elementos de trabajo para admitir la rastreabilidad

Compartir a través de