Personnaliser et gérer l'expérience de test [tcm et Microsoft Test Manager]

Vous pouvez personnaliser trois fonctionnalités prises en charge dans Microsoft Test Manager à l'aide de la commande tcm fieldmapping. Cette commande vous permet de modifier le type de bogue utilisé pour consigner automatiquement les bogues dans le Gestionnaire de tests et de personnaliser le menu déroulant ou les listes de choix pour les états de résolution et les types d'échec.

Pour accéder à l'outil de ligne de commande tcm, 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%.

De plus, vous pouvez utiliser les options de la commande tcm pour importer et exécuter des tests automatisés pour un plan de test.

Spécifications

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. Consultez Définir les autorisations d'administrateur pour les collections de projets d'équipe.

tcm fieldmapping /export /collection:CollectionURL /teamproject:Project /type:resolutiontype|bug|failuretype /mappingfile:path [/login:username,[password]]

tcm fieldmapping /import /collection:CollectionURL /teamproject:Project /type:resolutiontype|bug|failuretype /mappingfile:path [/login:username,[password]]

Paramètres

Paramètre	Description
/export	Spécifie l'exportation du fichier de mappage de champs du type spécifié. Pour plus d'informations sur la syntaxe des types de fichiers pris en charge, consultez la section Notes.
/import	Spécifie l'importation du fichier de mappage de champs.
/mappingfile:Path	Chemin d'accès et nom du fichier de définition XML qui contient les mappages de champs.
/collection:CollectionURL	Spécifie l'URI (Uniform Resource Identifier) de la collection de projets d'équipe. Le format de l'URI est le suivant : http://ServerName:Port/VirtualDirectoryName/CollectionName Si aucun répertoire virtuel n'est utilisé, le format de l'URI est le suivant : http://ServerName:Port/CollectionName
/teamproject:Project	Spécifie le nom du projet d'équipe pour lequel les mappages de champs 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.
/type:resolutiontype | bug | failuretype	Type de fichier à importer ou exporter. Pour plus d'informations sur la structure syntaxique de chaque type de fichier, consultez les bogues, les états de résolution et les types d'échec.
/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

Chaque fois que vous exécutez la commande tcm fieldmapping import, le contenu du fichier de mappage de champs existant est remplacé par le contenu que vous importez.

Fichier de mappage pour le type d'élément de travail Bogue

Lorsque le Gestionnaire de tests crée un bogue, le fichier de mappage définit le type d'élément de travail à créer et remplit trois champs de données : étapes à reproduire, informations système et build dans laquelle l'erreur a été détectée. Quand un testeur exécute un test et identifie une erreur, il peut créer un bogue dans lequel les trois champs sont remplis automatiquement.

Si votre projet d'équipe a été créé avec l'un des modèles de processus par défaut fournis avec Team Foundation Server, le type d'élément de travail Bogue est déjà activé. Cependant, si vous ajoutez un autre type d'élément de travail à la catégorie Bogue ou que vous travaillez avec un modèle de processus personnalisé, vous devrez peut-être utiliser la commande tcm.

Vous ne pouvez définir qu'un type d'élément de travail à créer lorsque vous exécutez des tests qui utilisent le Gestionnaire de tests.

La syntaxe XML suivante répertorie le contenu par défaut du fichier de mappages de champs de bogue. 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 détectées par le Gestionnaire de tests, consultez Référence des champs d'intégration de build et de tests.

Fichier de mappage pour les états de résolution

La syntaxe XML suivante répertorie le contenu par défaut des états de résolution définis pour les modèles de processus par défaut.

<?xml version="1.0" encoding="utf-8"?>
<TestResolutionStates>
    <TestResolutionState name="Needs investigation" />
    <TestResolutionState name="Test issue" />
    <TestResolutionState name="Product issue" />
    <TestResolutionState name="Configuration issue" />
</TestResolutionStates>

Avant de créer un projet d'équipe, vous pouvez personnaliser les états de résolution définis dans le modèle de processus.

Lorsque vous analysez les tests qui ont échoué, vous assignez le type d'échec et l'état de résolution.

Fichier de mappage pour les types d'échec

La syntaxe XML suivante répertorie les types d'échec par défaut définis pour un projet d'équipe.

<?xml version="1.0" encoding="utf-16"?>
<TestFailureTypes>
  <TestFailureType name="Regression" />
  <TestFailureType name="New Issue" />
  <TestFailureType name="Known Issue" />
  <TestFailureType name="Unknown" />
</TestFailureTypes> 

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

• Nom du projet : AdventureWorks

• Nom de fichier de mappage de champs de bogue : bugfieldmappings.xml

• Emplacement du dossier : "C:\Users\AdminUser\Documents\"

Importer le 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 fieldmapping /import /type:bug /mappingfile:"C:\Users\AdminUser\Documents\bugfieldmappings.xml" /collection:http://AdventureWorksServer:8080/tfs/Collection1 /teamproject:AdventureWorks 

Voir aussi

Concepts

Utilisation de TCM à partir de la ligne de commande

Autres ressources

Outils de ligne de commande pour TFS