Cómo: Ejecutar pruebas unitarias de base de datos desde Team Foundation Build

Actualización: noviembre 2007

Team Foundation Build permite ejecutar las pruebas unitarias de base de datos como parte de una prueba de comprobación de la generación. Puede configurar las pruebas unitarias de base de datos para implementar la base de datos, generar datos de prueba y ejecutar a continuación pruebas seleccionadas. Si no está familiarizado con Team Foundation Build, debe revisar la siguiente información antes de realizar los procedimientos de este tema:

Para poder realizar estos procedimientos, antes debe realizar las siguientes tareas para configurar el entorno de trabajo:

  • Instale Team Foundation Build y Control de versiones de Team Foundation como productos independientes o como parte de Visual Studio Team System. Es probable que tenga que instalar Team Foundation Build y Control de versiones de Team Foundation en equipos diferentes.

  • Instale Team Explorer en el equipo cliente.

  • Conecte una sesión de usuario de Visual Studio a un equipo que ejecute Team Foundation Server. Para obtener más información sobre cómo conectarse a Team Foundation Server, vea Cómo: Conectarse a Team Foundation Server.

Después de configurar el entorno de trabajo, deberá seguir estos pasos en Visual Studio Team System Database:  

  1. Crear un proyecto de base de datos.

  2. Importar o crear el esquema y los objetos del proyecto de base de datos.

  3. Configurar las propiedades del proyecto de base de datos para la generación e implementación.

  4. Crear una o más pruebas unitarias de base de datos.

  5. Agregar la solución que contiene el proyecto de base de datos y el proyecto de prueba unitaria de base de datos al sistema de control de versiones y proteger todos los archivos.

Los procedimientos de este tema describen la manera de crear una definición de compilación para ejecutar las pruebas unitarias de base de datos como parte de una ejecución de prueba automatizada:

  1. Crear una lista de pruebas con las pruebas unitarias de base de datos que desea ejecutar.

  2. Proteger la lista de pruebas.

  3. Crear una definición de compilación, especificando que la lista de pruebas debe ejecutarse como parte de la compilación.

  4. Modificar la definición de compilación para copiar el archivo app.config a la ubicación correcta para Team Foundation Build.

  5. Proteger la definición de compilación actualizada.

  6. Ejecutar la nueva definición de compilación.

Ejecutar las pruebas unitarias de base de datos en un equipo de compilación

Al ejecutar pruebas unitarias de base de datos en un equipo de compilación, es posible que las pruebas unitarias no puedan localizar los archivos de proyecto de base de datos (.dbproj) o los planes de generación de datos (.dgen). Este problema se produce porque el archivo app.config hace referencia a esos archivos utilizando rutas de acceso relativas. Además, podrían producirse errores en las pruebas unitarias de base de datos si no se encuentra la instancia de SQL Server que desea utilizar para ejecutar las pruebas unitarias de base de datos. Este problema puede producirse si las cadenas de conexión que están almacenadas en el archivo app.config no son válidas en el equipo de compilación.

Para solucionar este problema, debe crear un archivo app.config para utilizarlo con Team Foundation Build. En este ejemplo, el archivo se denomina app.TeamBuild.config. En este archivo, debe especificar las rutas de acceso y cadenas de conexión correctas para cuando Team Foundation Build se ejecute en el equipo de la compilación. Puede utilizar un destino posterior a la compilación para copiar este archivo en nombreDeEnsamblado.config. Cuando se copie el archivo, sobrescribirá el archivo .config que contiene los valores que se utilizan cuando los desarrolladores ejecutan las pruebas unitarias en sus equipos de desarrollo locales.

Nota:

Antes de poder generar un proyecto de base de datos, debe configurar la instancia de la base de datos de validación en tiempo de diseño para la cuenta de servicio del equipo en que se ejecuta Team Foundation Build. Puede configurar la instancia ejecutando Visual Studio como la cuenta de servicio del equipo de compilación. Si lo desea, puede utilizar también la línea de comandos siguiente para crear la entrada del Registro necesaria, que reemplaza los marcadores de posición con los nombres de su configuración:

Runas /user:[DOMAIN\nombreUsuarioServicioCompilación] "REG ADD HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\9.0\DBPro\DialogPage\Microsoft.VisualStudio.TeamSystem.Data.DBProject.Settings.DataConnectionOptionsSettings /v nombreServidorSql /d [nombreInstanciaLocal]"

Crear una lista de pruebas

