Rapporter un bug : Différence entre versions
(→Comment rapporter un bug) |
|||
| Ligne 5 : | Ligne 5 : | ||
=Introduction= | =Introduction= | ||
| − | + | L'outil de gestion de tickets client d'OpenFlyers utilise le logiciel [https://www.openproject.org openproject] disponible à l'adresse https://project.openflyers.com. Il remplace l'ancien système utilisant '''Mantis''' comme outil "traceur de bugs" qui était disponible à l'adresse (http://bts.openflyers.org). | |
| − | + | Afin de pouvoir voir et créer un ticket, il est nécessaire de créer un compte. '''Ce compte est indépendant de votre accès à la plateforme OpenFlyers au gestionnaire client d'OpenFlyers'''. | |
| − | Nous sommes conscient que l'utilisation de cet outil nécessite un peu plus de temps pour rapporter une anomalie que l' | + | Nous sommes conscient que l'utilisation de cet outil nécessite un peu plus de temps pour rapporter une anomalie que l'envoi d'un email. Mais pour l'équipe de développement OpenFlyers, c'est un véritable gain de temps qui permet ainsi d'être plus efficace et donc de limiter les coûts. |
=Créer son compte= | =Créer son compte= | ||
| − | * | + | |
| − | * | + | *Se rendre sur le gestionnaire de ticket à l'adresse https://project.openflyers.com. |
| − | + | *En haut à droite, cliquer sur '''Sign In''', puis '''Create a new account'''. | |
| − | + | *Remplir le formulaire d'inscription. Un email de confirmation va vous être envoyé. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | * | + | |
| − | + | ||
| − | + | ||
| − | + | ||
*Aller sur votre messagerie pour retrouver cet e-mail. L'envoi de l'e-mail est instantané mais il est possible de devoir attendre plusieurs minutes avant qu'il n'apparaisse dans votre messagerie du fait d'un traitement par votre serveur de messagerie. Si vous ne le recevez pas, vérifiez qu'il n'a pas été mis de côté (voir supprimé) par un outil anti-spam attaché à votre messagerie. Enfin, si vous ne retrouvez pas l'e-mail, envoyez-nous un e-mail de demande d'activation manuelle de votre compte en nous précisant l'identifiant que vous avez choisi pour sa création. | *Aller sur votre messagerie pour retrouver cet e-mail. L'envoi de l'e-mail est instantané mais il est possible de devoir attendre plusieurs minutes avant qu'il n'apparaisse dans votre messagerie du fait d'un traitement par votre serveur de messagerie. Si vous ne le recevez pas, vérifiez qu'il n'a pas été mis de côté (voir supprimé) par un outil anti-spam attaché à votre messagerie. Enfin, si vous ne retrouvez pas l'e-mail, envoyez-nous un e-mail de demande d'activation manuelle de votre compte en nous précisant l'identifiant que vous avez choisi pour sa création. | ||
| − | + | *Cliquer sur le lien contenu dans le message pour activer votre compte. | |
| − | + | *Se connecter. | |
| − | * | + | |
| − | + | ||
| − | + | ||
| − | * | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
=Comment rapporter un bug= | =Comment rapporter un bug= | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | *Se connecter sur https://project.openflyers.com. | |
| − | + | *Sur la page d'accueil, dans la case "Projects", cliquer sur '''OpenFlyers'''. | |
| − | + | *Dans le menu de gauche, cliquer que '''Lots de travaux''' (ou '''Work Packages''' si vous êtes en anglais). | |
| − | + | *Avant de rapporter un bug, prenez le temps d'effectuer les actions suivantes : | |
| − | + | **Vérifier que le bug n'est pas déjà rapporté. | |
| − | + | **Renseigner les items dès le début pour éviter l'envoi dans une rubrique non adaptée. | |
| − | + | *Cliquer sur '''Créer''' puis '''Bug'''. | |
| − | + | *Remplir uniquement les champs '''titre''' et '''description'''. Seuls ces deux champs sont nécessaires. | |
| − | + | :*Dans la description : | |
| − | + | ::*Indiquez sur quelle plateforme OpenFlyers vous l'avez rencontré | |
| − | + | ::*Précisez l'identifiant de l'utilisateur concerné | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | ** | + | |
| − | ** | + | |
| − | * | + | |
| − | * | + | |
| − | + | ||
| − | * | + | |
| − | + | ||
| − | + | ::La description doit être complète pour que les développeurs sachent identifier l'endroit du problème. | |
| − | :* | + | ::*La nature "réelle" (non affichage, warning, etc.) du problème et sa manifestation. |
| − | :* | + | ::*Quelles sont les actions qui vous conduisent au bug sous la forme du fil d'Ariane (c'est à dire par exemple '''Admin > Utilisateurs > Utilisateurs''' puis icone '''Modifier la fiche utilisateur''') |
| + | ::*Joindre une copie d'écran est parfois plus explicite que de long discours. Ne pas en abuser, on ne cherche pas à documenter un bug pour le contourner mais à fournir des explications au développeur pour traitement. | ||
| + | *Valider. | ||
| − | : | + | Remarques : |
| − | + | ||
| − | + | ||
| − | + | ||
*En cours de traitement, utiliser les notes pour ajouter des informations, éviter les échanges par email parallèles. | *En cours de traitement, utiliser les notes pour ajouter des informations, éviter les échanges par email parallèles. | ||
| − | |||
*Lorsque le bug est résolu vous recevrez un email d'information : | *Lorsque le bug est résolu vous recevrez un email d'information : | ||
:*Merci de bien vouloir confirmer que le bug est résolu en '''fermant votre rapport de bug'''. | :*Merci de bien vouloir confirmer que le bug est résolu en '''fermant votre rapport de bug'''. | ||
Version du 14 mai 2021 à 19:29
Sommaire
Introduction
L'outil de gestion de tickets client d'OpenFlyers utilise le logiciel openproject disponible à l'adresse https://project.openflyers.com. Il remplace l'ancien système utilisant Mantis comme outil "traceur de bugs" qui était disponible à l'adresse (http://bts.openflyers.org).
Afin de pouvoir voir et créer un ticket, il est nécessaire de créer un compte. Ce compte est indépendant de votre accès à la plateforme OpenFlyers au gestionnaire client d'OpenFlyers.
Nous sommes conscient que l'utilisation de cet outil nécessite un peu plus de temps pour rapporter une anomalie que l'envoi d'un email. Mais pour l'équipe de développement OpenFlyers, c'est un véritable gain de temps qui permet ainsi d'être plus efficace et donc de limiter les coûts.
Créer son compte
- Se rendre sur le gestionnaire de ticket à l'adresse https://project.openflyers.com.
- En haut à droite, cliquer sur Sign In, puis Create a new account.
- Remplir le formulaire d'inscription. Un email de confirmation va vous être envoyé.
- Aller sur votre messagerie pour retrouver cet e-mail. L'envoi de l'e-mail est instantané mais il est possible de devoir attendre plusieurs minutes avant qu'il n'apparaisse dans votre messagerie du fait d'un traitement par votre serveur de messagerie. Si vous ne le recevez pas, vérifiez qu'il n'a pas été mis de côté (voir supprimé) par un outil anti-spam attaché à votre messagerie. Enfin, si vous ne retrouvez pas l'e-mail, envoyez-nous un e-mail de demande d'activation manuelle de votre compte en nous précisant l'identifiant que vous avez choisi pour sa création.
- Cliquer sur le lien contenu dans le message pour activer votre compte.
- Se connecter.
Comment rapporter un bug
- Se connecter sur https://project.openflyers.com.
- Sur la page d'accueil, dans la case "Projects", cliquer sur OpenFlyers.
- Dans le menu de gauche, cliquer que Lots de travaux (ou Work Packages si vous êtes en anglais).
- Avant de rapporter un bug, prenez le temps d'effectuer les actions suivantes :
- Vérifier que le bug n'est pas déjà rapporté.
- Renseigner les items dès le début pour éviter l'envoi dans une rubrique non adaptée.
- Cliquer sur Créer puis Bug.
- Remplir uniquement les champs titre et description. Seuls ces deux champs sont nécessaires.
- Dans la description :
- Indiquez sur quelle plateforme OpenFlyers vous l'avez rencontré
- Précisez l'identifiant de l'utilisateur concerné
- La description doit être complète pour que les développeurs sachent identifier l'endroit du problème.
- La nature "réelle" (non affichage, warning, etc.) du problème et sa manifestation.
- Quelles sont les actions qui vous conduisent au bug sous la forme du fil d'Ariane (c'est à dire par exemple Admin > Utilisateurs > Utilisateurs puis icone Modifier la fiche utilisateur)
- Joindre une copie d'écran est parfois plus explicite que de long discours. Ne pas en abuser, on ne cherche pas à documenter un bug pour le contourner mais à fournir des explications au développeur pour traitement.
- La description doit être complète pour que les développeurs sachent identifier l'endroit du problème.
- Valider.
Remarques :
- En cours de traitement, utiliser les notes pour ajouter des informations, éviter les échanges par email parallèles.
- Lorsque le bug est résolu vous recevrez un email d'information :
- Merci de bien vouloir confirmer que le bug est résolu en fermant votre rapport de bug.
- Si vous constatez que la solution ne correspond pas à votre description (totale ou partielle), relancez le sujet en le changeant d'état.
- Par contre si vous détectez une nouvelle anomalie rédigez un nouveau rapport de bug.
- La fermeture du Bug doit être effectuée par celui qui l'a émis.
- En l'absence d'action de votre part dans un temps raisonnable le développeur ou un administrateur le fermera.
Faire une copie d'écran
Il est souvent utile de joindre une copie d'écran montrant le problème. Cela permet de montrer visuellement le problème et peut nous faire gagner un temps précieux à comprendre la description du problème.
Le site de www.commentcamarche.net présente une explication sur comment réaliser des captures d'écran.
Sous Windows, la combinaison de touches Alt + PrintScreen donne le meilleur résultat dans la plupart des cas : la fenêtre active est capturée et placée dans le presse papier. Il faut l'enregistrer avec un nom de fichier type jpg. Pour cela il existe une multitude de logiciels de traitement d'images. Ceci dépend des utilisations que vous souhaitez en faire :
- le plus simple est l'utilitaire Paint inclut dans Windows mais il n'est pas très pratique
- Gimp est très complet mais lourd pour juste faire des copies d'écran
FastStone est pratique si vous devez capturer une page qui est plus grande que l'écran ou une portion de l'écran et il permet de sauver la capture au format que l'on souhaite.
Description des états et de l'avancement de la résolution
Etats
| Intitulé de l'état | Description | Qui devrait mettre cet état |
|---|---|---|
| nouveau | nouveau bug, c'est l'état initial | le rédacteur du bug |
| commentaire | le bug nécessite plus d'informations, le rédacteur du bug devrait y préter attention | un gestionnaire ou un développeur |
| accepté | le bug a été lu mais n'est ni confirmé ni assigné | un gestionnaire ou le développeur dont dépend le bug |
| confirmé | le bug est confirmé et reproductible | un gestionnaire ou un développeur |
| assigné | le bug est assigné à un développeur | un gestionnaire ou un développeur qui le prend en charge |
| résolu | le bug devrait être résolu, en attente de la confirmation de sa résolution par le rédacteur du bug | le développeur qui a corrigé le bug |
| fermé | le bug est fermé | le rédacteur initial du bug ou un gestionnaire ayant confirmé le bug |
Résolutions
| Intitulé de la résolution | Description |
|---|---|
| ouvert | bug ouvert en attente |
| résolu | bug résolu d'après le développeur responsable |
| réouvert | bug considéré comme toujours existant après correction |
| impossible à reproduire | le bug rapporté n'arrive pas à être reproduit |
| impossible à corriger | il n'y a pas de possibilité de corriger le bug |
| doublon | le bug a déjà fait l'objet d'un rapport dans le BTS |
| pas un bug | Ce n'est pas considéré comme un bug |
| suspendu | Le bug est mis de côté |
| ne sera pas résolu | Le bug est reconnu mais ne sera pas résolu |
Comment fermer un rapport ?
Une fois qu'un rapport est positionné sur "résolu", voici comment procéder pour le fermer :
- Cliquer sur le bouton "Rouvrir"
- Mettre l'état du bug sur "fermer"
Traitement des bugs dans le BTS (pour les développeurs et gestionnaires)
- Lorsqu'un bug est résolu il faut faire attention à le marquer comme tel dans la version en cours de modif (=donc normalement la future version publiée)
- La fermeture du Bug doit être effectuée par celui qui l'a reporté.
- En l'absence d'action de sa part dans un temps raisonnable un gestionnaire le fermera.
Suivez vos bugs
Interopérabilité
JavaScript
Les interactions dynamiques d'OpenFlyers nécessitent que JavaScript soit actif. Voici une page du support AdSense de Google qui présente les différentes méthodes d'activation de JavaScript en fonction du navigateur.
