Importer, exporter et gérer des types d'éléments de travail [witadmin]

Vous pouvez gérer des types d'éléments de travail pour un projet d'équipe à l'aide des commandes witadmin suivantes :

• destroywitd :  détruit un type d'élément de travail et détruit définitivement chaque élément de travail de ce type, sans récupération possible.

• exportwitd:  exporte la définition d'un type d'élément de travail vers un fichier XML ou vers la fenêtre d'invite de commandes.

• importwitd :  importe des types d'élément de travail à partir d'un fichier de définition XML vers un projet d'équipe situé sur un serveur qui exécute Team Foundation Server. Si un type d'élément de travail du même nom existe déjà, la nouvelle définition de type d'élément de travail remplace la définition existante. Si le type d'élément de travail n'existe pas, cette commande crée un nouveau type d'élément de travail. Pour valider le fichier XML qui définit un type d'élément de travail, sans importer ce fichier, utilisez l'option /v.

• listwitd:  affiche les noms des types d'élément de travail du projet spécifié dans la fenêtre d'invite de commandes.

• renamewitd:  modifie le nom complet d'un type d'élément de travail dans un projet spécifique. Après l'exécution de cette commande, les éléments de travail de ce type indiquent le nouveau nom.

L'outil en ligne de commande witadmin ne fonctionne que quand vous l'exécutez sur un serveur TFS local. Pour exécuter l'outil, ouvrez une fenêtre d'invite de commandes à l'endroit où Visual Studio ou Team Explorer est installé et entrez :

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

Sur une édition 32 bits de Windows, remplacez %programfiles(x86)% par %programfiles%.

Pour plus d'informations sur les types d'élément de travail, consultez Ajouter les définitions de type pour les éléments de travail à un modèle de processus.

Spécifications

Pour le projet d'équipe pour lequel les types d'élément de travail sont définis, vous devez disposer des autorisations suivantes :

• Pour exporter ou répertorier les types d'élément de travail, vous devez être membre du groupe Project Administrators ou votre autorisation Afficher les informations au niveau du projet doit avoir la valeur Autoriser.

• Pour détruire, importer ou renommer des types d'élément de travail, vous devez être membre du groupe de sécurité Team Foundation Administrators ou Project Administrators.

Pour plus d'informations, consultez Référence des autorisations pour Team Foundation Server.

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

Paramètres

Notes

Lorsque vous utilisez la commande destroywitd, elle détruit tous les objets suivants :

• le type d'élément de travail ;

• tous les éléments de travail de ce type ;

• les entrées correspondantes dans les tables d'éléments de travail, les tables de texte long et les tables de liens ;

• les objets dans le cache de métadonnées de type d'élément de travail.

Exemples

Sauf spécification contraire, les valeurs suivantes s'appliquent dans chaque exemple :

• URI pour la collection de projets d'équipe : http://AdventureWorksServer:8080/tfs/DefaultCollection

• Nom du projet : AdventureWorks

• Nom du fichier d'entrée ou de sortie : myworkitems.xml

• Nom de type d'élément de travail : myworkitem

• Encodage par défaut : UTF-8

Exporter la définition d'un type d'élément de travail (WIT)

La commande suivante exporte la définition pour myworkitem vers le fichier myworkitems.xml.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

L'exemple suivant exporte l'élément de travail en utilisant l'encodage Unicode (UTF-7).

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Exporter la définition d'un WIT et ses listes globales référencées

L'exemple suivant exporte le type d'élément de travail et ses listes globales référencées.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Répertorier la définition d'un WIT

L'exemple suivant affiche la définition du type d'élément de travail dans la fenêtre d'invite de commandes.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Importer la définition des WIT

L'exemple suivant importe la définition de types d'élément de travail à partir du fichier XML.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Valider la définition XML d'un WIT

L'exemple suivant valide le fichier XML qui définit le type d'élément de travail mais n'importe pas la définition.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Q et R

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 les personnalisations que vous pouvez effectuer et celles à éviter, voir 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 puis-je modifier la couleur associée à un type d'élément de travail (WIT) ?

R : Dans Team Web Access, les éléments de travail apparaissent dans les résultats de la requête et sur les pages de 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.

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 et exporter des catégories [witadmin].

Voir aussi

Tâches

Créer un type d'élément de travail

Concepts

Personnaliser les objets de suivi de travail pour prendre en charge les processus de votre équipe

Autres ressources

witAdmin : personnaliser et gérer des objets pour le suivi des éléments de travail