Procedura: eseguire unit test del database da Team Foundation Build

Aggiornamento: novembre 2007

È possibile utilizzare Team Foundation Build per eseguire gli unit test del database come parte di un test di verifica della compilazione. Gli unit test del database possono essere configurati per distribuire il database, generare dati di test e quindi eseguire determinati test. Se non si ha familiarità con Team Foundation Build, consultare le informazioni riportate di seguito prima di eseguire le procedure di questo argomento:

Prima di utilizzare queste procedure, è necessario configurare l'ambiente di lavoro eseguendo le attività seguenti:

Installare Team Foundation Build e Controllo della versione di Team Foundation come prodotti singoli o come parte di Visual Studio Team System. È probabile che sia necessario installare Team Foundation Build e Controllo della versione di Team Foundation in più computer.
Installare Team Explorer nel computer client.
Connettere una sessione utente di Visual Studio a un computer che esegue Team Foundation Server. Per ulteriori informazioni su come connettersi a Team Foundation Server, vedere Procedura: connettersi a Team Foundation Server.

Dopo avere configurato l'ambiente di lavoro, è necessario effettuare le seguenti operazioni in Visual Studio Team System Database Edition:

Creare un progetto di database.
Importare o creare lo schema e gli oggetti per il progetto di database.
Configurare le proprietà del progetto di database per la compilazione e la distribuzione.
Creare uno o più unit test del database.
Aggiungere la soluzione contenente il progetto di database e il progetto di unit test del database al controllo delle versioni, quindi archiviare tutti i file.

Nelle procedure di questo argomento viene descritto come creare una definizione di compilazione per eseguire gli unit test del database durante un'esecuzione automatica di test:

Creare un elenco di unit test del database da eseguire.
Archiviare l'elenco di test.
Creare una definizione di compilazione, specificando che l'elenco di test da eseguire durante la compilazione.
Modificare la definizione di compilazione per copiare il file app.config nel percorso corretto in Team Foundation Build.
Archiviare la definizione di compilazione aggiornata.
Eseguire la nuova definizione di compilazione.

Esecuzione di unit test del database in un computer di compilazione

Quando si eseguono unit test del database in un computer di compilazione, potrebbe non essere possibile trovare i file di progetto del database (dbproj) o i piani di generazione dati (dgen) tramite gli unit test. Questo problema si verifica perché il file app.config fa riferimento a tali file tramite percorsi relativi. Gli unit test del database potrebbero, inoltre, dare esito negativo se non viene trovata l'istanza di SQL Server da utilizzare per eseguire gli unit test del database. Questo problema può verificarsi se le stringhe di connessione archiviate nel file app.config non sono valide dal computer di compilazione.

Per risolvere questi problemi, è necessario creare un file app.config da utilizzare con Team Foundation Build. In questo esempio il file è denominato app.TeamBuild.config. In questo file è necessario specificare le stringhe di connessione e i percorsi corretti per l'esecuzione di Team Foundation Build nel computer di compilazione. È possibile utilizzare una destinazione di post-compilazione per copiare questo file in NomeAssembly.config. Quando il file viene copiato, viene sovrascritto il file config che conteneva i valori utilizzati dagli sviluppatori per eseguire gli unit test nei loro computer di sviluppo locali.

Nota:
Prima di poter compilare un progetto di database, è necessario configurare l'istanza del database di convalida della fase di progettazione per l'account del servizio nel computer in cui viene eseguito Team Foundation Build. È possibile configurare l'istanza eseguendo Visual Studio come account del servizio nel computer di compilazione. In alternativa, è possibile utilizzare la riga di comando riportata di seguito per creare la voce del Registro di sistema necessaria, sostituendo i segnaposto con i nomi per la configurazione: Runas /user:[DOMAIN\NomeUtenteServizioCompilazione] "REG ADD HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\9.0\DBPro\DialogPage\Microsoft.VisualStudio.TeamSystem.Data.DBProject.Settings.DataConnectionOptionsSettings /v NomeSQLServer /d [NomeIstanzaLocale]"

Prima di poter compilare un progetto di database, è necessario configurare l'istanza del database di convalida della fase di progettazione per l'account del servizio nel computer in cui viene eseguito Team Foundation Build. È possibile configurare l'istanza eseguendo Visual Studio come account del servizio nel computer di compilazione. In alternativa, è possibile utilizzare la riga di comando riportata di seguito per creare la voce del Registro di sistema necessaria, sostituendo i segnaposto con i nomi per la configurazione:

Runas /user:[DOMAIN\NomeUtenteServizioCompilazione] "REG ADD HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\9.0\DBPro\DialogPage\Microsoft.VisualStudio.TeamSystem.Data.DBProject.Settings.DataConnectionOptionsSettings /v NomeSQLServer /d [NomeIstanzaLocale]"

