Informe Indicadores de calidad de la compilación

El informe Indicadores de calidad de la compilación muestra la cobertura de pruebas, la renovación de código y el número de errores para una definición de compilación especificada.Puede utilizar este informe como ayuda para determinar la medida en que la calidad de las partes del código se aproxima a la calidad de versión de lanzamiento.

Idealmente, las tasas de pruebas, los errores y la renovación de código producirían la misma imagen, pero con frecuencia no lo hacen.Cuando encuentre una diferencia, puede utilizar el informe Indicadores de calidad de la compilación para examinar los detalles de una compilación y una serie de datos concretas.Dado que este informe combina los resultados de pruebas, la cobertura de código de las pruebas, la renovación de código y los errores, podrá ver muchas perspectivas a la vez.

Para obtener información sobre cómo obtener acceso a los informes y cómo actualizarlos o administrarlos, vea Informes (Agile).

[!NOTA]

Este informe requiere que la colección de proyectos de equipo que contiene el proyecto de equipo se haya proporcionado con SQL Server Reporting Services.Este informe no está disponible si  Informes no aparece al abrir Team Explorer y expandir el nodo del proyecto de equipo.

En este tema Datos del informe Cambiar el número de compilaciones en el informe Interpretar el informe Filtrar el informe

Este informe se puede usar para responder a las siguientes preguntas: ¿Cuál es la calidad del software? ¿Con qué frecuencia se superan las pruebas y con qué frecuencia se prueba el código? Sobre la base del código y las métricas de pruebas, ¿es probable que el equipo cumpla los objetivos de destino?

Permisos necesarios

Para ver el informe, debe tener asignado (o pertenecer a un grupo que tenga asignado) el rol Explorador en Reporting Services.Para obtener más información, vea Agregar usuarios a proyectos de equipo o Administrar permisos.

Datos del informe

Los datos que aparecen en el informe Indicadores de calidad de la compilación se derivan del almacén de datos.El eje X muestra las compilaciones concretas que incluye el informe, sobre la base de los filtros establecidos para la plataforma, la configuración y la definición de compilación.

Cada barra vertical representa un conjunto de datos derivados de una o más compilaciones.En la variante de tamaño de código del informe, la longitud de cada barra vertical representa el tamaño de la base de código protegida.Las barras se escalan de modo que la figura más grande se ajuste al alto del gráfico.Las pruebas manuales se pueden ejecutar en cualquier momento después de la compilación y están asociadas a esa compilación.Las pruebas que no se han ejecutado todavía se cuentan como "no concluyentes".

La siguiente ilustración muestra un ejemplo de informe Indicadores de calidad de la compilación.

En la siguiente tabla se describe la información que aparece para cada indicador de calidad del informe:

Indicador de calidad	Descripción
Errores activos (número)	Gráfico de líneas que representa el número de errores que estaban activos en el momento de la compilación. Nota Los errores no están asociados explícitamente a compilaciones.Algunos de los errores que se enumeran podrían no afectar a las compilaciones que aparecen en el gráfico.Puede utilizar el parámetro Área para filtrar los errores por área de producto.Esta técnica podría mostrar errores que probablemente afecten a las compilaciones del informe.
Renovación de código (líneas)	Gráfico de líneas que describe el número de líneas de código que el equipo agregó, quitó y modificó en las protecciones antes de la compilación.La renovación de código se calcula determinando el número de líneas de código que se han agregado, eliminado o modificado en la compilación dividido por el número total de líneas de la compilación.
Cobertura de código (porcentaje)	Gráfico de líneas que representa el porcentaje de código que cubren las pruebas.
Pruebas no concluyentes	Parte gris del gráfico de barras apiladas, que indica el número de pruebas que no tuvieron un resultado correcto o se pusieron en pausa.Si la compilación no tuvo un resultado correcto, las pruebas no se cuentan o se cuentan como no concluyentes.
Pruebas no superadas	Parte roja del gráfico de barras apiladas, que indica el número de pruebas no superadas para la compilación.
Pruebas superadas	Parte verde del gráfico de barras apiladas, que indica el número de pruebas superadas para la compilación.

[!NOTA]

Para obtener más información sobre el significado de los resultados de prueba superada o no superada, vea Informe de progreso del plan de pruebas.

Puede filtrar el informe de las siguientes formas:

• Cambie el intervalo del eje X especificando el número de compilaciones y especificando la fecha de finalización para el informe.La fecha de la primera compilación mostrada dependerá de la frecuencia de las compilaciones.

• Filtre el conjunto de compilaciones que muestra el informe especificando la plataforma, la configuración y la definición de compilación que se van a incluir en el informe.Establezca los parámetros en esa secuencia porque el conjunto de valores disponibles para la definición de compilación depende de la plataforma y de la configuración.

• Filtre los errores que se enumeran en el informe especificando las áreas de producto que se van a incluir.Este filtro no afecta al conjunto de compilaciones que aparecen en el eje X, la renovación de código, la cobertura de código o los resultados de pruebas.

Para obtener más información, vea Filtrado del informe más adelante en este tema.

