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 item de plan d'exécution (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 :
- Avec la livraison 2024-10, l'orchestrateur cesse de générer des rapports Allure par défaut. La génération peut être réactivée par configuration, en utilisant la variable d'environnement
OPENTF_ALLURE_ENABLED: voir la documentation d'OpenTestFactory pour les détails. - 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'item de plan d'exécution fait partie 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'item est en cours d'exécution. | La suite automatisée a été lancée. |
| Succès |  |
L'item a été exécuté et son résultat (tel que rapporté par le framework de test) est "succès". | Tous les items de la suite automatisée ont été exécutés et ont un statut "succès" ou "ignoré". |
| Échec |  |
L'item a été exécuté et son résultat (tel que rapporté par le framework de test) est "échec". | Tous les items de la suite automatisée ont été exécutés, aucun item n'a un statut "bloqué", au moins un item a un statut "échec". |
| Bloqué |  |
L'item 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 items de la suite automatisée ont été exécutés, au moins un item a un statut "bloqué". |
| Ignoré (skipped)* |  |
L'item 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 items de la suite automatisée ont été exécutés et ont un statut "ignoré". |
| Annulé |  |
L'item 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 items 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 items de plan d'exécution 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 item 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.
