Modifier ou ajouter un type d'élément de travail personnalisé (WIT)

Article
06/10/2015

En tant qu'administrateur de projet, vous pouvez souhaiter modifier un type d'élément de travail (WIT) existant pour prendre en charge des spécifications de suivi ou des processus de flux de travail supplémentaires. Les raisons les plus courantes qui amènent à modifier un type d'élément de travail (WIT) sont l'ajout ou la modification de l'ensemble des champs ou des règles de champ, la modification du flux de travail ou la personnalisation du formulaire d'élément de travail. Ces trois raisons correspondent aux trois sections principales du fichier de définition XML du type d'élément de travail (WIT) : FIELDS, WORKFLOW et FORM.

Toutes ces modifications nécessitent que vous modifiiez la définition WIT, ce que vous ne pouvez faire pour les déploiements sur site de TFS. Cette rubrique fournit une vue d'ensemble des éléments que vous pouvez personnaliser, ainsi que des pointeurs vers le contenu qui vous montre comment procéder.

Types d'éléments de travail, personnaliser

Ajouter ou modifier un champ, une règle de champ, une étiquette ou du texte vide

Vous ajoutez des champs et des règles de champ dans la section FIELDS. Pour que le champ apparaisse dans le formulaire d'élément de travail, vous devez également l'ajouter à la section FORM de la définition WIT.

Par exemple, pour ajouter un ID d'élément de travail, spécifiez la syntaxe XML suivante dans la section FORM.

<Control FieldName="System.ID" Type="FieldControl" Label="ID" LabelPosition="Left" />

Pour en savoir plus sur la définition des champs, consultez Ajouter ou modifier un champ pour prendre en charge les requêtes, les rapports et le flux de travail.

Modifier les états, raisons et transitions des flux de travail, ou ajouter des règles de champ de flux de travail

Les sections STATES et REASONS dans le WORKFLOW spécifient les valeurs de liste de choix des champs État et Raison. Elles permettent de suivre l'état des éléments de travail. La section TRANSITIONS spécifie les transitions valides entre les états, comme le montre l'illustration suivante. Vous spécifiez des transitions vers l'avant et des transitions régressives.

Exemple de diagramme d'état de flux de travail

États du flux de travail du récit utilisateur, modèle de processus Agile

Vous modifiez le flux de travail pour atteindre les objectifs suivants :

Ajouter ou supprimer un état, une raison ou une transition.
Spécifier une valeur de champ à appliquer lors d'une modification d'état, de raison ou de transition.
Spécifier une ACTION personnalisée pour automatiser certaines assignations de champ en fonction d'une modification d'état, de raison ou de transition.

Lorsque vous personnalisez le flux de travail, suivez ces deux étapes :

Modifier le flux de travail ou la définition du WIT.
Modifier la configuration de processus pour mapper les nouveaux états de flux de travail sur les méta-états.

Cette seconde étape est nécessaire dans les circonstances suivantes :
- Quand vous modifiez le flux de travail pour un type d'élément de travail qui apparaît dans une page de l'outil de planification Agile. Ces types d'éléments de travail (WIT) appartiennent aux catégories de spécification ou de tâche. Pour en savoir plus sur la configuration de ces outils, consultez Configurer et personnaliser les outils de planification Agile pour un projet d'équipe.
- Quand vous modifiez le flux de travail du plan de test ou de la suite de tests et que vous utilisez un client Test Manager fourni avec Visual Studio 2013.2 ou versions antérieures. Ces types d'éléments de travail sont devenus disponibles quand vous avez mis à jour votre serveur de couche Application vers TFS 2013.3. qui apparaît dans une page de l'outil de planification Agile.
  
  Si vous rencontrez une erreur L'application a rencontré une erreur inattendue quand vous vous connectez à votre projet d'équipe après avoir modifié le flux de travail, vous pouvez y remédier en mappant les états du nouveau flux de travail aux méta-états. Pour corriger cette erreur, consultez Importer et exporter la configuration de processus [witadmin].

Règles de champ de flux de travail

Vous pouvez appliquer des règles de champ lorsque vous changez d'état ou spécifiez une raison, ou pendant une transition de flux de travail.

Par exemple, en ajoutant la règle EMPTY lorsque l'état a la valeur Actif, vous pouvez assigner automatiquement la valeur Null aux champs Date de fermeture et Fermé par, et les rendre accessibles en lecture seule. Cette règle est utile lorsque vous devez réactiver un élément de travail à partir d'un état fermé.

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

