Specificare il tipo di bug da registrare mediante Microsoft Test Manager

È possibile abilitare la creazione automatica di un elemento di lavoro quando un tester rileva un errore del codice all'utilizzo di Microsoft Test Manager.Lo strumento da riga di comando tcm bugfieldmapping supporta l'importazione e l'esportazione di un file di mapping nel progetto team.Il file di mapping consente di definire il tipo di elemento di lavoro da creare e i tre campi dati che devono essere riempiti da Microsoft Test Manager.I tre campi corrispondono a passi riproducibili, informazioni sul sistema e la build in cui è stato trovato il difetto.Quando un tester esegue un test e viene rilevato un errore, è possibile creare un bug in cui vengono compilati automaticamente i tre campi.

[!NOTA]

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 del bug o si opera con un modello di processo personalizzato, potrebbe essere necessario utilizzare il comando tcm.

Per accedere allo strumento della riga di comando tcm, aprire una finestra Prompt dei comandi in cui è installato Visual Studio o Team Explorer e immettere:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

In una versione a 64 bit di Windows sostituire %programfiles% con %programfiles(x86)%.

Per ulteriori informazioni sulle opzioni della riga di comando tcm aggiuntive, vedere tcm: importazione ed esecuzione di test automatizzati per un piano di test dalla riga di comando.

Per ulteriori informazioni sul tipo di bug dell'elemento di lavoro, vedere Bug (Scrum), Bug (Agile) o Bug (CMMI).

Autorizzazioni necessarie

Per il progetto team in cui vengono definiti i tipi di elemento di lavoro, è necessario essere un membro del gruppo di sicurezza Team Foundation Administrators o Project Administrators.Per ulteriori informazioni, vedere la classe Autorizzazioni per Team Foundation Server.

[!NOTA]

Anche se si accede con autorizzazioni amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione su un server che esegue Windows Server 2008.Per aprire una finestra del prompt dei comandi con privilegi elevati, fare clic Start, fare clic con il pulsante destro del mouse su Prompt dei comandi, quindi scegliere Esegui come amministratore.Per ulteriori informazioni, vedere questa pagina nel sito Web Microsoft: Controllo dell'account utente.

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

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

Parametri

Parametro	Descrizione
/export	Consente di specificare l'esportazione del file di mapping dei campi relativi ai bug.Questo file consente di definire il tipo di elemento di lavoro da creare quando viene rilevato un errore del codice mediante Microsoft Test Manager.Consente inoltre di specificare i campi dell'elemento di lavoro che verranno popolati con i dati definiti in Microsoft Test Manager, quali i passaggi di ripetizione, le informazioni sul sistema e la compilazione in cui è stato rilevato l'errore di codice.Per ulteriori informazioni, vedere Contenuto del file di mapping dei campi relativi ai bug più avanti in questo argomento.
/import	Consente di specificare l'importazione del file di mapping dei campi relativi ai bug.
/mappingfile:Path	Il percorso e il nome file del file di definizione XML contenente il mapping dei campi relativi ai bug. Nota Se si utilizza Windows Vista, è possibile che non si disponga delle autorizzazioni per alcune cartelle.Se si tenta di esportare il tipo di elemento di lavoro in una posizione per la quale non si dispone di autorizzazioni, la tecnologia di virtualizzazione del Registro di sistema reindirizzerà automaticamente il file esportato e lo salverà nell'archivio virtuale.Per evitare il reindirizzamento, è possibile esportare il file in un percorso per il quale si dispone di autorizzazioni.Per ulteriori informazioni sulla virtualizzazione del registro di sistema, vedere le pagine seguenti nel sito Web Microsoft: Registry Virtualization e Problemi comuni di virtualizzazione di file e del Registro di sistema in Windows Vista.
/collection:CollectionURL	Consente di specificare l'URI (Uniform Resource Identifier) della raccolta di progetti team.Il formato dell'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme Se non viene utilizzata alcuna directory virtuale, il formato dell'URI sarà il seguente: http://NomeServer:Porta/NomeInsieme
/teamproject:Progetto	Consente di specificare il nome del progetto team per cui è necessario applicare il mapping dei campi relativi ai bug.Questo progetto team deve essere definito nella raccolta di progetti team specificato dal parametro /collection.
/login:UserName,Password	Opzionale.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 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

Il file di mapping dei campi relativi ai bug consente di fornire Microsoft Test Manager con il nome del tipo di elemento di lavoro da creare e i campi da riempire per gli elementi di lavoro creati.

È possibile definire solo un tipo di elemento di lavoro da creare quando si eseguono test che utilizzano Microsoft Test Manager.Ogni volta che viene eseguito il comando tcm bugfieldmapping import, il tipo di elemento di lavoro specificato dall'elemento BugFilerMappings sostituisce qualsiasi tipo di elemento di lavoro specificato in precedenza.Ad esempio, nel codice seguente viene indicata la creazione degli elementi di lavoro basati sul tipo denominato AWBug.

<BugFilerMappings workitemtypetocreate="AWBug">

Per ulteriori informazioni, vedere Procedura: inviare un bug tramite Microsoft Test Manager.

Contenuto del file di mapping dei campi relativi ai bug

Nella sintassi XML seguente viene elencato il contenuto predefinito del file di mapping dei campi relativi ai bug.Nel file viene specificato il tipo di elemento di lavoro da creare e i tre campi dell'elemento di lavoro che verranno automaticamente riempiti da Microsoft Test Manager, sulla base dei dati rilevati durante l'esecuzione dei test.Quando si importa un file di mapping dei 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 ulteriori informazioni sui campi che tengono traccia delle informazioni rilevate da Microsoft Test Manager, vedere Riferimento ai campi Integrare test e compilare.

Esempi

Se non diversamente specificato, i valori seguenti vengono applicati in ogni esempio:

• URI per la raccolta di progetti team: http://AdventureWorksServer:8080/tfs/Collection1

• Nome del progetto: AdventureWorks

• Nome file di mapping dei campi relativi ai bug: bugfieldmappings.xml

• Percorso cartella: "C:\Utenti\UtenteAdmin\Documenti\"

Importare il file di mapping dei campi relativi ai bug

Il contenuto del file bugfieldmappings.xml viene importato dal seguente comando nel progetto team AdventureWorks definito in Collection1 nel server denominato AdventureWorksServer.

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

Vedere anche

Attività

Procedura: inviare un bug tramite Microsoft Test Manager

Concetti

Personalizzare modelli di processo

Procedura: eseguire test automatizzati dalla riga di comando utilizzando Tcm

Altre risorse

Utilizzo degli strumenti della riga di comando di Team Foundation Server