Personnaliser et gérer des types de liens
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
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 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