Définir les chemins de zone et les assigner à une équipe

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

Ajouter des chemins de zone pour organiser les équipes et les éléments de travail de groupe par produit, fonctionnalité ou domaines d'activité. L’attribution de chemins de zone aux équipes assure que les éléments de travail sous ces chemins apparaissent dans les backlogs et les tableaux des équipes respectives. Par défaut, tous les éléments de travail sont assignés au chemin de zone racine et apparaissent dans l’équipe par défaut du projet.

Après avoir défini des chemins de zone au niveau du projet, affectez-les aux équipes au sein de la configuration de l’équipe. Vous pouvez également créer une structure hiérarchique de chemins de zone pour prendre en charge les sous-zones, avec jusqu’à 14 niveaux de profondeur.

Pour effectuer les tâches suivantes, vous devez définir des chemins de zone :

Conseil

Vous pouvez définir votre structure de chemin de zone et affecter des chemins de zone aux équipes. Vous pouvez également ajouter une équipe et créer le chemin de zone avec le nom de l’équipe en même temps. Si les équipes sont totalement indépendantes, créez un ensemble plat de chemins de zone. Pour créer une hiérarchie d’équipes, créez une arborescence de chemins d’accès de zone. Pour plus d'informations, consultez Configurer une hiérarchie d'équipes.

Pour utiliser les outils suivants, les équipes doivent s’abonner à des chemins de zone :

Pour comprendre comment le système utilise les chemins de zone, consultez À propos des chemins de zone et d’itération.

Prerequisites

Catégorie	Exigences
Autorisations	- Pour définir la zone d'équipe ou les chemins d'itération : Administrateur d'équipe ou membre du groupe Administrateurs de projet. Par défaut, ces autorisations sont attribuées à l’utilisateur qui a créé le projet. - Pour ajouter un chemin de zone sous le nœud racine ou modifier ou supprimer un nœud enfant : Membre du groupe Administrateurs de projet. - Pour ajouter, modifier et gérer les chemins de zone sous un nœud : Une ou plusieurs des permissions suivantes définies sur Autoriser : - Créer des nœuds enfants - Supprimer ce nœud - Modifier ce nœud - Afficher les autorisations dans ce nœud

Catégorie

Exigences

Autorisations

- Pour définir la zone d'équipe ou les chemins d'itération : Administrateur d'équipe ou membre du groupe Administrateurs de projet. Par défaut, ces autorisations sont attribuées à l’utilisateur qui a créé le projet.
- Pour ajouter un chemin de zone sous le nœud racine ou modifier ou supprimer un nœud enfant : Membre du groupe Administrateurs de projet.
- Pour ajouter, modifier et gérer les chemins de zone sous un nœud : Une ou plusieurs des permissions suivantes définies sur Autoriser :
- Créer des nœuds enfants
- Supprimer ce nœud
- Modifier ce nœud
- Afficher les autorisations dans ce nœud

Pour plus d'informations, consultez Définir les autorisations et l'accès pour le suivi du travail.

Pour connaître les restrictions de dénomination des chemins de zones, consultez À propos des zones et des itérations : restrictions de dénomination.

Bien démarrer

Chaque équipe a accès à différents outils Agile, comme décrit dans À propos des équipes et des outils Agiles. Ces outils référencent les chemins de zone par défaut de l’équipe. La plupart des équipes utilisent un seul chemin de zone et plusieurs chemins d’itération pour le suivi du travail, mais elles peuvent également utiliser plusieurs chemins de zone dans leurs backlogs et tableaux pour soutenir différents scénarios.

Les nouveaux projets incluent une zone racine unique correspondant au nom du projet et une équipe par défaut portant le même nom que celui attribué à ce chemin de zone racine.

Si vous débutez dans la gestion des projets et des équipes, procédez comme suit pour configurer votre projet et vos équipes :

