Partager via

Gérer les types de liens [witadmin]

  • Article

Comme 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 gérez 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 de 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 de types de liens à partir d'un fichier XML. Si un type de 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 type de lien est créé.

  • listlinktypes : répertorie l'ensemble disponible des types de liens sur un serveur.

  • reactivatelinktype : réactive le type de lien spécifié, et lui attribue éventuellement 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(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

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

Spécifications

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

  • Pour répertorier ou exporter les types de liens, votre autorisation Afficher les informations au niveau du projet pour un projet d'équipe dans la collection doit être définie sur Autoriser.

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

Pour plus d'informations, consultez Référence des autorisations pour Team Foundation Server.

Notes

Même si vous vous connectez avec des autorisations d'administrateur, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur exécutant 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, voir le site web de 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 de l'URI est le suivant : http://NomServeur:Port/NomRépertoireVirtuel/NomCollection

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 Unicode (UTF-7). 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 les données XML du type de lien sans les importer.

/noprompt

Désactive la demande de confirmation.

/? ou help

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

Notes

Pour connaître la structure du schéma de définition du type de lien, consultez Référence des éléments de type de lien.

Pour plus d'informations sur la façon dont vous pouvez restreindre les types de relations que les membres d'équipe peuvent établir, consultez Contrôles de liens, restrictions et référence de champ 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

Afficher 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

Afficher 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

Dé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

Exporter 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

Importer la définition des types de liens

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

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

Voir aussi

Concepts

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

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

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