L'essentiel de Mantis

Mantis est un outil collaboratif permettant d’ouvrir des entrées appellées tickets et de suivre leur résolution en y associant des resources (notes,documents), des informations (étapes de reproduction, informations, description) et des métadonnées (priorité, impact, statut).

Il est accessible pour les utilisateurs à l’adresse suivante : https://mantis.admin.sai-erp.net

Ces tickets sont majoritairement utilisés pour rapporter des bugs ou des demandes d’évolution mais peuvent servir à beaucoup d’autres fonctions :

• Demande de nouvelle fonctionnalités
• Question
• etc…

Un ticket Mantis est caractérisé par une couleur qui indique son état de résolution.

Lorsqu’un ticket est créé, il n’est assigné à personne. Lorsqu’il a été pris en compte, il est assigné à la personne responsable de son traitement et de sa résolution. Le responsable d’un ticket peut être changé par l’équipe de développement en fonction des besoins. En cas de questions, les tickets sont ensuite assignés aux personnes devant y répondre.

---

Création de compte et connexion

Les comptes ne peuvent pas être créés par les utilisateurs, seuls les administrateurs peuvent créer un nouveau compte sur Mantis.

Une fois le compte créé, vous recevrez un email contenant un lien permettant l’initialisation de votre compte. Ce lien ne permet de se connecter qu’une seule fois uniquement, dans le but d’initialiser son mot de passe. Ainsi le compte peut être créé sans que personne ne connaisse votre mot de passe.

Sur cet écran, il vous sera possible de corriger votre nom ainsi que de saisir un mot de passe. Mémorisez ce mot de passe car il sera demandé lors de chaque connexion au site.

Une fois le compte créé et le mot de passe saisi, le système vous demandera de vous connecter à nouveau en saisissant votre nom d’utilisateur et votre mot de passe.

---

Mon affichage

Accessible par la navigation Mon affichage regroupe les informations essentielles à savoir d’un coup d’oeil.

Les tickets qui me sont assignés

Dès que l’une personne est responsable de l’avancement du ticket, que ce soit pour un développement, une réponse à une question, un supplément d’analyse, … le ticket lui est assigné et apparaît ici.

Les tickets qui ne sont pas assignés

Ces tickets sont ouverts et n’ont pas de personne de référence. Ce n’est pas pour ça qu’il ne seront pas traités. Il n’y a simplement pas une seule personne qui peut s’en occuper.

Les tickets que j’ai rapportés

On trouve ici les tickets qu’on a soi-même rapporté ce qui permet d’y accéder facilement

Les ticket résolus

Dès qu’un ticket est marqué comme résolu, il apparaît dans la liste, ce qui permet de savoir en continu l’avancement des demandes

Les tickets modifiés récemment

Dès qu’une personne change le statut d’un ticket, ajoute une note ou un document, ou apporte la moindre modification, le ticket apparaît ici.

---

Vue globale et exports

Accessible par la navigation Afficher les bugs permet de voir la liste complète de tous les tickets disponibles sur le projet. Les ticket se présentent sous la forme d’une liste unique triable.

Dans la première partie il est possible filtrer en fonction de tous les critères du ticket. Il suffit pour cela de cliquer sur l’entête du filtre pour choisir sa valeur. Pour filtrer suivant plusieurs critères il est nécéssaire de cliquer sur le lien Filtres avancés.

La recherche affiche tous les tickets correspondants. Il est possible de sauvegarder des filtres pré-définis afin de faciliter le travail courant, par exemple en préparant une liste de tickets ouverts, étant attribués à une personne, devant être validés, …

Si le projet contient des informations personnalisées, tel qu’une classification par domaines par exemple, ces informations peuvent également être exportées, suivant la configuration mise en place. Si des colonnes manquent, il est possible de demander leur ajout dans l’écran de rapports.

En haut de la liste des tickets un certain nombre d’opérations telles que l’export Excel des tickets sont disponibles. Les colonnes disponibles dans l’export dépendent du projet. Il est possible d’afficher des colonnes différentes dans les rapports Excel et dans l’affichage courant afin de pouvoir exploiter plus de données.

En plus d’exports sous forme de liste, il est possible de générer des documents de rapport sous forme imprimable. Ces documents peuvent être ouverts dans Word et imprimés sur papier.

L’export peut se faire vers Word ou un navigateur Internet. Ces documents contiennent toutes les informations présentes dans le ticket ainsi que les notes et des liens vers les fichiers attachés au ticket. Si tous les tickets ne doivent pas être exportés, il est possible de sélectionner une partie des tickets uniquement.

---

Accès en lecture

En mode lecture, les tickets ne sont pas modifiables. Il est néanmoins possible d’ajouter des notes. Un ticket se présente sous forme de tableau contenant des informations. Voici un exemple de ticket avec le descriptif de chaque champ.

Identifiant

Chaque ticket a son numéro unique qui permet facilement d’y accéder par l’url. Dans le cas du Mantis SAIERP®, l’url est toujours sous la forme suivante :

