Todas as coleções
Material Educativo
Anexos de Relatórios de Bugs
Anexos de Relatórios de Bugs

O que você precisa anexar ao enviar um relatório de bug?

Nikola Jonic avatar
Escrito por Nikola Jonic
Atualizado há mais de uma semana

Cada bug deve ser documentado com pelo menos um anexo. Com o(s) seu(s) anexo(s), você fornece evidências de que o bug ocorre em seu dispositivo, sistema operacional e/ou navegador.

Nota: Anexos NÃO substituem as informações por escrito em seu relatório. Os anexos são uma visualização do problema e servem como evidência.

Captura de tela ou gravação de tela?

Em geral, bugs funcionais requerem uma gravação de tela para serem ilustrados adequadamente e de forma eficaz. A menos que as instruções ou o líder da equipe solicitem anexos específicos, siga a regra geral a seguir para determinar se é necessário uma captura de tela ou uma gravação de tela para o seu bug:

  • Sempre que uma ação for necessária para acionar um bug ou quando um processo precisar ser ilustrado, faça o upload de uma gravação de tela. Capturas de tela, como imagens estáticas, são instantâneos e não podem ilustrar a causa raiz. Bugs funcionais sempre exigirão uma gravação de tela por essa razão.

  • Quando a natureza de um bug for estática, por exemplo, problemas estáticos de GUI, uma captura de tela é suficiente e uma visualização melhor do que um vídeo. Capturas de tela devem ser suficientes para problemas de conteúdo ou visual.

Requisitos gerais de anexos

  • Novos anexos devem ser criados para cada relatório de bug ou reprodução.

  • É proibido copiar anexos de outros relatórios de bugs ou reproduções.

  • Os anexos devem mostrar todas as informações relevantes do bug para servir como evidência.

  • Todas as informações relevantes devem ser exibidas em inglês (ou opcionalmente em alemão, se o idioma do relatório de bug for o alemão), por exemplo, a data, hora, informações do sistema e mensagens de erro.

  • Você deve selecionar apenas um dispositivo ou navegador ao relatar o bug e fazer upload de apenas um anexo para ele. Se você conseguir reproduzir o bug em outros dispositivos ou navegadores, mencione isso no Resultado Atual.

  • Não compartilhe informações de outros clientes da Test IO que possam estar relacionadas à Test IO, como e-mails de convite ou nomes de guias do navegador. A exibição de aplicativos instalados por outros clientes é permitida.

  • Não compartilhe informações pessoais ou não profissionais, como fotos, vídeos ou sugestões de palavras inadequadas do auto corretor. Lembre-se de que seus anexos estarão disponíveis para outros testadores, para a equipe da Test IO e para o cliente, então, tenha cuidado com o que você mostra neles.

  • Para testes de sites, o campo de URL deve ser visível nos anexos.

  • A resolução deve ser alta o suficiente para que o texto e os elementos possam ser facilmente identificados.

  • Por favor, sempre grave toda a sua tela.

  • Um log de travamento é obrigatório para relatórios de bugs e reproduções positivas de falhas de aplicativos. O vídeo que documenta a falha deve corresponder ao log de travamento (crash) anexado, ou seja, os cronômetros devem ser coerentes.

Regras específicas para data e hora:

  • A data e hora atuais devem ser visíveis nos anexos.

  • Ao comprovar um bug por meio de uma captura de tela em um dispositivo móvel, uma segunda captura de tela mostrando a data e a hora deve ser enviada (a carga da bateria e a hora devem corresponder à primeira captura de tela).

  • A data pode estar em qualquer formato de data comum, por exemplo, DD/MM ou MM/DD, em inglês (ou opcionalmente em alemão, se o idioma do relatório de bug for o alemão).

  • A hora deve estar no formato de relógio de 24 horas ou, se você usar um relógio de 12 horas, certifique-se de usar o formato AM/PM.

Ao exibir a data atual em seu anexo, você comprova que o gravou naquela data. A lista a seguir sugere onde encontrar a data:

  • Windows: Showing the taskbar or merging into the calendar

  • Mac: Showing the calendar icon in the Dock or menu bar

  • iOS and Android: Sliding the notification center at the start of your recording.

Mais informações: TecRevue

O que deve estar incluído em uma captura de tela?

Regras específicas para capturas de tela:

  • A captura de tela deve estar no formato de arquivo JPG ou PNG.

  • Destaque o bug em sua captura de tela.

Recomendamos ferramentas de gravação e melhores práticas no seguinte artigo: Capturas de Tela

O que deve estar incluído em uma gravação de tela?

