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.
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.
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 ».
Voici un autre exemple qui utilise le Nom du nœud et l’opérateur In.
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.
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.
Articles connexes
- Aide-mémoire sur les requêtes
- Définir les chemins de zone et les assigner à une équipe
- Définir les chemins d’itération (sprint) et configurer les itérations d’équipe
- Définir des autorisations et un accès pour le suivi du travail
API REST
Pour interagir par programmation avec des requêtes, consultez l’une de ces ressources d’API REST :