Analyser les résultats

Observation des logs d'exécution en temps réel

Attention

La visualisation des logs d'exécution en temps réel depuis l'interface de Squash TM est une fonctionnalité disponible uniquement avec une licence Premium ou Ultimate de Squash, ainsi que le plugin Squash TM Premium.

Il est possible de visualiser les logs des workflows en temps réel pour les tests automatisés exécutés depuis l'interface de Squash, en cliquant sur l'icône associée à une suite automatisée.

Pour une suite automatisée comportant un seul workflow, la fenêtre de visualisation des logs s'ouvre automatiquement :

Pour une suite automatisée contenant plusieurs workflows, un menu s'affiche avec la liste des workflows disponibles, vous offrant la possibilité de sélectionner celui dont vous voulez visualiser les logs :

Remontée des résultats d'un plan d'exécution

Durant l'exécution d'un plan de test (depuis Squash TM ou depuis un pipeline CI/CD) :

• Une nouvelle exécution est créée pour chaque ITPI (Iteration Test Plan Item, voir le glossaire Squash TM) au fur et à mesure de l'exécution de chaque test. Elle a un statut correspondant au résultat du test automatisé.
  Les rapports d'exécution et les attachements du test automatisé sont disponibles depuis l'onglet Suites automatisées.

• Quand tous les tests de la suite automatisée ont été exécutés, le statut de celle-ci est mis à jour.
  Un rapport HTML (executionreport.html), un rapport Allure (allure-report.tar) et les logs de Squash Orchestrator (executionlog.txt) correspondant à l'ensemble des tests exécutés sont disponibles depuis l'onglet Suites automatisées.
  Pour plus d'information sur la façon d'exploiter le rapport Allure, veuillez consulter la documentation Allure.

Obsolescence des rapports Allure

Depuis la livraison 2024-03, Squash Orchestrator peut générer un rapport HTML offrant un aperçu complet des tests d'un workflow. Il s'agit d'une fonctionnalité redondante avec les rapports Allure, mais ceux de l'orchestrateur sont plus polyvalents et pourront être encore étendus à l'avenir. Nous prévoyons donc de supprimer la prise en charge des rapports Allure :

• Au quatrième trimestre 2024, l'orchestrateur cessera de générer des rapports Allure par défaut. La génération pourra être réactivée par configuration.
• Au troisième trimestre 2025, la prise en charge des rapports Allure sera abandonnée. Aucun rapport Allure ne pourra plus être créé.

Les rapports et attachements des différentes exécutions sont également accessibles depuis l'écran Exécution (ils sont présents dans les pièces jointes).

Statut d'exécution des exécutions et suites automatisées

Statut Squash	Couleur	Exécution	Suite automatisée
À exécuter		L'ITPI fait parti d'une suite automatisée qui a été lancée, mais le script automatisé correspondant n'a pas encore été démarré.	-
En cours		L'ITPI est en cours d'exécution.	La suite automatisée a été lancée.
Succès		L'ITPI a été exécuté et son résultat (tel que rapporté par le framework de test) est "succès".	Tous les ITPIs de la suite automatisée ont été exécutés et ont un statut "succès" ou "ignoré".
Échec		L'ITPI a été exécuté et son résultat (tel que rapporté par le framework de test) est "échec".	Tous les ITPIs de la suite automatisée ont été exécutés, aucun ITPI n'a un statut "bloqué", au moins un ITPI a un statut "échec".
Bloqué		L'ITPI n'a pas pu être exécuté ou ses résultats n'ont pas pu être analysés : le test n'existe pas, une bibliothèque/dépendance/… est manquante, le rapport Surefire n'a pas été généré…	Tous les ITPIs de la suite automatisée ont été exécutés, au moins un ITPI a un statut "bloqué".
Ignoré (skipped)*		L'ITPI n'a pas été exécuté ou a un statut "ignoré" (par exemple, il a été marqué dans le code du test automatisée comme ne devant pas être exécuté).	Tous les ITPIs de la suite automatisée ont été exécutés et ont un statut "ignoré".
Annulé		L'ITPI ne sera jamais lancé car le workflow de l'orchestrateur a été volontairement interrompu par un utilisateur entre-temps.	La suite automatisée a été annulée avant que tous les ITPIs de la suite automatisée n'aient été exécutées.

* Le statut "Ignoré" n'existe que pour Cucumber et Robot Framework pour l'instant.

Les suites automatisées Squash Orchestrator

