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

Vous recherchez et créer des listes d'éléments de travail en créant des requêtes d'élément de travail.En définissant un ou plusieurs clauses, vous filtrez de tous les éléments de travail dans un projet d'équipe ou une collection de projets d'équipe de retourner l'ensemble d'éléments de travail qui vous intéressent.Pour chaque clause, vous spécifiez 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 comme @Project, qui représente le projet d'équipe actuel.

Exemple de clause de requête

Pour plus d'informations générales sur les requêtes, consultez Rechercher des bogues, des 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

• Recherche de mot de texte intégral et partiel

• Champs indexés de requête

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

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

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

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

   Pour plus d'informations, consultez Opérateurs.

3. Dans la même ligne, sous l'en-tête de colonne Valeur, l'un ou l'autre type de valeur, ou cliquez sur la flèche bas, puis sélectionnez un élément dans la liste.

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

5. Pour ajouter une clause, choisissez Cliquez ici pour ajouter une nouvelle clause ou Cliquer 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.

Et/ou

Vous spécifiez Et ou Ou pour créer des expressions logiques de les clauses de requête.Spécifiez Et pour rechercher des éléments de travail qui répondent aux critères dans la clause actuelle et la précédente.Spécifiez Ou pour rechercher des éléments de travail qui répondent au critère dans la clause actuelle ou la précédente.

Vous pouvez ajouter une nouvelle clause pour chaque champ d'élément de travail pour affiner vos critères de recherche, afin qu'elle retourne uniquement le jeu d'éléments de travail souhaités.Si vous ne recevez pas les résultats attendus de votre requête, vous pouvez ajouter, supprimer, grouper ou dissocier des clauses de requête pour affiner vos résultats de la requête.

Les clauses de requête peuvent être groupées pour fonctionner comme une unité unique distincte du reste de la requête, à l'instar de la mise entre parenthèses d'une expression dans une équation mathématique ou une instruction logique.Lorsque vous groupez des clauses, l'opérateur AND ou OR de la première clause du groupe s'applique à l'ensemble du groupe.

Comme le montre l'exemple suivant, les clauses regroupées sont traduites en l'expression logique correspondante.La première expression retourne les éléments de travail qui ont la priorité 1, ainsi que tous les bogues actifs de n'importe quelle priorité.La deuxième expression retourne tous les éléments de travail actifs de priorité 1, ainsi que tous les bogues de priorité 1, qu'ils soient actifs ou pas.

Clauses regroupées	Expression logique
	Priority=1 OR (Work Item Type=Bug AND State=Active)
	Priority=1 AND (Work Item Type=Bug OR State=Active)

Pour plus d'informations, consultez Spécifier des critères de filtre de requête.

Champs de requête et valeurs