Para crear una lista de pruebas con las pruebas unitarias de base de datos

  1. En la ventana Editor de la lista de pruebas, en la lista Agrupar por, haga clic en Nombre completo de la lista de pruebas para mostrar el panel de la lista de pruebas.

  2. Haga clic con el botón secundario en Listas de pruebas y, a continuación, haga clic en Nueva lista de pruebas.

    Aparecerá el cuadro de diálogo Crear lista de pruebas.

  3. Escriba el nombre de la lista de pruebas que va a contener las pruebas unitarias de base de datos. (Por ejemplo, escriba Pruebas unitarias de base de datos.)

  4. (Opcional) Escriba una descripción de la lista de pruebas unitarias de base de datos y especifique una ubicación en la jerarquía de listas de pruebas para colocar la nueva lista de pruebas.

  5. Haga clic en Aceptar.

    Se crea la lista de pruebas y se muestra en el panel de jerarquía de listas de pruebas.

  6. Haga clic en Todas las pruebas cargadas para mostrar todas las pruebas de su solución.

  7. Arrastre las pruebas que desea ejecutar como pruebas unitarias de base de datos a la lista de pruebas que acaba de crear.

    Nota:

    Para arrastrar más de una prueba cada vez, presione la tecla CTRL y manténgala presionada a la vez que hace clic en cada prueba. Para arrastrar un bloque contiguo de pruebas, haga clic en la primera prueba del bloque y mantenga presionada la tecla MAYÚS a la vez que hace clic en la última prueba del bloque. No utilice las casillas para este propósito.

  8. (Opcional) Para comprobar el contenido de la lista de pruebas, haga clic en ella en el panel de jerarquía de listas de pruebas.

    La lista de pruebas que ha creado, junto con todas las listas de pruebas de su solución, reside en el archivo de metadatos de prueba de la solución. Los archivos de metadatos de prueba tienen la extensión .vsmdi. Para obtener más información, vea Usar listas de pruebas.

Proteger la lista de pruebas

En este procedimiento, protegerá todos los archivos de su solución. Estos archivos incluyen el archivo de prueba de metadatos de la solución, que contiene las listas de pruebas y las pruebas. Siempre que se agrega, elimina, reorganiza o cambia el contenido de las listas de pruebas, o se cambia el contenido de listas, se actualiza automáticamente el archivo de metadatos de la prueba para que se reflejen dichos cambios.

Nota:

Este procedimiento describe los pasos que hay que realizar si se usa Control de versiones de Team Foundation. Si usa un software de control de versiones distinto, deberá seguir los pasos correspondientes a su software.

Para proteger la lista de pruebas

  1. Conéctese a un equipo que ejecute Visual Studio Team System Team Foundation Server. Para obtener más información, vea Cómo: Conectarse a Team Foundation Server.

  2. Si su solución aún no está en el control de código fuente, agréguela al control. Para obtener más información, vea Cómo: Agregar un proyecto o una solución al control de versiones.

  3. Haga clic en Ver y, a continuación, haga clic en Protecciones pendientes para mostrar la ventana Protección pendiente.

  4. Proteja todos los archivos de la solución. Para obtener más información, vea Cómo: Proteger cambios pendientes.

    Nota:

    Si usa Visual Studio Team System, podría tener un proceso de equipo específico para controlar la creación y administración de pruebas automatizadas. Por ejemplo, el proceso podría requerir la comprobación local de la generación, antes de proteger el código junto con las pruebas que se ejecutarán en él.

    Una vez finalizada la operación de protección, aparecerá un icono de candado junto a cada archivo en el Explorador de soluciones para indicar que el archivo está protegido.

    Sus pruebas protegidas están disponibles para la característica Team Foundation Build de Visual Studio Team System. Ahora puede crear una definición de compilación que contenga las pruebas que desea ejecutar.

Crear una definición de compilación

Para crear una definición de compilación

  1. En Team Explorer, haga clic en el proyecto de equipo.

  2. Haga clic con el botón secundario del mouse en Compilaciones y, después, haga clic en Definición de nueva compilación.

    Aparece el cuadro de diálogo Definición de compilación.

  3. Complete las secciones del cuadro de diálogo Definición de compilación. Para obtener más información, vea Cómo: Crear una definición de compilación.

    Nota importante:

    Team Foundation Build utiliza un archivo de proyecto de MSBuild. En las opciones de proyecto de MSBuild, debe seleccionar la casilla Ejecutar prueba y especificar el archivo de metadatos de prueba que contiene la lista de pruebas que creó en Crear lista de pruebas. Por último, debe especificar la lista de pruebas que contiene las pruebas que desea ejecutar.

  4. Cuando haya terminado de proporcionar información en el asistente, haga clic en Finalizar.

    La nueva definición de compilación aparece en la ventana de Team Explorer, bajo la carpeta Compilaciones.

