Partager via

Définir des listes globales

  • Article

À l'aide de listes globales dans Team Foundation Server (TFS), vous pouvez réduire le travail nécessaire pour mettre à jour une liste que plusieurs types de partage d'éléments de travail.Les listes globales sont des listes de choix que vous pouvez inclure dans un ou plusieurs champs et 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, comme une 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 pour une collection en incluant les éléments de liste dans un ou plusieurs éléments GLOBALLIST.

En définissant des types d'éléments de travail, vous pouvez constater que certains champs ont les mêmes valeurs.Bien souvent, vous pouvez partager plusieurs types d'éléments de travail et même plusieurs projets d'équipe.Certaines de ces valeurs peuvent changer fréquemment, par exemple le numéro de build des builds nocturnes, ce qui nécessite qu'un administrateur mette à jour ces listes à de nombreux emplacements, de manière fréquente.Les listes globales peuvent s'avérer particulièrement utiles lorsqu'une liste doit être dérivée d'un système externe.Par exemple, supposons qu'une société tienne à jour une base de données client distincte.Lorsque vous classez un bogue découvert par un client, le nom du client est entré dans un champ Found By Customer personnalisé.

Vous pouvez gérer des listes globales pour 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 dans une collection.

[!REMARQUE]

Il n'y a des listes globales pas définies par le système, ni les listes globales intégrées dans les modèles de processus par défaut que TFS fournit.

Dans cette rubrique

  • Ajout et gestion de listes globales

  • Structure de la syntaxe de définition des listes globales

  • Structure de la syntaxe des listes globales ajoutées à une définition de type d'élément de travail ou à un flux de travail global

  • Structure de la syntaxe des listes globales conservées pour une collection

[!REMARQUE]

Pour ajouter ou modifier une liste globale, utilisez l'outil en ligne de commande des witadmin pour importer et exporter la définition de 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 d' FIELD dans un type d'élément de travail.Consultez Référence de tous les éléments XML FIELD.

Ajout et gestion de listes globales

Une liste globale est un ensemble d'éléments LISTITEM qui sont stockés et utilisés de manière globale par tous les projets d'équipe dans une collection de projets.Les listes globales sont utiles aux champs définis dans plusieurs types d'éléments de travail, par exemple 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 quatre méthodes suivantes :

  • Modèle de processus: Vous pouvez définir des listes globales dans la définition d'un type d'élément de travail dans un modèle de processus.Chaque projet d'équipe créé à partir de ce modèle peut accéder aux listes globales.

  • 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 dans la collection.

  • Définition du type d'élément de travail: Une fois un projet d'équipe créé, vous pouvez ajouter les listes globales qui doivent être disponibles pour un type d'élément de travail à sa définition.

  • Définition de flux de travail global: Une fois un projet d'équipe créé, vous pouvez ajouter les listes globales qui doivent être disponibles pour tous les types d'éléments de travail à la définition de flux de travail global pour un projet d'équipe ou une collection.Pour plus d'informations, consultez Personnaliser le flux de travail global.

Retour au début

Structure de la syntaxe de définition des listes globales

Le tableau suivant décrit les éléments GLOBALLIST et LISTITEM.Vous pouvez utiliser ces éléments pour énumérer une liste de valeurs présentée à l'utilisateur comme une liste de choix ou un menu déroulant d'éléments.

Élément

Syntaxe

Description

GLOBALIST

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

Définit un ensemble d'éléments LISTITEM stocké pour une collection et pouvant être utilisé par tous les projets d'équipe dans une collection.

NomListeGlobale : 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 des listes de choix.

LISTITEM

 
<LISTITEM value="Name" />

Définit une valeur de liste valide.

RemarqueRemarque
Les listes globales ne doivent pas inclure de groupes à portée de projet parce qu'elles ne sont pas limitées au 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.

Retour au début

Structure de la syntaxe des listes globales ajoutées à une définition de type d'élément de travail ou à un flux de travail global

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 en ajoutant la syntaxe suivante :

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

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

<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 de types d'éléments de travail ou du 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.

Retour au début

Structure de la syntaxe des listes globales conservées pour une collection de projets

Pour ajouter une liste globale à une collection de projets, vous pouvez importer la syntaxe suivante à l'aide de 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.

Retour au début

Voir aussi

Référence

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

Concepts

Personnaliser les données de suivi de projet, les formulaires, les flux de travail et d'autres objets

Définir des listes utilisateur, des listes de choix et des listes globales

Autres ressources

Personnaliser le flux de travail global