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 /abort
tcm run /delete
tcm run /export
tcm run /publish
Il file tcm.exe si trova in <Drive:>\Program Files\Microsoft Visual Studio 10.0\Common7\IDE su qualsiasi computer in cui sia installato Visual Studio Ultimate.
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 Creare i test case da un assembly di test automatizzati e Procedura: eseguire test case con automazione dalla riga di comando tramite 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 /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 |
Oggetto di descrizione |
|---|---|
/collection:CollectionURL |
Specifica l'URI dell'insieme 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. Ad esempio, se si desidera eseguire più gruppi di test, è possibile utilizzare la sintassi seguente come parte del comando tcm /suiteid:2 /suiteid:3. Può inoltre specificare il gruppo di test da utilizzare quando si pubblica un'esecuzione dei test. .gif "Nota") 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.
|
/configid:configid |
Specifica le configurazioni di test che si desidera eseguire per i gruppi di test. Ad esempio, se si desidera eseguire più configurazioni di test, è possibile utilizzare la sintassi seguente come parte del comando tcm /configid:2 /configid:3. Può inoltre specificare la configurazione di test da utilizzare quando si pubblica un'esecuzione dei test. |
/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. |
/settingsname:name |
Facoltativo. 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 |
Facoltativo. Specifica il proprietario dell'esecuzione dei test. |
/runowner:owner |
Facoltativo. Specifica il proprietario dell'esecuzione dei test. |
/builddir:directory |
Facoltativo. 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 |
Facoltativo. 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 |
Facoltativo. Specifica il numero di build da utilizzare per pubblicare un'esecuzione dei test. Questo parametro deve essere utilizzato con /builddefinition. |
/builddefinition:builddefinition |
Facoltativo. Specifica la definizione di compilazione da utilizzare per pubblicare un'esecuzione dei test. Questo parametro deve essere utilizzato con /build. |
/flavor:flavor |
Facoltativo. Specifica la versione della build. Ad esempio, Release. Questo parametro può essere utilizzato solo se si utilizza il parametro /build. |
/platform:platform |
Facoltativo. Specifica la piattaforma di compilazione. Ad esempio, x86. Questo parametro può essere utilizzato solo se si utilizza il parametro /build. |
/assignfailurestouser:user |
Facoltativo. Specifica a chi assegnare eventuali test non superati nel un piano di test. |
/buildverification |
Facoltativo. Specifica che questa esecuzione dei test contiene test di verifica della compilazione che consentono di controllare la funzionalità di base della compilazione. |
/include |
Facoltativo. 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 |
Facoltativo. Specifica che all'utente non viene richiesto di confermare l'eliminazione di un'esecuzione dei test. |
/login:username,[password] |
Facoltativo. 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 10.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 2010, Visual Studio Tools, quindi fare clic su Prompt dei comandi di Visual Studio (2010).
Il prompt dei comandi viene aperto sulla cartella: <drive>:\Program Files\Microsoft Visual Studio 10.0\VC
Andare nella cartella contenente l'assembly compilato dal progetto di test.
.gif "Nota importante") 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 questa 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 case con automazione dalla riga di comando tramite 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 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
Altre risorse
tcm: elenco di piani di test, gruppi di test, configurazioni di test e ambienti
tcm: importazione ed esecuzione di test automatizzati per un piano di test dalla riga di comando