Résumé de la build, rapport

Le Résumé de la build liste les builds et fournit des informations sur les résultats des tests, la couverture des tests, l'évolution du code et les notes de qualité pour chaque build.

Pour plus d'informations sur l'accès aux rapports, leur actualisation ou leur gestion, consultez Rapports (Agile).

[!REMARQUE]

Ce rapport nécessite la configuration préalable avec SQL Server Reporting Services de la collection de projets d'équipe qui contient votre projet d'équipe.Ce rapport n'est pas disponible si  Rapports ne s'affiche pas lorsque vous ouvrez Team Explorer et développez le nœud de votre projet d'équipe.

Dans cette rubrique Données du rapport Définition de la durée de l'itération Interprétation du rapport Filtrage du rapport

Vous pouvez utiliser ce rapport pour répondre aux questions suivantes : Quel est l'état de toutes les builds dans le temps ? Quelles sont les builds qui ont réussi ? Quelles sont les builds qui ont un nombre significatif de modifications dans le code ? Quelle quantité de code a été exécutée par les tests ? Quelles sont les builds prêtes à être installées ?

Autorisations requises

Pour afficher le rapport, vous devez avoir été affecté ou appartenir à un groupe auquel a été attribué le rôle Explorateur dans Reporting Services.Pour plus d'informations, consultez Ajouter des utilisateurs aux projets d'équipe ou Gestion des autorisations.

Données du rapport

Les données qui s'affichent dans le rapport Résumé de la build proviennent de l'entrepôt de données.Le rapport affiche une présentation visuelle du pourcentage des tests réussis, du code testé et des modifications apportées au code sur plusieurs builds.

Vous pouvez passer en revue les résultats des builds manuelles et automatiques, ainsi que ceux des builds les plus récentes, des builds en continu ou fréquentes.Le rapport répertorie en premier les builds les plus récentes et contient les résultats de build obtenus pendant l'intervalle spécifié pour toutes les builds exécutées, en fonction des filtres que vous avez définis pour le rapport.

D'un coup d'œil, vous pouvez déterminer la réussite ou l'échec de plusieurs définitions de build pour la période observée, comme le présente l'illustration suivante.

Le tableau suivant décrit les informations qui s'affichent pour chaque indicateur de qualité :

Indicateur de qualité	Description
Progression de la génération	Spécifie l'état de la build.Une build peut être dans l'un des états suivants : Échec.Échec de compilation de la build ou d'exécution des tests. Succès partiel.Seules certaines parties de la build ont été compilées avec succès. Arrêté.La build a été arrêtée manuellement. Opération réussie.Réussite de la compilation de la build et de l'exécution des tests.
Qualité de build	Spécifie une évaluation manuelle de la qualité de la build.Vous pouvez ajouter ou supprimer les qualités de build définies pour votre projet d'équipe.Pour plus d'informations, consultez Ajouter ou supprimer des valeurs de qualité de build. La colonne est vide si la qualité de build n'a pas été notée.
% de tests réussis	Affiche un graphique à barres empilées horizontal qui indique le pourcentage de tests réussis en superposition sur une barre verte.Le segment de barre restant est rouge, afin d'indiquer le pourcentage d'échec des tests.La longueur totale du graphique est toujours égale à la largeur de la colonne.
% de couverture du code	Affiche un graphique à barres empilées horizontal qui indique le pourcentage de couverture du code en superposition sur une barre verte.Le segment de barre restant est bleu clair, afin d'indiquer le pourcentage de code non testé dans la build.La longueur totale du graphique est toujours égale à la largeur de la colonne.
% d'évolution du code (lignes)	Affiche un graphique à barres horizontal qui indique le pourcentage d'évolution du code en superposition sur une barre grise.L'évolution du code est calculée en divisant le nombre de lignes de code que l'équipe a ajoutées, supprimées ou modifiées, par le nombre total de lignes de la build.La longueur de la barre est proportionnelle au chiffre du pourcentage. Elle est mise à l'échelle sur le rapport afin que la quantité maximale d'évolution du code pour toutes les builds soit égale à la largeur de la colonne.

Vous pouvez filtrer le rapport Résumé de la build de différentes manières :

• Modifier les dates de début et de fin du rapport.

• Filtrez les définitions de build en spécifiant les plateformes, les configurations, les définitions de build, les qualités de build ou la progression de la génération à inclure dans le rapport.

Pour plus d'informations, consultez Filtrage du rapport, plus loin dans cette rubrique.

Activités de gestion de builds obligatoires

Pour que le rapport Résumé de la build soit utile, les membres de l'équipe doivent effectuer les activités suivantes afin de gérer les builds :

• **Configurer un système de génération :**Pour utiliser Team Foundation Build, vous devez installer un système de génération.

  Pour plus d'informations, consultez Configuring Your Build System.

• Créer des définitions de build.vous pouvez créer plusieurs définitions de build, qui peuvent chacune être exécutées pour produire le code d'une plateforme différente.En outre, vous pouvez exécuter chaque build pour une configuration différente.

  Pour plus d'informations, consultez Définir votre processus de build.