Définissez les chemins de zone : déterminez le nombre et les noms des chemins de zone dont vous avez besoin pour catégoriser votre travail. Ajoutez au moins un chemin de zone par équipe. Pour plus d'informations, consultez À propos des zones et itérations.
Définissez des équipes : déterminez le nombre et les noms des équipes requises. Pour plus d’informations, consultez À propos des équipes et des outils Agile.
Configurez les chemins de zone : accédez à Paramètres de projet>Configuration de projet>Zones et définissez les chemins de zone pour votre projet. Suivez les étapes décrites dans Ajouter des chemins de zone.
Créez des équipes : créez les équipes nécessaires en fonction de l’étape 2. Pour plus d’informations, consultez Ajouter une équipe, passer d’une équipe par défaut à plusieurs équipes.
Affectez des chemins de zone aux équipes : dans la configuration de l’équipe, affectez les chemins par défaut et autres chemins de zones à chaque équipe. Suivez les étapes décrites dans Définir les chemins de zone par défaut de l’équipe.
Affectez des chemins de zone aux éléments de travail : affectez des éléments de travail aux chemins de zone définis à l’aide de la modification en bloc pour mettre à jour plusieurs éléments à la fois.

Note

L’affectation du même chemin d’accès de zone à plusieurs équipes peut entraîner des conflits sur la propriété des éléments de travail et entraîner un comportement inattendu sur les tableaux d’équipe. Pour plus d’informations, consultez Limitations des affichages de tableau multi-équipes.

Si nécessaire, vous pouvez effectuer les actions suivantes à tout moment :

Ajouter d’autres nœuds enfants
Renommer un chemin de zone (sauf le chemin de zone racine)
Déplacer un nœud enfant sous un autre nœud
Supprimer un nœud enfant
Renommer une équipe
Modifier les affectations de chemin de zone effectuées pour une équipe

Répertorier les zones de projet

Pour répertorier les zones de projet, procédez comme suit :

Navigateur
Interface CLI Azure DevOps

Depuis votre portail web, sélectionnez (1) Paramètres du projet> (2) Configuration du projet> (3) Zones.

Capture d’écran montrant les sélections, Paramètres du projet, Configuration du projet.

Vous pouvez répertorier les chemins d’accès de zone définis pour un projet à l’aide de la commande az boards area project list . Pour bien démarrer avec l’interface CLI, consultez Prise en main d’Azure DevOps CLI.

az boards area project list [--depth]
                            [--path]
                            [--project]

Parameters

depth : facultatif. Profondeur des nœuds enfants à répertorier. Exemple : --depth 3. Lorsqu’aucune spécification n’est donnée, seuls les chemins de zone de niveau supérieur sont retournés.
path : facultatif. Chemin absolu d’une zone. \Area\ doit suivre après \ProjectName, ce qui distingue ce chemin d'un chemin d’itération. Par exemple : --path \ProjectName\Area\AreaName. Si des espaces sont utilisés dans un nœud, placez-les entre guillemets doubles, par exemple --path "\Fabrikam Fiber\Area\Service Delivery\Performance". Si elle n'est pas spécifiée, la liste des chemins d'accès aux zones est établie à partir du niveau racine.
project : facultatif. Nom ou ID du projet. Exemple : --project "Fabrikam Fiber".

Exemple

Par exemple, la commande suivante répertorie les chemins d'accès à une profondeur de 3 pour le projet Fabrikam Fiber. Pour d'autres options de format de sortie, consultez Formats de sortie pour les commandes Azure CLI.

az boards area project list --depth 3 --project 'Fabrikam Fiber' --output table
ID     Identifier                            Name                Path                                                Has Children
-----  ------------------------------------  ------------------  --------------------------------------------------  --------------
55302  91d8644a-e430-4fd0-aa95-742ea98770a3  Fabrikam Fiber      \Fabrikam Fiber\Area                                True
55373  26be05fd-e68a-4fcb-833f-497f6bee45f2  Service Delivery    \Fabrikam Fiber\Area\Service Delivery               True
55303  637dc203-0549-4415-9663-b6358ac27d21  Internet            \Fabrikam Fiber\Area\Service Delivery\Internet      False
55306  3f2067f9-684f-4121-8004-4a4745198b39  Voice               \Fabrikam Fiber\Area\Service Delivery\Voice         False
55372  4afc9ede-db1d-4703-8be6-95899b99be44  Email               \Fabrikam Fiber\Area\Service Delivery\Email         False
55381  f96d4738-c67e-42d0-bd4e-99f6b3fdeb22  Service Status      \Fabrikam Fiber\Area\Service Delivery\Service S...  False
55384  3a0c1189-6454-4ccd-9354-d72b653b7f74  TV                  \Fabrikam Fiber\Area\Service Delivery\TV            False
55380  4ea27e90-248c-41a0-8d11-eace6c9fd90e  Account Management  \Fabrikam Fiber\Area\Account Management             True
55382  4235f40d-753b-49dd-868f-82372065ec83  Shopping Cart       \Fabrikam Fiber\Area\Account Management\Shoppin...  False
55383  49d34650-6c65-446c-aff6-79edd3a21a75  Customer Profile    \Fabrikam Fiber\Area\Account Management\Custome...  False

