Conecte o Jira ao Relatório de confiança: cada teste end-to-end que falha vira um bug no Jira, automaticamente
Conecte o seu site do Jira ao GUI Test Studio uma vez e cada teste end-to-end que falha vira uma issue do Jira pronta para corrigir: etapas para reproduzir, imagens esperadas e encontradas com a mudança contornada, um PDF e as evidências.A partir do Relatório de confiança com um clique, ou do TeamCity e de qualquer pipeline de CI/CD em cada build que falha.
8 min de leituraPela equipe do GUI Test Studio
O relatório de bug que ninguém precisa escrever
Quando um teste de ponta a ponta reprova, alguém precisa avisar os desenvolvedores: o que quebrou, onde, como chegar lá e qual deveria ser a aparência.Escrever isso bem leva tempo, e as imagens e as etapas muitas vezes faltam ou são vagas.
Uma execução reprovada do GUI Test Studio já sabe tudo isso.
- Ela gravou cada etapa, a imagem ou o texto que esperava, o que a tela mostrou no lugar e quantas vezes o teste já tinha reprovado antes.
- O relatório de bug transforma isso em um ticket e, com o Jira conectado ao Relatório de confiança, ele cai direto no seu backlog: uma regressão funcional, um fluxo de trabalho quebrado, uma tela errada, cada um como um item pronto para ser corrigido.
Jean envia uma alteração
Um novo estilo para os botões do checkout
O TeamCity executa o teste de ponta a ponta
Com o gtr-cli
O teste é reprovado
Os botões não estão mais com a aparência certa
Um item do Jira aparece
Etapas, imagens, evidências
Neste artigo, Jean é o desenvolvedor, Pierre escreveu o teste, James cuida do backlog no Jira e John administra o TeamCity.A loja e o teste dela são uma pequena demonstração, mas todas as imagens vêm de uma execução real.
O que você precisa
| O quê | Por quê | Onde obter |
|---|---|---|
| Um site do Jira | Para onde vão os itens.Jira Cloud em qualquer plano, inclusive o gratuito, ou Jira Data Center | Jira, da Atlassian |
| Um token de API do Jira | Permite que o GUI Test Studio crie itens em seu nome, sem a sua senha | Criar um token de API |
| GUI Test Studio | O teste e a execução que reprovou | Instalar e configurar |
| TeamCity (para a etapa 3) | Executa os testes a cada alteração | TeamCity, da JetBrains |
Etapa 1: conecte o Jira ao Relatório de confiança
- 1
Crie um token de API
Na sua conta da Atlassian, abra Segurança, tokens de API e crie um.Copie-o: ele é mostrado só uma vez.No Jira Data Center, crie em vez disso um token de acesso pessoal no seu perfil do Jira.
- 2
Conecte o GUI Test Runner-Recorder
No Relatório de confiança de uma execução, clique em Conectar Jira ao lado de Relatório de bug (o formulário do relatório de bug também oferece essa opção, em Criar um item no Jira).Cole o endereço de qualquer página do seu site do Jira, o seu e-mail e o token.A janela os verifica na hora e diz com qual usuário você está conectado.A partir daí, todo Relatório de confiança pode registrar o seu relatório de bug no Jira.
Etapa 2: envie uma execução reprovada ao Jira pelo aplicativo
Abra o Relatório de confiança da execução reprovada e clique em Relatório de bug (ou pressione Ctrl+B).Escolha Criar um item no Jira.Tudo é preenchido a partir da execução: você só confere.
| Campo | Preenchido com |
|---|---|
| Projeto e tipo de item | Lidos do seu site do Jira.Um Bug quando o projeto tem esse tipo, senão uma Tarefa |
| Responsável | As pessoas a quem o Jira permite atribuir itens nesse projeto |
| Prioridade | A classificação do próprio relatório, associada às prioridades do seu site |
| Imagens | O esperado, o encontrado e o que mudou, mostrados no próprio item |
| Anexos | O relatório de bug em PDF e um zip com todas as imagens da falha |
Clique em Criar item no Jira.A chave do item e um link para ele aparecem na hora, e o relatório se lembra dele: a partir daí, o botão Jira do relatório abre esse item.O formulário em si é descrito em Criar um relatório de bug.
Etapa 3: deixe o TeamCity fazer isso a cada build reprovado
Em um pipeline ninguém abre um relatório, então o gtr-cli cria o item sozinho.Parta do comando de Execute os seus testes de ponta a ponta a cada build e adicione as opções do 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-regressionA conexão vem de três variáveis de ambiente, para que o token nunca apareça no comando nem no log do build:
| Variável | Contém |
|---|---|
| JIRA_BASE_URL | O seu site do Jira, como https://your-team.atlassian.net |
| JIRA_USER_EMAIL | O e-mail da conta que cria os itens |
| JIRA_API_TOKEN | O token de API.No TeamCity, transforme-o em um parâmetro de senha: ele fica oculto em todos os lugares |
Quando um teste reprova, o log do build diz em qual item ele se transformou, com o link, e o item tem um link de volta para o build.
O que o item do Jira contém
Etapas para reproduzir
- 1
- 2
- 3
Esperado
Encontrado
O que mudou
Este é o item que o build reprovado criou, do jeito que James o encontra no backlog.
Etapas para reproduzir
As etapas da própria execução, numeradas, até aquela que falhou.Um desenvolvedor pode segui-las à mão sem adivinhar nada.
O que o teste viu
Para cada asserção reprovada: a imagem que o teste espera, a imagem que ele encontrou e de novo a imagem encontrada, com cada mudança contornada em vermelho.Esta última é a visualização Pulso do Relatório de confiança: o olho vai direto ao que mudou.
O relatório de bug em PDF e um zip com todas as imagens vão anexados, para quem precisa da história completa ou quer guardá-la.
Um defeito, um item
Uma falha vista de novo não pode inundar o backlog.
- Cada falha leva um rótulo formado pelo teste e pelo que falhou.
- Quando o mesmo defeito reprova de novo, no build seguinte, em outro navegador ou dispositivo, ou em duas execuções ao mesmo tempo, o gtr-cli encontra o item aberto e adiciona um comentário com a nova execução em vez de criar uma duplicata.
Um teste é reprovado
Um novo item é criado
O mesmo defeito reprova de novo
Um comentário é adicionado ao item aberto
O item é concluído, e depois o defeito volta
Um novo item é criado
Depois que o item é concluído, uma nova falha registra um novo item: um defeito que volta é notícia.
| Opção | O que faz |
|---|---|
| --jira on-failure | Cria um item para cada teste reprovado.Um teste que não pôde ser executado nunca vira um item |
| --jira-project | A chave do projeto no Jira, como SCRUM |
| --jira-issue-type | Bug por padrão; o tipo mais próximo quando o projeto não tem esse tipo |
| --jira-assignee | Um e-mail ou um nome, comparado com as pessoas do projeto |
| --jira-labels | Rótulos próprios, separados por vírgulas |
| --jira-repeat new | Sempre cria um novo item, nunca um comentário |
Não usa Jira nem TeamCity?
O Jira e o TeamCity são o exemplo, não um requisito.
- 1
Qualquer ferramenta de CI
O gtr-cli funciona do mesmo jeito no Jenkins, no GitHub Actions, no GitLab, no Azure DevOps ou em um script seu, e
--jira on-failurefunciona em todos eles.Veja Executar testes no seu pipeline. - 2
Qualquer ferramenta de acompanhamento
Sem o Jira,
--bug-report pdf(ouexcel, ouboth) salva o mesmo relatório de bug preenchido e as evidências como arquivos, prontos para anexar a um ticket em qualquer ferramenta de acompanhamento.O arquivo de resultado--jsontem tudo o que um script precisa para registrá-lo por você. - 3
Nenhum pipeline
Pelo aplicativo, Relatório de bug salva o relatório como PDF ou como pasta de trabalho do Excel, ou o envia ao Jira, para qualquer execução que você escolher.
Para onde ir agora
Pronto para gravar o seu primeiro teste?
Todos os recursos, por 15 dias.
Prefere ver no tipo de aplicativo que você testa?Agende uma chamada gratuita de 30 minutos com a nossa equipe.