Actividades necesarias de administración de pruebas y compilaciones

Para que el informe Indicadores de calidad de la compilación sea útil y represente todos los indicadores de calidad que puede mostrar, los miembros del equipo deben realizar las siguientes actividades para administrar pruebas y compilaciones:

• Configurar un sistema de compilación.Para utilizar Team Foundation Build, debe configurar un sistema de compilación.

  Para obtener más información, vea Configuring Your Build System.

• Crear definiciones de compilación.Puede crear varias definiciones de compilación, de modo que cada una de ellas pueda ejecutarse para generar código para una plataforma diferente.Asimismo, puede ejecutar cada compilación para una configuración diferente.

  Para obtener más información, vea Definir el proceso de compilación.

• Definir las pruebas que se ejecutarán automáticamente como parte de la compilación.Como parte de la definición de compilación, puede definir las pruebas que se ejecutarán como parte de la compilación o que generarán un error si no se superan las pruebas.

  Para obtener más información, vea Definir un proceso de compilación basado en la plantilla predeterminada.

• Configurar las pruebas para recopilar datos de cobertura de código.Para que los datos de cobertura de código aparezcan en el informe, los miembros del equipo deben instrumentar las pruebas para recopilar esos datos.

  Para obtener más información, vea La configuración de la cobertura de código mediante la configuración de prueba está desusada y How to: Gather Code-Coverage Data with Generic Tests.

• Ejecutar compilaciones con regularidad.Puede ejecutar compilaciones a intervalos establecidos o después de cada protección.Puede crear compilaciones periódicas cuando utilice el desencadenador de programación.

  Para obtener más información, vea Crear una definición de compilación y Ejecutar, supervisar y administrar compilaciones.

  [!NOTA]

  Aunque un miembro del equipo puede valorar manualmente una compilación utilizando Build Explorer, esta valoración no se refleja en el informe Indicadores de calidad de la compilación.La valoración de las compilaciones aparece en el informe Resumen de la compilación.Para obtener más información, vea Valorar la calidad de una compilación completada e Informe Resumen de la compilación.

Cambiar el número de compilaciones en el informe

La presentación del informe Indicadores de calidad de la compilación variará significativamente en función del número de compilaciones que incluya el informe y de otros filtros que aplique al informe.Puede centrar el informe en un intervalo concreto de compilaciones cambiando el número de compilaciones que aparecen en el informe.

Para establecer el número de compilaciones que se representan en el informe

1. En Número de compilaciones, escriba el número que desea incluir.

2. Junto a Fin (Fecha), haga clic en el icono de calendario y, a continuación, haga clic en la fecha que corresponde al último día que se ejecutaron las compilaciones que desea incluir en el informe.

3. Haga clic en Ver informe.

Interpretar el informe

Puede revisar el informe para buscar respuestas a estas preguntas para cualquier definición de compilación concreta:

• ¿Cuál es la calidad del software?

• ¿Está el equipo probando suficiente código?

• ¿Se están superando las pruebas?

• ¿Es probable que el equipo termine en función del código y las métricas de pruebas?

• ¿Con qué frecuencia se superan las pruebas y con qué frecuencia se prueba el código?

  [!NOTA]

  La proporción de segmentos coloreados respecto a grises refleja la fracción del código que cubren las pruebas, pero las proporciones dentro de los segmentos coloreados solo reflejan aproximadamente las fracciones de código que superan o no las pruebas.Esta ambigüedad se debe a que la fracción de verde dentro del segmento coloreado representa realmente el número de pruebas que se superan.Un solo error en una parte del código puede hacer que muchas pruebas no se superen, o un único error puede representar un error importante en el diseño que tenga consecuencias en toda la base de código.

Versión positiva de informe

Un informe Indicadores de calidad de la compilación positivo muestra los siguientes indicadores:

• La mayoría de las pruebas se superan (áreas grandes de color verde) y pocas pruebas no se superan (cantidades pequeñas de color rojo).

• El porcentaje de color rojo es inferior al 20-30 por ciento.

Como muestra la siguiente ilustración, las tasas de cobertura de código y de pruebas superadas son altas y aumentan con el tiempo.El número de renovaciones de código, errores activos, pruebas no concluyentes y pruebas no superadas es bajo y está reduciéndose.

Versiones negativas del informe Indicadores de calidad de la compilación

Una versión negativa del informe Indicadores de calidad de la compilación mostrará uno o más de los siguientes indicadores.Quizá desee investigar la causa según la siguiente orientación.

• Menos cobertura de código y más renovación de código.La siguiente ilustración muestra una disminución en la cobertura de código y un aumento en la renovación de código.Estos datos son una advertencia clara de que el nuevo código se protege sin las correspondientes pruebas unitarias que lo cubran.

  

• Baja tasa de pruebas en ejecución.La siguiente ilustración muestra una tasa baja de pruebas en ejecución.Estos datos podrían indicar que el equipo no está realizando suficientes pruebas.Este bloqueo podría indicar falta de recursos o que los evaluadores estén haciendo otras tareas, como escribir la automatización de pruebas en lugar de probar la funcionalidad actual.En cualquier caso, podría estar justificado equilibrar los recursos.

  

