Champs de requête, opérateurs, valeurs et variables

Lorsque vous créez une requête pour rechercher des éléments de travail dans Visual Studio Team Foundation Server 2010, vous pouvez définir une ou plusieurs clauses qui identifient le jeu d'éléments de travail à rechercher. Pour chaque clause, vous pouvez spécifier un champ, un opérateur et une valeur ou variable. Par exemple, vous pouvez rechercher tous les éléments de travail dans un projet d'équipe particulier en spécifiant le champ Projet d'équipe, l'opérateur d'égalité (=) et le nom du projet d'équipe comme valeur. Au lieu de spécifier une valeur, vous pouvez spécifier une variable telle que @Project, qui représente le projet d'équipe actuel.

Exemple de clause de requête

Et/ou	Champ	Opérateur	Value
Et	Projet d'équipe	=	@Project

Pour plus d'informations générales sur les requêtes, consultez Recherche de bogues, de tâches et d'autres éléments de travail. Pour plus d'informations sur la navigation dans l'Éditeur de requêtes ou dans l'Affichage des requêtes à l'aide de raccourcis clavier, consultez Raccourcis clavier de l'éditeur de requêtes et de l'affichage Résultats de la requête.

Dans cette rubrique

• Et/Ou

• Champs de requête et valeurs

• Opérateurs de requête

• Variables de requête

Liste de vérification pour la définition d'une clause de requête :

1. Dans la première ligne vide, cliquez sous l'en-tête de colonne Champ, sur la flèche bas pour afficher la liste des champs disponibles, puis sur un élément dans la liste.

   Pour plus d'informations, consultez Champs de requête et valeurs.

2. Dans la même ligne, cliquez sous l'en-tête de colonne Opérateur, sur la flèche bas pour afficher la liste des opérateurs disponibles, puis sur un élément dans la liste.

   Pour plus d'informations, consultez Opérateurs.

3. Dans la même ligne, cliquez sous l'en-tête de colonne Valeur.

4. Tapez une valeur ou cliquez sur la flèche bas, puis cliquez sur un élément dans la liste.

5. Pour plus d'informations sur l'utilisation de variables pour spécifier le projet d'équipe, la date ou l'utilisateur actuel, consultez Variables.

6. Pour ajouter une clause, cliquez sur Cliquez ici pour ajouter une nouvelle clause.

   Vous pouvez ajouter une clause à la fin de la requête, insérer une clause après une clause existante (), et supprimer (), regrouper () et dégrouper () des clauses selon vos besoins. Vous pouvez également copier et coller le contenu d'une clause dans un nouvel emplacement. Pour plus d'informations, consultez Spécifier des critères de filtre de requête.

Et/ou

Vous pouvez utiliser cette colonne pour spécifier la façon dont les clauses sont testées. Vous pouvez spécifier Et pour rechercher des éléments de travail qui répondent aux critères dans cette clause et la clause précédente. Vous pouvez spécifier Ou pour rechercher des éléments de travail qui répondent au critère dans cette clause ou la clause précédente.

Champs de requête et valeurs

Lorsque vous spécifiez une valeur pour chaque champ, la valeur doit être conforme au type de données de ce champ. Tous les champs dans Team Foundation ont l'un des types de données répertoriés dans le tableau suivant :

Type de données	Données stockées
DateTime	Moment exprimé en temps UTC (Universal Coordinated Time). Vous pouvez spécifier une variable (telle que @Today ou @Today-1) ou une valeur (telle que 1/1/2009).
Double	Nombre réel, tel que 0,2 ou 3,5.
GUID	Chaîne de caractères qui représente un ID unique.
HTML	Chaînes de texte qui prennent en charge des descriptions mises en forme.
Integer	Entier 32 bits signé, tel que 0, 1, 2, 34.
PlainText	Chaînes de texte qui prennent en charge les descriptions longues, telles que les champs Description ou Historique définis pour un élément de travail. Vous pouvez rechercher des éléments de travail selon une expression ou un mot clé contenu dans un champ PlainText.
String	Chaîne de texte qui contient jusqu'à 255 caractères Unicode.
TreePath	Arborescence de branchement, par exemple un chemin de zone ou un chemin d'itération. Vous devez cliquer sur un élément dans une liste de valeurs valides. Vous pouvez rechercher des éléments de travail qui sont égaux à une arborescence ou qui se trouvent sous celle-ci.

Retour au début

Opérateurs de requête

Vous pouvez utiliser des opérateurs de requête dans le tableau suivant pour spécifier la relation entre chaque valeur d'une clause et la valeur correspondante dans un élément de travail. Pour plus d'informations sur le type de données assigné aux champs d'élément de travail, consultez Utilisation de champs système et de champs définis par les modèles de processus MSF.

