Définir des contrôles de liens pour restreindre les relations de liens

Vous pouvez contrôler les liens entre les éléments de travail en personnalisant le formulaire de travail. Plus spécifiquement, vous pouvez contrôler les types de liens et d'éléments de travail que les utilisateurs peuvent afficher et ajouter dans un contrôle des liens. Par exemple, vous pouvez ajouter un onglet à votre formulaire pour vous aider à gérer les fonctionnalités dépendantes. Sous cet onglet, vous pouvez ajouter le contrôle des liens et restreindre les relations de liens que les membres de l'équipe peuvent afficher et créer à partir de ce contrôle pour inclure uniquement les liens vers d'autres fonctionnalités.

Vous utilisez l'attribut LinksControl Type de l'élément Control pour permettre aux utilisateurs de créer des relations de liens entre des éléments de travail et d'autres objets de la base de données Team Foundation. Vous pouvez ensuite utiliser les éléments enfants LinksControlOptions pour définir les options servant à contrôler quels liens les membres de l'équipe peuvent ajouter à un élément de travail et à quels types d'éléments de travail ou d'objets ils peuvent être liés. Vous pouvez également définir les colonnes par défaut que vous souhaitez afficher pour la liste de liens de ce contrôle.

Pour obtenir un résumé des restrictions de liens définies pour les modèles de processus TFS, consultez Contrôles de liens, restrictions et référence de champ. Pour plus d'informations sur les types de liens, consultez Référence des éléments de type de lien.

Dans cette rubrique

• Spécification du contrôle des liens

• Contrôle des relations de liens

• Restriction des relations de liens aux éléments de travail

• Restriction des relations de liens aux ensembles de modifications, liens hypertexte et autres éléments qui ne sont pas des éléments de travail

• Restriction des relations de liens aux types d'éléments de travail

• Spécification des colonnes par défaut à afficher

Spécification du contrôle des liens

Vous utilisez l'option LinksControl pour permettre aux utilisateurs d'ajouter, d'afficher et de gérer des relations de liens dans un formulaire d'élément de travail. À l'aide de ce contrôle, vous pouvez ouvrir, modifier, ajouter ou supprimer des liens.

Vous pouvez personnaliser un formulaire afin qu'un onglet affiche uniquement les liens parents et enfants et qu'un autre onglet affiche tous les autres types de liens. Dans l'exemple suivant, un onglet étiqueté « Tout les liens » est créé, que les membres de l'équipe peuvent utiliser pour ajouter tous les types de liens. En outre, les colonnes par défaut qui apparaissent pour l'affichage des liens sont ID, Work Item Type, Title, Assigned To, State, et le champ Link Comment.

LinksControl

<Tab Label="All Links">
   <Control Type="LinksControl" Name="All" >
      <LinksControlOptions>
         <LinkColumns>
            <LinkColumn RefName="System.ID" />
            <LinkColumn RefName="System.WorkItemType" />
            <LinkColumn RefName="System.Title" />
            <LinkColumn RefName="System.AssignedTo" />
            <LinkColumn RefName="System.State" />
            <LinkColumn LinkAttribute="System.Links.Comment" />
         </LinkColumns>
      </LinksControlOptions>
   </Control>
</Tab>

Retour au début

Contrôle des relations de liens

Lorsque vous ajoutez un contrôle de lien à un formulaire d'élément de travail, vous pouvez spécifier des filtres qui restreignent les types de liens et d'éléments de travail que les membres de l'équipe peuvent ajouter lorsqu'ils utilisent le contrôle. Le tableau suivant décrit les éléments enfants facultatifs qui contrôlent les relations de liens.

Élément	Description
WorkItemLinkFilters	Restreint les types de liens qui peuvent être utilisés pour établir des liens vers des éléments de travail.
ExternalLinkFilters	Restreint les types de liens qui peuvent être utilisés pour établir des liens vers un objet qui n'est pas un type d'élément de travail, tel qu'un ensemble de modifications, lien hypertexte ou élément de contrôle de version.
WorkItemTypeFilters	Restreint les types d'éléments de travail vers lesquels un utilisateur peut établir un lien, et les projets d'équipe dans lesquels ces éléments de travail sont définis.
Filter	Spécifie les types de liens ou types d'éléments de travail à inclure ou exclure.