http://mantis.admin.sai-erp.net/view.php?id=<#ticket>

Projet

Il est possible d’avoir plusieurs projets ouverts qui permettent de trier les tickets. Dans la plupart des utilisations, tous les tickets sont regroupés dans le même projet et un seul projet est accessible.

Catégorie

Les ticket sont triés en différentes catégories qui varient par projet. Ceci qui permet de mieux juger de leur importance :

• Adaptation
• Bug
• Question
• Evolution

Il est crucial de bien définir le bon type afin qu’il soit traité correctement.

Afficher l’état

Certains tickets peuvent être cachés des utilisateurs non responsables. L’état peut alors être privé. Dans notre utilisation standard, tous les tickets sont publiques.

Rapporteur

C’est la personne qui a créé le ticket

Assigné à

C’est la personne responsable actuellement de l’avancement du ticket. Cette personne peut changer le long de la vie du ticket

Priorité

Les ticket peuvent être triés par priorité de traitement. Il est important de comprendre que si tous les ticket sont prioritaires, aucun ne l’est. La priorié est généralement redéfinie (ou pas) par la personne à qui le ticket est assigné. Les priorités sont :

• Aucune
• Basse
• Normale
• Elevée
• Urgente
• Immédiate

Etat

Cette information indique l’avancement du bug. Les possibilités sont :

• Nouveau - Vient d’être ouvert et n’est pas encore affecté
• Accepté - Lu et accepté. Souvent utilisé pour des développements importants planifiés
• Affecté - Assigné à une personne mais pas traité
• Résolu dev - Terminé au niveau developpement, pas encore disponible pour le client
• Livré test - Livré sur serveur de test, en attente de validation coté client
• Feedback - Le client a identifié des problèmes dans la version livée
• Validé - Le client a testé/validé le ticket
• Fermé - Le ticket est terminé et livré en production

Tous les tickets passent normalement par les états Nouveau, Affecté, Résolu dev, Livré test, Validé puis Fermé. Les tickets plus complexes utilisent l’état supplémentaire Accepté en attendant le début des travaux.

Résumé

Une description succinte du la problématique

Descriptions, étapes, etc…

Des informations clés sur la compréhension du ticket

Pièces jointes

Il est possible d’adjoindre des documents divers (images, pdf, Word, Excel) aux tickets afin de mieux pouvoir faire l’analyse de la demande. Toutes les pièces sont disponibles ici.

En accès en lecture, les utilisateurs peuvent faire des commentaires en passant par la saisie des notes

---

Saisie des notes

La saisie des notes permet de communiquer entre les différents acteurs du système tout en gardant la trace de ce chacun a dit.

Il est possible d’attacher un ou plusieurs fichiers à chacune des notes liées au ticket. Ceci permet d’attacher des documents d’output de la solution, des documents annotés afin de préciser les demandes, …

Les notes sont visibles à la fin du ticket et sont saisissables grâce au mémo disponible.

Une note privée ne sera pas visible des utilisateurs simples mais ne sera visible que par la personne qui a créé la note et par les administrateurs. D’autres systèmes de droits sont disponibles dans Mantis et dépendent de la configuration initiale.

---

Edition des tickets

Lors de la consultation d’un ticket, il est possible, pour autant que les droits vous aient été attribués, d’éditer un ticket.

Si des informations complémentaires sont à fournir, il est préférable de les ajouter sous forme de notes dans le ticket. L’édition devrait être réservée à l’édition des métadonnées du ticket : Classification, modification de l’importance, correction du titre pour être plus précis, …

Pour éditer un ticket, il suffit de cliquer sur le bouton Modifier présent au fond de l’écran.

Toutes les informations présentes dans le ticket sont affichées sous forme de menus et de champs de saisies, comme lors de la création d’un ticket.

Pour la description et la signification exacte des différents champs, se référer à la section sur la lecture d’un ticket.

Si des champs personnalisés ont été activés pour le projet, il est possible de les modifier dans cet écran.

Une fois les modifications effectuées, cliquer sur le bouton Mettre à jour l’information. Une email de notification sera envoyé au responsable du ticket ainsi qu’à la personne l’ayant rapporté.

---

Rapporter un ticket

Pour créer un ticket il suffit de cliquer sur le lien Rapporter un bogue dans la navigation de Mantis ou d’accéder au lien suivant :

http://mantis.admin.sai-erp.net/bug_report_page.php

---

Changer l'état d'un ticket

Pour valider un ticket il faut avoir les droits de modification. Il suffit ensuite de se rendre dans le ticket concerné en cliquant sur le lien dans la liste ou en accédant directement à l’url comme vu précédement.

Il faut ensuite cliquer sur le bouton Changer l’état en après avoir selectionné le bon état. Le prochain état disponible est automatiquement présenté.

Ceci ouvre un deuxième panneau ou on peut mettre un commentaire associé au changement d’état