Documentation utilisateur MANTIS

Transcription

1 Documentation utilisateur MANTIS Outil de suivi d anomalies des Référents Utilisateur : Rapporteur

2 SOMMAIRE 1 Préambule Convention typographique ICONES Attributs Contexte Rôles utilisateurs Objet du document Utilisation Première connexion Description de la page d accueil (Mon affichage) Recherche et filtres (Afficher les Bug) Déclaration d anomalie (Rapporter un bug) Déclaration détaillée (Rapport détaillé) Modification/consultation d une demande (click sur ID anomalie) Visualisation historique (historique du bug) Utilisation avancée : Modification paramétrage du compte (options) Lien Option Lien préférences Lien Profils Lien documentation projet (Documentation) Lien Rapport imprimable (Rapport imprimable)...24 Contacts Pôle Animation Service Assistance : Jean-Michel Kellern Diane Vidal Téléphone : (numéro indigo) Courriel : info.pft@regioncentre.org Page 2 / 24

3 Chapitre 1 - Préambule 1 Préambule 1.1 Convention typographique ICONES Les icônes ci-dessous sont utilisés dans ce document pour attirer l attention du lecteur sur un point particulier. Donne une information complémentaire qui n est pas nécessaire pour la compréhension du concept présenté Message d alerte : il est préférable de lire attentivement cette remarque avant de passer à la suite.. Commentaire ou remarque. Donne un niveau de détail supplémentaire sur l information traitée. Trucs ou astuces Ce chapitre décrit des fonctions qui seront intégrées dans la prochaine version. Elles sont présentées à titre d information Attributs Dans ce document, des mots ou des groupes de mots apparaissent en gras ou en italique. Les Mot en gras désignent un menu ou un choix existant dans une interface graphique Exemple : Sélectionnez Fichier, Enregistrer sous pour sauvegarder un fichier existant sous un autre nom. Page 3 / 24

4 Chapitre 1 - Préambule Gras/italique sont utilisés pour les têtes de chapitre ou pour faire ressortir certains concepts du corps du texte. Italics. Comme indiqué dans la section précédente Conventions Typographiques, l italique est utilisé pour présenter un texte associé à une icône. La police Courier est utilisée pour la présentation des scripts ou des mots clés. Pour des exemples de script complet, le code apparaît dans un tableau ou bien sur un fond gris pour le différencier du texte. Le formalisme des titres correspond aux liens de navigation : description de la fonctionnalité (Liens de navigation réel) 1.2 Contexte La solution MANTIS a été sélectionnée pour la plate-forme Libres Savoirs comme gestionnaire de suivi d incidents. Il a été personnalisé en fonction des besoins des utilisateurs et des contraintes projet. 1.3 Rôles utilisateurs Il existe dans MANTIS différents types d'utilisateurs avec des profils qui leur donnent accès à des fonctionnalités spécifiques. Ces profils ont des droits décroissants : Administrateur > Chef de projet > Développeur > Rapporteur > Invité Concrètement, MANTIS devant permettre aux Référents des organismes de formation de signaler les anomalies et les disfonctionnements qu'ils peuvent constater au cours de leur utilisation de la plate-forme LIBRES SAVOIRS, le rôle qui leur est conféré est celui de Rapporteur. Les incidents signalés dans MANTIS par les rapporteurs font l'objet d'un premier niveau d'analyse et de qualification par les membres du Service Assistance (Pôles Animation Libres Savoirs). L'objectif de cette qualification est de faire le tri entre : - ce qui peut relever d'un problème utilisateur (erreurs de manipulation, mauvais paramétrage du poste de travail, etc ) - ce qui relève d'un disfonctionnement effectif de la plate-forme, susceptible d'être traité et résolu par le prestataire technique. Les incidents qualifiés sont transmis par le Pôle Animation au prestataire technique pour analyse approfondie et résolution. Page 4 / 24

5 1.4 Objet du document Chapitre 1 - Préambule Le but de ce document est de décrire l utilisation du gestionnaire d anomalie pour le rôle rapporteur. Page 5 / 24

6 2 Utilisation 2.1 Première connexion Adresse web de connexion à l'outil MANTIS : Attention c est une connexion SSL, il faut accepter le certificat pour pouvoir accéder au site. Les exemples d Url ne sont pas significatifs, les textes, sont indiqués à titre d exemple. L Url d accès est communiquée aux utilisateurs par courrier ou courrier électronique. L accès au site a été testé avec : Internet Explorer Sp 2 Page 6 / 24

7 Permet de sauvegarder les paramètres de connexion (propre à chaque navigateur) Fonctionnalités l'instant inhibées pour Suivant les navigateurs, il est possible de sauvegarder le mot de passe sans avoir besoin de le saisir à chaque fois Une fois identifié, l'utilisateur accède à la page d accueil (cf2.2). Page 7 / 24

