Définir les listes globales

  • Article

Avec les listes globales proposées dans Team Foundation Server (TFS), vous pouvez minimiser le travail requis pour mettre à jour une liste qui s'affiche dans les définitions de plusieurs types d'éléments de travail. Les listes globales sont des listes de choix que vous pouvez inclure dans un ou plusieurs champs et définitions de types d'éléments de travail. Vous pouvez définir une liste globale dans un type d'élément de travail que vous ajoutez à un projet d'équipe, en tant que liste globale pour une collection de projets d'équipe, ou dans un flux de travail global. Vous pouvez partager des éléments de liste entre plusieurs types d'éléments de travail d'une collection en incluant les éléments de la liste dans un ou plusieurs éléments GLOBALLIST.

Lors de la définition des types d'éléments de travail, vous constaterez peut-être que certains champs partagent les mêmes valeurs. Il est en effet souvent possible de partager entre plusieurs types d'éléments de travail, voire entre plusieurs projets d'équipe. Certaines de ces valeurs, telles que le numéro de build des builds nocturnes, changent fréquemment, ce qui oblige l'administrateur à mettre à jour fréquemment ces listes à de nombreux endroits. Les listes globales peuvent être particulièrement utiles quand une liste doit être dérivée d'un système externe. Par exemple, supposez qu'une entreprise gère une base de données cliente distincte. Quand vous archivez un bogue détecté par un client, le nom du client est entré dans un champ Found By Customer personnalisé.

Vous pouvez gérer les listes globales d'une collection sous la forme d'un fichier XML que vous pouvez répertorier, importer, exporter et supprimer. Le nom de chaque liste globale peut contenir jusqu'à 254 caractères Unicode et doit être unique au sein d'une collection.

Notes

Il n'existe pas de liste globale définie par le système ni de liste globale prédéfinie dans les modèles de processus par défaut fournis par TFS.

Spécifications

  • Pour exporter ou répertorier les 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 définir ou modifier les listes globales, vous devez être membre du groupe Project Administrators ou votre autorisation Modifier les informations au niveau du projet doit avoir la valeur Autoriser.

  • Pour ajouter ou modifier une liste globale, utilisez l'outil en ligne de commande witadmin pour importer et exporter la définition pour les listes globales. Consultez Gérer des listes globales de types d'éléments de travail [witadmin]. Pour utiliser une liste globale, ajoutez-la à la définition de FIELD dans un type d'élément de travail. Consultez Référence de tous les éléments XML FIELD.

Ajouter et gérer des listes globales

Une liste globale est un ensemble d'éléments LISTITEM qui est stocké et utilisé globalement par tous les projets d'équipe d'une collection. Les listes globales sont utiles pour les champs définis dans plusieurs types d'éléments de travail, tels que Système d'exploitation, Trouvé dans la build et Corrigé dans la build.

Vous pouvez définir des listes globales et leurs éléments en utilisant l'une des méthodes suivantes :

  • Collection de projets d'équipe : vous pouvez exporter, modifier, supprimer et importer les listes globales définies pour une collection de projets d'équipe. Ces listes globales sont disponibles pour tous les projets d'équipe de la collection.

  • Définition de type d'élément de travail : une fois qu'un projet d'équipe a été créé, vous pouvez ajouter à sa définition les listes globales que vous souhaitez garder disponibles pour un type d'élément de travail.

  • Définition de flux de travail global : une fois qu'un projet d'équipe a été créé, vous pouvez ajouter les listes globales que vous souhaitez garder disponibles pour tous les types d'éléments de travail dans la définition du flux de travail global pour un projet d'équipe ou une collection. Pour plus d'informations, consultez Personnaliser le flux de travail global.

Structure de la syntaxe

Le tableau ci-dessous décrit les éléments GLOBALLIST et LISTITEM. Vous pouvez utiliser ces éléments pour énumérer une liste de valeurs qui est présentée à l'utilisateur sous la forme d'une liste de choix ou d'un menu déroulant d'éléments.

Élément

Syntaxe

Description

GLOBALLIST

 
<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

Définit un ensemble d'éléments LISTITEM qui est stocké pour une collection et que tous les projets d'équipe d'une collection peuvent utiliser.

globalListName : chaîne de texte qui contient entre 1 et 255 caractères.

GLOBALLIST est un élément enfant obligatoire de l'élément GLOBALLISTS et un élément enfant facultatif des éléments ALLOWEDVALUES, SUGGESTEDVALUES et PROHIBITEDVALUES. Pour plus d'informations, consultez Définir les listes de choix.

LISTITEM

 
<LISTITEM value="Name" />

Définit une valeur de liste valide.

Notes

Les listes globales ne doivent pas inclure de groupes limités à un projet, car elles ne sont justement pas limitées à un projet.

LISTITEM est un élément enfant obligatoire de l'élément GLOBALLIST et un élément enfant facultatif des éléments ALLOWEDVALUES, SUGGESTEDVALUES et PROHIBITEDVALUES.

Exemple de liste globale

En ajoutant la syntaxe suivante, vous pouvez définir une liste globale dans un fichier de définition XML pour un type d'élément de travail ou un flux de travail global :

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

En utilisant la syntaxe suivante, vous pouvez référencer une liste globale dans un fichier de définition XML pour un type d'élément de travail :

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

Pour plus d'informations sur la structure et l'emplacement des fichiers de définition pour les types d'éléments de travail ou le flux de travail global, consultez Référence de tous les éléments XML WITD ou Référence des éléments XML du workflow global, respectivement.

Exemple de liste globale conservée pour une collection de projets

Pour ajouter une liste globale à une collection de projets, vous pouvez importer la syntaxe suivante en utilisant la commande witadmin importgloballist :

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

Une liste globale ne peut pas être vide. Chaque élément GLOBALLIST doit avoir au moins un élément LISTITEM défini.

Q et R

Q : Des listes globales sont-elles remplies automatiquement par des données ?

R : oui. La liste globale nommée Builds – NomProjetÉquipe est complétée chaque fois qu'une build est exécutée. Au fil du temps, la liste peut devenir très longue. La méthode recommandée consiste à supprimer régulièrement les builds inutilisées de la liste.

Pour en savoir plus sur l'utilisation de cette liste, consultez Champs prenant en charge l'intégration avec un test, une build et un contrôle de version.

Voir aussi

Référence

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

Concepts

Personnaliser les objets de suivi de travail pour prendre en charge les processus de votre équipe