Creare un elenco di test

Per creare un elenco di unit test del database

Nell'elenco relativo al raggruppamento, nella finestra Editor elenco dei test fare clic su Nome completo elenco di test per visualizzare il riquadro dell'elenco di test.
Fare clic con il pulsante destro del mouse su Elenco di test, quindi scegliere Nuovo elenco di test.

Verrà visualizzata la finestra di dialogo Crea nuovo elenco test.
Digitare il nome dell'elenco di test che conterrà gli unit test del database. Ad esempio, digitare Unit test del database.
(Facoltativo) Digitare una descrizione dell'elenco di unit test del database e specificare una posizione nella gerarchia dell'elenco di test in cui inserire il nuovo elenco.
Scegliere OK.

L'elenco di test verrà creato e visualizzato nel riquadro relativo agli elenchi di test.
Fare clic su Tutti i test caricati per visualizzare tutti i test disponibili nella soluzione.

Trascinare i test da eseguire come unit test del database nell'elenco di test appena creato.

Nota:
Per trascinare più test alla volta, tenere premuto il tasto CTRL e fare clic su ognuno di essi. Per trascinare un blocco contiguo di test, fare clic sul primo test del blocco, quindi tenere premuto il tasto MAIUSC e fare clic sull'ultimo test del blocco. Non utilizzare le caselle di controllo a questo scopo.

(Facoltativo) Per verificare il contenuto dell'elenco di test, fare clic su di esso nel riquadro relativo agli elenchi di test.

L'elenco di test creato, insieme a tutti gli elenchi di test della soluzione, risiede nel file di metadati di test della soluzione. I file di metadati di test hanno l'estensione vsmdi. Per ulteriori informazioni, vedere Utilizzo di elenchi di test.

Archiviare l'elenco di test

In questa procedura vengono archiviati tutti i file della soluzione, compreso il file di metadati di test, contenente gli elenchi di test e i test. Ogni volta che si aggiunge, elimina, riorganizza o modifica il contenuto degli elenchi di test, il file di metadati di test verrà automaticamente aggiornato per riflettere tali modifiche.

Nota:
In questa procedura vengono descritti i passaggi necessari se si utilizza Controllo della versione di Team Foundation. Se si utilizza un software di controllo delle versioni diverso, è necessario attenersi alla procedura appropriata corrispondente.

Per archiviare l'elenco di test

Connettersi a un computer con Visual Studio Team System Team Foundation Server. Per ulteriori informazioni, vedere Procedura: connettersi a Team Foundation Server.
Aggiungere la soluzione al controllo del codice sorgente, se non è già stata inclusa. Per ulteriori informazioni, vedere Procedura: aggiungere un progetto o una soluzione al controllo della versione.
Fare clic su Visualizza e quindi su Archiviazioni in sospeso per visualizzare la finestra Archiviazioni in sospeso.

Archiviare tutti i file della soluzione. Per ulteriori informazioni, vedere Procedura: archiviare le modifiche in sospeso.

Nota:
Se si utilizza Visual Studio Team System, è possibile avere un processo di team specifico che regola la modalità di creazione e di gestione dei test automatici. Il processo potrebbe ad esempio richiedere di verificare localmente la compilazione prima di archiviare tale codice insieme ai test che verranno eseguiti.

Al termine dell'operazione di archiviazione, accanto a ogni file in Esplora soluzione verrà visualizzata l'icona del lucchetto per indicare che il file è archiviato.

I test archiviati sono disponibili per la funzione Team Foundation Build di Visual Studio Team System. A questo punto è possibile creare una definizione di compilazione contenente i test da eseguire.

Creazione di una definizione di compilazione

Per creare una definizione di compilazione

In Team Explorer fare clic sul progetto Team.
Fare clic con il pulsante destro del mouse su Compilazioni, quindi su Nuova definizione di compilazione.

Viene visualizzata la finestra di dialogo Definizione di compilazione.

Completare le sezioni nella finestra di dialogo Definizione di compilazione. Per ulteriori informazioni, vedere Procedura: creare una definizione di compilazione.

Nota importante:
Team Foundation Build utilizza un file di progetto MSBuild. Nelle opzioni del progetto MSBuild, è necessario selezionare la casella di controllo Esegui test e specificare il file di metadati del test contenente l'elenco dei test creato in Creare un elenco di test. Infine, è necessario specificare l'elenco contenente i test da eseguire.

Dopo aver fornito le informazioni nella procedura guidata, scegliere Fine.

La nuova definizione di compilazione verrà visualizzata nella cartella Compilazioni della finestra Team Explorer.

Modificare il progetto di test

