tcm: esecuzione di test da un piano di test tramite l'utilità della riga di comando

È possibile eseguire i test automatizzati appartenenti a un piano di test dalla riga di comando.Ciò consente di avviare un'esecuzione dei test utilizzando un file batch, in modo che sia possibile pianificare un'esecuzione.È inoltre possibile gestire le esecuzioni dei test dalla riga di comando.Se si desidera esportare un'esecuzione dei test in modo che uno sviluppatore possa visualizzare i risultati del test utilizzando Visual Studio, tale operazione può essere eseguita utilizzando il comando tcm.È inoltre possibile pubblicare i risultati delle esecuzioni dei test da un file di esecuzione dei test (estensione trx) di Visual Studio tramite tcm.È possibile specificare quali risultati di questo file di esecuzione dei test si desidera pubblicare nuovamente nel piano di test.È possibile utilizzare i seguenti comandi tcm per eseguire queste attività:

• tcm run /create

• tcm run /list

• tcm run /execute

• tcm run /abort

• tcm run /delete

• tcm run /export

• tcm run /publish

tcm.exe si trova in <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE in un qualsiasi computer che disponga di Visual Studio Ultimate, Visual Studio Premium, o Visual Studio Test Professional installato.

Per ulteriori informazioni su come importare i test automatizzati all'interno del progetto di test e configurare il piano di test per l'esecuzione di tali test, vedere Create Test Cases from an Assembly of Automated Tests e Procedura: eseguire test automatizzati dalla riga di comando utilizzando Tcm.

tcm run /create /title:title /planid: id /collection:CollectionURL /teamproject:project (suiteid:id /configid:configid | /querytext: query) [/settingsname:name] [/owner:owner] [/builddir:directory]  [/testenvironment:name] [/login:username,[password]] [/include]

tcm run /execute /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /list [/planid:id | /querytext: query] /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /abort /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /delete /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]] [/noprompt]

tcm run /export /id:id /resultsfile:path /collection:CollectionURL /teamproject:project [/login:username,[password]] [/attachment:attachmentname]

