Modification du flux de travail d'un type d'élément de travail

Article
08/10/2011

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 effectuer cette procédure, vous devez être membre du groupe Team Foundation Administrators ou 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 witadmin exportwitd pour exporter le fichier XML du type d'élément de travail que vous souhaitez modifier. Pour plus d'informations, consultez Personnalisation et gestion des types d'éléments de travail (witadmin).
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.

Notes

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 éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous avez des droits d'accès. Pour plus d'informations sur la virtualisation du Registre, consultez les pages suivantes sur le site Web Microsoft : Virtualisation du Registre (page éventuellement en anglais) et Problèmes de virtualisation de fichiers communs et du Registre dans Windows Vista.
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 est indiqué en surbrillance dans l'exemple suivant :

<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 qui apparaît en surbrillance dans l'exemple suivant.

Notes

À cause de cette modification, tous les nouveaux éléments de travail de ce genre 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 ouvrante en insérant le code XML suivant, en surbrillance dans l'exemple suivant. 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 qui apparaît en surbrillance dans l'exemple suivant. 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>
...
```
Notes

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 Mode d'évaluation des règles.

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 seul projet, consultez Personnalisation et gestion des types d'éléments de travail (witadmin). Pour ajouter le type d'élément de travail à votre modèle de processus, consultez Ajouter des définitions de type pour des éléments de travail à un modèle de processus.

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 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

Conception du workflow

Restriction des transitions d'état

Quand et où appliquer une règle de champ

Autres ressources

Automatisation des assignations des champs par état, transition ou raison

Partager via