Connecter Jira au rapport de confiance : chaque test de bout en bout en échec devient un bug Jira, automatiquement

Le rapport d'anomalie que personne n'a à écrire

Quand un test de bout en bout échoue, quelqu'un doit le dire aux développeurs : ce qui a cassé, où, comment y arriver et à quoi cela devrait ressembler.Bien l'écrire prend du temps, et les images et les étapes manquent souvent ou restent vagues.

Une exécution GUI Test Studio en échec sait déjà tout cela.Elle a enregistré chaque étape, l'image ou le texte attendu, ce que l'écran a montré à la place et le nombre de fois où le test avait déjà échoué.Le rapport de bug en fait un ticket, et avec Jira connecté au rapport de confiance il arrive directement dans votre backlog : une régression fonctionnelle, un parcours cassé, un écran erroné, chacun comme un ticket prêt à corriger.

Dans cet article, Jean est le développeur, Pierre a écrit le test, James s'occupe du backlog dans Jira, et John gère TeamCity.La boutique et son test sont une petite démo, mais chaque image vient d'une vraie exécution.

Ce qu'il vous faut

Étape 1 : connecter Jira au rapport de confiance

1. 1

   Créer un jeton d'API

   Dans votre compte Atlassian, ouvrez Sécurité, jetons d'API et créez-en un.Copiez-le : il n'est affiché qu'une seule fois.Sur Jira Data Center, créez plutôt un jeton d'accès personnel dans votre profil Jira.

2. 2

   Connecter GUI Test Runner-Recorder

   Dans le rapport de confiance d'une exécution, cliquez sur Connecter Jira à côté de Rapport de bug (le formulaire de rapport de bug le propose aussi, sous Créer un ticket Jira).Collez l'adresse de n'importe quelle page de votre site Jira, votre e-mail et le jeton.La fenêtre les vérifie aussitôt et dit en tant que qui vous êtes connecté.Dès lors, chaque rapport de confiance peut déposer son rapport de bug dans Jira.

   

   Agrandir

Étape 2 : envoyer une exécution échouée à Jira depuis l'application

Ouvrez le rapport de confiance de l'exécution en échec et cliquez sur Rapport de bug (ou appuyez sur Ctrl+B).Choisissez Créer un ticket Jira.Tout est rempli à partir de l'exécution : vous ne faites que vérifier.

Agrandir

Cliquez sur Créer le ticket Jira.La clé du ticket et un lien vers lui apparaissent aussitôt, et le rapport s'en souvient : son bouton Jira ouvre ce ticket dès lors.Le formulaire lui-même est décrit dans Créer un rapport de bug.

Étape 3 : laisser TeamCity le faire à chaque build échoué

Dans un pipeline, personne n'ouvre de rapport : gtr-cli crée donc le ticket lui-même.Partez de la commande de Exécutez vos tests de bout en bout à chaque build et ajoutez les options Jira :

gtr-cli run tests --countdown 0 --format teamcity --artifacts ci-out\artifacts ^
  --jira on-failure --jira-project SCRUM --jira-assignee "James" ^
  --jira-labels gui-test-studio,ui-regression

La connexion vient de trois variables d'environnement, le jeton n'apparaît donc jamais dans la commande ni dans le journal de build :

Agrandir

Quand un test échoue, le journal de build indique quel ticket il est devenu, avec son lien, et le ticket renvoie au build.

Agrandir

Ce que contient le ticket Jira

Voici le ticket créé par le build échoué, tel que James le trouve dans le backlog.

Agrandir

Étapes pour reproduire

Les étapes de l'exécution elle-même, numérotées, jusqu'à celle qui a échoué.Un développeur peut les suivre à la main sans deviner.

Agrandir

Ce que le test a vu

Pour chaque assertion échouée : l'image que le test attend, l'image qu'il a obtenue, et de nouveau l'image obtenue avec chaque changement entouré en rouge.Cette dernière est la vue Pulsation du rapport de confiance : l'œil va droit à ce qui a changé.

Agrandir

Le rapport d'anomalie en PDF et un zip de chaque image sont joints, pour qui a besoin de toute l'histoire ou veut la conserver.

Une anomalie, un ticket

Un échec revu ne doit pas inonder le backlog.Chaque échec porte une étiquette formée à partir du test et de ce qui a échoué.Quand la même anomalie échoue à nouveau, au build suivant, sur un autre navigateur ou appareil, ou dans deux exécutions en même temps, gtr-cli trouve son ticket ouvert et ajoute un commentaire avec la nouvelle exécution au lieu d'un doublon.

Agrandir

Une fois le ticket terminé, un nouvel échec crée un nouveau ticket : une anomalie qui revient est une information nouvelle.

Vous n'utilisez ni Jira ni TeamCity ?

Jira et TeamCity sont l'exemple, pas une obligation.

1. 1

   N'importe quel outil de CI

   gtr-cli s'exécute de la même façon dans Jenkins, GitHub Actions, GitLab, Azure DevOps ou un script à vous, et --jira on-failure fonctionne dans chacun d'eux.Voir Exécuter des tests dans votre pipeline.

2. 2

   N'importe quel outil de suivi

   Sans Jira, --bug-report pdf (ou excel, ou both) écrit le même rapport d'anomalie rempli et ses preuves dans des fichiers, prêts à joindre à un ticket dans n'importe quel outil de suivi.Le fichier de résultats --json contient tout ce dont un script a besoin pour le déposer à votre place.

3. 3

   Pas de pipeline du tout

   Depuis l'application, Rapport de bug enregistre le rapport en PDF ou en classeur Excel, ou l'envoie à Jira, pour n'importe quelle exécution de votre choix.

Où aller ensuite