Les commandes Azure DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.

Ajouter un chemin de zone

Une seule zone racine est définie par défaut. Ajoutez des chemins de zone nouveau et enfant sous le chemin de zone racine du projet, ou en tant qu’enfant à un autre chemin de zone ou à une autre équipe. Les nouveaux chemins de zone sont ajoutés au nœud racine par défaut.

Capture d’écran montrant Zones, valeurs par défaut définies pour le projet.

Vous pouvez également ajouter de nouveaux chemins de zone enfant à une équipe. Pour plus d’informations, consultez Définir les chemins de zone d’équipe.

Navigateur
Interface CLI Azure DevOps

Pour ajouter un nouveau chemin de zone, procédez comme suit :

Mettez en surbrillance le chemin de zone, puis choisissez Nouvel enfant. Vous pouvez également sélectionner un chemin d’accès à une zone et choisir Nouveau, ou sélectionner l’élément de menu Nouveau en haut de la liste des zones.
Saisissez un nom (255 caractères maximum) pour le nœud. Pour en savoir plus sur les restrictions sur le nom, consultez À propos des zones et des itérations, Restrictions concernant l’attribution de noms.
Sélectionnez Enregistrer et fermer

Toutes les nouvelles zones sont ajoutées en tant que nœud enfant au chemin de zone racine.

Pour ajouter un chemin de zone enfant, procédez comme suit :

Mettez en surbrillance le chemin de zone, puis choisissez Nouvel enfant. Vous pouvez également sélectionner le chemin d’accès à la zone et choisir Nouvel enfant ou sélectionner Nouvel enfant dans le menu en haut de la liste des zones.
Saisissez un nom (255 caractères maximum) pour le nœud. Pour en savoir plus sur les restrictions sur le nom, consultez À propos des zones et des itérations, Restrictions concernant l’attribution de noms.
Sélectionnez Enregistrer et fermer

Vous pouvez également ajouter des chemins de zone à une équipe sur la page Configuration d'équipe>Zones.

Vous pouvez ajouter des chemins de zone à un projet à l’aide de la commande az boards area project create. Pour commencer, consultez Bien démarrer avec l’interface CLI Azure DevOps.

Si vous spécifiez le paramètre --path, le nouveau chemin de zone est ajouté en tant que nœud enfant au chemin spécifié. Si vous ne spécifiez pas le paramètre --path, le nouveau chemin d'accès à la zone est ajouté en tant que nœud enfant au nœud racine.

az boards area project create --name
                              [--path]
                              [--project]

Parameters

name : obligatoire. Nom du chemin de zone.
path : facultatif. Chemin absolu d’une zone. Exemple : --path \NomProjet\Area\NomZone. Lorsqu’il n’est pas spécifié, il ajoute une zone au niveau racine.
project : facultatif. Nom ou ID du projet. Exemple : --project "Fabrikam Fiber".

Exemple : format JSON

Par exemple, la commande suivante ajoute le chemin de la zone Voice au projet Fabrikam Fiber au niveau du nœud racine.

az boards area project create --name Voice --project "Fabrikam Fiber"
{
  "attributes": null,
  "children": null,
  "hasChildren": false,
  "id": 55412,
  "identifier": "b00f86a2-3d49-4ad2-af01-da2537947baa",
  "name": "Voice",
  "path": "\\Fabrikam Fiber\\Area\\Voice",
  "structureType": "area",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Areas/Voice"
}

