Comment : modifier le flux de travail d'un type d'élément de travail

Article
08/22/2008

Mise à jour : novembre 2007

Vous pouvez modifier le flux de travail d'un type d'élément de travail en exportant le fichier XML et en modifiant son contenu. Une fois que vous avez modifié le flux de travail, vous pouvez importer le fichier XML pour commencer à utiliser le type d'élément de travail mis à jour.

Autorisations requises

Pour exécuter cette procédure, vous devez être membre du groupe Team Foundation Administrators ou membre du groupe Project Administrators pour le projet. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Pour modifier le flux de travail

Si vous modifiez un type d'élément de travail sur un projet unique, exécutez witexport pour exporter le fichier XML du type d'élément de travail que vous souhaitez modifier. Pour plus d'informations, consultez Comment : exporter un type d'élément de travail à partir d'un projet existant.
Dans Visual Studio, cliquez sur Fichier, Ouvrir, puis sur Fichier.

La boîte de dialogue Ouvrir un fichier s'affiche.

Sous Regarder dans, accédez à l'emplacement où vous avez exporté le fichier.

Si vous modifiez un type d'élément de travail pour personnaliser un modèle de processus, accédez à l'emplacement où vous avez téléchargé le modèle de processus.

Remarque :
Si vous exécutez Windows Vista, vous ne disposez peut-être pas des droits d'accès à certains dossiers. Si vous tentez d'exporter le type d'élément de travail vers un emplacement où vous n'avez pas de droits d'accès, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel. Pour plus d'informations, consultez https://go.microsoft.com/fwlink/?LinkId=92325 et https://go.microsoft.com/fwlink/?LinkId=92323. Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous avez des droits d'accès.

Si vous exécutez Windows Vista, vous ne disposez peut-être pas des droits d'accès à certains dossiers. Si vous tentez d'exporter le type d'élément de travail vers un emplacement où vous n'avez pas de droits d'accès, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel. Pour plus d'informations, consultez https://go.microsoft.com/fwlink/?LinkId=92325 et https://go.microsoft.com/fwlink/?LinkId=92323. Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous avez des droits d'accès.

Sélectionnez le fichier XML du type d'élément de travail que vous souhaitez mettre à jour, puis cliquez sur Ouvrir. Lorsque vous êtes invité à modifier les fins de ligne, cliquez sur Non.

Recherchez la définition du flux de travail du type d'élément de travail, dans la section <WORKFLOW> du fichier XML, comme indiqué dans le code XML suivant :

<WORKFLOW>
  <STATES>
    <STATE value="Active">
      <FIELDS>
        <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
          <EMPTY />
        </FIELD>
        <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
...

Ajoutez un état Unapproved à la définition de type en insérant un autre élément <STATE>. Le nouvel état s'affiche en gras.

<WORKFLOW>
  <STATES>
    <STATE value="Unapproved">    </STATE>    <STATE value="Active">
      <FIELDS>
        <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
          <EMPTY />
        </FIELD>
        <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
...

Créez une transition entre l'état null et l'état non autorisé. Pour cela, recherchez d'abord la section de la définition du flux de travail concernant les transitions. Puis, insérez le code XML suivant en gras. À cause de cette modification, tous les nouveaux éléments de travail de ce type démarreront dans l'état Non autorisé avec la raison par défaut affectée de la valeur Nouveau.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">    <REASONS>      <DEFAULTREASON value="New" />    </REASONS>  </TRANSITION>  <TRANSITION from="" to="Active">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
    <FIELDS>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
        <COPY from="currentuser" />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
        <COPY from="clock" />
      </FIELD>
      <FIELD refname="System.AssignedTo">
        <COPY from="currentuser" />
      </FIELD>
    </FIELDS>
  </TRANSITION>

Supprimez la transition vers l'état Actif qui apparaît en surbrillance dans le code XML suivant. Cette opération est requise, car il ne peut y avoir qu'une seule transition d'ouverture.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
  </TRANSITION>
  <TRANSITION from="" to="Active">    <REASONS>      <DEFAULTREASON value="New" />    </REASONS>    <FIELDS>      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">        <COPY from="currentuser" />      </FIELD>      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">        <COPY from="clock" />      </FIELD>      <FIELD refname="System.AssignedTo">        <COPY from="currentuser" />      </FIELD>    </FIELDS>  </TRANSITION>

