Partager via

Personnaliser et gérer des types de liens

  • Article

De même que pour les types d'éléments de travail, vous pouvez définir et modifier les types de liens personnalisés.Toutefois, vous ne pouvez apporter aucune modification aux types de liens définis par le système.Avant d'ajouter un nouveau type de lien à votre collection de projets d'équipe, vérifiez les types de liens disponibles pour votre utilisation.Consultez Lier des éléments de travail et des objets pour la prise en charge de la traçabilité.

Vous pouvez gérer les types de liens définis pour une collection de projets d'équipe à l'aide des commandes witadmin suivantes.

  • deactivatelinktype : désactive le type de lien spécifié.Les utilisateurs ne seront plus en mesure de créer des liens de ce type.Les liens existants de ce type continueront à fonctionner correctement.

  • deletelinktype : supprime définitivement le type de lien spécifié de la base de données.Tous les liens définis avec ce type de lien sont également supprimés.

  • exportlinktype : exporte les définitions des types de liens.Vous pouvez exporter la définition d'un type de lien unique ou tous les types de liens définis pour le serveur.

  • importlinktype : importe les définitions des types de liens d'un fichier XML.Si un lien portant le même nom de référence existe déjà, il est mis à jour pour correspondre au type de lien importé.Si le type de lien n'existe pas encore, un nouveau type de lien est alors créé.

  • listlinktypes : affiche l'ensemble de types de liens disponibles sur un serveur.

  • reactivatelinktype : réactive le type de lien spécifié, et éventuellement lui assigne un nouveau nom.

Pour exécuter l'outil de ligne de commande witadmin, ouvrez une fenêtre d'invite de commandes à l'endroit où Visual Studio ou Team Explorer est installé et entrez :

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Sur une édition 64 bits de Windows, remplacez %programfiles% par %programfiles(x86)%.

Configuration requise

Pour la collection de projets d'équipe dans laquelle les types de liens sont définis, vous devez disposer des autorisations suivantes :

  • Pour répertorier ou exporter des types de liaison, votre autorisation Afficher les informations au niveau du projet pour un projet d'équipe dans de collection doit avoir la valeur Autoriser.

  • Pour supprimer, importer ou réactiver des types de liaison, vous devez être membre du groupe de sécurité Project Collection Administrators ou votre autorisation Gérer les types de liaison d'élément de travail doit avoir la valeur Autoriser.

Pour plus d'informations, consultez Autorisations de Team Foundation Server et Groupes, autorisations et rôles par défaut de Team Foundation Server.

[!REMARQUE]

Même si vous vous connectez avec des autorisations d'administration, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur Windows Server 2008.Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, sélectionnez Démarrer, ouvrez le menu contextuel Invite de commandes, puis sélectionnez Exécuter en tant qu'administrateur.Pour plus d'informations, consultez le site Web Microsoft : Contrôle de compte d'utilisateur.

witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

Paramètres

Paramètre

Description

/collection:CollectionURL

Spécifie l'URI de la collection de projets d'équipe.Le format pour l'URI est le suivant :http://ServerName:Port/VirtualDirectoryName/CollectionName

Par exemple :

http//NomServeur: 8080/tfs/Collection0

Si aucun répertoire virtuel n'est utilisé, le format de l'URI est le suivant :

http://NomServeur:Port/NomCollection

/n:LinkName

Nom ou nom de référence du type de lien à désactiver ou supprimer.

/f:FileName

Fichier XML de types de liens.Obligatoire pour l'importation, facultatif pour l'exportation.Si vous omettez ce paramètre, le résultat de la commande s'affiche.

/e:encoding

Nom d'un .NET Framework 2.0 qui encode le format.L'encodage spécifié sera utilisé pour exporter ou importer les données XML.Par exemple, /e:utf-7 spécifie l'encodage (UTF-7) Unicode.Si vous omettez ce paramètre, witadmin essaie de détecter l'encodage, et si la détection échoue, witadmin utilise UTF-8.

/v

Valide le type de lien XML sans l'importer.

/noprompt

Désactive l'invite pour la confirmation.

/? ou help

Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes.

Notes

Pour la structure du schéma de définition de type de lien, consultez Référence d'élément Type de lien.

Pour plus d'informations sur la façon dont vous pouvez restreindre les types de relations de liens que les membres de l'équipe peuvent effectuer, consultez Liaison des éléments de travail avec les contrôles de liens et les restrictions et Éléments LinksControlOptions.

Exemples

Sauf spécification contraire, les valeurs suivantes s'appliquent dans chaque exemple :

  • URI pour la collection de projets d'équipe : http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Nom du serveur : AdventureWorksServer

  • Nom du fichier d'entrée ou de sortie : myLinkTypes.xml

  • Nom du type de lien : mylinktype

  • Encodage par défaut : UTF-8

Dd273716.collapse_all(fr-fr,VS.110).gifAfficher les types de liens

La commande suivante affiche les types de liens personnalisés définis pour Team Foundation AdventureWorksServer.

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Dd273716.collapse_all(fr-fr,VS.110).gifAfficher la définition d'un type de lien

L'exemple suivant affiche la définition du type de lien dans la fenêtre d'invite de commandes :

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Dd273716.collapse_all(fr-fr,VS.110).gifDésactiver, puis réactiver un type de lien

Les exemples suivants désactivent le type de lien, mylinktype, puis le réactivent :

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

Dd273716.collapse_all(fr-fr,VS.110).gifExporter la définition d'un type de lien

La commande suivante exporte la définition de tous les types de liens vers le fichier, mylinktype.xml :

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Dd273716.collapse_all(fr-fr,VS.110).gifImporter la définition des types de liens

L'exemple suivant importe la définition des types de lien définis dans le fichier XML :

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Voir aussi

Concepts

Référence d'élément Type de lien

Liaison des éléments de travail avec les contrôles de liens et les restrictions

Autres ressources

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

witAdmin : personnaliser et gérer des objets pour le suivi des éléments de travail