Retour au début

Restriction des relations de liens aux éléments de travail

Vous utilisez les éléments enfants WorkItemLinkFilters et Filter pour définir les types de liens que le contrôle des liens doit inclure ou exclure. Vous utilisez cet élément pour restreindre les types de liens qui peuvent être sélectionnés par le contrôle des liens pour établir des relations vers les éléments de travail définis dans le même projet. La syntaxe pour ces éléments est la suivante.

<WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
</WorkItemLinkFilters>

Attribut	Description
FilterType	Attribut WorkItemLinkFilters requis. Définit la méthode utilisée pour filtrer l'ensemble des types de liens fourni dans l'ensemble d'éléments Filter. Vous pouvez utiliser les valeurs valides suivantes : exclude : à utiliser pour empêcher la création de liens à partir des types de liens répertoriés dans les éléments Filter. excludeAll : à utiliser pour interdire tout type de lien. include : à utiliser pour n'autoriser que les types de liens répertoriés dans les éléments Filter. includeAll : à utiliser pour autoriser la création de liens de tous types.
LinkType	Attribut Filter requis. Spécifie le nom de référence d'un type de lien. Pour plus d'informations, consultez Référence des éléments de type de lien.
FilterOn	Attribut Filter facultatif. Spécifie le type de filtre à appliquer au type de lien. Vous pouvez utiliser les valeurs valides suivantes : forwardname : à utiliser pour filtrer sur le nom direct défini pour un type de lien. reversename : à utiliser pour filtrer sur le nom inverse défini pour un type de lien. Si aucune valeur n'est spécifiée, les noms direct et inverse sont utilisés pour filtrer le type de lien. Si la topologie de type de lien est Réseau, les noms direct et inverse sont les mêmes. Pour plus d'informations, consultez Référence des éléments de type de lien.

Exemple : exclusion de deux types de liens d'éléments de travail

Vous pouvez définir un contrôle de liens qui autorise des relations de liens pour tous les types de liens à l'exception d'un type de lien de spécification personnalisé et du type de lien de hiérarchie système, à l'aide de l'exemple de code suivant.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="exclude">
         <Filter LinkType="MyLinks.LinkTypes.Requirement" /> 
         <Filter LinkType="System.LinkTypes.Hierarchy" /> 
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
. . .
</Control>

Retour au début

Restriction des relations de liens aux ensembles de modifications, liens hypertexte et autres éléments qui ne sont pas des éléments de travail

Vous utilisez les éléments enfants ExternalLinkFilters et Filter pour définir quels types de liens vers des éléments externes au projet d'équipe le contrôle de liens doit inclure ou exclure. La syntaxe pour ces éléments est la suivante.

<ExternalLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="externalLinkName" />
</ExternalLinkFilters>

Attribut	Description
FilterType	Attribut ExternalLinkFilters facultatif. Définit la méthode utilisée pour filtrer l'ensemble des types de liens fournis dans l'ensemble d'éléments Filter. Vous pouvez utiliser les valeurs valides suivantes : exclude : à utiliser pour interdire la création de liens à partir des types de liens répertoriés dans les éléments Filter. excludeAll : à utiliser pour interdire tout type de lien. include : à utiliser pour n'autoriser que les types de liens répertoriés dans les éléments Filter. includeAll : à utiliser pour autoriser la création de liens de tous types. Si aucune valeur n'est spécifiée, tous les liens vers des éléments de travail externes sont exclus.
LinkType	Attribut Filter requis. Spécifie le nom de référence d'un type de lien à exclure ou inclure. Vous pouvez spécifier les types de liens suivants : Résolu dans l'ensemble de modifications Pièce jointe de résultat Fichier de code source Résultat de test Lien hypertexte vers un élément de travail

Exemple : exclure tous les liens vers des éléments qui ne sont pas des éléments de travail

L'exemple suivant définit un contrôle des liens qui inclut tous les types de liens vers des éléments de travail, tels que des liens associés et parent/enfant, mais exclut les types de liens vers des éléments qui ne sont pas des éléments de travail, tels que les ensembles de modifications, les liens hypertexte et les résultats de test.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="includeAll" /> 
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
</Control>