Per impostazione predefinita, in Team Foundation Build viene creato un file di configurazione dal file app.config del progetto quando viene compilato il progetto di unit test. I percorsi del piano di generazione dati e del progetto di database vengono memorizzati come percorsi relativi nel file app.config. I percorsi relativi utilizzabili in Visual Studio non possono essere usati perché in Team Foundation Build i file compilati vengono inseriti in percorsi diversi in relazione alla posizione di esecuzione degli unit test. Nel file app.config sono inoltre contenute le stringhe di connessione che specificano il database da testare. È inoltre necessario disporre di un file app.config separato per Team Foundation Build se gli unit test devono essere connessi a un database diverso rispetto a quello utilizzato al momento della creazione del progetto di test. Apportando le modifiche indicate nella procedura successiva, è possibile impostare il progetto di test e il server di compilazione affinché in Team Foundation Build venga utilizzata una configurazione diversa.

Nota importante:
È necessario attenersi a questa procedura per ogni progetto di test (vbproj o vsproj).

Per utilizzare un file app.config diverso per Team Foundation Build

In Esplora soluzioni fare clic con il pulsante destro del mouse sul file del progetto di test (vbproj o csproj) da modificare, quindi scegliere Estrai per la modifica.

Verrà visualizzata la finestra di dialogo Estrai.
Scegliere Estrai.
Scegliere Chiudi soluzione dal menu File.

È necessario chiudere la soluzione poiché non è possibile modificare il file di progetto se la soluzione che lo contiene è aperta.

Nota:

È inoltre possibile scaricare il progetto e ricaricarlo dopo averlo modificato.
Scegliere Apri dal menu File, quindi scegliere File.
Individuare il file del progetto di test del passaggio 1 e fare doppio clic su di esso per aprirlo nell'editor.

Nota:
È inoltre possibile scaricare il progetto e ricaricarlo dopo averlo modificato.

Scorrere fino alla fine del file e aggiungere quanto segue dopo l'elemento che inizia con "<Import Project=" e che consente l'importazione del file con estensione Targets di Visual Basic o di Visual C#:

<Import Condition="'$(TeamBuildConstants)' != ''" Project="$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v8.0\TeamData\Microsoft.VisualStudio.TeamSystem.Data.TeamBuild.targets"/>
<Target Name="AfterBuild" DependsOnTargets="$(AfterBuildTeamBuildTargets)">
</Target>

Scegliere Salva NomeFile dal menu File.
Nel computer in cui viene eseguito Team Foundation Build, accedere alla cartella %ProgramFiles%\MSBuild\Microsoft\VisualStudio\v9.0\TeamData.

In questa cartella creare un file denominato Microsoft.VisualStudio.TeamSystem.Data.TeamBuild.Targets con il seguente contenuto:

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<PropertyGroup> 
<AfterBuildTeamBuildTargets>RenameTeamBuildConfig</AfterBuildTeamBuildTargets>
</PropertyGroup>
<ItemGroup>
<__TeamBuildConfig Include="$(OutDir)$(TargetFileName).config"/>
</ItemGroup>

<Target Name="RenameTeamBuildConfig">

<CreateItem Include="app.TeamBuild.config">
<Output ItemName="TeamBuildAppConfig" TaskParameter="Include" />
</CreateItem>

<Copy SourceFiles="@(TeamBuildAppConfig)" DestinationFiles="@(__TeamBuildConfig)" />
</Target>

</Project>

Nota:
Se al file di configurazione viene assegnato un nome diverso da app.TeamBuild.config, è necessario sostituire il nome nel codice XML.

Copiare il file app.config per il progetto di test in un file denominato app.teambuild.config.
Personalizzare le impostazioni per i percorsi relativi e le stringhe di connessione nel file app.teambuild.config per includere i valori da utilizzare durante l'esecuzione degli unit test del database in Team Foundation Build.

Archiviare i progetti di test aggiornati

Per archiviare la definizione di compilazione aggiornata

Ripetere i passaggi eseguiti nella procedura Per archiviare l'elenco di test per archiviare le modifiche apportate al file del progetto di test (vbproj, csproj).

Eseguire il nuovo tipo di compilazione

Per eseguire il nuovo tipo di compilazione

Scegliere Accoda compilazione {NomeProgettoTeam} dal menu Compila.

Verrà visualizzata la finestra di dialogo Compila {NomeProgettoTeam} con un elenco di tutti i tipi di compilazione esistenti.
Se necessario, in Definizione di compilazione fare clic sulla nuova definizione di compilazione.
Controllare che i valori dei campi Definizione di compilazione, Agente di compilazione e Cartella di ricezione per la compilazione siano corretti e quindi fare clic su Accoda.

Viene visualizzata la scheda In coda di Build Explorer. Per ulteriori informazioni, vedere la classe Informazioni su Esplora compilazione di Team Foundation.