Partager via


Requête par chemin de zone ou d’itération

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Le chemin de zone et le chemin d’itération sont deux champs qui s’affichent dans le formulaire de suivi du travail pour tous les types d’élément de travail. Vous les définissez pour un projet (chemins de zone et chemins d’itération), puis sélectionnez ceux que vous souhaitez associer à une équipe.

Pour mieux comprendre comment utiliser les chemins de zone et d’itération, consultez À propos des équipes et des outils Agile.

Notes

Les macros suivantes sont uniquement prises en charge à partir du portail web : @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity et @TeamAreas. Les requêtes qui contiennent ces macros ne fonctionnent pas lorsqu’elles sont ouvertes dans Visual Studio/Team Explorer, Microsoft Excel ou Microsoft Project.

Opérateurs et macros pris en charge

Lorsque vous créez des requêtes et spécifiez les champs Chemin de zone et Chemin d’itération, vous pouvez utiliser les opérateurs suivants :

Opérateur À utiliser pour...
= Spécifier un chemin de zone ou d’itération spécifique
<> Filtrez un chemin de zone ou d’itération spécifique.
In Filtrez un ensemble de chemins de zone ou d’itération.
Not In Excluez les éléments affectés à un ensemble de chemins de zone ou d’itération.
Under Spécifiez tous les chemins sous un chemin de zone ou d’itération spécifique.
Not Under Excluez les éléments affectés sous un chemin de zone ou d’itération spécifique.

Avec ces opérateurs, vous pouvez utiliser les macros suivantes lorsque vous sélectionnez le chemin d’itération. Pour obtenir des exemples, consultez Requête par date ou itération actuelle.

Macro À utiliser pour...
@CurrentIteration Spécifiez l’itération actuelle associée au contexte d’équipe sélectionné.
@CurrentIteration +/- n Filtrez les éléments en fonction de l’affectation à une fenêtre glissante de sprints associés au contexte d’équipe sélectionné.
@TeamAreas Filtrez les éléments en fonction des chemins de zone attribués à une équipe spécifique.

Notes

Les macros @CurrentIteration +/- n et @TeamAreas sont prises en charge pour Azure DevOps Server 2019 et versions ultérieures. Ces macros sont uniquement prises en charge à partir du portail web. Les requêtes qui contiennent ces macros ne fonctionnent pas lorsqu’elles sont ouvertes dans Visual Studio/Team Explorer, Microsoft Excel ou Microsoft Project.

Requêtes de chemin de zone

Vous pouvez choisir de filtrer les éléments de travail affectés à plusieurs chemins de zone à l’aide de l’opérateur In, comme illustré dans l’exemple suivant.

Interroger sur le chemin de zone pour plusieurs zones

Requêtes basées sur le nom du nœud et le mot clé

Utilisez le champ Nom du nœud pour filtrer les éléments de travail affectés aux chemins de zone en fonction d’un mot clé à l’aide de l’opérateur Contains. Le Nom du nœud spécifie le dernier nœud d’un Chemin de zone, qui correspond au dernier nœud de la hiérarchie d’arborescence.

La requête suivante génère le même résultat que l’exemple précédent.

Interroger sur le nom du nœud pour plusieurs zones

Dans cet exemple, le filtre renvoie tous les éléments de travail affectés à un chemin d’accès à la zone dont le dernier nœud contient le mot « Azure ».

Interroger plusieurs sprints

Voici un autre exemple qui utilise le Nom du nœud et l’opérateur In.

Interroger sur le nom du nœud pour plusieurs zones

Requêtes de chemin de zone d’équipe

Utilisez la macro @TeamAreas pour rechercher rapidement les éléments affectés aux chemins de zone attribués à une équipe spécifique. Spécifiez l’opérateur =. L’Éditeur de requête vous invite automatiquement à entrer le nom de l’équipe. Vous pouvez l’ajouter en entrant le nom de l’équipe et en choisissant la valeur de l’équipe qui apparaît dans les critères de filtre de recherche.

Interroger sur les chemins de zone attribués à une équipe

Référence de champ de classification

Nom du champ Description Nom de la référence
Chemin de la zone Groupe des éléments de travail dans des fonctionnalités de produit ou des zones d'équipe. La zone doit être un nœud valide dans la hiérarchie de projet. System.AreaPath
Chemin de l’itération Groupe des éléments de travail par durées ou périodes de sprint nommées. L'itération doit être un nœud valide dans la hiérarchie de projet. System.IterationPath

Pour chaque champ, chemin de données=TreePath, type pouvant être déclaré=Dimension, attribut d’index=True.

Si vous définissez un nom de chemin d’accès qui contient plus de 256 caractères, vous ne pourrez pas le spécifier dans Microsoft Project. Pour éviter ce problème, définissez des noms de chemin d’accès qui ne contiennent pas plus de 10 caractères et qui n’imbriquent pas de nœuds sur plus de 14 niveaux.

Vous ne pouvez pas appliquer la plupart des règles de champ aux champs système, comme les champs System.AreaPath et System.ItérationPath. Pour plus d’informations, consultez Règles et évaluation des règles.

Les champs suivants ne s’affichent pas sur les formulaires d’élément de travail, mais sont suivis pour chaque type d’élément de travail. Ces champs fournissent une valeur numérique pour chaque valeur de classification définie pour un projet. Vous pouvez utiliser ces champs pour filtrer les requêtes et créer des rapports.

Nom du champ Description Nom de la référence Type de données
ID de zone ID unique de la zone à laquelle cet élément de travail est affecté. System.AreaId Integer
ID d'itération ID unique de l’itération à laquelle cet élément de travail est affecté. System.IterationId Integer
Node Name Nom du dernier nœud d’un chemin de zone. Par exemple, si le chemin de zone est Project\A1\B2\C3, le nom du nœud est C3. System.NodeName String

Le type signalable par défaut est none. L’ID de zone et l’ID d’itération sont indexés ; le nom du nœud ne l’est pas. Pour en savoir plus sur les attributs de champ, consultez Champs et attributs d’élément de travail.

API REST

Pour interagir par programmation avec des requêtes, consultez l’une de ces ressources d’API REST :