Spécification du type de bogue à consigner dans le Gestionnaire de tests Microsoft

Article
08/10/2011

Vous pouvez activer la création automatique d'un élément de travail lorsqu'un testeur trouve une erreur de code en utilisant Gestionnaire de tests Microsoft. L'outil de ligne de commande tcm bugfieldmapping prend en charge l'importation et l'exportation d'un fichier de mappage au projet d'équipe. Le fichier de mappage définit le type d'élément de travail à créer et les trois champs de données à compléter par Gestionnaire de tests Microsoft. Les trois champs concernent des étapes à reproduire, des informations système et le nom de la build dans laquelle l'erreur a été trouvée. Quand un testeur exécute un test et identifie une défaillance, il peut créer un bogue dans lequel les trois champs sont automatiquement complétés.

Notes

Si votre projet d'équipe a été créé avec un modèle de processus basé sur la version MSF (Microsoft Solutions Framework) 5.0, le type d'élément de travail de bogue est déjà activé. Cependant, si vous ajoutez un autre type d'élément de travail à la catégorie de bogue ou que vous travaillez avec un modèle de processus personnalisé, vous devrez peut-être utiliser la commande tcm.

L'outil de ligne de commande tcm se trouve dans Lecteur :\Program Files\Microsoft Visual Studio 10.0\Common7\IDE sur l'ordinateur client qui exécute Team Explorer.

Pour plus d'informations sur les options supplémentaires de l'outil de ligne de commande tcm, consultez tcm : importation et exécution des tests automatisés pour un plan de test à partir de la ligne de commande.

Pour plus d'informations sur le type de bogue d'un élément de travail, consultez Bogue (Agile) ou Bogue (CMMI).

Autorisations requises

Pour le projet d'équipe dans lequel les types d'éléments de travail sont définis, vous devez être membre du groupe de sécurité de Team Foundation Administrators ou du groupe de sécurité de Project Administrators. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Notes

Même si vous vous connectez avec des autorisations d'administration, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Contrôle d'accès utilisateur.

tcm bugfieldmapping /export /mappingfile:path /collection:CollectionURL /teamproject:Project [/login:username,[password]]

tcm bugfieldmapping /import /mappingfile:path /collection:CollectionURL /teamproject:Project [/login:username,[password]]

Paramètres

Paramètre	Description
/export	Spécifie l'exportation du fichier de mappage de champs de bogue. Ce fichier définit le type d'élément de travail à créer lorsqu'une erreur de code est trouvée avec Gestionnaire de tests Microsoft. Il spécifie également les champs d'élément de travail qui seront remplis avec les données définies dans Gestionnaire de tests Microsoft, tel que les étapes de reproduction, les informations système et le build dans lequel l'erreur de code a été trouvée. Pour plus d'informations, consultez Contenu du fichier de mappage de champs de bogue plus loin dans cette rubrique.
/import	Spécifie l'importation du fichier de mappage de champs de bogue.
/mappingfile:Path	Chemin d'accès et nom du fichier de définition XML qui contient les mappages de champs de bogue. Remarque Si vous utilisez Windows Vista, il est possible que vous ne disposiez pas d'autorisations sur certains dossiers.Si vous tentez d'exporter le type d'élément de travail vers un emplacement pour lequel aucune autorisation ne vous est attribuée, 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 disposez d'autorisations.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.
/collection:CollectionURL	Spécifie l'URI (Uniform Resource Identifier) de la collection de projets d'équipe. Le format pour 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
/teamproject:Projet	Spécifie le nom du projet d'équipe pour lequel les mappages de champs de bogue doivent être appliqués. Ce projet d'équipe doit être défini dans la collection de projets d'équipe spécifiée par le paramètre /collection.
/login:UserName,Password	Facultatif. Spécifie le nom et le mot de passe d'un utilisateur qui est connecté au serveur de couche Application pour Team Foundation et qui dispose des autorisations d'exécution de la commande. Utilisez cette option dans les cas suivants : Vos informations d'identification Windows ne disposent pas des autorisations appropriées, vous utilisez l'authentification de base ou vous n'êtes pas sur un domaine.
/? ou help	Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes.

Notes

Le fichier de mappages de champs de bogue fournit à Gestionnaire de tests Microsoft le nom du type d'élément de travail à créer et les champs à compléter pour les éléments de travail qu'il crée.

Vous ne pouvez définir qu'un type d'élément de travail à créer lorsque vous exécutez des tests qui utilisent Gestionnaire de tests Microsoft. Chaque fois que vous exécutez la commande tcm bugfieldmapping import, le type d'élément de travail qui est spécifié par l'élément BugFilerMappings remplace le type d'élément de travail précédemment spécifié. Par exemple, le code suivant indique la création des éléments de travail qui sont basés sur le type nommé AWBug.

<BugFilerMappings workitemtypetocreate="AWBug">

Pour plus d'informations, consultez Comment : envoyer un bogue à l'aide du Gestionnaire de tests Microsoft.

Contenu du fichier de mappage de champs de bogue

La syntaxe XML suivante répertorie le contenu par défaut du fichier de mappages de champs de bogue. Le fichier spécifie le type d'élément de travail à créer et les trois champs d'élément de travail que Gestionnaire de tests Microsoft complète automatiquement, en fonction des données qui ont été trouvées pendant la série de tests. Chacun des trois champs doit être spécifié quand vous importez un fichier de mappage de champs de bogue.

<?xml version="1.0" encoding="utf-16"?>
<BugFilerMappings workitemtypetocreate="Bug">
   <ReproSteps>Microsoft.VSTS.TCM.ReproSteps</ReproSteps>
   <SystemInformation>Microsoft.VSTS.TCM.SystemInfo</SystemInformation>
   <BuildFoundIn>Microsoft.VSTS.Build.FoundIn</BuildFoundIn>
</BugFilerMappings>

Pour plus d'informations sur les champs utilisés pour assurer le suivi des informations trouvées par Gestionnaire de tests Microsoft, consultez Intégration de build et de tests.

Exemples

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

URI pour la collection de projets d'équipe : http://AdventureWorksServer:8080/AWTeam/Collection1
Nom du projet : AdventureWorks
Nom de fichier de mappage de champs de bogue : bugfieldmappings.xml
Emplacement du dossier : "C:\Users\AdminUser\Documents\"

Importation du fichier de mappage de champs de bogue

La commande suivante importe le contenu du fichier bugfieldmappings.xml dans le projet d'équipe AdventureWorks qui est défini dans Collection1 sur le serveur nommé AdventureWorksServer.

tcm bugfieldmapping /import /mappingfile:"C:\Users\AdminUser\Documents\bugfieldmappings.xml" /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /teamproject:AdventureWorks