Condividi tramite

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

  • Articolo

È possibile eseguire i test automatizzati che fanno parte di un piano di test dalla riga di comando. Ciò consente di avviare un'esecuzione dei test usando un file batch, in modo che sia possibile pianificare un'esecuzione. È inoltre possibile gestire le esecuzioni dei test dalla riga di comando. Per esportare un'esecuzione dei test per permettere allo sviluppatore di visualizzare i risultati dei test tramite Visual Studio, usare 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 usare 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 su cui sia installata un'istanza di Visual Studio Ultimate, Visual Studio Premium o Visual Studio Test Professional.

Per altre informazioni su come importare test automatizzati nel progetto di test e configurare il piano di test per eseguire i test, vedere Creare i test case da un assembly di test automatizzati e Eseguire test automatizzati dalla riga di comando con 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 dell'insieme di progetti team. Il formato dell'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeRaccolta

Se non viene usata alcuna directory virtuale, il formato dell'URI sarà il seguente:

http://NomeServer:Porta/NomeRaccolta

/teamproject:project

Nome del progetto team contenente il piano di test nel quale si vuole importare i test automatizzati.

/title: title

Specifica il titolo che si desidera usare 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 da eseguire o il piano associato alle esecuzioni dei test da elencare.

/suiteid:id

Specifica i gruppi di test da eseguire.

Può inoltre specificare il gruppo di test da usare 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 altre informazioni, vedere tcm: elenco di piani di test, gruppi di test, configurazioni di test e ambienti.

Suggerimento

Per eseguire più di un gruppo di test, è possibile usare il parametro /querytext.

/configid:configid

Specifica la configurazione dei test da eseguire per i gruppi di test.

Può inoltre specificare la configurazione dei test da usare quando si pubblica un'esecuzione dei test.

Suggerimento

Per eseguire più di una configurazione dei test, è possibile usare il parametro /querytext.

/querytext:query

Specifica la query da usare per restituire le esecuzioni dei test oppure la query da usare per selezionare i test che si desidera eseguire.

Suggerimento

Per eseguire più di un gruppo di test è possibile usare il parametro /querytext.Ad esempio:

querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)”

/settingsname:name

Parametro facoltativo. Specifica le impostazioni test da usare per questa esecuzione dei test. Se non si selezionano impostazioni di test con questo parametro, vengono usate le impostazioni di test predefinite per test automatizzati nel piano di test.

/owner:owner

Parametro facoltativo. Specifica il proprietario dell'esecuzione dei test.

/runowner:owner

Parametro facoltativo. Specifica il proprietario dell'esecuzione dei test.

/builddir:directory

Parametro facoltativo. Specifica la directory di compilazione da usare per individuare gli assembly di test per il test automatizzato. Se non specificato, viene usato il percorso di compilazione a seconda della compilazione assegnata attualmente al piano di test.

/testenvironment:name

Parametro facoltativo. Specifica l'ambiente di test che si desidera usare per questa esecuzione dei test. Se non si seleziona un ambiente di test con questo parametro, viene usato 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 da usare per esportare un'esecuzione dei test o per trovare l'esecuzione dei test da pubblicare. 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 dei test.

/build:buildnumber

Parametro facoltativo. Specifica il numero di build da usare per pubblicare un'esecuzione dei test. Questo parametro deve essere usato con /builddefinition.

/builddefinition:builddefinition

Parametro facoltativo. Specifica la definizione di compilazione da usare per pubblicare un'esecuzione dei test. Questo parametro deve essere usato con /build.

/flavor:flavor

Parametro facoltativo. Specifica la versione della build. Ad esempio, Release. Questo parametro può essere usato solo se si utilizza il parametro /build.

/platform:platform

Parametro facoltativo. Specifica la piattaforma di compilazione. Ad esempio, x86. Questo parametro può essere usato solo se si utilizza il parametro /build.

/assignfailurestouser:user

Parametro facoltativo. Specifica a chi assegnare eventuali test non superati nell'esecuzione dei test.

/buildverification

Parametro facoltativo. Specifica che questa esecuzione dei test contiene test di verifica della compilazione che consentono di controllare la funzionalità di base della compilazione.

/include

Parametro 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

Parametro facoltativo. Specifica che all'utente non viene richiesto di confermare l'eliminazione di un'esecuzione dei test.

/login:username,[password]

Parametro 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 usata se le credenziali di Windows non includono le autorizzazioni appropriate, se si usa l'autenticazione di base o se non si è connessi a un dominio.

Per accedere a Visual Studio Online, è anche necessario usare /allowalternatecredentials elencato di seguito.

/allowalternatecredentials

Questo flag deve essere specificato in aggiunta al parametro /login quando si effettua la connessione a Visual Studio Online. Il flag è disponibile solo con Visual Studio 2013 Update 4 o versioni successive.

È 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 al file si aggiungono questi parametri, 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 dei 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, scegliere Start, quindi Tutti i programmi, Microsoft Visual Studio 2012, Strumenti di Visual Studio e infine Prompt dei comandi sviluppatore.

Il prompt dei comandi apre la seguente 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 per l'uso di una compilazione al fine di individuare i test automatizzati da eseguire se nella riga di comando non vengono specificate le informazioni sulla compilazione.Per altre 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 usare tcm per elencare gli elementi del test e i relativi ID. Per altre informazioni su come eseguire questa operazione, vedere tcm: elenco di piani di test, gruppi di test, configurazioni di test e ambienti e Eseguire test automatizzati dalla riga di comando con TCM.

Il seguente comando consente di eseguire i test usando 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 usando 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 usando 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

Uso di TCM per importare ed eseguire test automatizzati per un piano di test dalla riga di comando