Référence des éléments de type de lien

Article
06/09/2015

Il existe différents types de liens qui vous permettent d'établir des relations de lien entre différents types d'éléments de travail. Les types de liens se répartissent en trois catégories : ceux définis par le système, ceux définis par le modèle de processus et ceux définis par l'utilisateur. Les types de liens définis dans les modèles de processus par défaut prennent en charge les relations de lien entre les types d'éléments de travail de gestion des tests.

Chaque type de lien définit les étiquettes de lien, le type de topologie et les restrictions utilisés lors de l'établissement de liens entre des éléments de travail. Par exemple, le type de lien parent-enfant définit deux étiquettes (Parents et Enfant), prend en charge une topologie hiérarchique ou 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, utilisez witadmin importlinktype pour importer le fichier de définition de type de lien à la collection de projets qui héberge votre projet d'équipe.

Structure de la syntaxe

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

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

Les descriptions contenues dans le tableau ci-dessous s'appliquent à la syntaxe précédente :

Attribut	Description
ReferenceName	Nom du type de lien. Ce nom est 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 source. Ce nom apparaît lorsque vous ajoutez des liens vers l'élément de travail source.
ReverseName	Nom du lien au niveau de l'élément de travail cible. Ce nom apparaît dans la liste des liens 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 vous les utilisez pour définir des relations subordonnées ou séquentielles. Utilisez Network pour définir des relations entre homologues ou lorsqu'il n'existe aucune subordination implicite.

La direction des liens est déterminée par les valeurs assignées aux attributs ForwardName et ReverseName. Si vous créez un lien personnalisé et que vous assignez le même nom à ces deux attributs, sélectionnez Network comme type de lien car il s'agit de la seule topologie non directionnelle.

Spécifications

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

Chaque type de lien comprend un nom de référence et deux noms conviviaux facultatifs, ou étiquettes de nom, qui doivent être uniques au sein de la collection de projets. Chaque nom de type de lien doit respecter 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épertorie les types de liens définis par le système. Vous ne pouvez pas modifier ces types de liens.

Nom direct	Nom inverse	Nom de la référence	Topologie
Successeur	Prédécesseur	System.LinkTypes.Dependency	Dépendance
Enfant	Parent	System.LinkTypes.Hierarchy	Arborescence
Associé	Associé	System.LinkTypes.Related	Réseau

Par ailleurs, il existe d'autres types de liens utilisés pour lier des éléments de travail à d'autres objets du projet d'équipe ou d'autres éléments, comme une page web ou un emplacement réseau. Par exemple, le type de lien Storyboard établit un lien entre des éléments de travail et des animations ou tout fichier situé sur un partage réseau. Pour plus d’informations, voir Lier des éléments de travail et des objets pour la prise en charge de la traçabilité.

Types de liens définis par le modèle de processus

Quand vous créez un projet d'équipe à l'aide de l'un des modèles de processus par défaut fournis par TFS, les types de liens suivants sont ajoutés à votre projet d'équipe. Ces types de liens sont spécifiquement conçus pour prendre en charge l'interaction avec le suivi des éléments de travail dans Team Foundation et Microsoft Test Manager.

Types d'élément de travail de gestion de test

Nom direct	Nom inverse	Nom de référence du type de lien	Topologie
Affecte (voir remarque 1)	Affecté par	Microsoft.VSTS.Common.Affects	Dépendance
Référencé par (voir remarque 2)	Références	Microsoft.VSTS.TestCase.SharedParameterReferencedBy	Dépendance
Testé par	Tests	Microsoft.VSTS.Common.TestedBy	Dépendance
Cas de test	Étapes partagées	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Dépendance

Remarques

Le type de lien Affecte/Affecté par établit un lien entre les demandes de modification et les spécifications. Ce type de lien est uniquement ajouté aux projets d'équipe qui sont créés avec un modèle de processus CMMI.
Le type de lien Référencé par/Références établit un lien entre les paramètres partagés et le cas de test pour prendre en charge l'exécution de tests avec des données différentes. Ce type de lien est ajouté à un projet d'équipe quand vous mettez celui-ci à jour à l'aide de l'Assistant Configurer les fonctionnalités ou quand vous créez un projet d'équipe basé sur un modèle de processus TFS 2013.2 ou version ultérieure.

Les fichiers de définition de type de lien sont définis dans le dossier WorkItem Tracking\LinkTypes du fichier Template.zip. La définition suivante pour le type de lien Microsoft.VSTS.Common.TestedBy est définie dans le fichier de 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 du type de lien est importée dans la collection de projets.

Restrictions de lien et topologies

Les types de topologies décrits dans le tableau suivant déterminent les restrictions gouvernant l'utilisation de chaque type de lien.

Type de topologie	Illustration
Réseau : vous pouvez utiliser des liens réseau pour créer des relations de base entre des éléments de travail qui ne sont pas restrictifs. Le lien est le même aux deux extrémités. Les relations circulaires sont autorisées. Exemple d'utilisation : utilisez un lien réseau, comme Associé, pour enregistrer une relation entre deux fonctionnalités susceptibles de partager dépendances.
Réseau dirigé : vous pouvez utiliser des liens réseau pour créer des relations entre les éléments de travail qui indiquent une direction. Le nom du lien est différent à chaque extrémité. Les relations circulaires sont autorisées. Exemple d'utilisation : utilisez un lien réseau pour enregistrer une relation entre deux fonctionnalités susceptibles de partager des dépendances et que vous souhaitez caractériser d'une certaine façon.
Dépendance : vous pouvez utiliser des liens de dépendance pour créer des relations entre des éléments de travail ayant une direction et pour limiter les relations circulaires. Le nom du lien est différent à chaque extrémité. Dans l'illustration, vous ne pouvez pas créer un lien dépendant vers un élément de travail qui contient des relations de lien 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 effectuées pour répondre à une spécification utilisateur.
Arborescence : vous pouvez utiliser des liens d'arborescence pour créer des relations hiérarchiques sur plusieurs niveaux entre éléments de travail. Les liens d'arborescence prennent en charge les vues hiérarchiques, ont une direction et limitent les relations circulaires. Le nom du lien est différent à chaque extrémité. Les liens d'arborescence sont le seul type de lien qui est 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 de votre équipe qui doivent être effectuées pour fournir une fonctionnalité.

Définition du schéma de types de liens

Le code suivant présente la définition du schéma pour les 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>

Q et R

Q : Comment ajouter un type de lien personnalisé ?

R : Définissez un fichier de définition XML en fonction du contenu fourni dans cette rubrique, puis utilisez witadmin importlinktype pour importer le fichier de définition de type de lien dans la collection de projets qui héberge votre projet d'équipe.

Q : Quel type lien est utilisé pour établir des liens entre des cas de test et des suites de tests et entre des suites de tests et des plans de test ?

R : À l'aide de Team Web Access ou de Test Manager, vous pouvez examiner les cas de test qui sont définis pour une suite de tests et les suites de tests qui sont définies pour un plan de test. Cependant, ces objets ne sont pas liés entre eux par l'intermédiaire de types de liens.

Voir aussi

Concepts

Personnaliser les objets de suivi de travail pour prendre en charge les processus de votre équipe

Autres ressources

Lier des éléments de travail et des objets pour la prise en charge de la traçabilité

Partager via