Créer des maquettes efficaces en collaboration

J'ai enregistré une nouvelle émission dans la série Bon App!. Je vous y présente les outils à disposition pour la réalisation des maquettes dynamiques dans la suite Visual Studio ALM et comment les créer en collaboration.

Les avantages d'une maquette dynamique

La création d'une maquettes dynamique (storyboard, animation, mockup) permet de clarifier les fonctionnalités d'une application à développer. Elle permet aux utilisateurs de se projeter dans la future application afin de valider les fonctions à implémenter. Si vous y intégrez la charte graphique, vous pourrez aussi la valider à l'avance!

Les outils Storyboard et SketchFlow

Visual Studio 2012 Premium installe un Add-In PowerPoint. Celui-ci vous permet d'étendre les fonctionnaltés de PowerPoint et vous fourni beaucoup de formes prédéfinies pour accélerer le maquettage (PageWeb, controles Windows UI, Windows Phone, ...).

Dans l'update 2, Microsoft a inclus SketchFlow un outil de mockup intégré à Blend. Celui-ci vous permet d'aller encore plus loin en créant une véritable maquette interactive avec une expérience utilisateur très proche de celle de l'application finale (clique et sélection d'éléments, navigation libre dans les différents écrans, réutilisation de composants, ...)

La collaboration et l'implication des utilisateurs

Pour obtenir une maquette de la meilleure qualité et acceptée par tous, il est important d'obtenir des retours et commentaires de la part de l'équipe et des utilisateurs. Les outils de collaboration sont variés : TFS, SharePoint, FeedBack Client, Yammer.... Dans ma société, nous avons mis en place un processus pour nos outils internes. Il permet un premier retour par l'équipe via SharePoint puis une deuxième boucle par les utilisateurs finaux via Yammer.

Afficher le bogue dans le Web Access

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.