Modificar el proyecto de prueba

De forma predeterminada, Team Foundation Build crea un archivo de configuración a partir del archivo app.config del proyecto cuando genera el proyecto de pruebas unitarias. Las rutas de acceso al plan de generación de datos y al proyecto de base de datos se almacenan como rutas relativas en el archivo app.config. Las rutas de acceso relativas que funcionan en Visual Studio no funcionarán porque Team Foundation Build sitúa los archivos integrados en ubicaciones diferentes que dependen del lugar en el que se ejecuten las pruebas unitarias. Además, el archivo app.config contiene las cadenas de conexión que especifican la base de datos que se va a probar. También necesitará un archivo app.config distinto para Team Foundation Build si las pruebas unitarias deben establecer conexión con una base de datos diferente de la que se utilizó cuando se creó el proyecto de prueba. Cuando realice las modificaciones especificadas en el siguiente procedimiento, podrá configurar el proyecto de prueba y el servidor de compilación para que Team Foundation Build utilice una configuración diferente.

Nota importante:

Debe realizar este procedimiento en cada proyecto de prueba (.vbproj o .vsproj).

Para utilizar un archivo app.config diferente en Team Foundation Build

  1. En Explorador de soluciones, haga clic con el botón secundario del mouse en el archivo de proyecto de prueba (.vbproj o .csproj) que desea modificar y haga clic en Desproteger para editar.

    Aparecerá el cuadro de diálogo Desproteger.

  2. Haga clic en Desproteger.

  3. En el menú Archivo, haga clic en Cerrar solución.

    Debe cerrar la solución porque no se puede modificar el archivo de proyecto mientras la solución que contiene ese archivo de proyecto está abierta.

    Nota:

    También podría descargar el proyecto y cargarlo de nuevo después de modificarlo.

  4. En el menú Archivo, haga clic en Abrir y, a continuación, haga clic en Archivo.

  5. Busque el archivo del proyecto de prueba del paso 1 y haga doble clic en él para abrirlo en el editor.

  6. Desplácese a la parte inferior del archivo y agregue lo siguiente después del elemento que empieza por "<Import Project=" y que importa el archivo .Targets de Visual Basic o Visual C#:

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

  7. En el menú Archivo, haga clic en Guardar nombreDeArchivo.

  8. En el equipo donde se ejecuta Team Foundation Build, vaya a la carpeta %ProgramFiles%\MSBuild\Microsoft\VisualStudio\v9.0\TeamData.

  9. En esa carpeta, cree un archivo llamado Microsoft.VisualStudio.TeamSystem.Data.TeamBuild.Targets con el contenido siguiente:

    <?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:

    Si no llama a su archivo de configuración app.TeamBuild.config, deberá reemplazar el nombre en el código XML.

  10. Copie el archivo app.config de su proyecto de prueba en un archivo denominado app.teambuild.config.

  11. Personalice los valores de las rutas de acceso relativas y las cadenas de conexión en el archivo app.teambuild.config para obtener los valores que desea que se utilicen cuando se ejecuten las pruebas unitarias de base de datos en Team Foundation Build.

Proteger los proyectos de prueba actualizados

Para proteger la definición de compilación actualizada

  • Repita los pasos que siguió en el procedimiento Para proteger la lista de pruebas para proteger los cambios realizados en el archivo de proyecto de prueba (.vbproj, .csproj).

Ejecutar el nuevo tipo de generación

Para ejecutar el nuevo tipo de generación

  1. En el menú Generar, haga clic en Poner en cola compilación {nombreDeProyectoDeEquipo}.

    Aparece el cuadro de diálogo Generar {nombreDeProyectoDeEquipo} con una lista de todos los tipos de generación existentes.

  2. Si es necesario, en Definición de compilación, haga clic en la nueva definición de compilación.

  3. Confirme que los valores de los campos Definición de compilación, Agente de compilación y Carpeta de destino para esta compilación sean correctos y haga clic en Poner en la cola.

    Se mostrará la ficha Puesta en cola de Build Explorer. Para obtener más información, vea Introducción al Explorador de Team Foundation Build.

Vea también

Tareas

Cómo: Organizar las pruebas en listas de pruebas

Cómo: Crear una definición de compilación

Cómo: Implementar cambios con Team Foundation Build

Cómo: Poner en cola o iniciar una definición de compilación

Conceptos

Introducción a la terminología de Database Edition

  • Last updated on