Exemple : format de tableau

Et voici la même commande avec un tableau comme format de sortie.

az boards area project create --name Voice --project "Fabrikam Fiber" --output table
ID     Identifier                            Name    Path                         Has Children
-----  ------------------------------------  ------  ---------------------------  --------------
55413  3c16691b-160c-4498-ab42-aa77b7f354fc  Voice  \Fabrikam Fiber\Area\Voice  False

Les commandes Azure DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.

Répertorier les chemins de zone d’équipe

Vous définissez les valeurs par défaut de l’équipe à partir des paramètres d’équipe. Si vous n’êtes pas administrateur d’équipe, demandez à être ajouté. Seuls les administrateurs d’équipe ou de projet peuvent modifier les paramètres d’équipe.

Navigateur
Interface CLI Azure DevOps

Ouvrez votre projet, puis sélectionnez Paramètres de projet>Configuration d'équipe>Zones.
Si vous devez changer le contexte de l’équipe, utilisez le sélecteur d’équipe dans la barre de navigation.

Vous pouvez répertorier les chemins de zone définis pour une équipe à l’aide de la commande az boards area team list. Pour commencer, consultez Bien démarrer avec l’interface CLI Azure DevOps.

az boards area team list --team
                         [--project]

Parameters

team : obligatoire. Nom ou ID de l'équipe.
project : facultatif. Nom ou ID du projet. Exemple : --project "Fabrikam Fiber".

Par exemple, la commande suivante répertorie les chemins de zone pour l’équipe Service delivery. Pour d'autres options de format de sortie, consultez Formats de sortie pour les commandes Azure CLI

az boards area team list --team "Service Delivery" --project "Fabrikam Fiber" --output table
Area                             Include sub areas    Is Default
-------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery  True                 True

Les commandes Azure DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.

Ouvrez les paramètres d’équipe depuis le profil d’équipe

Vous définissez à la fois des zones et des itérations à partir de Paramètres de projet > Configuration d'équipe. Vous pouvez y accéder rapidement à partir d’un backlog, d’un tableau ou d’un tableau de bord de suivi du travail d’équipe.

Ouvrez un backlog ou un tableau pour une équipe et choisissez Profil de l'équipe>Paramètres d'équipe.

Ici, nous allons ouvrir le tableau de l’équipe Fabrikam Fiber et à partir de là le profil de l’équipe.
Sélectionnez Itérations et zones.
Si vous devez changer le contexte de l’équipe, utilisez le sélecteur d’équipe dans la barre de navigation.

Définir les chemins de zone d’équipe

Tous les éléments de travail attribués à un chemin de zone d’équipe apparaissent dans les backlogs et les tableaux de cette équipe. Vous pouvez sélectionner un ou plusieurs chemins de zone et éventuellement inclure les chemins de sous-zone. Choisissez d’inclure les chemins de sous-zone lorsque vous souhaitez prendre en charge les vues récapitulatives du travail effectué pour plusieurs équipes ou zones.

Note

Les équipes peuvent être affectées à un maximum de 300 chemins d’accès à la zone pour une organisation de travail et des performances efficaces. Pour plus d’informations sur les limites, consultez Suivi du travail, processus et limites de projet.

Le chemin de zone par défaut détermine le chemin de zone par défaut affecté aux éléments de travail créés à partir du contexte d’équipe.

Importante

Les éléments de travail qui apparaissent sur le tableau de plusieurs équipes peuvent produire des résultats de requête inattendus. Étant donné que chaque équipe peut personnaliser les colonnes du tableau et les voies, les valeurs des éléments de travail peuvent varier entre les différents tableaux d’équipe. Pour éviter ce problème, conservez la propriété unique des éléments de travail en les affectant à des chemins d’accès de zone d’équipe spécifiques.

Navigateur
Interface CLI Azure DevOps

Vous pouvez sélectionner des chemins de zone existants ou créer des chemins de zone nouveaux ou enfants à partir des paramètres de l’équipe.

