Toutes les collections
Matériel éducatif
Pièces jointes au rapport de bogue
Pièces jointes au rapport de bogue

Que devez-vous joindre lorsque vous soumettez un rapport de bogue?

Zorica Micanovic avatar
Écrit par Zorica Micanovic
Mis à jour il y a plus d’une semaine

Chaque bogue doit être documenté avec au moins une pièce jointe. Avec vos pièces jointes, vous fournissez la preuve que le bogue se produit sur votre appareil, votre système d'exploitation et/ou votre navigateur.

Note: Les pièces jointes NE remplacent PAS les informations écrites dans votre rapport. Les pièces jointes sont une visualisation du problème et servent de preuve.

Capture d'écran ou enregistrement?

Capture d'écran ou enregistrement d'écran ? En général, les bogues fonctionnels nécessitent un enregistrement d'écran pour être correctement et efficacement illustrés. À moins que les instructions ou le chef d'équipe ne demandent des pièces jointes spécifiques, utilisez la règle suivante pour déterminer si une capture d'écran ou un enregistrement d'écran est nécessaire pour votre bogue:

  • Chaque fois qu'une action est nécessaire pour déclencher un bogue ou lorsqu'un processus doit être illustré, téléchargez un enregistrement d'écran. Les captures d'écran en tant qu'images statiques ne sont que des instantanés et ne peuvent pas illustrer la cause profonde. Pour cette raison, les bogues fonctionnels nécessiteront toujours un enregistrement d'écran.

  • Lorsque la nature d'un bogue est statique, par exemple pour les problèmes statiques d'interface graphique (GUI), une capture d'écran suffit et offre une meilleure visualisation qu'une vidéo. Les captures d'écran devraient être suffisantes pour les problèmes de contenu ou visuels.

Exigences générales pour les pièces jointes

  • De nouvelles pièces jointes doivent être créées pour chaque rapport de bogue ou reproduction.

  • Il est interdit de copier des pièces jointes d'autres rapports de bogue ou reproductions.

  • Les pièces jointes doivent montrer toutes les informations pertinentes sur le bogue pour servir de preuve.

  • Toutes les informations pertinentes doivent être affichées en anglais (ou en allemand en option si la langue du rapport de bogue est l'allemand), par exemple, la date, l'heure, les informations système et les messages d'erreur.

  • Vous devriez sélectionner un seul appareil ou navigateur lorsque vous signalez le bogue, et télécharger uniquement une pièce jointe pour celui-ci. Si vous parvenez à reproduire le bogue sur d'autres appareils ou navigateurs, mentionnez-le dans votre résultat réel.

  • Ne montre aucune information concernant d'autres clients de Test IO qui pourrait être liée à Test IO (par exemple, des courriels d'invitation ou des noms d'onglets de navigateur). Il est permis de montrer les applications installées d'autres clients.

  • Ne montre aucune information personnelle ou des données non professionnelles telles que des photos, des vidéos ou des suggestions de mots incorrects de la fonction de correction automatique. N'oubliez pas que vos pièces jointes seront disponibles pour d'autres testeurs, pour le personnel de Test IO et pour le client, alors faites attention à ce que vous montrez.

  • Pour les tests de site web, le champ d'URL doit être visible sur les pièces jointes.

  • La résolution doit être suffisamment élevée pour que le texte et les éléments puissent être facilement identifiés.

  • Enregistre toujours l'intégralité de votre écran.

  • Un journal de plantage est obligatoire pour les rapports de bogue et les reproductions positives des plantages d'application. La vidéo qui documente le plantage doit correspondre au journal de plantage joint, c'est-à-dire que les minutages doivent être cohérents.

Règles spécifiques à la date et à l'heure:

  • La date et l'heure actuelles doivent être visibles dans les pièces jointes.

  • Lorsque vous prouvez un bogue via une capture d'écran sur un appareil mobile, téléchargez une deuxième capture d'écran montrant la date et l'heure (la charge de la batterie et l'heure doivent correspondre à la première capture d'écran).

  • La date peut être dans n'importe quel format de date courant, par exemple, JJ/MM ou MM/JJ, en anglais (ou en allemand en option si la langue du rapport de bogue est l'allemand).

  • L'heure doit être au format 24 heures, ou si vous utilisez un format de 12 heures, assurez-vous d'utiliser le format AM/PM.

En affichant la date actuelle sur ta pièce jointe, vous prouvez que vous l'as enregistrée à cette date. La liste suivante suggère où trouver la date:

  • Windows: Affichage de la barre des tâches ou intégration dans le calendrier.

  • Mac: Affichage de l'icône du calendrier dans le "Dock" ou dans la barre de menus.

  • iOS et Android: Fais glisser vers le bas le centre de notification au début de votre enregistrement.

Pour plus d'informations: TecRevue

Ce qui doit être inclus dans une capture d'écran?

Règles spécifiques à la capture d'écran:

  • La capture d'écran doit être au format JPG ou PNG.

  • Mets en évidence le bogue sur ta capture d'écran.

Nous recommandons des outils d'enregistrement et les meilleures pratiques dans l'article suivant: Captures d'écran.

Ce qui doit être inclus dans un enregistrement?

