Partager via


Définition des listes globales

À l'aide de listes globales, vous pouvez réduire le travail nécessaire à la mise à jour d'une liste utilisée par 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 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 ou à un modèle de processus, 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.

Notes

Pour qu'un flux de travail global puisse être défini, la fonctionnalité doit être activée sur le serveur de couche Application. Par conséquent, le serveur doit exécuter une version de Visual Studio Team Foundation Server, telle que Team Foundation Server 2010 avec le Service Pack 1 (SP1) qui prend en charge cette fonctionnalité. Vous pouvez télécharger le Service Pack sur la page suivante du site Web Microsoft : Service Pack 1 of Visual Studio Team Foundation Server 2010, Beta. Pour plus d'informations, consultez Personnalisation du workflow global.

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.

Notes

Il n'existe aucune liste globale définie par le système, ni aucune liste globale prédéfinie dans les modèles de processus Microsoft Solutions Framework (MSF).

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

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 définissez des listes globales pour 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 : vous pouvez ajouter les listes globales qui doivent être disponibles pour un type d'élément de travail à sa définition.

  • Définition du flux de travail global : vous pouvez ajouter les listes globales qui doivent être disponibles pour tous les types d'éléments de travail à la définition du flux de travail global pour un projet d'équipe ou une collection. Pour plus d'informations, consultez Personnalisation du workflow 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éfinition 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

Tâches

Ajouter, utiliser et gérer des listes globales

Référence

Gestion de listes globales de types d'éléments de travail (witadmin)

Concepts

Personnalisation des données de suivi de projet, de formulaires, de flux de travail et d'autres objets

Définition et utilisation de listes, listes de choix et listes globales

Autres ressources

Personnalisation du workflow global

Historique des modifications

Date

Historique

Motif

Janvier 2011

Le contenu a été mis à jour pour inclure les quatre méthodes permettant de définir des listes globales, y compris le flux de travail global. La section sur la définition de schéma a été supprimée.

Améliorations apportées aux informations.