L'exemple suivant définit un contrôle de lien qui permet aux utilisateurs de spécifier uniquement le type de lien d'ensemble de modifications et d'établir des liens uniquement vers des ensembles de modifications.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="excludeAll"/>
      <ExternalLinkFilters FilterType="include" /> 
         <Filter LinkType="Fixed in Changeset" />
      </ExternalLinkFilters> 
 </LinksControlOptions>
. . .
</Control>

Retour au début

Restriction des relations de liens aux types d'éléments de travail

Vous utilisez les éléments enfants WorkItemTypeFilters et Filter pour restreindre les types d'éléments de travail vers lesquels le contrôle des liens peut établir des liens. Vous pouvez restreindre les relations de liens au projet d'équipe ou par type d'élément de travail. La syntaxe pour ces éléments est la suivante.

<WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" >
   <Filter WorkItemType="workItemTypeReferenceName" />
</WorkItemTypeFilters>

Attribut	Description
Scope	Attribut WorkItemTypeFilters facultatif. Définit la portée du filtre appliqué à l'ensemble de types d'éléments de travail fourni dans l'ensemble d'éléments Filter. Vous pouvez utiliser les valeurs valides suivantes : all : à utiliser pour autoriser la création de liens vers tous les types d'éléments de travail spécifiés dans les éléments Filter. project : à utiliser pour autoriser la création de liens uniquement vers les types d'éléments de travail définis pour le projet actuel. Si aucune valeur n'est spécifiée, les liens vers tous les types d'éléments de travail sont autorisés.
FilterType	Attribut WorkItemTypeFilters requis. Définit la méthode utilisée pour filtrer l'ensemble des types de liens fourni dans l'ensemble d'éléments Filter. Vous pouvez utiliser les valeurs valides suivantes : exclude : à utiliser pour interdire les types d'éléments de travail répertoriés dans les éléments Filter. excludeAll : à utiliser pour interdire tous les types d'éléments de travail. include : à utiliser pour autoriser les types d'éléments de travail répertoriés dans les éléments Filter. includeAll : à utiliser pour autoriser tous les types d'éléments de travail.
WorkItemType	Attribut Filter requis. Spécifie le nom de référence pour un type d'élément de travail.

Exemple : limitation des relations de liens aux éléments de travail Tâche

L'exemple suivant définit un contrôle des liens qui autorise uniquement l'établissement de relations hiérarchiques vers des tâches définies dans le projet d'équipe.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="System.LinkTypes.Hierarchy" />
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll"/>
      <WorkItemTypeFilters Scope ="project" FilterType="include" />
         <Filter WorkItemType="Task" />
      </WorkItemTypeFilters> 
   </LinksControlOptions>
. . .
</Control>

Retour au début

Spécification des colonnes par défaut à afficher

Vous utilisez les éléments enfants LinkColumns et LinkColumn pour spécifier les colonnes par défaut à afficher dans le contrôle des liens. Vous pouvez spécifier le nom de référence pour un champ d'élément de travail ou un attribut de lien. La syntaxe pour ces éléments est la suivante.

<LinkColumns>
   <LinkColumn RefName="reference name" | LinkAttribute=" link attribute name" />
</LinkColumns>

L'ordre dans lequel les éléments sont répertoriés définit l'ordre d'affichage des champs de colonne dans le formulaire d'élément de travail. Pour obtenir une liste des noms de référence et attributs de lien, consultez Référence des champs d'éléments de travail pour Visual Studio ALM. La syntaxe suivante définit l'affichage de quatre colonnes : ID, State, Title, et l'attribut de lien Comment.

<Control Type="LinksControl">
. . .
   <LinksControlOptions>
      <LinkColumns>
         <LinkColumn RefName="System.ID" />
         <LinkColumn RefName="System.State" />
         <LinkColumn RefName="System.Title" />
         <LinkColumn LinkAttribute="System.Links.Comment" />
      </LinkColumns>
   </LinksControlOptions>
</Control>

Retour au début

Voir aussi

Référence

Éléments LinksControlOptions

Concepts

Contrôles de liens, restrictions et référence de champ

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

Spécifier des contrôles de formulaire d'élément de travail