Appliquez des règles de champ de flux de travail pour accomplir les actions suivantes :

Qualifier la valeur qu'un champ peut avoir en spécifiant CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY et REQUIRED.
Copier une valeur dans un champ en utilisant COPY, DEFAULT et SERVERDEFAULT.
Limiter les personnes autorisées à modifier un champ.
Appliquer les critères spéciaux sur un champ de type string (chaîne) avec MATCH.
Appliquer de façon conditionnelle les règles basées sur les valeurs d'autres champs avec WHEN, WHENNOT, WHENCHANGED et WHENNOTCHANGED.
Limiter les règles pour qu'elles s'appliquent à des groupes ou à des utilisateurs spécifiques. La plupart des règles prennent en charge les attributs for ou not pour mettre l'accent sur les personnes auxquelles la règle s'applique et sur celles auxquelles elle ne s'applique pas.

Pour plus d'informations sur l'application des règles de champs de flux de travail, consultez Élément FIELD (Workflow).

Personnaliser le formulaire d'élément de travail

L'illustration suivante met en évidence les éléments les plus courants sur les formulaires d'élément de travail. Vous pouvez les personnaliser tous à l'exception de la zone de titre et des contrôles de formulaire.

Éléments et contrôles du formulaire Élément de travail

Vous pouvez personnaliser un formulaire de WIT pour atteindre les objectifs suivants :

Ajoutez ou supprimez un champ, modifiez une étiquette de champ ou modifiez le placement d'un champ sur le formulaire. Pour plus d'informations, consultez Spécifier des contrôles de formulaire d'élément de travail.
Ajoutez de nouveaux onglets ou de nouvelles colonnes, ou déplacez des groupes de champs d'un onglet à un autre. Consultez Concevoir le formulaire d'élément de travail.
Ajoutez du texte informatif pour aider au remplissage du formulaire, des liens hypertexte vers le guide complet du processus, ou incorporez du texte HTML ou des rapports dynamiques. Consultez Fournir du texte d'aide, des liens hypertexte ou du contenu Web sur un formulaire d'élément de travail.
Spécifiez les onglets qui restreignent les types de liens ou les WIT qui peuvent être liés à un élément de travail. Consultez Définir des contrôles de liens pour restreindre les relations de liens.
Ajoutez un contrôle de pièce jointe pour prendre en charge l'ajout de fichiers joints. Consultez Ajouter le contrôle Pièces jointes.

Modifier la définition du WIT

Pour modifier la définition WIT, exportez, modifiez, puis importez le fichier de définition WIT.

Traiter un objet WIT à des fins de personnalisation

Avec witadmin, vous pouvez importer et exporter des fichiers de définition. Il existe d'autres outils que vous pouvez utiliser pour modifier la syntaxe XML d'un objet, parmi lesquels l'éditeur de processus, disponible avec le téléchargement de TFS Power Tools, ou TFS Team Project Manager, un projet de ressource communautaire disponible sur CodePlex.

Si vous ne disposez pas des autorisations d'administration pour votre projet d'équipe, demandez-les.
Ouvrez une fenêtre d'invite de commandes à l'emplacement où Visual Studio ou Team Explorer est installé, puis entrez :
```
cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE
```
Sur une édition 64 bits de Windows, remplacez %programfiles% par %programfiles(x86)%. Accédez à cette page web pour télécharger Team Explorer gratuitement.
Exportez le fichier de définition du WIT où vous souhaitez modifier ou ajouter un champ. Spécifiez le nom du WIT ainsi qu'un nom pour le fichier.
```
witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"
```
Un exemple de CollectionURL est http://MonServeur:8080/tfs/NomCollectionProjetÉquipe.
Modifiez le fichier. Pour plus d'informations, consultez Suivi des éléments de travail : index des définitions d'éléments XML.

Importez le fichier de définition du WIT.

witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

Ouvrez TWA ou Team Explorer pour afficher les modifications. Si le client est déjà ouvert, actualisez la page.

Dans Team Explorer, sélectionnez le bouton Actualiser.

Les mises à jour les plus récentes sont téléchargées à partir du serveur, notamment les modifications que vous venez d'importer. Attendez quelques secondes que l'actualisation opère.