Sélectionnez Paramètres de projet>Configuration d’équipe>Zones.
Sélectionnez l’équipe que vous souhaitez configurer dans la liste déroulante en haut de la page.

Ici nous montrons les zones pour l’équipe Fabrikam Fiber.
Choisissez un ou plusieurs chemins de zone à activer pour l’équipe.

Dans cette instance, nous choisissons d’activer les chemins de sous-zone du projet. L’équipe de gestion peut maintenant suivre la progression pour toutes les équipes.
Lorsque vous avez terminé, actualisez la page du backlog de produit pour l’équipe et vous voyez ces éléments de travail affectés à l’équipe. Ajoutez le chemin de zone aux colonnes affichées pour voir les affectations apportées aux éléments de travail.

Vous pouvez définir le chemin de zone par défaut d’une équipe ou ajouter un chemin de zone à l’aide de la commande az boards area team add. Pour commencer, consultez Bien démarrer avec l’interface CLI Azure DevOps.

az boards area team add --path  --team
                        [--include-sub-areas {false, true}]
                        [--project]
                        [--set-as-default]

Parameters

path : obligatoire. Chemin absolu d’une zone. Exemple : --path \ProjectName\AreaName.
team : obligatoire. Nom ou ID de l'équipe.
include-sub-areas : facultatif. Incluez les nœuds enfants du chemin de zone. Valeurs acceptées : false, true.
project : facultatif. Nom ou ID du projet. Exemple : --project "Fabrikam Fiber".
set-as-default : facultatif. Spécifiez comme chemin de zone par défaut pour l’équipe. Valeur par défaut : False.

Exemple

Par exemple, la commande suivante ajoute le chemin de la zone Voice à l’équipe Voice du projet Fabrikam Fiber, la définit comme étant la valeur par défaut et indique d'inclure les sous-zones.

az boards area team add --path "\Fabrikam Fiber\Voice" --team Voice --project "Fabrikam Fiber" --include-sub-areas --set-as-default --include-sub-areas true --output table
Area                                   Include sub areas    Is Default
-------------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery\Voice  False                False
Fabrikam Fiber\Voice                   True                 True

Les commandes Azure DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.

Renommer ou déplacer un chemin de zone

Le système met automatiquement à jour les éléments de travail et les requêtes qui référencent votre chemin de zone mis à jour. Chaque chemin de zone est associé à un GUID unique.

Navigateur
Interface CLI Azure DevOps

Pour renommer un chemin de zone, ouvrez la page Paramètres de projet>Configuration de projet>Zone du portail web.
Choisissez le menu contextuel pour le nœud, puis sélectionnez Modifier.
Dans la boîte de dialogue qui s’ouvre, entrez le nouveau nom.
Pour déplacer le nœud dans la hiérarchie, modifiez le champ Emplacement.

Note

Lorsque vous renommez ou modifiez le champ Emplacement d’un nœud, le système met automatiquement à jour les éléments de travail existants qui référencent le Chemin de zone.

Renommer ou déplacer un chemin de zone depuis un projet

Vous pouvez renommer ou déplacer le chemin de zone d'un projet à l'aide de la commande az boards area project update. Pour commencer, consultez Bien démarrer avec l’interface CLI Azure DevOps.

az boards area project update --path
                              [--child-id]
                              [--name]
                              [--project]

path : obligatoire. Chemin absolu d’une zone. Exemple : --path \ProjectName\AreaName.
child-id : facultatif. Déplace un chemin de zone existant et l’ajoute en tant que nœud enfant pour le nom ou l’ID de chemin spécifié.
name : facultatif. Spécifie le nouveau nom du chemin de zone.
project : facultatif. Nom ou ID du projet. Exemple : --project "Fabrikam Fiber".

Exemple

Par exemple, la commande suivante renomme le chemin de la zone Voice en Voice and Web pour le projet Fabrikam Fiber.

az boards area project update --path "\Fabrikam Fiber\Area\Voice" --name "Voice and Web" --project "Fabrikam Fiber" --output table
ID     Identifier                            Name           Path                                Has Children
-----  ------------------------------------  -------------  ----------------------------------  --------------
55412  b00f86a2-3d49-4ad2-af01-da2537947baa  Voice and Web  \Fabrikam Fiber\Area\Voice and Web  False