Depuis l'ancre Suites automatisées d'une itération ou d'une suite de tests, il est possible de consulter la liste des suites automatisées.

Pour chaque suite automatisée, les informations suivantes sont disponibles :

• date de création ;
• statut de la suite automatisée ("Succès", "Échec", "Annulé", "Bloqué", "En cours", "Ignoré") ;
• détails contenant la liste des exécutions de la suite, ainsi que les rapports d'exécutions ;
• rapport global et log d'exécution ;
• utilisateur ayant lancé les tests automatisés ;
• nature de l'entité depuis laquelle a été lancée la suite (Itération ou Suite) ;
• date de modification ;
• nombre total d'exécutions ;
• nombre d'exécutions ayant un statut "Succès" ;
• nombre d'exécutions ayant un statut "Échec" ;
• nombre d'exécutions ayant un autre statut ("Bloqué", "Annulé", "À exécuter" ou "Ignoré") ;
• tags d'environnements d'exécution utilisés lors du lancement des tests ;
• variables d'environnements utilisées lors du lancement des tests.

Nettoyage des suites automatisées

Un administrateur, chef de projet ou testeur référent peut :

• supprimer une ou plusieurs suites automatisées, en cliquant sur le bouton ;
• nettoyer partiellement (seules les pièces jointes associées aux exécutions ayant un statut "Succès" seront supprimées) en cliquant sur le bouton , puis en sélectionnant "Nettoyage partiel" ;
• nettoyer complètement (les pièces jointes de toutes les exécutions seront supprimées) une ou plusieurs suites automatisées, en cliquant sur le bouton , puis en sélectionnant "Nettoyage complet" ;
• arrêter une suite automatisée lancée depuis squash TM ayant un statut "En cours", en cliquant sur le bouton .

Un testeur avancé peut arrêter les suites automatisées qu'il a lancées, mais pas celles lancées par d'autres utilisateurs.

Info

La suppression et le nettoyage des pièces jointes ne concernent que les suites automatisées terminées. Celles ayant un statut "En cours" seront ignorées.

Consulter une exécution automatisée et ses rapports d'exécution

Depuis le plan d'exécution

Il est possible de consulter une exécution et ses rapports depuis le plan d'exécution.

La page de consultation de l'exécution s'affiche en cliquant sur le sous-menu Historique des exécutions, puis sur le numéro de l'exécution.

Depuis la page de consultation de l'exécution, les tags, les variables d'environnement utilisées, ainsi que les temps d'exécution sont visibles, et les rapports d'exécution sont téléchargeables dans le bloc des pièces jointes.

Depuis une suite automatisée

Il est possible de consulter le détail d'une exécution et ses rapports depuis la suite automatisée.

La consultation des rapports d'exécutions se fait en cliquant sur le bouton . Ceux-ci sont organisés par cas de test afin d'en faciliter la lecture.

La consultation des logs de l'exécution de la suite automatisée se fait en cliquant sur le bouton .

Consulter les statuts d'exécution des pas de tests BDD

Info

Cette fonctionnalité requiert Squash Orchestrator 4.11.0 (livraison 2024-05) ou supérieur pour fonctionner.

Il est possible de consulter les statuts d'exécution des pas de tests d'une exécution de test BDD Robot Framework ou Cucumber directement depuis l'ancre Scénario d'exécution d'une exécution.

Attention

Les statuts d'exécution des pas de tests ne seront pas mis à jour et resteront "À exécuter" si le nombre de pas de tests dans Squash diffère de celui du rapport XML de l'exécution (par exemple, s'il manque des pas de tests dans le rapport XML).

Les équivalences entre les statuts des pas de tests et les statuts Squash sont les suivantes :

Statut Squash	Cucumber	Robot Framework
Succès	passed	PASS
Échec	failed	FAIL
Ignoré	skipped	SKIP
Non exécuté	-	NOT RUN

Comparer les statuts d'exécution

Attention

La comparaison des statuts d'exécution est une fonctionnalité disponible avec la licence Premium de Squash et le plugin Squash TM Premium.

Il est possible de comparer le détail des statuts d'exécution des ITPIs de plusieurs suites automatisées.

La comparaison s'effectue en sélectionnant au moins deux suites automatisées, puis en cliquant sur l'icône .

La pop-up de comparaison des suites automatisées contient un tableau avec une ligne par ITPI et une colonne par suite automatisée. Les suites sont triées par ordre de sélection et les colonnes peuvent être filtrées et triées par statut d'exécution.