Pour plus d'informations sur l'utilisation de witadmin, consultez Importer, exporter et gérer des types d'éléments de travail [witadmin].

Q et R

Q : comment utiliser les balises ?

R : pour apprendre à ajouter des balises et filtrer des listes, cliquez ici.

Q : Quelles personnalisations puis-je effectuer tout en continuant à utiliser l'Assistant Configurer les fonctionnalités pour mettre à jour mon projet d'équipe après une mise à niveau TFS ?

R : vous pouvez ajouter des types d'éléments de travail et modifier la disposition du formulaire. L'Assistant Configurer les fonctionnalités mettra à jour vos projets d'équipe et vous aurez accès aux fonctionnalités les plus récentes.

La modification du flux de travail ou l'affectation d'un nouveau nom au type d'élément de travail nécessite que vous effectuiez certaines opérations manuelles lors de la mise à jour de votre projet d'équipe. Pour en savoir plus sur d'autres personnalisations que vous pouvez effectuer et celles à éviter, consultez Personnaliser l'expérience de suivi du travail : avant d'effectuer la personnalisation, comprendre les implications en matière de maintenance et de mise à jour.

Q : comment ajouter un nouveau type d'élément de travail (WIT) ?

R : la façon la plus facile d'ajouter un nouveau type d'élément de travail (WIT) consiste à en copier un qui existe déjà, puis à modifier le fichier de définition. Pour obtenir un exemple, consultez Créer un type d'élément de travail.

Q : puis-je renommer un type d'élément de travail (WIT) ?

R : oui. Pour renommer un WIT existant, utilisez witadmin renamewitd. Par exemple, vous pouvez renommer un WIT nommé « Élément QoS » en « Accord de service ».

witadmin renamewitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"QoS Item" /new:"Service Agreement"

Lorsque vous renommez un WIT qui appartient à une catégorie, vous devez mettre à jour la définition des catégories du projet d'équipe afin de refléter le nouveau nom. En particulier, les outils de planification Agile ne fonctionnent pas tant que vous n'avez pas mis à jour la définition des catégories.

Pour plus d’informations, consultez Importer, exporter et gérer des types d'éléments de travail [witadmin] et Importer et exporter des catégories [witadmin].

Q : comment désactiver un WIT ?Comment puis-je restreindre la possibilité des utilisateurs de créer des éléments de travail d'un certain type ?

A : si vous souhaitez supprimer un WIT tout en conservant les éléments de travail créés sur ce type, vous pouvez ajouter une règle qui empêche tous les utilisateurs valides d'enregistrer ce type d'élément de travail.

<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
   </FIELDS>
</TRANSITION>

Si vous souhaitez limiter la création d'un WIT spécifique par un groupe d'utilisateurs, il existe deux façons de restreindre son accès :

Ajoutez le type d'élément de travail (WIT) au groupe des catégories masquées pour empêcher la plupart des collaborateurs de les créer. Si vous souhaitez autoriser un groupe d'utilisateurs à y accéder, vous pouvez créer un lien hypertexte vers un modèle qui ouvre le formulaire d'élément de travail et partager ce lien avec les membres de l'équipe que vous souhaitez.
Ajoutez une règle de champ au flux de travail pour le champ System.CreatedBy afin d'empêcher de manière effective un groupe d'utilisateurs de créer un élément de travail d'un type spécifique. Comme le montre l'exemple suivant, l'utilisateur qui crée l'élément de travail doit appartenir à Allowed Group pour enregistrer l'élément de travail.
```
<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />
     </FIELD>
   </FIELDS>
</TRANSITION> 
```

Q : comment supprimer un type d'élément de travail (WIT) ?

R : pour empêcher les membres de l'équipe d'utiliser un type d'élément de travail (WIT) spécifique afin de créer un élément de travail, vous pouvez le supprimer du projet d'équipe. Lorsque vous utilisez witadmin destroywitd, vous supprimez définitivement tous les éléments de travail créés à l'aide du WIT, ainsi que le WIT lui-même. Par exemple, si votre équipe n'utilise pas « Obstacle », vous pouvez supprimer le WIT intitulé « Obstacle » du projet de site web Fabrikam.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

Lorsque vous supprimez un WIT qui appartient à une catégorie, vous devez mettre à jour la définition des catégories du projet d'équipe afin de refléter le nouveau nom. En particulier, les outils de planification Agile ne fonctionnent pas tant que vous n'avez pas mis à jour la définition des catégories.

