Partager via

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

  • Article

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.

Pour exécuter l'outil de ligne de commande witadmin, 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 12.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, voir Ajouter les définitions de type pour les éléments de travail à un modèle de processus.

Notes

Vous pouvez créer et modifier des types d'éléments de travail à l'aide de Process Editor, un outil puissant dédié à Visual Studio.Cet outil n'est pas pris en charge.Pour plus d'informations, voir la page suivante sur le site web de Microsoft : Team Foundation Server Power Tools.

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.

Notes

Même si vous vous connectez avec des autorisations d'administrateur, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur exécutant Windows Server 2008.Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, choisissez Démarrer, ouvrez le menu contextuel de l'invite de commandes, puis choisissez Exécuter en tant qu'administrateur.Pour plus d'informations, voir le site web de Microsoft : Contrôle de compte d'utilisateur.

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

Paramètre

Description

/collection:CollectionURL

Spécifie l'URI de la collection de projets d'équipe. Le format de l'URI est le suivant : http://NomServeur:Port/NomRépertoireVirtuel/NomCollection

Si aucun répertoire virtuel n'est utilisé, le format de l'URI est le suivant :

http://NomServeur:Port/NomCollection

/p:Project

Projet d'équipe pour lequel les types des éléments de travail doivent être gérés. Ce projet d'équipe doit être défini dans la collection de projets spécifiée par le paramètre /collection.

Le paramètre /p est requis à moins que vous exécutiez la commande importwitd avec l'option /v.

/n:TypeName

Nom du type d'élément de travail à détruire, exporter, importer ou renommer.

/f:FileName

Chemin d'accès et nom de fichier du fichier de définition XML qui contient les types d'élément de travail à exporter ou importer. Si vous omettez ce paramètre lorsque vous utilisez la commande exportwitd, le fichier XML apparaît dans la fenêtre d'invite de commandes.

Notes

Si vous utilisez Windows Vista, vous n'avez peut-être pas l'autorisation d'accéder à certains fichiers.Si vous essayez d'exporter le type d'élément de travail vers un emplacement où vous ne possédez pas d'autorisation, 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 possédez des autorisations. Pour plus d'informations sur la virtualisation du Registre, voir les pages suivantes sur le site web de Microsoft : Virtualisation du Registre et Problèmes de virtualisation de fichiers communs et du Registre dans Windows Vista.

/e:Encodage

Nom d'un .NET Framework 2,0 qui encode le format. Cette commande utilise l'encodage spécifié pour exporter ou importer les données XML. Par exemple, /e:utf-7 spécifie l'encodage Unicode (UTF-7). Si vous omettez ce paramètre, witadmin essaie de détecter l'encodage, et si la détection échoue, witadmin utilise UTF-8.

/exportgloballists

Exporte les définitions des listes globales référencées par le type d'élément de travail. Les définitions pour les listes globales seront incorporées dans le fichier XML de définition de type d'élément de travail. Si elles ne sont pas spécifiées, les définitions pour les listes globales sont omises.

/v

Valide le fichier XML qui définit le type d'élément de travail mais n'importe pas le fichier XML de définition.

Notes

Vous pouvez valider la définition du type sans spécifier de projet d'équipe.Les références aux groupes dont la portée est un projet sont ignorées.

/new:NouveauNom

Nouveau nom du type d'élément de travail.

/noprompt

Désactive la demande de confirmation.

/? ou help

Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes.

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.

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

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