8 2.2 Description de la page d accueil (Mon affichage) Information identification d Menu de navigation Projet cours en Recherche par «Bug ID» Valeur numérique Comptage des Bug par état Action ou Etat (1-N / total N étant le nombre affiché Page 8 / 24 Les couleurs représentent les états des déclarations en cours sur le projet. Incident venant d être déclaré Incident mis à l état de commentaire Incident état accepté Incident état confirmé Incident état affecté Incident état résolu Incident état fermé Menu de navigation Accueil Lien d information générale, News diffusée par le chef de projet Mon affichage Lien d accueil utilisateur Cf chapitre :2.2

9 Afficher les bugs Lien de recherche Cf chapitre :2.3 Rapporter un bug Lien de saisie Cf chapitre :2.4 Changements Lien des changements Documentation Lien de documentation Cf chapitre :2.9 Options Lien de modifications de profil Cf chapitre :2.8 Déconnexion Lien de déconnexion (à utiliser de préférence avant fermeture du navigateur) En général le cycle de vie d un bug passe successivement par les états suivants : Nouveau Accepté/Affecté Résolu Fermé Page 9 / 24

10 2.3 Recherche et filtres (Afficher les Bug) Combos permettant la sélection d un filtre Efface le filtre existant ou réinitialise aux valeurs par défaut Critère de tris Zone d export ou d impression Permet les multi sélections dans les combos Zone pouvant être déployée ou fermée Les filtres sont sauvegardés d une session à une autre. Aucun critère n est plus pertinent plus qu un autre, tout dépend du but de la recherche. Il est possible de personnaliser ses filtres et de les enregistrer, si les droits ont été donnés par l administrateur du projet Le bouton d action «effacer le filtre» permet de remettre les paramètres aux valeurs par défaut. Toutes les zones sont sélectionnables ou modifiables (cas des dates) Afin de ne pas surcharger l écran il est conseillé de garder le filtre : Cacher le statut sur fermé ou supérieur et afficher l état sur tous. Page 10 / 24

11 Exemple de modification de critère de sélection : Combo sélection de Les filtres sont sauvegardés d une session à une autre, risque de ne pas afficher des anomalies non résolues suivant le filtre. Ex : Pour ne pas afficher les incidents fermés sélectionner «fermé», puis cliquer sur filtrer Sélection multiple Ex : De sélection en mode filtre avancé, permettant la multi sélection dans les combos box, ceci permettant des critères de recherches plus Page 11 / 24

12 fins. 2.4 Déclaration d anomalie (Rapporter un bug) Depuis n'importe quelle page, il est possible d accéder à cette page par l intermédiaire du menu de navigation générale. Combos de sélections Accès rapport détaillé au (*)Indique une zone de saisie obligatoire *Résumé *Description Informations complémentaires Champs résumant le bug ou la demande. Description du bug, ce champ doit contenir la description du bug constaté. Permet de valoriser des informations complémentaires, ce champ n est pas obligatoire, mais le valoriser augmente la complétude de la réponse. Page 12 / 24

13 Le champ : catégorie, est propre à chaque utilisateur, est à définir dans la partie configuration profil Les champs : reproductibilités, sévérités sont propres à chaque projet, et sont à définir avec le pôle Animation. Sinon les valeurs par défaut sont : Reproductibilité de l incident, N/A si «non applicable» Sélection de la sévérité de l incident, la valeur est à définir par projet. La sévérité de l incident, influe sur le workflow de mail, si ce dernier est actif Page 13 / 24

14 Il est possible selon les droits du projet, de joindre des documents, des écrans, des binaires, la taille maximum de Up-load est indiquée dans la zone de gauche. La notion publique, privée est propre à chaque projet, en général il faut laisser la valeur public, car sinon la note est modifiable uniquement par le créateur de cette dernière. Garder le rapport, permet la saisie d autres bugs, sans revenir sur l écran précédent Page 14 / 24

15 2.5 Déclaration détaillée (Rapport détaillé) Si l utilisateur a déjà remplit des champs, en rapport simplifié, ces derniers gardent leurs valorisations. Basculement de mode Combo de sélection de profil, correspond généralement aux groupes logiciel ou machines en maintenances. Il est possible de paramétrer plusieurs profils, décrivant l ensemble des plates-formes suivies (Cf la partie configuration : 2.8.3) Généralement un profil correspond à un produit ou un type de machine La bascule du mode simplifié à détaillé se fait par simple click Le profil permet de sélectionner automatiquement la plate-forme, OS et Version concernée. Ces profils sont valorisés par l utilisateur ou le manager du projet (cf 2.8.3) Page 15 / 24

16 2.6 Modification/consultation d une demande (click sur ID anomalie) Il est possible de passer en mode modification/consultation de la demande, soit par Mon affichage ou par le mode de recherche : Afficher les bugs. Permet de suivre par mail l évolution d une anomalie Permet de rouvrir une anomalie fermée ou clôturée Relation «Inter bug» Suivant le paramétrage du projet, il est possible de clôturer une anomalie, définition donnée par le manager du projet. Démarrer la surveillance d un «bug» permet de recevoir un mail (à l adresse paramétrée dans ses options) à chaque changement d état de celui-ci. Pour les différentes valeurs des états cf 2.2 «Relation» : Certaines anomalies peuvent être mises en relation avec d autres, car elles peuvent êtres liées: Ce champ est informatif, et permet de naviguer vers d autres anomalies liées. Page 16 / 24

17 La taille des pièces jointes est limitée et indiquée par l administrateur, la valeur par défaut est en général : ko. Une demande évolue au travers des notes ajoutées, la partie historique décrie chaque modification, changement d état, ajout de note Page 17 / 24

18 2.7 Visualisation historique (historique du bug) Si la note appartient à l utilisateur il peut la modifier ou la supprimer Historique l incident de Toute action est synthétisée dans un tableau récapitulatif intitulé historique du «bug». Date de modification, les différents intervenants, les champs modifiés, et les changements d état. On peut naviguer plus rapidement en cliquant sur les raccourcis comme [Ajouter une note]. Page 18 / 24

19 2.8 Utilisation avancée : Modification paramétrage du compte (options) Lien Option Cette option permet de modifier le mot de passe, l adresse mail de l utilisateur, et son nom réel. Modification paramètres compte des du Modification profiles des Attention ces actions peuvent rendre le site inaccesible, comme par exemple une mauvaise saisie du mot de passe L adresse mail doit être valorisée correctement, car elle est permet (si cette fonction est active) d informer l utilisateur de l évolution du bug. le wokrflow de diffusion est paramétrable par projet. En revanche : Il est indispensable d avoir ce champ valorisé avec une adresse valide au niveau syntaxique (Ex : nom@nomdudomaine), sinon une erreur aura lieu lors de la mise à Page 19 / 24

20 jour de l utilisateur Lien préférences Cette partie est à «valoriser» avec précaution, en général les valeurs par défaut, ci dessous sont correctes. Ces valeurs sont fixées à la création du projet, et ne doivent pas être modifié, sauf cas exceptionnels. Validation des modification s Ces options permettent de personnaliser par utilisateur l affichage et la saisie des demandes. rapport détaillé : permet d avoir la saisie en mode détaillé, plutôt que le mode simplifié : plus adapté au suivi d un parc de machines vue détaillée :idem, en visualisation Mise à jour avancée : Idem pour la modification délai de rafraîchissement : délai exprimé en minute Délai de redirection : délai exprimé en secondes avant la redirection vers une autre Url (ex sur une confirmation) Suivant le projet, demander à l administrateur le niveau de compatibilité pour les langues gérées. Page 20 / 24

21 L utilisateur peut choisir de recevoir les mails en fonction des différents critères sélectionnés, mais ses choix peuvent avoir aucune action suivant le paramétrage du Workflow fait par l administrateur. Suivant les contraintes projets les mails peuvent être systématiquement envoyés à l adresse paramétrée dans les «Options» utilisateurs « Bug note limite»nombre de notes modifiées entraînant une notification par mail Lien Profils Cette partie permet de paramétrer des «profils» de sélection dans le mode détaillé de la saisie d un bug. Sélection du profil à modifier Ajout d un nouveau profil Validation de ma modification d un profil existant Valoriser les profils permet de gagner du temps en saisie et en précision de «reporting» de la demande. Ex : Plate-forme : Mantis Système d exploitation : Linux debian Page 21 / 24

22 Version : 1.0 Il n y a pas de limite dans le nombre de profils Page 22 / 24

23 2.9 Lien documentation projet (Documentation) Le pôle Animation peut mettre à disposition des documentations. Cela peut être des pieces jointes, des liens vers d autres sites. Page 23 / 24

24 2.10 Lien Rapport imprimable (Rapport imprimable) Ce lien permet d exporter les anomalies sous différents formats, afin de les traiter dans un tableur par exemple ou de les imprimer. Case à cocher pour sélectionner le bug à imprimer Puis cliquer sur «afficher seulement» Si aucun n est coché, tous sont sélectionnés Type d export imprimable Différent format d export et d impression sont disponibles. Les sélectionner permet de filtrer les anomalies à exporter. Sous forme Excel, Word : Attention due à un bug Microsoft, la liaison avec le fichier css ne fonctionne pas en «https», pour conserver la mise en forme il faut modifier le fichier téléchargé en mettant le fichier de style en local. Fichier d export Excel Mise en forme Browser Internet Mise en forme pour Word Mise en forme identique à Word pour un browser Page 24 / 24