Ajoutez une raison "Ported" pour la transition d'ouverture en insérant le code XML suivant affiché en gras. Cela permet aux utilisateurs de déterminer si l'élément de travail est nouveau ou s'il a été porté à partir d'un autre système de suivi.
```
<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />    </REASONS>
  </TRANSITION>
...
```

Insérez la règle COPY suivante, affichée en gras. Cette règle attribue par défaut au champ Assigné à l'utilisateur qui a créé l'élément de travail, et elle doit être évaluée uniquement pendant la transition d'ouverture.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />
    </REASONS>
    <FIELDS>       <FIELD refname="System.AssignedTo">         <COPY from="currentuser" />       </FIELD>    </FIELDS>
  </TRANSITION>
...

Remarque :
L'insertion de cette règle sous d'autres éléments <TRANSITION> ou <STATE> étend sa portée à d'autres transitions ou états. Pour plus d'informations, consultez Utilisation des règles <WHEN*>, <DEFAULT> et <COPY>.

Créez une transition de l'état Non autorisé à l'état Actif en insérant le code XML suivant, qui apparaît en surbrillance dans l'exemple suivant. À cause de cette modification, lorsqu'un élément de travail est approuvé, il peut subir cette transition.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />
    </REASONS>
    <FIELDS>
       <FIELD refname="System.AssignedTo">
         <COPY from="currentuser" />
       </FIELD>
    </FIELDS>
  </TRANSITION>
  <TRANSITION from="Unapproved" to="Active">    <REASONS>      <DEFAULTREASON value="Approved" />    </REASONS>  </TRANSITION>  <TRANSITION from="Active" to="Closed">
    <REASONS>
      <DEFAULTREASON value="Completed" />
      <REASON value="Deferred" />
      <REASON value="Obsolete" />
      <REASON value="Cut" />
    </REASONS>
...

Dans la barre d'outils, cliquez sur Enregistrer pour enregistrer les modifications apportées au fichier XML.
Pour importer le nouveau type d'élément de travail dans un projet unique, consultez Comment : importer un type d'élément de travail dans un projet existant. Pour ajouter le type d'élément de travail à votre modèle de processus, consultez Types d'éléments de travail.

Pour vérifier les modifications importées dans un projet unique

Dans Team Explorer, cliquez sur Actualiser pour télécharger les mises à jour les plus récentes à partir du serveur.

Ces mises à jour comprennent les modifications que vous venez d'importer. Attendez quelques secondes jusqu'à ce que le nœud Éléments de travail soit chargé. Les nœuds encore en cours de chargement affichent le mot en cours.
Créez un élément de travail à l'aide du type d'élément de travail que vous avez modifié. Pour ce faire, cliquez avec le bouton droit sur le nœud Éléments de travail, pointez sur Ajouter un élément de travail, puis cliquez sur le type d'élément de travail.

Cet élément de travail est créé à partir du type d'élément de travail que vous avez modifié et importé.
Remarquez que l'État initial a désormais la valeur Non autorisé et que la Raison a la valeur Nouveau. En outre, la valeur Assigné à est attribuée à votre nom du compte. Cliquez sur le champ Raison pour afficher une zone de liste qui répertorie les raisons New et Ported.
Complétez le champ Titre, puis cliquez sur Enregistrer pour enregistrer l'élément de travail. Attendez la fin de l'opération d'enregistrement, tel qu'indiqué par Éléments enregistrés dans la barre d'état.
Dans le champ État, sélectionnez la valeur Actif pour approuver l'élément de travail et lui appliquer une autre transition. Remarquez que le champ Raison a la valeur Approuvé.
Dans la barre d'outils, cliquez sur Enregistrer pour enregistrer cette transition.
Cliquez sur Fermer pour fermer l'élément de travail.

Voir aussi

Concepts

États, transitions et raisons

Sécurité des transitions

Définition de la portée des règles des champs par État, Transition ou Raison

Autres ressources

Automatisation des transitions d'état

Partager via