Collegare Jira al rapporto di affidabilità: ogni test end-to-end fallito diventa un bug Jira, automaticamente
Collega il tuo sito Jira una volta a GUI Test Studio e ogni test end-to-end fallito diventa una issue Jira pronta da correggere: passi per riprodurlo, immagini attesa e trovata con la modifica evidenziata, un PDF e le prove.Dal rapporto di affidabilità con un clic, o da TeamCity e qualsiasi pipeline CI/CD a ogni build fallito.
8 min di letturaDal team di GUI Test Studio
La segnalazione di bug che nessuno deve scrivere
Quando un test end-to-end fallisce, qualcuno deve dirlo agli sviluppatori: cosa si è rotto, dove, come arrivarci e come dovrebbe apparire.Scriverlo bene richiede tempo, e le immagini e i passi spesso mancano o sono vaghi.
Un'esecuzione fallita di GUI Test Studio sa già tutto questo.Ha registrato ogni passo, l'immagine o il testo atteso, cosa ha mostrato invece lo schermo e quante volte il test era già fallito.La segnalazione di bug ne fa un ticket, e con Jira collegato al rapporto di affidabilità arriva direttamente nel tuo backlog: una regressione funzionale, un flusso rotto, una schermata sbagliata, ciascuno come issue pronta da correggere.
Jean fa il push di una modifica
Un nuovo stile per i pulsanti del checkout
TeamCity esegue il test end-to-end
Con gtr-cli
Il test non viene superato
I pulsanti non hanno più l'aspetto giusto
Compare un ticket Jira
Passaggi, immagini, prove
In questo articolo Jean è lo sviluppatore, Pierre ha scritto il test, James si occupa del backlog in Jira e John gestisce TeamCity.Il negozio e il suo test sono una piccola demo, ma ogni immagine viene da un'esecuzione reale.
Cosa serve
| Cosa | Perché | Dove trovarlo |
|---|---|---|
| Un sito Jira | Dove finiscono i ticket.Jira Cloud con qualsiasi piano, gratuito compreso, oppure Jira Data Center | Jira di Atlassian |
| Un token API di Jira | Permette a GUI Test Studio di creare ticket a vostro nome, senza la vostra password | Creare un token API |
| GUI Test Studio | Il test e l'esecuzione non superata | Installare e configurare |
| TeamCity (per il passo 3) | Esegue i test a ogni modifica | TeamCity di JetBrains |
Passo 1: collegare Jira al rapporto di affidabilità
- 1
Creare un token API
Nel vostro account Atlassian, aprite Sicurezza, token API e createne uno.Copiatelo: viene mostrato una sola volta.Su Jira Data Center, create invece un token di accesso personale nel vostro profilo Jira.
- 2
Connettere GUI Test Runner-Recorder
Nel rapporto di affidabilità di un'esecuzione, fai clic su Collega Jira accanto a Segnalazione di bug (anche il modulo della segnalazione lo offre, sotto Crea una issue Jira).Incolla l'indirizzo di una pagina qualsiasi del tuo sito Jira, la tua email e il token.La finestra li verifica subito e dice come chi sei connesso.Da quel momento ogni rapporto di affidabilità può aprire la sua segnalazione di bug in Jira.
Passo 2: inviare a Jira un'esecuzione non superata dall'app
Apri il rapporto di affidabilità dell'esecuzione fallita e fai clic su Segnalazione di bug (o premi Ctrl+B).Scegli Crea una issue Jira.Tutto è compilato a partire dall'esecuzione: tu lo controlli soltanto.
| Campo | Compilato con |
|---|---|
| Progetto e tipo di ticket | Letti dal vostro sito Jira.Un Bug se il progetto ne ha uno, altrimenti un Task |
| Assegnato a | Le persone che Jira vi permette di assegnare in quel progetto |
| Priorità | La valutazione propria della segnalazione, abbinata alle priorità del vostro sito |
| Immagini | Attesa, trovata e ciò che è cambiato, mostrate nel ticket stesso |
| Allegati | La segnalazione di bug in PDF e uno zip di ogni immagine dell'errore |
Fai clic su Crea issue Jira.La chiave della issue e un link compaiono subito, e il rapporto se la ricorda: da quel momento il suo pulsante Jira apre quella issue.Il modulo stesso è descritto in Creare una segnalazione di bug.
Passo 3: lasciarlo fare a TeamCity a ogni build non superata
In una pipeline nessuno apre un rapporto, quindi gtr-cli crea la issue da solo.Parti dal comando di Esegui i tuoi test end-to-end a ogni build e aggiungi le opzioni 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-regressionLa connessione viene da tre variabili d'ambiente, quindi il token non compare mai nel comando né nel log di build:
| Variabile | Contiene |
|---|---|
| JIRA_BASE_URL | Il vostro sito Jira, per esempio https://your-team.atlassian.net |
| JIRA_USER_EMAIL | L'e-mail dell'account che crea i ticket |
| JIRA_API_TOKEN | Il token API.In TeamCity, rendetelo un parametro password: viene nascosto ovunque |
Quando un test non viene superato, il log di build dice quale ticket è diventato, con il suo collegamento, e il ticket rimanda alla build.
Cosa contiene il ticket Jira
Ecco il ticket creato dalla build non superata, così come James lo trova nel backlog.
Passaggi per riprodurre
I passaggi dell'esecuzione stessa, numerati, fino a quello non superato.Uno sviluppatore può seguirli a mano senza dover indovinare.
Cosa ha visto il test
Per ogni controllo non superato: l'immagine che il test si aspetta, l'immagine che ha trovato, e di nuovo l'immagine trovata con ogni modifica evidenziata in rosso.Quest'ultima è la vista Pulsazione del report di affidabilità: l'occhio va dritto a ciò che è cambiato.
La segnalazione di bug in PDF e uno zip di ogni immagine sono allegati, per chi ha bisogno della storia completa o vuole conservarla.
Un difetto, un ticket
Un errore visto di nuovo non deve inondare il backlog.Ogni errore porta un'etichetta formata dal test e da ciò che non è stato superato.Quando lo stesso difetto si ripresenta, nella build successiva, su un altro browser o dispositivo, o in due esecuzioni contemporanee, gtr-cli trova il suo ticket aperto e aggiunge un commento con la nuova esecuzione invece di un duplicato.
Una volta chiuso il ticket, un nuovo errore apre un nuovo ticket: un difetto che ritorna è una notizia.
| Opzione | Cosa fa |
|---|---|
| --jira on-failure | Crea un ticket per ogni test non superato.Un test che non ha potuto essere eseguito non lo diventa mai |
| --jira-project | La chiave del progetto Jira, per esempio SCRUM |
| --jira-issue-type | Bug per impostazione predefinita; il tipo più vicino quando il progetto non ne ha |
| --jira-assignee | Un'e-mail o un nome, confrontato con le persone del progetto |
| --jira-labels | Etichette vostre, separate da virgole |
| --jira-repeat new | Crea sempre un nuovo ticket, mai un commento |
Non usate Jira o TeamCity?
Jira e TeamCity sono l'esempio, non un requisito.
- 1
Qualsiasi strumento di CI
gtr-cli funziona allo stesso modo in Jenkins, GitHub Actions, GitLab, Azure DevOps o in uno script vostro, e
--jira on-failurefunziona in tutti.Vedete Eseguire i test nella pipeline. - 2
Qualsiasi tracker
Senza Jira,
--bug-report pdf(oppureexcel, oppureboth) scrive la stessa segnalazione di bug compilata e le sue prove come file, pronti da allegare a un ticket in qualsiasi tracker.Il file dei risultati--jsoncontiene tutto ciò che serve a uno script per registrarla al posto vostro. - 3
Nessuna pipeline
Dall'app, Segnalazione di bug salva il rapporto come PDF o cartella Excel, oppure lo invia a Jira, per qualsiasi esecuzione tu scelga.
Dove andare dopo
Pronti a registrare il vostro primo test?
Tutte le funzionalità, per 15 giorni.
Preferite vederlo sul tipo di app che testate?Prenotate una chiamata gratuita di 30 minuti con il nostro team.