Partager via

Gérer des listes globales de types d'éléments de travail [witadmin]

  • Article

Les listes globales sont des listes de choix que vous pouvez inclure dans un ou plusieurs champs et types d'éléments de travail. Utilisez-les pour réduire le travail nécessaire à la mise à jour d'une liste partagée par plusieurs types d'éléments de travail. Comme les listes globales sont définies pour une collection de projets d'équipe, elles peuvent être incluses dans les types d'éléments de travail pour tous les projets d'équipe de la collection.

Vous pouvez définir une liste globale dans son propre fichier de définition, dans le fichier de définition pour un type d'élément de travail ou dans un flux de travail global. La définition de liste globale gère les listes globales définies pour une collection. La définition de liste globale utilise les commandes suivantes dans l'outil en ligne de commande witadmin :

  • destroygloballist :  détruit une liste globale.

  • exportgloballist :  exporte les listes globales vers un fichier XML ou vers la fenêtre d'invite de commandes. Elle exporte un seul fichier, qui contient toutes les listes globales définies pour la collection de projets d'équipe.

  • importgloballist :  importe les listes globales d'un fichier XML. Si vous essayez d'importer une liste globale qui existe déjà sur le serveur, un message d'avertissement vous demande si vous souhaitez remplacer celle présente sur le serveur. Si vous essayez d'importer une liste globale qui n'existe pas, la commande crée une liste globale.

  • listgloballist :  affiche le nom de chaque liste globale définie sur le serveur.

Consultez Définir les listes globales et Personnaliser le flux de travail global.

L'outil en ligne de commande witadmin ne fonctionne que quand vous l'exécutez sur un serveur TFS local. Pour exécuter l'outil, 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 14.0\Common7\IDE

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

Notes

Vous pouvez créer et modifier des listes globales à l'aide de Process Editor, un outil Power Tool pour Visual Studio.Pour plus d'informations, consultez Team Foundation Server Power Tools.

Spécifications

Pour la collection de projets d'équipe dans laquelle les listes globales sont définies, vous devez disposer des autorisations suivantes :

  • Pour exporter ou répertorier des listes globales, vous devez être membre du groupe Utilisateurs autorisés de la collection de projets ou votre autorisation Afficher les informations au niveau de la collection doit avoir la valeur Autoriser.

  • Pour importer des listes globales, vous devez être membre du groupe de sécurité Project Administrators ou votre autorisation Modifier les informations au niveau du projet doit avoir la valeur Autoriser.

  • Pour détruire une liste globale avec witadmin destroygloballist, vous devez être membre du groupe de sécurité Administrateurs de la collection de projets ou votre autorisation Modifier les informations au niveau de la collection doit avoir la valeur Autoriser.

Voir 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 la fenêtre du menu contextuel Invite de commandes, puis sélectionnez Exécuter en tant qu'administrateur.Pour plus d'informations, consultez la page suivante sur le site web Microsoft : Contrôle de compte d'utilisateur.

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

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

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

http://NomServeur:Port/NomCollection.

/n:GlobalListName

Nom de la liste globale à détruire.

/f:FileName

Chemin d'accès et nom du fichier de définition XML de liste globale à exporter ou importer.

Notes

Si l'ordinateur client exécute Windows Vista, vous pouvez ne pas disposer d'autorisations d'accès à certains dossiers.Si vous essayez d'exporter la liste globale vers un emplacement où vous ne possédez pas d'autorisation, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel.Pour plus d'informations, consultez les pages suivantes du site web Microsoft : Virtualisation du Registre et Problèmes de virtualisation de fichiers communs et du Registre dans Windows Vista.Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous possédez des autorisations.

/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.

/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

L'importation d'une liste globale s'accompagne de la création d'une liste s'il n'en existe aucune. Si la liste existe déjà, la commande witadmin importgloballist vous prévient que la liste actuelle sera remplacée. Vous pouvez écrire votre propre programme pour mettre à jour une liste globale existante ou mettre à jour la liste globale vous-même avec les nouvelles données.

Pour créer une liste globale, commencez par le code suivant et modifiez-le selon vos besoins. Cet exemple définit une liste globale des disciplines que vous pouvez affecter à des tâches.

<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST> 
</gl:GLOBALLISTS>

N'incluez pas de groupes de sécurité à portée de projet dans une liste globale, car les listes globales portent sur une collection et non un projet.

Pour ajouter une liste globale à un champ, exportez la définition du type d'élément de travail qui contient le champ et ajoutez-la à la définition de champ, comme indiqué dans l'exemple suivant :

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
     <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

Pour afficher les modifications, importez la définition du type et actualisez votre navigateur ou cache client. Vous devrez peut-être fermer tous les éléments de travail qui référencent le champ et les rouvrir.

Pour plus d'informations sur l'exportation et l'importation de définitions de type, consultez Importer, exporter et gérer des types d'éléments de travail [witadmin].

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

  • Numéro de port du site web du serveur : 8080

Afficher les noms des listes globales

L'exemple suivant affiche les listes globales définies sur le serveur. Cet exemple exporte les listes globales à l'aide de l'encodage UTF-8 par défaut :

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

Exporter la définition des listes globales

L'exemple suivant exporte les listes globales :

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

L'exemple suivant exporte les mêmes listes globales vers le même serveur, mais utilise l'encodage Unicode (UTF-7) :

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7

Importer la définition des listes globales

L'exemple suivant importe des listes globales :

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

L'exemple suivant importe les mêmes listes globales vers le même serveur, mais utilise l'encodage Unicode (UTF-7) :

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7

Voir aussi

Concepts

Définir les listes globales

Autres ressources

Personnaliser le flux de travail global

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