Dans un billet précédent
Ajouter l'effort au type bogue, j'ai expliqué comment ajouter le suivi des temps au type Bogue. Afin de tirer parti des nouvelles fonctionnalités du Web Access, je vous propose de réaliser les modifications nécessaires pour l'y ajouter. A nouveau, je précise que cet ajout n'a de sens que dans le cadre de l'utilisation du processus Msf Agile 5.x ou 6.x
Celui-ci affiche l'ensemble des éléments de travail dont le type est dans la catégorie Task. Si vous souhaitez intégrer le type Bogue à l'outil de planification Agile, il faut l'ajouter à cette catégorie. Vous aurez alors la possibilité de gérer la capacité de l'équipe sur l'ensemble du travail restant des tâches et bogues.
Modifier le type bogue
Avant de l'intégrer, il nous faut à nouveau modifier le type Bug/bogue. Il est indispensable d'ajouter un champ
Activity utilisé dans la planification agile et il est intéressant d'ajouter l'état New/Nouveau au type Bug/Bogue pour obtenir une meilleure cohérence entre les 2 types.
Ouvrez une console de commande en tant qu'administrateur et tapez les commandes suivantes pour télécharger les définitions du type Bug/Bogue et Task/Tache :
cd %programfiles(x86)%\Microsoft Visual Studio 11.0\Common7\IDE
witadmin exportwitd /n:Bug /f:C:\Bug.xml /collection:http://tfsserveur:8080/tfs/DefaultCollection /p:TestProj
witadmin exportwitd /n:Task /f:C:\Task.xml /collection:http://tfsserveur:8080/tfs/DefaultCollection /p:TestProj
Si ce n'est pas déjà fait, vous devez
Ajouter l'effort au type bogue en ajoutant les champs de référence
Microsoft.VSTS.Scheduling.Xxxx.
D'abord, vous copiez la définition de champ de référence
Microsoft.VSTS.Common.Activity depuis le fichier Task.xml et les collez dans le fichier Bug.xml sous le noeud
FIELDS. Vous devez aussi ajouter le contrôle correspondant dans la colonne Planning dans la définition de l'interface.
<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
<HELPTEXT>Type of work involved</HELPTEXT>
<SUGGESTEDVALUES expanditems="true">
<LISTITEM value="Development" />
<LISTITEM value="Testing" />
<LISTITEM value="Requirements" />
<LISTITEM value="Design" />
<LISTITEM value="Deployment" />
<LISTITEM value="Documentation" />
</SUGGESTEDVALUES>
</FIELD>
Vous ajoutez l'état "New" au noeud
STATES en le copiant à partir de l'état "Active" du type Bug/Bogue :
<STATE value="New">
<FIELDS>
<FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
<EMPTY />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ResolvedBy">
<ALLOWEXISTINGVALUE />
<EMPTY />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ResolvedReason">
<EMPTY />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ClosedDate">
<EMPTY />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ClosedBy">
<ALLOWEXISTINGVALUE />
<EMPTY />
</FIELD>
</FIELDS>
</STATE>
Puis, vous remplacez la transition de l'état "" à l'état "Active" par les suivantes:
<TRANSITION from="" to="New">
<REASONS>
<DEFAULTREASON value="New" />
<REASON value="Build Failure" />
</REASONS>
</TRANSITION>
<TRANSITION from="New" to="Active">
<REASONS>
<DEFAULTREASON value="Work started" />
</REASONS>
<FIELDS>
<FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
<ALLOWEXISTINGVALUE />
<COPY from="currentuser" />
<VALIDUSER />
<REQUIRED />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
<SERVERDEFAULT from="clock" />
</FIELD>
<FIELD refname="System.AssignedTo">
<DEFAULT from="currentuser" />
</FIELD>
</FIELDS>
<ACTIONS>
<ACTION value="Microsoft.VSTS.Actions.StartWork" />
</ACTIONS>
</TRANSITION>
<TRANSITION from="Active" to="New">
<REASONS>
<DEFAULTREASON value="Work halted" />
</REASONS>
<ACTIONS>
<ACTION value="Microsoft.VSTS.Actions.StopWork" />
</ACTIONS>
</TRANSITION>
Enfin, vous ajoutez au minimum la transition de l'état "Closed" à "New" dans le noeud TRANSITIONS. Vous pouvez copier la transition depuis celle de l'état "Closed" à "Active". Vous pouvez aussi ajouter toutes les transitions depuis/vers l'état "New", cela permettra de déplacer depuis/vers n'importe quelle colonne du tableau le bogue:
<TRANSITION from="Closed" to="New">
<REASONS>
<DEFAULTREASON value="Regression" />
<REASON value="Reactivated" />
</REASONS>
<FIELDS>
<FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
<ALLOWEXISTINGVALUE />
<COPY from="currentuser" />
<VALIDUSER />
<REQUIRED />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
<SERVERDEFAULT from="clock" />
</FIELD>
<FIELD refname="System.AssignedTo">
<COPY from="field" field="Microsoft.VSTS.Common.ResolvedBy" />
</FIELD>
</FIELDS>
</TRANSITION>
Ouvrez une console de commande en tant qu'administrateur et tapez les commandes suivantes pour télécharger sur le serveur la nouvelle définition du type Bug/Bogue dans le projet d'équipe :
cd %programfiles(x86)%\Microsoft Visual Studio 11.0\Common7\IDE
witadmin importwitd /f:C:\Bug.xml /collection:http://tfsserveur:8080/tfs/DefaultCollection /p:TestProj
Modifier les catégories
Vous allez ajouter le type Bug/Bogue à la catégorie Task pour qu'il apparaisse dans le tableau de taches. Ouvrez une console de commande en tant qu'administrateur et tapez les commandes suivantes pour télécharger en local le fichier des catégories :
cd %programfiles(x86)%\Microsoft Visual Studio 11.0\Common7\IDE
witadmin exportcategories /collection:http://tfsserveur:8080/tfs/DefaultCollection /p:TestProj /f:C:\Categories.xml
Vous allez ensuite modifier la catégorie Task pour lui ajouter le type Bug/Bogue comme suit.
<CATEGORY refname="Microsoft.TaskCategory" name="Task Category">
<DEFAULTWORKITEMTYPE name="Task" />
<WORKITEMTYPE name="Bug" />
</CATEGORY>
Ouvrez une console de commande en tant qu'administrateur et tapez les commandes suivantes pour télécharger sur le serveur la nouvelle définition des catégories.
cd %programfiles(x86)%\\Microsoft Visual Studio 11.0\Common7\IDE
witadmin importcategories /collection:http://tfsserveur:8080/tfs/DefaultCollection /p:TestProj /f:C:\Categories.xml
Modifier la configuration du processus :
Ouvrez une console de commande en tant qu'administrateur et tapez les commandes suivantes pour télécharger en local le fichier de configuration du processus :
cd %programfiles(x86)%\Microsoft Visual Studio 11.0\Common7\IDE
witadmin exportcommonprocessconfig /collection:http://tfsserveur:8080/tfs/DefaultCollection /p:TestProj /f:C:\commonConf.xml
Vous ajoutez à la categorie Bug l'état "New" en "Proposed" :
<BugWorkItems category="Microsoft.BugCategory">
<States>
<State type="Proposed" value="New" />
<State type="InProgress" value="Active" />
<State type="Complete" value="Closed" />
<State type="Resolved" value="Resolved" />
</States>
</BugWorkItems>
Et vous ajoutez à la categorie Task le statut "Resolved" en "Resolved" afin de visualiser aussi cette colonne dans le tableau de taches :
<TaskWorkItems category="Microsoft.TaskCategory">
<States>
<State type="Proposed" value="New" />
<State type="InProgress" value="Active" />
<State type="InProgress" value="Resolved" />
<State type="Complete" value="Closed" />
</States>
</TaskWorkItems>
Ouvrez une console de commande en tant qu'administrateur et tapez les commandes suivantes pour télécharger sur le serveur la nouvelle configuration du processus:
cd %programfiles(x86)%\Microsoft Visual Studio 11.0\Common7\IDE
witadmin importcommonprocessconfig /collection:http://tfsserveur:8080/tfs/DefaultCollection /p:TestProj /f:C:\commonConf.xml
Note : Si nous n'avions pas ajouter le champ Activity au Bug/Bogue, nous aurions l'erreur du type suivant:
The following element contains an error: TypeFields/TypeField[type='Activity'].
TF400501: The value of this element is set to: Microsoft.VSTS.Common.Activity. Y
ou must set the value to a field that exists in the work item types that are def
ined in: TaskWorkItems. These work item types must also have the following field
defined: TypeFields/TypeField[type='RemainingWork']. The field does not exist
in the following work item types: Bug.
Afficher et gérer les bogues
Vous pouvez maintenant planifier la capacité de votre équipe en considérant le temps restant sur les bogues et visualiser ou modifier ceux-ci depuis le tableau de tache du Web Access.
Il vous faudra tout comme pour les taches vous assurer que le bogue est attaché en tant qu'enfant à un User story/récit utilisateur et qu'il est bien assigné aux bonnes zones et itérations. Je conseille de créer le lien et vérifier les infos au moment du triage.
have a nice day.
