Personalizzare e gestire l'esperienza di test [tcm e Microsoft Test Manager]
È possibile personalizzare tre delle funzionalità supportate in Microsoft Test Manager usando il comando tcm fieldmapping. Con questo comando è possibile modificare il tipo di bug utilizzato per segnalare automaticamente i bug in Test Manager e di personalizzare il menu a discesa o gli elenchi di selezione per gli stati di risoluzione e i tipi di errore.
Lo strumento da riga di comando tcm funziona solo se viene eseguito in un'istanza locale di Team Foundation Server. Per eseguire lo strumento, aprire una finestra del prompt dei comandi in cui è installato Visual Studio o Team Explorer e digitare:
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
In una versione a 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%.
È inoltre possibile utilizzare le opzioni del comando tcm per importare ed eseguire test automatizzati per un piano di test.
Requisiti
Per il progetto team in cui sono definiti i tipi di elemento di lavoro, è necessario essere un membro del gruppo di sicurezza Team Foundation Administrators o Project Administrators. Vedere Impostare autorizzazioni di amministratore per raccolte di progetti team.
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]]
Parametri
Parametro |
Descrizione |
---|---|
/export |
Specifica l'esportazione del file di mapping campi del tipo specificato. Per la sintassi dei tipi di file supportati, vedere la sezione Osservazioni. |
/import |
Specifica l'importazione del file di mapping campi. |
/mappingfile:Path |
Percorso e nome file del file di definizione XML contenente il mapping dei campi. |
/collection:CollectionURL |
Specifica l'URI (Uniform Resource Identifier) della raccolta di progetti team. Il formato dell'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeRaccolta Se non viene utilizzata alcuna directory virtuale, il formato dell'URI sarà il seguente: http://NomeServer:Porta/NomeRaccolta |
/teamproject: Project |
Specifica il nome del progetto team per il quale è necessario applicare il mapping dei campi. Questo progetto team deve essere definito nella raccolta di progetti team specificata dal parametro /collection. |
/type:resolutiontype | bug | failuretype |
Tipo di file da importare o esportare. Per la struttura di sintassi di ogni tipo di file, vedere bug, stati di risoluzione e tipi di errore. |
/login: UserName,Password |
Parametro facoltativo. Specifica il nome e la password di un utente collegato al server a livello applicazione di Team Foundation e che dispone delle autorizzazioni per eseguire il comando. Utilizzare questa opzione quando le credenziali di Windows utilizzate non dispongono delle autorizzazioni appropriate, quando si utilizza l'autenticazione di base o quando non si è in un dominio. |
/? o help |
Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi. |
Note
Ogni volta che si esegue il comando tcm fieldmapping import, il contenuto del file di mapping campi esistente viene sostituito con il contenuto importato.
File di mapping per il tipo di elemento di lavoro bug
Quando in Test Manager viene creato un bug, il file di mapping definisce il tipo di elemento di lavoro da creare e compila tre campi dati: passi riproducibili, informazioni di sistema e compilazione in cui è stato trovato il problema. Quando un tester esegue un test e trova un difetto, può creare un bug nel quale i tre campi vengono riempiti automaticamente.
Se il progetto team è stato creato con uno dei modelli di processo predefiniti forniti con Team Foundation Server, il tipo di elemento di lavoro bug è già abilitato. Tuttavia, se si aggiunge un altro tipo di elemento di lavoro alla categoria bug o si utilizza un modello di processo personalizzato, potrebbe essere necessario utilizzare il comando tcm.
È possibile definire solo un tipo di elemento di lavoro da creare quando si eseguono test che utilizzano Test Manager.
Nella sintassi XML seguente viene elencato il contenuto predefinito del file di mapping campi relativi ai bug. Quando si importa un file di mapping campi relativi ai bug, è necessario specificare tutti e tre i campi.
<?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>
Per altre informazioni sui campi usati per tenere traccia delle informazioni trovate da Test Manager, vedere Riferimento ai campi Integrare test e compilare.
File di mapping per gli stati di risoluzione
Nella sintassi XML che segue sono elencati i contenuti predefiniti degli stati di risoluzione definiti per i modelli di processo predefiniti.
<?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>
Prima di creare un progetto team, è possibile personalizzare gli stati di risoluzione definiti nel modello di processo.
Quando si analizzano i test non superati, si assegnano il tipo di errore e lo stato di risoluzione.
File di mapping per i tipi di errore
Nella sintassi XML che segue sono elencati i tipi di errore predefiniti definiti per un progetto team.
<?xml version="1.0" encoding="utf-16"?>
<TestFailureTypes>
<TestFailureType name="Regression" />
<TestFailureType name="New Issue" />
<TestFailureType name="Known Issue" />
<TestFailureType name="Unknown" />
</TestFailureTypes>
Esempi
Se non diversamente specificato, in ciascun esempio vengono applicati i valori seguenti:
URI per la raccolta di progetti team: http://AdventureWorksServer:8080/tfs/Collection1
Nome progetto: AdventureWorks
Nome file di mapping campi relativi ai bug: bugfieldmappings.xml
Percorso cartella: "C:\Utenti\UtenteAdmin\Documenti\"
Importare il file di mapping campi relativi ai bug
Il contenuto del file bugfieldmappings.xml viene importato mediante il seguente comando nel progetto team AdventureWorks definito in Collection1 nel server denominato AdventureWorksServer.
tcm fieldmapping /import /type:bug /mappingfile:"C:\Users\AdminUser\Documents\bugfieldmappings.xml" /collection:http://AdventureWorksServer:8080/tfs/Collection1 /teamproject:AdventureWorks
Vedere anche
Concetti
Uso di TCM dalla riga di comando