• Alta renovación de código, baja tasa de cobertura de código.La renovación de código alta sugiere que los errores se introducirán como efectos secundarios de los cambios.En un proyecto perfectamente refactorizado, se puede ver la existencia de renovación de código sin cambios en la cobertura de código ni en las tasas de superación de pruebas.De lo contrario, una alta renovación de código podría indicar una cobertura reducida y la necesidad de reescribir pruebas.

  La siguiente ilustración muestra una alta tasa de renovación de código y una baja tasa de cobertura de código de las pruebas, aunque las tasas de superación de pruebas sigan siendo altas.Estos datos indican que las pruebas que se están ejecutando no están ejercitando el nuevo código.

  

• Tasa alta de pruebas no superadas.La siguiente ilustración muestra que muchas pruebas se realizan con una cobertura de código razonable, pero que no se están superando las pruebas.Estos datos podrían indicar prácticas de desarrollo poco rigurosas o, en iteraciones tempranas, que las pruebas son demasiado duras para esta etapa del producto.

  

  Las pruebas no superadas deben solucionarse lo antes posible.Si corregir el código no es práctico, las pruebas no superadas deben deshabilitarse temporalmente y debe registrarse un error.Aunque a veces es aceptable tratar los errores del análisis de código con menos urgencia en las etapas tempranas del proyecto, no se debe permitir que las secciones de color rojo aumenten demasiado.

• Alta tasa de pruebas que se superan y alta tasa de errores activos.La siguiente ilustración muestra una alta tasa de pruebas superadas pero, no obstante, una alta tasa de errores de entrada.Esta situación se puede producir por varias razones.Es posible que las pruebas no sean suficientemente rigurosas para esta etapa del producto.

  

  En iteraciones tempranas las pruebas simples son buenas pero, cuando el producto madura, las pruebas deben ejercitar integraciones y escenarios más amplios.Es posible que las pruebas estén obsoletas o que no se esté probando la funcionalidad apropiada.Podría ser el momento de cambiar las técnicas de prueba.

• Tasa creciente de superación de pruebas sin aumento en la cobertura de código.Habitualmente, cuantas más pruebas se realizan, se debe cubrir más código.Por otro lado, si la ejecución de pruebas y las tasas de superación de pruebas aumentan sin un aumento correspondiente en la cobertura de código, es posible que las pruebas incrementales sean redundantes.

• El número de errores activos aumenta, pero las pruebas no superadas no aumentan.Si el número de errores activos está aumentando y las pruebas no están mostrando los errores correspondientes, es probable que las pruebas no estén probando la misma funcionalidad que indican los errores.

• El número de errores activos está disminuyendo, pero las pruebas superadas no aumentan.Si el número de errores activos está disminuyendo y las tasas de pruebas superadas no aumentan, quizá haya riesgo de que aumente la tasa de reactivación.

• Áreas grandes de color gris.Los segmentos de color gris significan que el código no se compiló o no se probó dentro de la compilación dada.Estos datos solo aparecen en un informe periódico donde una o más compilaciones especificadas no se produjeron dentro del período.

Filtrar el informe

Puede filtrar el informe Indicadores de calidad de la compilación de las siguientes maneras:

• Cambie el intervalo de tiempo especificando el número de compilaciones y la fecha de finalización para el informe.

• Filtre el conjunto de compilaciones representadas en el informe especificando la plataforma, la configuración y la definición de compilación que se incluirán en el informe.

  [!NOTA]

  Puede configurar las definiciones de compilación para que no se ejecuten pruebas, se ejecuten algunas o se ejecuten todas.El informe tendrá grandes variaciones en función de la configuración de las definiciones de compilación.

• Filtre los errores que se enumeran en el informe especificando las áreas de producto que se van a incluir.

En la siguiente ilustración se muestran los filtros disponibles:

Aplique los filtros en la secuencia que se especifica en el procedimiento siguiente.Las opciones que están disponibles con algunos filtros dependen de los filtros establecidos previamente.

Para filtrar las compilaciones que aparecen en el informe

1. En Número de compilaciones, escriba el número que desea incluir.

2. Junto a Fecha de finalización, haga clic en el icono de calendario y, a continuación, haga clic en la última fecha para incluir compilaciones.

3. En la lista Plataforma, active la casilla de cada una de las plataformas que se van a incluir.

4. En la lista Configuración, active la casilla de cada una de las configuraciones que se van a incluir.

5. En la lista Definición de compilación, active la casilla de cada una de las definiciones de compilación que se van a incluir.

6. Haga clic en Ver informe.

Para filtrar los números de errores que se muestran en el informe

1. En la lista Área, active la casilla de cada resultado de la prueba que desee incluir.

   Este paso filtra el informe basándose en la jerarquía de los resultados de pruebas.

2. Haga clic en Ver informe.

Vea también

Conceptos

Informe de progreso del plan de pruebas

Informe de compilaciones correctas

Informe Resumen de la compilación

Artefactos (Agile)

Otros recursos

Informes (Agile)