Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Les champs Chemin de zone et Chemin d’itération apparaissent sur tous les formulaires des éléments de travail pour tous les types d’éléments de travail. Vous définissez ces chemins pour votre projet ( chemins d’accès de zone et chemins d’itération), puis sélectionnez ceux que vous souhaitez associer à une équipe.
Pour comprendre comment utiliser des chemins d’itération et de zone, consultez À propos des équipes et des outils Agile.
Prerequisites
| Category | Requirements |
|---|---|
| Niveaux d’accès | - Pour afficher et exécuter des requêtes partagées : membre du projet. - Pour ajouter et enregistrer une requête partagée : au moins un accès de base (Basic). |
| Permissions | Autorisation Contribuer définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Par défaut, le groupe des contributeurs ne dispose pas de cette autorisation. |
Note
Les utilisateurs disposant d’un accès Partie prenante pour un projet public ont un accès complet aux fonctionnalités de requête, tout comme les utilisateurs disposant d’un accès De base. Pour plus d'informations, consultez guide rapide d'accès pour les parties prenantes.
| Category | Requirements |
|---|---|
| Niveaux d’accès | - Pour afficher et exécuter des requêtes partagées : membre du projet. - Pour ajouter et enregistrer une requête partagée : au moins accès de base. |
| Permissions | Autorisation Contribuer définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Par défaut, le groupe des contributeurs ne dispose pas de cette autorisation. |
Note
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 des champs Chemin d’accès à la zone et chemin d’itération, vous pouvez utiliser les opérateurs suivants :
| Operator | À utiliser pour... |
|---|---|
= |
Spécifier un chemin de zone ou d’itération spécifique |
<> |
Filtrer un chemin d’itération ou une zone spécifique |
In |
Filtre pour un ensemble de chemins d’itération ou de zone |
Not In |
Exclure les éléments affectés à un ensemble de chemins d’itération ou de zone |
Under |
Indiquer tous les chemins d'accès dans une zone ou un chemin d'itération sélectionné |
Not Under |
Exclure les éléments assignés dans un chemin d’itération spécifique ou d'une zone spécifique |
Vous pouvez utiliser les macros suivantes lorsque vous sélectionnez le champ Chemin d’itération. Pour obtenir des exemples, consultez les exemples de requête de cette page.
| Macro | À utiliser pour... |
|---|---|
@CurrentIteration |
Spécifier l’itération actuelle associée au contexte d’équipe sélectionné |
@CurrentIteration +/- n |
Filtrer les éléments en fonction de l’affectation à une fenêtre glissante de sprints associés au contexte d’équipe sélectionné |
@TeamAreas |
Filtrer les éléments en fonction du ou des chemins d’accès de zone attribués à une équipe spécifique |
Note
Le portail web Azure DevOps évalue les macros telles que @CurrentIteration, @CurrentIteration +/- net @TeamAreas (Services et serveur). Les clients non-web (Visual Studio/Team Explorer, Excel, Project) et les appels WIQL/REST directs nécessitent des chemins d'accès explicites des zones et des itérations et n’acceptent pas de tokens directs de macro. Lorsque vous enregistrez une requête dans l’interface utilisateur web, le portail étend généralement les macros aux valeurs concrètes dans le WIQL stocké. Vérifiez ce comportement dans votre environnement si vous devez utiliser des requêtes en dehors de l’interface utilisateur web.
Requêtes de chemin de zone
Vous pouvez filtrer les éléments de travail affectés à plusieurs chemins d’accès 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 d’accès de zone en fonction d’un mot clé à l’aide de l’opérateur Contains . Le nom de nœud spécifie le dernier nœud d’un chemin d’accès de zone , qui correspond au dernier nœud dans la hiérarchie arborescente.
La requête suivante produit le même résultat que l’exemple précédent.
Dans cet exemple, le filtre retourne des éléments de travail affectés à un chemin d’accès de zone dont le dernier nœud contient le mot « Azure ».
Voici un autre exemple qui utilise le nom de nœud et l’opérateur dans.
Requêtes de chemin de zone d’équipe
Utilisez la macro @TeamAreas pour rechercher les éléments affectés aux chemins d’accès de zone qu’une équipe spécifique utilise. Spécifiez l’opérateur =. L’Éditeur de requête vous invite à entrer le nom de l’équipe ; sélectionnez l’équipe dans la liste suggérée.
Référence de champ de classification
| Nom de champ | Description | Nom de référence |
|---|---|---|
| Chemin d’accès à 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 d’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 supérieur à 256 caractères, vous ne pouvez 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 n’apparaissent pas sur les formulaires d’élément de travail, mais Azure DevOps les suit pour chaque type d’élément de travail. Ces champs fournissent une valeur numérique pour chaque valeur de classification que vous définissez pour un projet. Vous pouvez utiliser ces champs pour filtrer les requêtes et créer des rapports.
| Nom de champ | Description | Nom de référence | Type de données |
|---|---|---|---|
| ID de zone | ID unique de la zone où vous affectez cet élément de travail. | System.AreaId | Integer |
| ID d’itération | ID unique de l’itération où vous affectez cet élément de travail. | System.IterationId | Integer |
| Nom du nœud | 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 reportable par défaut est aucun. L’ID de zone et l’ID d’itération ont des index. Le nom du nœud ne fonctionne pas. Pour en savoir plus sur les attributs de champ, consultez Champs et attributs d’élément de travail.
Contenu connexe
- Référence rapide des requêtes
- Définir les chemins de zone et les assigner à une équipe
- Définir les chemins de l’itération (sprint) et configurer les itérations d’équipe
- Définir des autorisations et un accès pour le suivi du travail
REST API
Pour interagir par programmation avec des requêtes, consultez l’une de ces ressources d’API REST :