As gravações de tela devem ser o mais curtas possível, mas tão longas quanto necessárias. Isso significa que você deve deixar de fora etapas que não causam o bug. Por exemplo, quando o botão "Adicionar ao carrinho" em uma página de detalhes do produto de uma loja online estiver com defeito, geralmente não importa como você navegou pela loja online para chegar à página de detalhes do produto. A última etapa de navegação, a etapa que aciona o bug e o bug em si, geralmente são relevantes.

Exemplo 1: Bug no site, testado em um dispositivo desktop

Passos para produzir uma gravação de tela:

  1. Vá para a página onde o bug ocorre.

  2. Inicie sua gravação.

  3. Atualize a página.

  4. Execute a ação que aciona o bug.

  5. Aguarde até que o bug ocorra.

  6. Pare a gravação.

Exemplo 2: Bug no aplicativo, testado no dispositivo móvel

Passos para produzir a gravação de tela:

  1. Execute o aplicativo e vá para a página em que apenas mais uma etapa de navegação é necessária para chegar à página onde o bug ocorre.

  2. Inicie sua gravação.

  3. Deslize para baixo o centro de notificações para mostrar a data atual por alguns segundos.

  4. Execute a última etapa de navegação para chegar à página correta.

  5. Execute a ação que aciona o bug.

  6. Aguarde até que o bug ocorra.

  7. Pare a gravação.

Os líderes da equipe podem enviar uma solicitação de informações pedindo uma gravação externa ou adicional. Isso é feito para obter uma compreensão melhor do bug ou quando há dúvidas devido ao bug ser não-reproduzível.

Regras específicas para gravações de tela:

  • As gravações de tela devem estar no formato de arquivo MP4.

  • O tempo máximo para uma gravação de tela é de 60 segundos para Relatórios de Bugs, a menos que seu bug exija a exibição de um processo de carregamento infinito ou inserções manuais longas necessárias.

  • O tempo máximo para uma gravação de tela é de 15 segundos para Reproduções e Anexos de Histórias do Usuário ("User Story"), já que você só precisa mostrar a última ação que acionou o bug.

  • Seus cliques/toques e o ícone do mouse devem ser visíveis (apenas necessário para gravações em desktops e Android).

  • Faça sua gravação de uma vez. Você não deve pausar nem cortar partes no meio. Se sua gravação de tela for muito longa e você quiser editá-la, corte apenas o início ou o final do arquivo.

  • Aumentar a velocidade de sua gravação de tela não é permitido. Se você gravou mais do que o tempo permitido, verifique se não mostrou etapas desnecessárias em sua gravação.

  • Não grave ruídos (choro de bebê, conversas, TV, músicas, animais, etc).

Recomendamos ferramentas de gravação e melhores práticas no seguinte artigo: Gravações de Tela

Regras específicas para gravações de tela em dispositivos de Streaming:

  • Sempre grave toda a tela da sua TV.

  • A gravação de tela deve ter alta resolução e boa qualidade.

  • A luz ambiente não deve estar escura.

  • Seu controle remoto da TV deve ser visível na gravação de tela. Além disso, o controle remoto deve estar totalmente visível e claro.

  • A data e a hora atuais devem ser mostradas no anexo. Você pode mostrar a data atual na própria TV ou em algum dispositivo externo, como um PC, telefone ou tablet.

  • Para Relatórios de Bugs, o tempo máximo para uma gravação de tela é de 60 segundos, enquanto para Reproduções de Bugs e Anexos de Histórias do Usuário ("User Story"), o tempo máximo é de 15 segundos.

  • Não grave ruídos (choro de bebê, conversas, TV, músicas, animais, etc).

  • A gravação de tela deve sempre ter uma aparência profissional; não grave suas pernas, suporte de TV bagunçado ou similar.

Desfocar Informações Privadas nos Anexos

Para proteger suas informações privadas, como marcadores, nomes de contas ou emails salvos, de estarem visíveis nas guias do navegador, você pode seguir esta técnica simples de desfoque. No entanto, por motivos de eficiência no relato de bugs, é recomendável usar uma janela de navegador dedicada para fins de teste, conforme demonstrado no exemplo abaixo, que não mostra guias de navegador desnecessárias ou favoritos visíveis.

Se você precisar incluir informações privadas em seus anexos, mas não quiser que elas sejam visíveis, pode seguir este exemplo para ocultá-las profissionalmente; observe que os nomes das guias do navegador que podem mostrar endereços de email, nomes de usuários e favoritos estão ocultos.

É importante observar que a URL ainda deve ser visível, e os elementos do site não devem ser obstruídos.

Por razões profissionais, é crucial evitar métodos desenhados à mão ou rudimentares ao cobrir informações em seus anexos, como mostrado no exemplo abaixo:

Isto respondeu à sua pergunta?