tcm run /publish /suiteid:id /configid:id /resultowner:owner /resultsfile:path /collection:CollectionURL /teamproject:project    [/title: runtitle] [/runowner:owner] [/build:buildnumber /builddefinition:builddefinition] [/flavor:flavor [/platform:platform]  [/assignfailurestouser:user] [/login:username,[password]] [/buildverification]

Parametri

Parametro	Descrizione
/collection:CollectionURL	Specifica l'URI 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:project	Nome del progetto team contenente il piano di test nel quale si desidera importare i test automatizzati.
/title: title	Specifica il titolo che si desidera utilizzare per l'esecuzione che si crea oppure se si pubblica un file di esecuzione dei test.
/planid:id	Specifica il piano che contiene i test che si desidera eseguire o il piano associato alle esecuzioni dei test che si desidera elencare.
/suiteid:id	Specifica i gruppi di test che si desidera eseguire. Può inoltre specificare il gruppo di test da utilizzare quando si pubblica un'esecuzione dei test. Nota Per trovare l'ID gruppo, è possibile elencare i gruppi di test per un piano di test.Per ulteriori informazioni, vedere tcm: elenco di piani di test, gruppi di test, configurazioni di test e ambienti. Suggerimento Per eseguire più di una suite di test, è possibile utilizzare il parametro /querytext.
/configid:configid	Specifica la configurazione del test che si desidera eseguire per i gruppi di test. Può inoltre specificare la configurazione di test da utilizzare quando si pubblica un'esecuzione dei test. Suggerimento Per eseguire più di una configurazione di test, è possibile utilizzare il parametro /querytext.
/querytext:query	Specifica la query da utilizzare per restituire le esecuzioni dei test oppure la query da utilizzare per selezionare i test che si desidera eseguire. Suggerimento È possibile utilizzare il parametro /querytest per l'esecuzione di più di una suite di test.Ad esempio:querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)”
/settingsname:name	Opzionale.Specifica le impostazioni test che si desidera utilizzare per questa esecuzione dei test.Se non si selezionano impostazioni di test con questo parametro, vengono utilizzate le impostazioni di test predefinite per test automatizzati nel piano di test.
/owner:owner	Opzionale.Specifica il proprietario dell'esecuzione dei test.
/runowner:owner	Opzionale.Specifica il proprietario dell'esecuzione dei test.
/builddir:directory	Opzionale.Specifica la directory di compilazione da utilizzare per individuare gli assembly di test per il test automatizzato.Se non specificato, viene utilizzato il percorso di compilazione a seconda della compilazione assegnata attualmente al piano di test.
/testenvironment:name	Opzionale.Specifica l'ambiente di test che si desidera utilizzare per questa esecuzione dei test.Se non si seleziona un ambiente di test con questo parametro, viene utilizzato l'ambiente di test predefinito per test automatizzati nel piano di test.
/id:id	Specifica l'ID esecuzione che si desidera eliminare, interrompere o esportare.
/resultsfile:path	Specifica il percorso per utilizzare per esportare un'esecuzione dei test o per trovare l'esecuzione dei test per pubblicarla.Ad esempio, "c:\temp\ResultsForDeveloper.trx".
/attachment:attachmentname	Specifica il nome dell'allegato per un'esecuzione dei test esportata.
/resultowner:owner	Specifica il proprietario per i risultati del test.
/build:buildnumber	Opzionale.Specifica il numero di build da utilizzare per pubblicare un'esecuzione dei test.Questo parametro deve essere utilizzato con /builddefinition.
/builddefinition:builddefinition	Opzionale.Specifica la definizione di compilazione da utilizzare per pubblicare un'esecuzione dei test.Questo parametro deve essere utilizzato con /build.
/flavor:flavor	Opzionale.Specifica la versione della build.Ad esempio, Release.Questo parametro può essere utilizzato solo se si utilizza il parametro /build.
/platform:platform	Opzionale.Specifica la piattaforma di compilazione.Ad esempio, x86.Questo parametro può essere utilizzato solo se si utilizza il parametro /build.
/assignfailurestouser:user	Opzionale.Specifica a chi assegnare eventuali test non superati nel un piano di test.
/buildverification	Opzionale.Specifica che questa esecuzione dei test contiene test di verifica della compilazione che consentono di controllare la funzionalità di base della compilazione.
/include	Opzionale.Specifica l'inclusione di tutti i test selezionati per l'esecuzione dei test, anche se i test attualmente non sono impostati sullo stato attivo.
/noprompt	Opzionale.Specifica che all'utente non viene richiesto di confermare l'eliminazione di un'esecuzione dei test.
/login:username,[password]	Opzionale.Specifica il nome e la password di un utente collegato al server a livello applicazione di Team Foundation Server e che dispone delle autorizzazioni per eseguire il comando.Questa opzione deve essere utilizzata se le credenziali di Windows non includono le autorizzazioni appropriate, se si utilizza l'autenticazione di base o se non si è connessi a un dominio.

È possibile aggiungere parametri per /collection e /teamproject al file XML tcm.exe.config che si trova nella stessa directory di tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE.Se si aggiungono questi al file, non è necessario immetterli nella riga di comando ogni volta che si esegue un comando tcm.È possibile aggiungere queste chiavi e i relativi valori al file, come segue, nella sezione appSettings:

    <appSettings>
         <add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
         <add key ="TeamProject" value="DinnerNow"/>
    </appSettings>

Esecuzione di test e gestione delle esecuzioni dei test

Negli esempi seguenti si presuppone che sia stato avviato un prompt dei comandi di Visual Studio.

A tale scopo, fare clic su Start, scegliere Tutti i programmi, Microsoft Visual Studio 2012, Visual Studio Tools, quindi Prompt dei comandi sviluppatore.

Il prompt dei comandi viene aperto sulla cartella: <drive>:\Program Files\Microsoft Visual Studio 11.0\VC

Andare nella cartella contenente l'assembly compilato dal progetto di test.

Importante

Per eseguire i test automatizzati dalla riga di comando tramite tcm.exe, è necessario che i test case siano associati ai test automatizzati.È inoltre necessario configurare correttamente il piano di test all'utilizzo di una compilazione per individuare i test automatizzati da eseguire se nella riga di comando non vengono specificate le informazioni sulla compilazione.Per ulteriori informazioni su tale procedura, vedere Procedura: creare test case da un assembly di test automatizzati utilizzando tcm.exe.

Per ottenere gli ID necessari per i comandi seguenti, potrebbe essere necessario utilizzare tcm per elencare gli elementi del test e i relativi ID.Per ulteriori informazioni su come eseguire questa operazione, vedere tcm: elenco di piani di test, gruppi di test, configurazioni di test e ambienti e Procedura: eseguire test automatizzati dalla riga di comando utilizzando Tcm.

Il seguente comando consente di eseguire i test utilizzando una query del punto di test:

tcm run /create /title:"Nightly Run" /planid:1 /querytext:"SELECT * FROM TestPoint WHERE ConfigurationId=13" /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

Il seguente comando consente di eseguire i test utilizzando un gruppo di test e una configurazione di test specifici:

tcm run /create /title:"Nightly Run" /planid:1 /suiteid:5 /configid:13 /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

Il seguente comando consente di eseguire i test utilizzando un ID specifico:

Tcm run /execute /id:1207 /collection:<CollectionURL> /teamproject:<Team Project name>

Il seguente comando consente di elencare le esecuzioni di test per un piano di test specifico:

tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>

Il comando seguente consente di eliminare un'esecuzione dei test specifica:

tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>

Il comando seguente consente di esportare un'esecuzione dei test in un file con estensione trx:

tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>

Mediante il comando seguente viene pubblicata un'esecuzione dei test per un gruppo di test e una configurazione di test specifici e viene riassegnato il proprietario.In tal modo i punti di test esistenti per i test case nel gruppo di test accoppiato a questa configurazione vengono aggiornati in base ai risultati del file con estensione trx:

tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>

Vedere anche

Riferimenti

tcm: elenco di piani di test, gruppi di test, configurazioni di test e ambienti

Altre risorse

tcm: importazione ed esecuzione di test automatizzati per un piano di test dalla riga di comando