Documentation Mantis v2.4-2830307 - Libres … Générale Formation Education Direction des Formations professionnelles Documentation utilisateur MANTIS Outil de suivi d’anomalies

Direction Générale Formation Education Direction des Formations professionnelles

Documentation utilisateur

MANTIS

Outil de suivi d’anomalies des Référents

Utilisateur : Rapporteur

Direction Générale Formation Education Direction des Formations

professionnelles

Page 2 / 24

SOMMAIRE 1 Préambule.........................................................................................................................3

1.1 Convention typographique .........................................................................................3 1.1.1 ICONES..............................................................................................................3 1.1.2 Attributs...............................................................................................................3

1.2 Contexte.....................................................................................................................4 1.3 Rôles utilisateurs........................................................................................................4 1.4 Objet du document.....................................................................................................5

2 Utilisation...........................................................................................................................6 2.1 Première connexion ...................................................................................................6 2.2 Description de la page d’accueil (Mon affichage) ......................................................8 2.3 Recherche et filtres (Afficher les Bug) .....................................................................10 2.4 Déclaration d’anomalie (Rapporter un bug) .............................................................12 2.5 Déclaration détaillée (Rapport détaillé)....................................................................15 2.6 Modification/consultation d’une demande (click sur ID anomalie) ...........................16 2.7 Visualisation historique (historique du bug) .............................................................18 2.8 Utilisation avancée : Modification paramétrage du compte (options) ......................19

2.8.1 Lien Option .......................................................................................................19 2.8.2 Lien préférences ...............................................................................................19 2.8.3 Lien Profils ........................................................................................................21

2.9 Lien documentation projet (Documentation) ............................................................23 2.10 Lien Rapport imprimable (Rapport imprimable) ...................................................24

Contacts Pôle Animation – Service Assistance : Jean-Michel Kellern Diane Vidal Téléphone : 0820-820-045 (numéro indigo) Courriel : [email protected]


professionnelles

Chapitre 1 - Préambule

Page 3 / 24

1 Préambule

1.1 Convention typographique

1.1.1 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.

1.1.2 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.


professionnelles


Page 4 / 24

• 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 na vigation : 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.


professionnelles


Page 5 / 24

1.4 Objet du document

Le but de ce document est de décrire l’utilisation du gestionnaire d’anomalie pour le rôle rapporteur.


professionnelles

Chapitre 2 - Utilisation

Page 6 / 24

2 Utilisation 2.1 Première connexion

Adresse web de connexion à l'outil MANTIS : https://supporttma.citb.bull.net

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

Attention c’est une connexion SSL, il faut accepter le certificat pour pouvoir accéder au site.


professionnelles


Page 7 / 24

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).

Permet de sauvegarder les paramètres de connexion (propre à chaque navigateur)

Fonctionnalités pour l'instant inhibées


professionnelles


Page 8 / 24

2.2 Description de la page d’accueil (Mon affichage )

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

Menu de navigation

Information d identification

Projet en cours

Recherche par « Bug ID » Valeur numérique

Comptage des Bug par état Action ou Etat (1-N / total N étant le nombre affiché


professionnelles


Page 9 / 24

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é


professionnelles


Page 10 / 24

2.3 Recherche et filtres (Afficher les Bug)

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.

Combos permettant la sélection d’un filtre

Zone pouvant être déployée ou fermée

Zone d’export ou d’impression

Efface le filtre existant ou réinitialise aux valeurs par défaut

Permet les multi sélections dans les combos

Critère de tris


professionnelles


Page 11 / 24

Exemple de modification de critère de sélection :

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

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

Combo de sélection

Sélection multiple


professionnelles


Page 12 / 24

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.

(*)Indique une zone de saisie obligatoire

*Résumé Champs résumant le bug ou la demande. *Description Description du bug, ce champ doit contenir la description

du bug constaté. Informations

complémentaires Permet de valoriser des informations complémentaires, ce champ n’est pas obligatoire, mais le valoriser augmente la complétude de la réponse.

Combos de sélections

Accès au rapport détaillé


professionnelles


Page 13 / 24

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


professionnelles


Page 14 / 24

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


professionnelles


Page 15 / 24

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.

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)

Combo de sélection de profil, correspond généralement aux groupes logiciel ou machines en maintenances.

Basculement de mode


professionnelles


Page 16 / 24

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.

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.

Permet de suivre par mail l’évolution d’une anomalie

Permet de rouvrir une anomalie fermée ou clôturée

Relation « Inter bug »


professionnelles


Page 17 / 24

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 : 2 000 ko.

Une demande évolue au travers des notes ajoutées, la partie historique décrie chaque modification, changement d’état, ajout de note …


professionnelles


Page 18 / 24

2.7 Visualisation historique (historique du bug)

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].

Historique de l’incident

Si la note appartient à l’utilisateur il peut la modifier ou la supprimer


professionnelles


Page 19 / 24

2.8 Utilisation avancée : Modification paramétrage du compte (options)

2.8.1 Lien Option Cette option permet de modifier le mot de passe, l’adresse mail de l’utilisateur, et son nom réel.

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 à

Modification des paramètres du compte

Modification des profiles


professionnelles


Page 20 / 24

jour de l’utilisateur.

2.8.2 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.

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.

Validation des modifications


professionnelles


Page 21 / 24

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

« Email Bug note limite »Nombre de notes modifiées entraînant une notification par mail

2.8.3 Lien Profils Cette partie permet de paramétrer des « profils » de sélection dans le mode détaillé de la saisie d un bug.

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

Sélection du profil à modifier

Ajout d’un nouveau profil

Validation de ma modification d un profil existant


professionnelles


Page 22 / 24

Version : 1.0 Il n’y a pas de limite dans le nombre de profils


professionnelles


Page 23 / 24

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.


professionnelles


Page 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.

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

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

Documents

Documentation Mantis v2.4-2830307 - Libres … Générale Formation Education Direction des Formations professionnelles Documentation utilisateur MANTIS Outil de suivi d’anomalies