L'enregistrement doit être aussi court que possible, mais aussi long que nécessaire. Cela signifie que vous devriez exclure les étapes qui ne provoquent pas le bogue. Par exemple, lorsque le bouton "Ajouter au panier" sur une page de détails de produit d'une boutique en ligne est défectueux, il est généralement sans importance de savoir comment vous avez navigué sur le site web pour atteindre la page de détails du produit. La dernière étape de navigation, l'étape qui déclenche le bogue, et le bogue lui-même sont généralement pertinents.

Exemple 1: Bogue sur le site web, testé sur un appareil de bureau

Étapes pour produire un enregistrement:

  1. Accédez à la page où le bogue se produit.

  2. Démarrez l'enregistrement de votre écran.

  3. Actualisez la page.

  4. Effectuez l'action qui a provoqué le bogue.

  5. Attendez que le bogue se produise.

  6. Arrêtez l'enregistrement.

Exemple 2: Bogue dans l'application, testé sur un appareil mobile

Étapes pour produire le enregistrement:

  1. Lancez l'application et accédez à la page où le bogue se produit, en ne restant qu'à une étape de navigation pour y parvenir.

  2. Démarrez votre enregistrement.

  3. Affichez la date actuelle en faisant glisser vers le bas le centre de notification pendant quelques secondes.

  4. Effectuez la dernière étape de navigation pour atteindre la bonne page.

  5. Effectuez l'action qui déclenche le bogue.

  6. Attendez que le bogue se produise.

  7. Arrêtez l'enregistrement.

Les Chefs d'Équipe ("Team Leader") peuvent vous envoyer une demande d'information pour un enregistrement externe ou supplémentaire. Cela se fait pour mieux comprendre le bogue ou en cas de doute en raison de l'irreproductibilité du bogue.

Règles spécifiques aux enregistrement:

  • Les enregistrements doivent être au format MP4.

  • La durée maximale pour un enregistrement est de 60 secondes pour les rapports de bogue, sauf si votre bogue nécessite de montrer un processus de chargement ou de longues saisies manuelles.

  • La durée maximale pour un enregistrement est de 15 secondes pour les reproductions de bogue et les pièces jointes aux histoires d'utilisateurs ("User Stories"), car vous devez montrer uniquement la dernière action qui a déclenché le bogue.

  • Vos clics/tapotements/contacts et l'icône de la souris doivent être visibles (uniquement requis pour l'enregistrement Android et de bureau).

  • Faites votre enregistrement en une seule fois. Vous ne devez pas mettre en pause ni couper des parties au milieu. Si votre enregistrement est trop long et que vous souhaitez le modifier, coupez uniquement le début ou la fin du fichier.

  • L'augmentation de la vitesse de votre enregistrement n'est pas autorisée. Si vous avez enregistré plus que le temps autorisé, vérifiez si vous n'avez pas montré des étapes inutiles de votre enregistrement.

  • N'enregistrez pas de bruit (pleurs de bébé, conversations, télévision, musique, animaux, etc.).

Nous recommandons des outils d'enregistrement et les meilleures pratiques dans l'article suivant: Enregistrement.

Règles spécifiques aux enregistrement pour les appareils de diffusion en continu:

  • Enregistrez toujours l'intégralité de votre écran de télévision.

  • Les enregistrements doivent avoir une résolution élevée et une bonne qualité.

  • L'ambiance lumineuse ne doit pas être sombre.

  • Votre télécommande de télévision doit être visible dans l'enregistrement. De plus, la télécommande doit être entièrement et clairement visible.

  • La date et l'heure actuelles doivent être affichées dans la pièce jointe. Vous pouvez afficher la date actuelle sur la télévision elle-même ou sur un appareil externe tel qu'un PC, un téléphone ou une tablette.

  • Pour les rapports de bogue, la durée maximale pour un enregistrement est de 60 secondes, tandis que pour les reproductions de bogue et les pièces jointes aux histoires d'utilisateurs, la durée maximale est de 15 secondes.

  • Ne pas enregistrer de bruit (pleurs de bébé, conversations, télévision, musique, animaux, etc.).

  • Les enregistrements doivent toujours avoir un aspect professionnel. Ne filmez pas vos jambes, un meuble de télévision en désordre ou similaire.

Cacher les informations privées sur les pièces jointes

Pour protéger vos informations privées, telles que les signets, les noms de compte ou les courriels enregistrés, afin qu'elles ne soient pas visibles dans les onglets du navigateur, vous pouvez suivre cette technique simple pour les flouter. Cependant, pour un processus de signalement de bogue plus efficace, il est recommandé d'utiliser une fenêtre de navigateur dédiée à des fins de test, comme le montre l'exemple ci-dessous, qui n'affiche pas d'onglets de navigateur inutiles ni de signets visibles.

Si vous avez besoin d'inclure des informations privées dans vos pièces jointes mais que vous ne voulez pas qu'elles soient visibles, vous pouvez suivre cet exemple pour les masquer de manière professionnelle ; notez que les noms des onglets de navigateur qui peuvent afficher des adresses électroniques, des noms d'utilisateur et des signets sont masqués.

Il est important de noter que l'URL doit toujours être visible et que les éléments du site Web ne doivent pas être obstrués.

Pour des raisons professionnelles, il est essentiel d'éviter les méthodes de dessin à main levée ou d'esquisse pour masquer des informations dans vos pièces jointes, comme illustré dans l'exemple ci-dessous:

Avez-vous trouvé la réponse à votre question ?