Opérateur de requête	Retourne des éléments de travail si la valeur dans l'élément de travail correspond aux critères répertoriés	Types de données applicables
=	Correspond à la valeur dans la clause.	Nombre, texte, date, arborescence
<>	Ne correspond pas à la valeur dans la clause.	Nombre, texte, date, arborescence
>	Est supérieure à la valeur dans la clause.	Nombre, texte, date
<	Est inférieure à la valeur dans la clause.	Nombre, texte, date
>=	Est supérieure ou égale à la valeur dans la clause.	Nombre, texte, date
<=	Est inférieure ou égale à la valeur dans la clause.	Nombre, texte, date
=[Champ]	Correspond à la valeur contenue dans le champ spécifié.	Nom d'un champ de même type de données que le champ spécifié
<>[Champ]	Ne correspond pas à la valeur contenue dans le champ spécifié.	Nom d'un champ de même type de données que le champ spécifié
>[Champ]	Est supérieure à la valeur contenue dans le champ spécifié.	Nom d'un champ de même type de données que le champ spécifié
<[Champ]	Est inférieure à la valeur contenue dans le champ spécifié.	Nom d'un champ de même type de données que le champ spécifié
>=[Champ]	Est supérieure ou égale à la valeur contenue dans le champ spécifié.	Nom d'un champ de même type de données que le champ spécifié
<=[Champ]	Est inférieure ou égale à la valeur contenue dans le champ spécifié.	Nom d'un champ de même type de données que le champ spécifié
Contient	Contient la valeur texte dans la clause.	Texte
Ne contient pas	Ne contient pas la valeur texte dans la clause.	Texte
Dans	Correspond à n'importe quelle valeur dans un jeu délimité. Par exemple, vous pouvez rechercher des éléments de travail dont les ID sont 100, 101 et 102 si vous spécifiez ces valeurs pour le champ ID. Important Valeurs séparées avec le séparateur de liste qui correspond aux paramètres régionaux définis pour votre ordinateur client.Par exemple, vous pouvez utiliser une virgule (,).	Nombre, texte, date, arborescence
Dans le groupe	Correspond à une valeur qui est membre du groupe dans la clause. Vous pouvez spécifier un groupe par défaut, personnalisé ou de catégories dans Team Foundation Server. Par exemple, vous pouvez créer une requête pour trouver tous les éléments de travail assignés aux membres du groupe Contributors. Remarque Vous ne pouvez pas spécifier de groupe de sécurité ou de groupe de distribution par messagerie électronique comme valeur.	Chaîne qui correspond au nom d'un groupe d'utilisateurs ou groupe de catégories dans Team Foundation Server. Remarque Vous pouvez uniquement utiliser l'opérateur Dans le groupe avec des champs qui utilisent le type de données String ou le champ Type d'élément de travail. Pour plus d'informations sur les groupes de catégorie, consultez Regroupement de types d'éléments de travail en catégories.
Pas dans le groupe	Ne correspond pas à une valeur qui est membre du groupe dans la clause.	Chaîne qui correspond au nom d'un groupe d'utilisateurs ou groupe de catégories dans Team Foundation Server. Remarque Vous pouvez uniquement utiliser l'opérateur Pas dans le groupe avec des champs qui utilisent le type de données String ou le champ Type d'élément de travail. Pour plus d'informations sur les groupes de catégorie, consultez Regroupement de types d'éléments de travail en catégories.
Toujours	Correspond à la valeur dans la clause à un point précédent quelconque.	Texte, date
Sous	Correspond à la valeur dans la clause ou est contenue sous le nœud dans la clause.	Arborescence
Pas sous	Ne correspond pas à la valeur dans la clause et n'est pas contenue sous le nœud dans la clause.	Arborescence

Retour au début

Variables de requête

Vous pouvez utiliser les variables dans le tableau suivant pour rechercher des éléments de travail en rapport avec l'utilisateur actuel, le projet actuel ou la date actuelle.

Variable de requête	Utilisation
@Me	Utilisez cette variable pour rechercher automatiquement l'alias de l'utilisateur actuel dans un champ qui contient des alias d'utilisateur. Par exemple, vous pouvez rechercher les éléments de travail que vous avez ouverts si vous affectez à la colonne Champ la valeur Activé par, à la colonne Opérateur la valeur = et à la colonne Valeur la valeur @Me.
@Project	Utilisez cette variable pour rechercher des éléments de travail dans le projet d'équipe actuel. Par exemple, vous pouvez trouver tous les éléments de travail dans le projet d'équipe actuel si vous affectez à la colonne Champ la valeur Projet d'équipe, à la colonne Opérateur la valeur = et à la colonne Valeur la valeur @Project.
@Today	Utilisez cette variable pour rechercher des éléments de travail en rapport avec la date actuelle ou une date antérieure. Vous pouvez également modifier la variable @Today en retirant des jours. Par exemple, vous pouvez rechercher tous les éléments activés la semaine dernière en affectant à la colonne Champ la valeur Date d'activation, à la colonne Opérateur la valeur >= et à la colonne Valeur la valeur @Today - 7.
[Any]	Utilisez cette variable pour rechercher des éléments de travail en rapport avec n'importe quelle valeur définie pour un champ particulier.

Retour au début

Voir aussi

Tâches

Spécifier des critères de filtre de requête

Ajouter, supprimer, réorganiser et trier les colonnes

Enregistrer, copier, renommer et supprimer des requêtes d'élément de travail

Dresser une liste d'éléments de travail (liste plate par défaut)

Afficher et modifier des éléments de travail dans une vue de liens directs

Afficher et modifier des éléments de travail dans une arborescence

Concepts

Recherche de bogues, de tâches et d'autres éléments de travail

Autres ressources

Partage des éléments de travail et des requêtes avec les membres de l'équipe

Historique des modifications

Date	Historique	Motif
Juillet 2010	Informations corrigées sur le délimiteur que vous utilisez lorsque vous spécifiez plusieurs valeurs.	Commentaires client.
Septembre 2010	Informations corrigées sur les valeurs que vous pouvez spécifier pour les opérateurs Dans le groupe et Pas dans le groupe.	Commentaires client.