Informations de référence sur les éléments XML de configuration de processus
La configuration du processus définit la configuration par défaut et les capacités fonctionnelles auxquelles les équipes peuvent accéder à l'aide des outils de planification Agile. Ces outils, disponibles depuis le portail web, incluent le backlog de produit, les backlogs de sprints, le tableau kanban et le tableau de tâches. Vous pouvez y accéder quand vous créez une équipe de projet dans Visual Studio Online ou sur un serveur Team Foundation Server (TFS) localement.
Les éléments de configuration spécifient les types d'éléments de travail (WIT), les colonnes par défaut, les champs utilisés par les outils et d'autres éléments. Les principales configurations effectuées déterminent les éléments qui apparaissent pour les backlogs de sprint, de produit et de portefeuille d'après la définition des sections PortfolioBacklog, RequirementBacklog et TaskBacklog du fichier de définition XML de configuration de processus. En outre, la configuration de processus définit les mappages états à méta-états pour tous les WIT qui nécessitent un mappage.
Configurer et personnaliser les outils de planification Agile pour un projet d'équipe résume ce que vous pouvez configurer via l'interface utilisateur et ce que vous devez configurer en définissant le fichier ProcessConfiguration.
Zones que vous personnalisez via ProcessConfiguration :
Configurer un backlog
|
|
Pour mettre à jour la configuration de processus, exportez le fichier de définition XML, modifiez-le, puis importez-le. Vous utilisez l'outil de ligne de commande witadmin pour importer et exporter le fichier.
Notes
Les exemples de syntaxe indiqués dans cette rubrique correspondent aux assignations par défaut définies dans le modèle de processus Scrum.Pour accéder à la version la plus récente des modèles de processus, installez la version la plus récente de TFS et téléchargez les modèles à l'aide du Gestionnaire de modèles de processus.
Configurer un backlog
Vous pouvez personnaliser les éléments suivants pour le backlog de produit, les backlogs des sprints et les backlogs de portefeuille :
Mappages de méta-états : mappez les états de flux de travail aux méta-états. Ces mappages prennent en charge l'affichage de tous les outils de planification Agile, notamment les tableaux kanban et de tâches.
Panneau d'ajout rapide : spécifiez les types d'éléments de travail (WIT) et les champs d'élément de travail qui apparaissent pour ajouter rapidement des éléments au backlog.
Pour modifier les types d'éléments de travail qui sont considérés comme des éléments ou des tâches du backlog, ajoutez-les à la catégorie correspondante. Pour obtenir un exemple, voir Ajouter des bogues au tableau de tâches ou au backlog.
Champs de colonne : définissez les champs et la séquence de colonnes par défaut.
Vous configurez les backlogs dans les sections XML qui apparaissent dans l'exemple suivant :
<PortfolioBacklogs>
<PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic" workItemCountLimit="1000">
. . .
</PortfolioBacklog>
<PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature" parent="Microsoft.EpicCategory" workItemCountLimit="1000">
. . .
</PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="User Story" workItemCountLimit="1000">
. . .
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="1000">
. . .
</TaskBacklog>
Élément |
Description |
---|---|
PortfolioBacklogs |
Facultatif. Élément conteneur pour les backlogs de portefeuille. |
PortfolioBacklog |
Facultatif. Jusqu'à cinq instances. Élément conteneur qui définit les mappages méta-états, les colonnes par défaut et le volet d'ajout rapide pour un backlog de portefeuille.
Assignez des valeurs aux attributs comme indiqué :
|
RequirementBacklog |
Obligatoire. Une seule instance. Élément conteneur qui définit les mappages méta-états, les colonnes par défaut et le volet d'ajout rapide pour le backlog de produit. Le backlog de produit affiche tous les éléments actifs dans le backlog de l'équipe.
|
TaskBacklog |
Obligatoire. Une seule instance. Élément conteneur utilisé pour personnaliser la disposition des backlogs de sprints.
|
Remarques d'implémentation
Par défaut, chaque backlog est limité à un total de 1000 éléments de travail. Vous pouvez modifier cette limite en spécifiant une valeur pour l'attribut workItemCountLimit.
Les valeurs assignées à CategoryName doivent correspondre à un groupe de catégories défini pour le projet d'équipe. Vous spécifiez les groupes de catégorie dans le fichier de définition des catégories.
Vous utilisez les backlogs de portefeuille pour organiser votre backlog, afficher le cumul des éléments du backlog aux niveaux inférieurs et consulter sa progression sur plusieurs équipes. Les projets d'équipe nouveaux et mis à niveau contiennent deux niveaux de backlog de portefeuille : fonctionnalités et narrations. Vous pouvez ajouter jusqu'à trois niveaux. Seul le backlog de portefeuille de niveau supérieur ne spécifie pas de catégorie parent.
Notes
Vous aurez peut-être besoin d'un accès avancé pour exercer certaines des fonctionnalités de backlog de portefeuille.
Votre backlog de produit correspond à votre plan de projet, la feuille de route de ce que votre équipe prévoit de livrer. Il répertorie les éléments de travail dont les WIT appartiennent à la catégorie des spécifications. Pour gérer d'autres WIT que ceux fournis par votre projet d'équipe par défaut, vous pouvez ajouter des WIT à la catégorie des spécifications et effectuer un mappage états à méta-états du flux de travail.
Vos backlogs de sprints ou d'itération affichent l'ensemble des spécifications que votre équipe et vous-même devez respecter dans un cycle de sprint spécifique et les tâches que vous avez liées à ces spécifications. Vous liez les tâches aux spécifications à l'aide du type de lien parent-enfant. Étant donné que les WIT qui apparaissent dans ces backlogs correspondent aux types qui apparaissent dans le backlog de produit, une grande partie du travail de personnalisation effectué pour le backlog de produit consiste à définir les fonctionnalités du backlog de sprints.
Mapper les états du flux de travail sur les méta-états
La plupart des types d'éléments de travail (WIT) requièrent que les états de leurs flux de travail soient mappés à un méta-état. Les états du flux de travail définissent la façon dont un élément de travail passe de la première activation ou création à l'état de fermeture ou d'achèvement. Par exemple, les états définis pour l'élément de backlog de produit Scrum définissent une progression des quatre états de Nouveau, Approuvé, Validé, à Terminé. Un cinquième état est également inclus : Supprimé, pour indiquer un état supprimé du journal sans avoir été implémenté.
Les méta-états, en revanche, déterminent la façon dont les outils de planification Agile traitent chaque état de flux de travail. Les principaux méta-états utilisés par le backlog et le tableau de tâches sont Proposed, InProgress et Complete.
En associant chaque état de flux de travail à un méta-état, les opérations en arrière-plan exécutées pour afficher le backlog et les tableaux de tâches sont capables d'interpréter correctement l'état de chaque élément de travail. Par exemple, les mappages suivants sont définis pour les backlogs de produit Scrum.
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
<States>
<State value="New" type="Proposed" />
<State value="Approved" type="Proposed" />
<State value="Committed" type="InProgress" />
<State value="Done" type="Complete" />
</States>
. . .
</RequirementBacklog >
Il existe trois catégories de méta-états : Agile, bogue et commentaire. Le tableau suivant décrit les attributs et les valeurs de mappage.
Élément |
Description |
---|---|
State |
Obligatoire. Affecte un état de flux de travail à un méta-état.
Les valeurs valides de TypeName correspondent à une valeur attribuée à un STATE dans la section WORKFLOW des WIT assignés au groupe de catégories. Les valeurs valides de ValueName correspondent à l'une des valeurs énumérées suivantes :
|
States |
Spécifie une collection d'éléments State qui associent des états de flux de travail de types d'éléments de travail (WIT) à des méta-états. Élément requis pour les éléments parents suivants :
|
Personnaliser les colonnes et la séquence de colonne par défaut
Spécifiez les champs à afficher dans chaque backlog dans la section Columns. Les modifications que vous apportez via la boîte de dialogue Options de colonne sont conservées jusqu'à ce qu'elles soient à nouveau modifiées.
Voici la configuration par défaut définie par le modèle de processus Scrum pour le backlog de produit.
<Columns>
<Column refname="Microsoft.VSTS.Common.Priority" width="400" />
<Column refname="System.Title" width="400" />
<Column refname="System.State" width="100" />
<Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" />
<Column refname="System.IterationPath" width="200" />
</Columns>
Élément |
Description |
---|---|
Columns |
Spécifie une collection d'éléments Column. Élément requis pour les éléments de backlog : PortfolioBacklog, RequirementBacklog et TaskBacklog. |
Column |
Spécifie un champ à afficher comme colonne dans un backlog.
|
En-têtes de colonne du tableau de tâches
Les en-têtes de colonne qui apparaissent dans le tableau de tâches correspondent aux états de flux de travail assignés au type d'élément de travail (WIT) par défaut assigné à la catégorie de tâche. La séquence de colonne correspond à la progression naturelle des transitions de flux de travail, en allant de gauche à droite. Pour modifier la disposition de colonne, vous modifiez le flux de travail du WIT assigné à la catégorie de tâche. Les états de flux de travail définis pour le type de tâche par défaut dans la catégorie de tâche doivent être assignés à un méta-état valide, comme décrit dans Mapper les méta-états pour une catégorie de types d'éléments de travail.
Personnaliser le panneau d'ajout rapide
Vous pouvez ajouter des champs pour n'importe quel volet d'ajout rapide. Par exemple, l'exemple suivant ajoute Valeur commerciale au volet du Backlog de produit.
Le volet affiche uniquement les champs inclus dans la section FIELDS de la définition WIT du WIT sélectionné. Par exemple, si vous sélectionnez le WIT du bogue, seul Titre s'affiche, étant donné que Valeur commerciale n'est pas définie pour les bogues. Pour ajouter un autre WIT au volet, vous l'ajoutez à la catégorie des spécifications comme décrit ici.
Le code suivant correspond aux assignations par défaut définies dans les modèles de processus Visual Studio Scrum et MSF for Agile.
<AddPanel>
<Fields>
<Field refname="System.Title" />
</Fields>
</AddPanel>
Élément |
Description |
---|---|
AddPanel |
Élément conteneur utilisé pour spécifier l'expérience d'ajout rapide, les champs devant apparaître dans la zone de volet où de nouveaux éléments de backlog sont définis. |
Fields |
Spécifie une collection d'éléments Field. |
Field |
Spécifie un champ d'élément de travail à afficher dans le volet du backlog de produit.
Le même champ doit apparaître sur le formulaire d'élément de travail de chaque WIT inclus dans la catégorie du backlog. |
Modifier le nombre d'éléments de travail qui peuvent s'afficher dans le tableau de tâches
Pour des raisons de performance, l'affichage du tableau de tâches est limité à 1000 éléments de travail. Lorsque vous ouvrez le tableau de tâches, tous les éléments de travail sont chargés dans le cache. La limitation du nombre d'éléments de travail peut entraîner des temps de chargement plus rapides. Vous pouvez modifier cette limite en spécifiant une valeur pour l'attribut workItemCountLimit de l'élément TaskBacklog.
Par exemple, vous pouvez réduire la limite en spécifiant workItemCountLimit="800" :
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>
Mapper les méta-états pour des types d'éléments de travail spécifiques aux outils
Les mappages de méta-états sont définis pour des catégories supplémentaires de types d'éléments de travail (WIT). Pour le modèle de processus Scrum, cela inclut les mappages pour les catégories de demande de commentaires et de réponse aux commentaires. Pour les modèles de processus MSF Agile et CMMI, cela inclut également des mappages pour la catégorie de bogue. (Scrum comprend des bogues dans la catégorie de spécification et définit donc les mappages de méta-états dans la section RequirementBacklog.)
<FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" pluralName="Feedback Requests" singularName="Feedback Request">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackRequestWorkItems>
<FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" pluralName="Feedback Responses" singularName="Feedback Response">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackResponseWorkItems>
Le tableau suivant décrit les éléments supplémentaires utilisés pour définir les mappages de méta-états des types d'éléments de travail spécifiques aux outils. Consultez Mapper les méta-états pour une catégorie de types d'éléments de travail pour plus d'informations sur l'assignation des types et valeurs d'état réels. CategoryName doit correspondre à une catégorie définie pour le projet d'équipe.
Élément |
Description |
---|---|
BugWorkItems |
Facultatif. Élément conteneur qui définit les mappages méta-états des types d'éléments de travail assignés à la catégorie de bogue. Outre la façon dont ces mappages sont utilisés dans l'affichage des outils Agile, ils contrôlent également la façon dont la fonctionnalité Mon travail met à jour l'état du bogue dans Team Explorer pendant que les développeurs déplacent les bogues à l'aide de Mon travail. Pour plus d'informations, consultez Journée d'un développeur ALM : écriture d'un nouveau code pour un récit utilisateur.
|
FeedbackRequestWorkItems |
Obligatoire. Ne pas personnaliser. Élément conteneur qui définit les mappages de méta-états des types d'éléments de travail assignés à la catégorie de demande de commentaires.
|
FeedbackResponseWorkItems |
Obligatoire. Ne pas personnaliser. Élément conteneur qui définit les mappages de méta-états des types d'éléments de travail assignés à la catégorie de réponse aux commentaires.
|
TestPlanWorkItems |
Uniquement requis si vous personnalisez l'état de flux de travail pour le plan de test et que vous prenez en charge les connexions au projet d'équipe à partir de versions de Test Manager installées avec Visual Studio 2013.2 ou versions antérieures. Élément conteneur qui définit les mappages de méta-états des types d'éléments de travail assignés à la catégorie de plan de test. Exemple :
|
TestSuiteWorkItems |
Uniquement requis si vous personnalisez l'état de flux de travail pour la suite de tests et que vous prenez en charge les connexions au projet d'équipe à partir de versions de Test Manager installées avec Visual Studio 2013.2 ou versions antérieures. Élément conteneur qui définit les mappages de méta-états des types d'éléments de travail assignés à la catégorie de suite de tests. Par exemple :
|
Pour mapper les méta-états pour TestPlanWorkItems ou TestSuiteWorkItems, vous devez mettre à niveau votre serveur de couche Application vers TFS 2013.3. Vous pouvez ensuite personnaliser l'état de flux de travail des plans de test et des suites de tests.
Pour en savoir plus, voir Importer et exporter la configuration de processus.
Assigner les champs utilisés dans les outils de planification et graphiques Agile
Vous pouvez modifier les champs de l'élément de travail utilisés dans le calcul de capacité, les graphiques d'avancement (Burndown Chart), les prévisions et la vélocité. Toute modification apportée à l'une des assignations par défaut doit correspondre à une modification apportée au WIT utilisé pour définir et capturer des informations pour cette valeur.
Par exemple, si vous modifiez le refname assigné à type="Activity", vous devez inclure le même champ dans la définition WIT assignée à la catégorie de tâche qui capture les informations d'activité.
<TypeFields>
<TypeField refname="System.AreaPath" type="Team" />
<TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
<TypeField refname=" Microsoft.VSTS.Common.BacklogPriority" type="Order" />
<TypeField refname="Microsoft.VSTS.Scheduling.Effort" type="Effort" />
<TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>
</TypeField>
</TypeFields>
Élément |
Description |
---|---|
TypeFields |
Obligatoire. Spécifie une collection d'éléments TypeField. |
TypeField |
Obligatoire. Spécifie le nom de référence d'un champ dont la valeur prend en charge un type d'activité pour une zone de fonctionnalités. Les champs que vous spécifiez doivent correspondre aux champs que vous utilisez dans les types d'éléments de travail (WIT) utilisés pour capturer les informations relatives aux fonctionnalités.
Spécifiez le format uniquement lorsque type="RemainingWork". Vous pouvez spécifier n'importe quelle chaîne de texte pour le TimeUnitString que vous souhaitez voir apparaître sur les barres de capacité du backlog de sprints actuel et du tableau de tâches. Pour les outils Agile :
Pour le formulaire de demande de commentaires : Notes Vous ne devez pas être obligé de modifier les assignations par défaut effectuées pour les éléments TypeField suivants.Ces assignations correspondent aux champs utilisés pour capturer les informations correspondantes dans le WIT assigné à la catégorie de demande de commentaires.
|
TypeFieldValues |
Obligatoire pour TypeFieldValue si type="ApplicationType". Spécifie une collection d'éléments TypeFieldValue utilisés dans le formulaire de demande de commentaires. |
TypeFieldValue |
Obligatoire. Ne pas personnaliser. Spécifie le nom d'un type d'application à afficher sur le formulaire de demande de commentaires.
Les assignations par défaut correspondent aux valeurs autorisées spécifiées dans la définition de type pour le formulaire de demande de commentaires.
|
Remarques d'implémentation
Si vous modifiez un champ dans la section TypeFields, vous devez apporter la modification correspondante dans la définition WIT. Par exemple, si vous modifiez les champs assignés pour capturer l'Effort de travail, vous devez apporter la même modification dans les définitions WIT pour l'élément et le bogue du backlog de produit (pour Scrum).
Vous pouvez rechercher le nom de référence d'un champ à l'aide de cet index.
Assigner des jours chômés
Les jours chômés sont supprimés des calculs effectués par l'outil de planification de la capacité et les burndown charts. Les modèles de processus TFS et les processus Visual Studio Online par défaut spécifient samedi et dimanche comme des jours chômés. Une fois que vous avez créé un projet d'équipe, chaque équipe peut définir ses propres jours chômés.
<Weekends>
<DayOfWeek>Saturday</DayOfWeek>
<DayOfWeek>Sunday</DayOfWeek>
</Weekends>
Élément |
Description |
---|---|
DayOfWeek |
Enfant obligatoire de l'élément Weekends. Spécifie un jour de la semaine correspondant à un jour chômé.
Les noms valides correspondent aux jours de la semaine en anglais : Sunday, Monday, Tuesday, Wednesday, Thursday, Friday et Saturday. Notes Vous devez spécifier un jour de semaine en anglais, indépendamment de la langue installée pour votre serveur TFS local. |
Weekends |
Facultatif. Élément conteneur utilisé pour spécifier les jours chômés. Spécifiez les jours chômés lorsque vous souhaitez prendre en compte des jours chômés dans le calcul des graphiques de capacité et d'avancement (Burndown Chart). |
Modifier la couleur d'un type d'élément de travail
D'un seul coup d'œil, vous pouvez différencier les WIT lorsque vous consultez un résultat de requête ou un backlog selon la couleur attribuée au WIT.
Le modèle de processus Scrum définit les assignations de couleurs suivantes. Des assignations similaires sont effectuées pour les modèles Agile et CMMI.
<WorkItemColors>
<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
<WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
<WorkItemColor primary="FFFF7B00" secondary="FFFFD7B5" name="Epic" />
<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
<WorkItemColor primary="FFCC293D" secondary="FFFAEAE5" name="Bug" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Impediment" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Step" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Case" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Plan" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Suite" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Parameter" />
</WorkItemColors>
Élément |
Description |
---|---|
WorkItemColors |
Facultatif. Élément conteneur pour spécifier les couleurs des types d'éléments de travail. |
WorkItemColor |
Spécifie les couleurs utilisées pour afficher un WIT dans le portail web. La couleur principale est utilisée dans les affichages de liste et la couleur secondaire dans les affichages de tableau, tels qu'un tableau de tâches ou un tableau kanban.
|
Spécifier les propriétés et les comportements
Vous ne pouvez à ce stade spécifier qu'une seule propriété. La propriété BugsBehavior définit l'affichage par défaut, dans les backlogs et les tableaux, des bogues et autres WIT définis dans la catégorie de bogue. Fondamentalement, vous pouvez configurer si les bogues sont traités comme des spécifications, des tâches ou ne pas apparaître dans les backlogs et les tableaux. Une fois que vous avez créé un projet d'équipe, chaque équipe peut définir le comportement de son choix.
<Properties>
<Property name="BugsBehavior" value="AsTasks" />
<Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />
</Properties>
Élément |
Description |
---|---|
Properties |
Facultatif. Élément conteneur permettant de spécifier les comportements et les propriétés par défaut. |
Property |
Spécifie l'affectation par défaut pour les nouvelles équipes ou les équipes existantes lors de la mise à jour d'un projet d'équipe avec des nouvelles fonctionnalités. Les équipes peuvent choisir le comportement qu'ils souhaitent via leurs paramètres d'équipe. BugsBehavior définit la valeur par défaut pour Afficher les bogues sur les backlogs ou les tableaux. HiddenBacklogs spécifie la catégorie de backlog qui est inactive pour l'équipe. Les valeurs autorisées pour BugsBehavior sont :
|
Q et R
Q : comment personnaliser les autres fonctionnalités des outils Agile ?
R : Certaines personnalisations peuvent être effectuées dans l'interface utilisateur. D'autres nécessitent de modifier la configuration du processus ou d'autres objets du projet d'équipe. Pour une vue d'ensemble, consultez Configurer et personnaliser les outils de planification Agile pour un projet d'équipe.
Q : Souhaitez-vous ajouter ou modifier les WIT qui apparaissent sur votre tableau de tâches ou votre Backlog de produit ?
R : Si vous avez ajouté un WIT personnalisé, vous pouvez l'ajouter au Backlog ou au tableau de tâches. Cependant, vous ne pouvez pas les faire apparaître aux deux emplacements. Pour connaître la procédure à suivre, consultez Ajouter des types d'éléments de travail à des backlogs et tableaux.