• **Définir des tests à exécuter automatiquement dans le cadre de la build :**dans le cadre de la définition de build, vous pouvez définir des tests qui doivent s'exécuter avec la build, ou ne pas s'exécuter en cas d'échec de cette dernière.

  Pour plus d'informations, consultez Définir un processus de build basé sur le modèle par défaut.

• **Configurer des tests pour rassembler les données de couverture du code :**pour que les données de couverture du code s'affichent dans le rapport, les membres de l'équipe doivent instrumenter des tests pour rassembler ces données.

  Pour plus d'informations, consultez La configuration de la couverture du code à l'aide de paramètres de test est déconseillée et How to: Gather Code-Coverage Data with Generic Tests.

• **Exécuter les builds régulièrement :**les builds peuvent être exécutées à des intervalles définis ou après chaque archivage.Vous pouvez planifier des builds classiques lorsque vous utilisez le déclencheur de planification.

  Pour plus d'informations, consultez Créer une définition de build et Exécuter, surveiller et gérer des builds.

• (Facultatif) **Noter les builds terminées :**un membre de l'équipe peut noter manuellement une build via l'Explorateur de builds.

  Pour plus d'informations, consultez Évaluer la qualité d'une build terminée.

Définition de la durée de l'itération

Pour déterminer la progression de l'équipe dans votre itération actuelle, vous devez définir les dates de début et de fin du rapport, de sorte qu'elles correspondent à celles de votre cycle d'itération actuel.

Pour modifier la durée de l'itération

1. En regard de Début de l'itération (Date) ou de Fin de l'itération (Date), cliquez sur l'icône de calendrier, puis sur une date.

2. Cliquez sur Afficher le rapport.

Interprétation du rapport

Vous pouvez passer en revue le rapport Résumé de la build afin de trouver les réponses aux questions relatives aux builds les plus récentes.Il contient davantage d'informations que le rapport Réussite des builds dans le temps.

Questions auxquelles répond le rapport

Vous pouvez utiliser ce rapport pour trouver des réponses aux questions suivantes :

• Quel est l'état de toutes les builds dans le temps ?

• Quelles sont les builds qui ont réussi ?

• Quelles sont les builds qui ont un nombre significatif de modifications dans le code ?

• Quelles sont les builds prêtes à être installées ?

• Quelle quantité de code a été exécutée par les tests ?

Le rapport Résumé de la build ne spécifie pas les causes des problèmes, mais il indique la direction où chercher pour déterminer la cause initiale des problèmes.Par ailleurs, ce rapport n'indique pas non plus l'importance ou l'impact des problèmes de build.

Version correcte du rapport

Un rapport Résumé de la build correct affiche les indicateurs suivants :

• Réussite de la plupart des builds.

• Réussite de la plupart des tests.

• Couverture du code élevée.

• Peu de pics affichés dans l'évolution du code.

Version incorrecte du rapport

Une version incorrecte du rapport Résumé de la build affiche un ou plusieurs des indicateurs ci-après.Vous pouvez l'analyser en fonction des indications suivantes :

• Échec de nombreuses builds.Recherchez les raisons de l'échec des builds.

• Échec de nombreux tests.Recherchez et corrigez les échecs des tests.

• Couverture du code principalement de couleur bleue.Vous pouvez écrire davantage de tests automatiques.

• Pics affichés dans l'évolution du code.Vous pouvez vérifier que les pics inhabituels sont pris en compte.

Filtrage du rapport

Vous pouvez filtrer le rapport Résumé de la build de différentes manières :

• Modifier les dates de début et de fin du rapport.

• Filtrez l'ensemble des builds représentées dans le rapport en spécifiant la plateforme, la configuration, la définition de build, la qualité de build et la progression de la génération à inclure dans le rapport.

  [!REMARQUE]

  Vous pouvez configurer les définitions de build afin de n'effectuer aucun test, d'en effectuer une partie ou de les effectuer tous.Le rapport varie grandement selon la configuration des définitions de build.

L'illustration suivante présente les filtres disponibles :

Vous devez appliquer les filtres dans l'ordre spécifié par la procédure ci-après.Les options disponibles avec certains filtres dépendent des filtres que vous avez définis précédemment.

Pour filtrer les builds qui s'affichent dans le rapport

1. Dans la liste Plateforme, activez la case à cocher de chaque plateforme à inclure.

2. Dans la liste Configuration, activez la case à cocher de chaque configuration à inclure.

3. Dans la liste Définition de build, activez la case à cocher de chaque définition de build à inclure.

4. Dans la liste Qualité de build, activez la case à cocher de chaque qualité de build à inclure.

5. Dans la liste Progression, activez la case à cocher de chaque progression de la génération à inclure.

6. Cliquez sur Afficher le rapport.

Voir aussi

Concepts

Indicateurs de qualité de build, rapport

Réussite des builds dans le temps, rapport

Progression des récits, rapport (Agile)

Autres ressources

Afficher des résultats de build

Rapports (Agile)