Utilisation des types de liens

Article
08/10/2011

Vous utilisez un type de lien pour définir les étiquettes de lien, le type de topologie et les restrictions utilisées lors de la construction des liens entre les éléments de travail. Par exemple, le type de lien parent-enfant définit deux étiquettes (Parent et Enfant), prend en charge une topologie hiérarchique ou une topologie d'arborescence, et empêche la création de références circulaires entre les éléments de travail.

Pour personnaliser ou créer un type de lien, vous importez un fichier XML vers la collection de projets d'équipe qui contient la définition du type de lien. Les types de liens sont ajoutés à l'ensemble des types de liens définis pour la collection. Les types de liens existants sont remplacés par les nouvelles informations selon le nom de la référence que vous spécifiez.

Contenu de la rubrique

Structure de la syntaxe
Spécifications pour les types de liens
Types de liens définis par le système
Types de liens définis par les modèles de processus MSF
Restrictions et topologies des liens
Définition du schéma de type de lien

Structure de la syntaxe

Vous pouvez définir des types de liens supplémentaires en les ajoutant aux types de liens qui sont définis pour une collection de projets d'équipe. Vous pouvez définir des types de liens valides à utiliser dans votre processus en fonction de la structure fournie par le schéma de définition du type de lien. Les types de liens sont définis par la syntaxe XML suivante dans le fichier XML de types de liens :

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

Les descriptions du tableau suivant s'appliquent à la syntaxe précédente :

Attribut	Description
ReferenceName	Nom du type de lien. Il s'agit du nom utilisé en interne lorsque vous créez un lien entre deux éléments de travail.
ForwardName	Nom du lien au niveau de l'élément de travail de code source. Ce nom apparaît lorsque vous ajoutez des liens à l'élément de travail de code source.
ReverseName	Nom du lien au niveau de l'élément de travail cible. Ce nom apparaît lorsqu'une liste des liens s'affiche au niveau de l'élément de travail cible.
TopologyType	Spécifie la topologie DirectedNetwork, Network, Tree ou Dependency. Les trois premières topologies sont directionnelles et permettent de définir des relations subordonnées ou des relations séquentielles. La topologie Network permet de définir des relations d'égal à égal ou est utilisée lorsqu'aucune subordination implicite n'existe.

La direction du lien est déterminée par les assignations faites aux attributs ForwardName et ReverseName. Si vous créez un lien personnalisé et assignez le même nom aux noms directs et inverses, vous devez affecter au type de lien la valeur Network, car il s'agit de la seule topologie non directionnelle.

Spécifications pour les types de liens

LINKTYPES est un ensemble d'éléments LINKTYPE stockés et utilisés par une collection de projets d'équipe.

Chaque type de lien dispose d'un nom de référence et de deux noms conviviaux facultatifs, ou étiquettes de nom, qui doivent être uniques dans la collection de projets. Chaque nom de type de lien doit satisfaire les spécifications suivantes :

Les noms peuvent contenir jusqu'à 254 caractères Unicode.
Les noms ne doivent pas être vides.
Les noms ne peuvent pas contenir d'espaces blancs de début ou de fin.
Les noms ne peuvent pas contenir de barres obliques inverses (\).
Les noms ne peuvent pas contenir deux espaces blancs consécutifs.

Types de liens définis par le système

Le tableau suivant récapitule les types de liens définis par le système. Ces types de liens ne doivent pas être remplacés ou modifiés de quelque manière que ce soit.

Nom direct	Nom inverse	Nom de référence du type de lien	Topologie
Successeur	Prédécesseur	System.LinkTypes.Dependency	Dependency
Enfant	Parent	System.LinkTypes.Hierarchy	Tree
Associé	Associé	System.LinkTypes.Related	Network

Types de liens définis par les modèles de processus MSF

Le tableau suivant répertorie les types de liens créés lorsque vous créez un projet d'équipe à l'aide d'un modèle de processus MSF (Microsoft Solutions Framework). Ces types de liens sont spécialement conçus pour prendre en charge les interactions avec le suivi d'éléments de travail dans Team Foundation et Gestionnaire de tests Microsoft.

Nom direct	Nom inverse	Nom de référence du type de lien	Topologie
Testé par	Tests	Microsoft.VSTS.Common.TestedBy	Dependency
Cas de test	Étapes partagées	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Dependency

Chacun des types de liens répertoriés précédemment dans cette rubrique est ajouté à la collection de projets d'équipe lorsque vous utilisez un modèle de processus MSF pour créer un projet d'équipe. Les fichiers de définition de type de lien sont définis dans le dossier Tracking\LinkTypes du fichier Template.zip de l'élément de travail. La définition suivante pour le type de lien Microsoft.VSTS.Common.TestedBy est définie dans le fichier TestedBy.xml :

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

Lorsque vous créez le projet d'équipe à l'aide du modèle de processus correspondant, la définition de type de lien est importée dans la collection de projets.

Restrictions et topologies des liens

La topologie assignée à un type de lien détermine les restrictions ajoutées pour son utilisation. Le tableau suivant indique les différents types de topologies :

Type de topologie	Illustration
Réseau : vous pouvez utiliser des liens de réseau pour créer des relations de base entre les éléments de travail qui sont non restrictifs. Le lien est identique aux deux points de terminaison. Les relations circulaires sont autorisées. Exemple d'utilisation: utilisez un lien de réseau, tel que Associé, pour enregistrer une relation entre deux fonctionnalités susceptibles de partager des dépendances.
Réseau dirigé : vous pouvez utiliser des liens de réseau dirigé pour créer des relations entre les éléments de travail qui indiquent la direction. Le nom du lien est différent au niveau des points de terminaison. Les relations circulaires sont autorisées. Exemple d'utilisation : utilisez un lien de réseau dirigé pour enregistrer une relation entre deux fonctionnalités susceptibles de partager des dépendances et que vous souhaitez pouvoir distinguer l'une de l'autre d'une certaine façon.
Dépendance : vous pouvez utiliser des liens de dépendance pour créer des relations entre les éléments de travail directionnels et restreindre les relations circulaires. Le nom du lien est différent au niveau des points de terminaison. Dans l'illustration, vous ne pouvez pas créer de lien dépendant vers un élément de travail qui contient des relations de liaisons dépendantes vers les mêmes éléments de travail. Exemple d'utilisation : utilisez un lien de dépendance pour enregistrer les fonctionnalités qui doivent être terminées afin de répondre aux besoins des utilisateurs.
Arborescence : vous pouvez utiliser des liens d'arborescence pour créer des relations hiérarchiques multiniveaux entre les éléments de travail. Les liens d'arborescence prennent en charge les vues hiérarchiques multiniveaux, ils sont directionnels et restreignent les relations circulaires. Le nom du lien est différent au niveau des points de terminaison. Les liens d'arborescence sont les seuls types de liens pris en charge par la requête Arborescence des éléments de travail. Dans l'illustration, vous ne pouvez pas assigner deux parents à un enfant. Exemple d'utilisation : utilisez un lien d'arborescence pour enregistrer les tâches et sous-tâches d'équipe dont dépend la finalisation d'une fonctionnalité.

Définition du schéma des types de liens

Le code suivant répertorie la définition du schéma des types de liens :

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