Supprimer un chemin de zone d’une équipe

Pour supprimer un chemin de zone d’une équipe, utilisez az boards area team remove.

az boards area team remove --path
                           --team
                           [--project]

Parameters

path : obligatoire. Chemin absolu d’une zone. Exemple : --path \ProjectName\AreaName.
team : obligatoire. Nom ou ID de l'équipe.
project : facultatif. Nom ou ID du projet. Exemple : --project "Fabrikam Fiber".

Exemple

Par exemple, la commande suivante supprime le chemin de zone \Service Delivery\Voice de l’équipe Voice du projet Fabrikam Fiber.

az boards area team remove --path "\Fabrikam Fiber\Service Delivery\Voice" --team Voice --project "Fabrikam Fiber" --output table

Les commandes Azure DevOps CLI ne sont pas prises en charge pour Azure DevOps Server.

Supprimer un chemin de zone

Lorsque vous supprimez un chemin de zone, vous devez fournir un chemin de zone à utiliser pour mettre à jour les éléments de travail affectés au chemin de zone que vous souhaitez supprimer.

Importante

La suppression de valeurs de chemin d’accès de zone ou la reconfiguration des valeurs de chemin d’itération entraîne une perte de données irréversible dans les graphiques suivants :

Graphiques de burndown et burn up pour widget
Graphiques des sprints burndown
Graphiques de vélocité pour les équipes avec des chemins de zone modifiés
Graphiques de tendance historique qui référencent les valeurs chemin d’accès à la zone et chemin d’itération définies au moment de chaque élément de travail

Vous pouvez supprimer des chemins de zone et d’itération uniquement lorsqu’ils ne sont plus utilisés par des éléments de travail. Lorsque vous supprimez ces chemins d’accès, vous ne pouvez plus récupérer leurs données historiques.

Pour supprimer un chemin de zone, ouvrez la page Paramètres de projet>Configuration de projet>Zone du portail web.
Choisissez le menu contextuel pour le nœud, puis sélectionnez Supprimer ou Retirer.
Dans la boîte de dialogue qui s’ouvre, sélectionnez le chemin de zone auquel réaffecter les éléments de travail, puis choisissez Supprimer le chemin.

Progression du graphique par zone

Vous pouvez rapidement générer des requêtes pour afficher la progression en fonction d’un chemin de zone. Par exemple, visualisez la progression des éléments de travail affectés dans la zone de chaque équipe, comme indiqué dans le graphique à barres empilées suivant. Sélectionnez le nom du nœud pour obtenir le nœud terminal du chemin de zone.

Capture d’écran montrant le graphique à barres empilées par zone et état.

Étapes suivantes

Définir des chemins d’itération ou des sprints

Comme vous pouvez le constater, les chemins d'accès jouent un rôle majeur dans la prise en charge des outils Agile, des équipes et de la gestion des éléments de travail. Pour en savoir plus sur l’utilisation de ces champs, consultez les articles suivants :

Ressources programmatiques

Les chemins de zone et les chemins d’itération sont également appelés Nœuds de classification.

Utilisez az boards area (CLI Azure DevOps).
Utiliser Teams (API REST) pour gérer les configurations d’équipe.
Utiliser les nœuds de classification (API REST) pour organiser les classifications d’éléments de travail.

Utiliser Teams (API REST) pour gérer les configurations d’équipe.
Utiliser les nœuds de classification (API REST) pour organiser les classifications d’éléments de travail.
Configurer le processus en définissant le plug-in de classification (modèle de processus).

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-12-22

Partager via

Définir les chemins de zone et les assigner à une équipe

Prerequisites

Bien démarrer

Répertorier les zones de projet

Ajouter un chemin de zone

Répertorier les chemins de zone d’équipe

Ouvrez les paramètres d’équipe depuis le profil d’équipe

Définir les chemins de zone d’équipe

Renommer ou déplacer un chemin de zone

Supprimer un chemin de zone

Progression du graphique par zone

Étapes suivantes

Contenu connexe

Ressources programmatiques

Commentaires

Ressources supplémentaires