La valeur que vous spécifiez pour un champ doit être conforme au type de données de ce champ.Le tableau suivant répertorie les types de données pris en charge :

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/2012).
Double	Nombre réel, tel que 0,2 ou 3,5.
GUID	Chaîne de caractères qui représente un ID unique.
History	Champ mis en forme de personnalisé utilisé pour suivre les informations d'historique.Ce type de données est uniquement utilisé pour prendre en charge le champ Historique .Ce champ est automatiquement indexé pour la recherche en texte intégral lorsque la recherche en texte intégral est disponible.Consultez l' Recherche de mot de texte intégral et partiel décrit ultérieurement dans cette rubrique.
HTML	Chaînes de texte qui prennent en charge des descriptions mises en forme, telles que les champs Description ou de Étapes de reproduction .Ces champs sont automatiquement indexés pour la recherche en texte intégral lorsque la recherche en texte intégral est disponible.Consultez l' Recherche de mot de texte intégral et partiel décrit ultérieurement dans cette rubrique. Remarque Lorsque vous mettez à niveau Team Foundation Server, le champ Description est modifié pour un type de champ d' PlainText à HTML.À l'aide de la commande d' witadmin changefield vous pouvez rétablir le type de données de ce champ si nécessaire.Consultez Gérer des champs d'éléments de travail (witadmin).
Integer	Entier 32 bits signé, tel que 0, 1, 2, 34.
PlainText	Chaînes de texte qui prennent en charge des descriptions longues, telles que le champ Informations de démarrage de l'application .Ces champs sont automatiquement indexés pour la recherche en texte intégral, lorsque la recherche en texte intégral est disponible.Consultez l' Recherche de mot de texte intégral et partiel décrit ultérieurement dans cette rubrique.
String	Chaîne de texte courte qui peut contenir jusqu'à 255 caractères Unicode.
TreePath	Arborescence de branchement, par exemple un chemin de zone ou un chemin d'itération.Vous devez choisir 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.Pour plus d'informations, consultez Créer et modifier des zones et des itérations.

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 Référence des champs d'éléments de travail pour Visual Studio ALM.

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, qui inclut Double, GUID, Integer, et String, DateTime, et TreePath
<>	Ne correspond pas à la valeur dans la clause.	Nombre, String, DateTime, et TreePath
>	Est supérieure à la valeur dans la clause.	Nombre, String, et DateTime
<	Est inférieure à la valeur dans la clause.	Nombre, String, et DateTime
>=	Est supérieure ou égale à la valeur dans la clause.	Nombre, String, et DateTime
<=	Est inférieure ou égale à la valeur dans la clause.	Nombre, String, et DateTime
=[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 un particulier ou une correspondance partielle de la chaîne de texte dans le champ que vous avez sélectionné pour le filtrage.	String
Ne contient pas	Ne contient pas un particulier ou une correspondance partielle de la chaîne de texte dans le champ que vous avez sélectionné pour le filtrage.	String
Contient des mots	Contient la chaîne de texte ou des mots exact dans le champ que vous avez sélectionné pour le filtrage.Vous pouvez également taper les mots partiels ou expression qui contiennent le caractère générique, *.Pour les restrictions, consultez l' Recherche en texte intégral pour les besoins du serveur et de classement.	Champs de Long- texte qui sont indexés pour la recherche en texte intégral, qui correspondent à tous les champs d' PlainText et d' HTML et à Titre.
Ne contient pas de mots	Ne contient pas la chaîne de texte ou des mots exact dans le champ que vous avez sélectionné pour le filtrage.	Champs de texte qui sont indexés pour la recherche en texte intégral.
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, String, DateTime, TreePath
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.	String qui correspond au nom d'un groupe de groupe d'utilisateurs ou groupe de catégories dans Team Foundation Server. Remarque Vous pouvez utiliser l'opérateur Dans le groupe uniquement avec des champs qui utilisent le type de données d' String ou le champ Type d'élément de travail . Pour plus d'informations sur les groupes de catégorie, consultez Définir des catégories pour regrouper des types d'éléments de travail.
Pas dans le groupe	Ne correspond pas à une valeur qui est membre du groupe dans la clause.	String qui correspond au nom d'un groupe d'utilisateurs dans Team Foundation Server ou d'un groupe de catégories définies pour un projet d'équipe. Remarque Vous pouvez utiliser l'opérateur Pas dans le groupe uniquement avec des champs qui utilisent le type de données d' String ou le champ Type d'élément de travail . Pour plus d'informations sur les groupes de catégorie, consultez Définir des catégories pour regrouper des types d'éléments de travail.
Toujours	Correspond à la valeur dans la clause à un point précédent quelconque.	String, DateTime
Sous	Correspond à la valeur dans la clause ou est contenue sous le nœud dans la clause.	TreePath
Pas sous	Ne correspond pas à la valeur dans la clause et n'est pas contenue sous le nœud dans la clause.	TreePath

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.

Retour au début

Recherche de mot de texte intégral et partiel

Spécifiez Contient ou Ne contient pas pour trouver sur particulier ou des correspondances partielles d'un mot ou une expression.Spécifiez Contient les mots ou Ne contient pas les mots pour trouver sur une expression spécifique ou pour utiliser le caractère générique, *.Ces opérateurs utilisent l'index de texte intégral.Vous pouvez uniquement utiliser le caractère générique à la fin d'un mot ou une expression partiel.

Pour obtenir des exemples, consultez Rechercher des éléments de travail sur la base de mots clés ou d'expressions et Afficher l'historique et rechercher des éléments de travail à l'aide du champ Historique.

[!REMARQUE]

Tous les déploiements prennent en charge les recherches de texte intégral.Par exemple, SQL express et SQL Azure, qui prennent en charge le service Team Foundation, ne prennent pas en charge la recherche en texte intégral.Dans ces instances, vous verrez que les opérateurs Contient et de Ne contient pas .

Contient les mots et Ne contient pas les mots filtrer des éléments selon l'index de texte intégral créé pour les champs de long- texte.clésTeam Foundation automatiquement tous les champs de long- texte avec un type de données d' PlainText et d' HTML et le champ Titre pour la recherche en texte intégral.L'index les opérateurs et sont disponibles uniquement lorsque SQL Server qui prend en charge la recherche en texte intégral de prend en charge Team Foundation Server .

Les recherches de texte intégral requièrent un classement SQL qui correspond à un langage qui a un analyseur lexical enregistré avec SQL Server.Si les paramètres de classement pour la base de données de collection de projets d'équipe utilisé pour votre instance d' Team Foundation Server ne correspondent pas à un langage pris en charge, les résultats de la recherche peuvent ne pas correspondre à vos attentes.Dans ces cas, vous pouvez essayer à l'aide de les opérateurs Contient ou de Ne contient pas .

Pour plus d'informations, consultez l' Requêtes de recherche en texte intégral et paramètres de classement.

Champs indexés de requête

Dans l'ajout de l'index de texte intégral, un index de requête est créé.Il est basé sur ces champs qui ont l'indexation activée.L'index de requête améliore le temps de réponse où vous exécutez les requêtes qui incluent des champs indexés.

Par défaut, les champs suivants sont indexés : Assigné à, Date de création, Modifié par, État, Raison, ID de zone, ID d'itération, et Type d'élément de travail.S'il existe d'autres champs que votre équipe utilise fréquemment dans leurs requêtes, vous pouvez les ajouter à l'index de requête.

Vous utilisez la commande pour witadmin indexfield d'activer ou de désactiver l'indexation pour un champ.Consultez Gérer des champs d'éléments de travail (witadmin).

Voir aussi

Tâches

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

Utiliser une requête de liste plate (par défaut)

Utilisation des hiérarchies liées (Arborescence des éléments de travail)

Concepts

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

Autres ressources

Utilisation des dépendances liées (Liens directs)

Historique des modifications