Pour plus d’informations, consultez Importer, exporter et gérer des types d'éléments de travail [witadmin] et Importer et exporter des catégories [witadmin].

Q : puis-je modifier la couleur associée à un type d'élément de travail (WIT) ?

R : oui. Dans Team Web Access, les éléments de travail apparaissent dans les résultats de la requête et sur les pages du Backlog et du tableau des outils de planification Agile. Pour modifier la couleur associée à un WIT existant ou ajouter la couleur à utiliser pour un nouveau WIT, modifiez la configuration de processus.

Attributions de couleurs à différents types d'éléments de travail

Q : puis-je ajouter ou supprimer un WIT du Backlog ou du tableau de tâches ?

R : oui. Les outils de planification Agile (Backlog de produit, Backlog des sprints et pages du tableau de tâches) affichent certains WIT particuliers en fonction du modèle de processus utilisé pour créer votre projet d'équipe. Vous pouvez ajouter ou supprimer des WIT qui apparaissent sur ces pages. Par exemple, si votre projet d'équipe utilise des WIT Scrum, les éléments du Backlog de produit et les bogues s'affichent dans les pages du Backlog. Toutefois, si votre projet d'équipe a été créé à l'aide d'Agile, CMMI ou tout autre modèle de processus, les bogues ne s'affichent pas dans votre Backlog ou votre tableau de tâches.

Par exemple, vous pouvez ajouter des bogues à partir de la page du Backlog de produit.

Panneau mis à jour avec l'ajout d'un type d'élément de travail Bogue

Pour découvrir comment ajouter ou supprimer des WIT du Backlog ou du tableau de tâches, rendez-vous ici. Pour ajouter un nouveau WIT afin de prendre en charge un Backlog de portefeuille, cliquez ici.

Q : lorsque je modifie un WIT, comment cela affecte-t-il les éléments de travail existants ?

R : le tableau suivant récapitule les effets sur les éléments de travail lorsque vous modifiez des champs ou des définitions WIT.

Action	Effet sur les éléments de travail
Supprimer des champs d'un WIT	Les données des champs supprimés restent dans le magasin de données. Toutefois, aucune nouvelle donnée ne peut être ajoutée, car vous les avez supprimées de la définition WIT.
Renommer un champ	Les données des champs renommés restent dans le magasin de données sous le nouveau nom convivial.
Supprimer des champs	Les données des champs supprimés sont supprimées du magasin de données.
Renommer un WIT	Toutes les données restent intactes sous le nouveau nom.
Supprimer un WIT	Toutes les données des éléments de travail créés à partir du WIT supprimé sont définitivement supprimées sans possibilité de récupération.

Si vous souhaitez supprimer complètement les champs du magasin de données, utilisez l'outil en ligne de commande witadmin deletefield. Consultez Gérer des champs d'éléments de travail (witadmin).

Q : comment modifier le type d'un élément de travail existant ?

A : vous ne pouvez pas modifier le type d'un élément de travail existant, mais vous pouvez copier l'élément de travail et lui spécifier un nouveau type. Par exemple, vous pouvez copier un élément existant du Backlog de produit modifier son type en bogue, comme indiqué dans l'illustration suivante.

Copiez un élément de travail et spécifiez un nouveau type

En outre, si vous avez plusieurs éléments de travail dont vous souhaitez modifier le type, vous pouvez les exporter à l'aide d'Excel, puis les ajouter comme nouveau type.

Q : puis-je supprimer des éléments de travail de TFS ?

R : oui. Utilisez witadmin destroywi pour supprimer définitivement des éléments de travail de la base de données.

Q : que dois-je savoir sur la personnalisation des WIT et les mises à niveau de TFS ?

R : Consultez Mettre à jour un projet d'équipe mis à niveau pour accéder à de nouvelles fonctionnalités.

Q : où m'adresser si j'ai d'autres questions ?

R : Pour trouver des réponses ou poser une question, visitez le forum : Team Foundation Server - Gestion de projet et élément de travail.

Pour plus d'informations, consultez Spécifier des contrôles de formulaire d'élément de travail.

Utilisez Process Editor, disponible lors du téléchargement des outils Power Tools de TFS, pour modifier le flux de travail ou pour afficher un diagramme d'état du flux de travail.

Partager via