Champs de requête, opérateurs, valeurs et variables (Team Explorer Everywhere)

Article
04/04/2011

Lorsque vous créez une requête pour rechercher des éléments de travail, 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.

Le tableau suivant montre un exemple de clause de requête :

Et/ou	Champ	Opérateur	Valeur
Et	Nom du projet	=	@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 (Team Explorer Everywhere). 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 (TEE).

Dans cette rubrique

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

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 Query Fields and Values.
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 Query Operators.
Dans la même ligne, cliquez sous l'en-tête de colonne Valeur.
Tapez une valeur ou cliquez sur la flèche bas, puis cliquez sur un élément dans la liste.

Pour plus d'informations sur l'utilisation de variables pour spécifier le projet d'équipe, la date ou l'utilisateur actuel, consultez Query Variables.
Pour ajouter une clause, cliquez sur * dans la colonne la plus à gauche.

Notes

Vous devez remplir les champs de la clause ajoutée avant de pouvoir ajouter une deuxième clause.

Vous pouvez ajouter une clause à la fin de la requête ou entre des clauses existantes, et supprimer, regrouper et dissocier des clauses selon vos besoins. Vous pouvez également copier et coller le contenu d'une clause dans un autre emplacement. Pour plus d'informations, consultez Spécifier des critères 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 ou 34.
PlainText	Chaîne de texte qui prend en charge de longues descriptions, telles que le champ Description ou Historique. Vous pouvez rechercher des éléments de travail selon une expression ou un mot clé contenu dans un champ PlainText.
Chaîne	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.

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.

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 champs 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 des virgules. 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.	Nombre, texte, date, arborescence
Dans le groupe	Correspond à une valeur qui est membre du groupe dans la clause. Par exemple, vous pouvez utiliser ce champ pour rechercher tous les éléments de travail assignés à tout membre d'une liste de distribution.	Chaîne ou nom d'un groupe de catégorie Remarque Vous ne pouvez utiliser l'opérateur Dans le groupe qu'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 la page suivante : Regroupement de types d'éléments de travail en catégories (page éventuellement en anglais).
Pas dans le groupe	Ne correspond pas à une valeur qui est membre du groupe dans la clause.	Chaîne ou nom d'un groupe de catégorie Remarque Vous ne pouvez utiliser l'opérateur Pas dans le groupe qu'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 la page suivante : Regroupement de types d'éléments de travail en catégories (page éventuellement en anglais).
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

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 des éléments de travail ouverts si vous affectez à la colonne Champ la valeur Ouvert 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.
[N'importe lequel]	Utilisez cette variable pour rechercher des éléments de travail en rapport avec n'importe quelle valeur définie pour un champ particulier.