Création de requêtes d'élément de travail

Mise à jour : novembre 2007

Utilisez des requêtes pour rechercher des éléments de travail en fonction des informations fournies dans les formulaires d'élément de travail. Une requête simple peut permettre de rechercher des éléments de travail qui contiennent une valeur spécifique dans une partie du formulaire, par exemple, tous les éléments de travail qui vous sont assignés. Des requêtes plus complexes peuvent permettre de rechercher plusieurs valeurs dans le formulaire. Vous créez des requêtes à l'aide de clauses pour affiner les résultats de vos requêtes.

Dans le suivi des éléments de travail Team Foundation, une requête spécifique aux éléments de travail est appelée requête d'élément de travail et est identifiée par l'extension de nom de fichier .wiq.

Opérateurs de requête

Un opérateur de requête est utilisé dans une clause de requête pour créer une requête d'élément de travail. Chaque clause de requête est composée d'un nom de champ, d'un opérateur de requête et d'une valeur. L'opérateur de requête détermine l'opération à appliquer pour vérifier si un élément de travail doit être inclus dans les résultats.

Le tableau suivant répertorie les opérateurs de requête disponibles dans le suivi des éléments de travail de Team Foundation.

Opérateur de requête	Description	Types de champ applicables
=	Retourne un élément de travail si le champ correspond à la valeur spécifiée.	Nombre, texte, date, arborescence
<>	Retourne un élément de travail si le champ ne correspond pas à la valeur spécifiée.	Nombre, texte, date, arborescence
>	Retourne un élément de travail si le champ est supérieur à la valeur spécifiée.	Nombre, texte, date
<	Retourne un élément de travail si le champ est inférieur à la valeur spécifiée.	Nombre, texte, date
>=	Retourne un élément de travail si le champ est supérieur ou égal à la valeur spécifiée.	Nombre, texte, date
<=	Retourne un élément de travail si le champ est inférieur ou égal à la valeur spécifiée.	Nombre, texte, date
Contient	Retourne un élément de travail si le champ contient la valeur de texte spécifiée.	Texte
Ne contient pas	Retourne un élément de travail si le champ ne contient pas la valeur de texte spécifiée.	Texte
Dans	Retourne un élément de travail si le champ correspond à une valeur dans un ensemble spécifié. Par exemple, la comparaison du champ d'ID à l'ensemble de valeurs 100, 101, 102 retourne les éléments de travail 100, 101 et 102.	Nombre, texte, date, arborescence
Toujours	Recherche l'historique du champ. Retourne l'élément de travail si l'une des valeurs du champ d'historique correspond à la valeur spécifiée.	Texte, date
Sous	Recherche un champ d'arborescence et retourne les éléments de travail contenus sous le nœud spécifié par la valeur.	Arborescence
Pas sous	Recherche un champ d'arborescence et retourne les éléments de travail qui ne sont pas contenus sous le nœud spécifié par la valeur.	Arborescence

Variables de requête

Les variables de requête vous permettent de générer la valeur d'une requête, et donc de créer des requêtes dynamiques qui recherchent la date, l'utilisateur ou le projet actuel.

Le tableau suivant répertorie les variables de requête disponibles dans le suivi des éléments de travail Team Foundation.

Variable de requête	Résultat
@Me	Utilisez la valeur @Me dans la colonne Valeur pour rechercher automatiquement l'alias de l'utilisateur actuel dans un champ contenant des alias d'utilisateurs. Par exemple, pour renvoyer la liste des éléments de travail que vous avez ouverts, affectez à la colonne Champ la valeur Activé par, à la colonne Opérateur la valeur = et à la colonne Valeur la valeur @Me.
@Project	Utilisez la valeur @Project dans la colonne Valeur pour tout champ qui référence les projets d'équipes dans lesquels effectuer la recherche dans le projet d'équipe actuel. Par exemple, pour renvoyer la liste de tous les éléments de travail actifs pour le projet actuellement sélectionné, affectez à la colonne Champ la valeur Projet d'équipe, à la colonne Opérateur la valeur = et à la colonne Valeur la valeur @Project.
@Today	Utilisez la valeur @Today dans la colonne Valeur pour tout champ date dans lequel rechercher la date actuelle. La requête entre la date actuelle chaque fois qu'elle est exécutée. Vous pouvez également modifier la variable @Today en retirant des jours. Par exemple, pour rechercher tous les éléments activés la semaine dernière, affectez à la colonne Champ la valeur Date d'activation, à la colonne Opérateur la valeur >=, et à la colonne Valeur la valeur @Today - 7.

Dans cette section

• Comment : ajouter de nouvelles requêtes d'élément de travail
  Explique comment créer de nouvelles requêtes d'élément de travail.

• Comment : ajouter ou supprimer des clauses de requêtes d'élément de travail
  Décrit comment ajouter ou supprimer des clauses dans une requête d'élément de travail.

• Comment : regrouper ou dissocier des clauses de requêtes d'élément de travail
  Décrit comment grouper ou dissocier les clauses dans une requête d'élément de travail.

• Comment : enregistrer des requêtes d'élément de travail
  Décrit comment enregistrer des requêtes d'élément de travail dans Team Foundation Server ou dans un fichier.

• Comment : renommer des requêtes d'élément de travail
  Décrit comment renommer des requêtes d'élément de travail.

• Comment : annuler une requête d'élément de travail
  Décrit comment arrêter une requête d'élément de travail dont l'exécution prend du temps.

• Comment : envoyer des requêtes d'élément de travail par courrier électronique
  Décrit comment créer un fichier de requête que vous pouvez envoyer par message électronique.

• Comment : envoyer les résultats d'une requête par courrier électronique
  Décrit comment envoyer une sélection d'éléments de travail, ou tous les résultats d'une requête au format tabulaire dans un message électronique.

• Comment : ouvrir des requêtes d'élément de travail à partir d'un message électronique
  Décrit comment ouvrir et enregistrer des requêtes que vous recevez par message électronique.

• Comment : rechercher des dates dans les éléments de travail
  Décrit comment créer une requête qui recherche des dates spécifiques dans un élément de travail.

• Comment : interroger plusieurs projets d'équipe
  Décrit comment créer une requête qui recherche dans plusieurs projets d'équipe.

• Comment : supprimer des requêtes d'élément de travail
  Décrit comment supprimer des requêtes d'élément de travail.

Voir aussi

Autres ressources

Ajout et modification d'éléments de travail