Skip to content
This repository was archived by the owner on Oct 9, 2023. It is now read-only.

Commit 3245afc

Browse files
stonebuzzstonebuzz
committed
Ajout de la documentation du plugin, modification du code et des langues
1 parent 89ddc8b commit 3245afc

20 files changed

Lines changed: 1423 additions & 55 deletions

‎README‎

Lines changed: 0 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +0,0 @@
1-
# Plugin Mantis
2-
3-
Plugin générique à reverser à la communauté.
4-
5-
Création d’un ticket Mantis à partir des données d’un ticket GLPI via un onglet.
6-
7-
Échange d’URL avec les ID entre GLPI et Mantis via les Web Service.
8-
9-
Nécessite un compte Mantis ayant les droits de création.
10-
11-
Le statut du ticket Mantis sera affiché dans le ticket GLPI
12-
13-
Le statut Fermer de Mantis déclenche le statut Clos dans GLPI
14-
15-
## Notes specs
16-
17-
Utilisation de Mantis pour le bugtracking à cette occasion :
18-
- un ticket GLPI peut-être escaladé dans Mantis
19-
- une clôture/mise à jour dans Mantis doit être transférée au ticket initial GLPI
20-
21-
Un onglet "Mantis" est présent dans un ticket GLPI (si l'utilisateur a au moins le droit lecture mantis) :
22-
- si le ticket est déjà lié à un bug mantis, l'état du bug est affiché avec un lien vers le bug Mantis
23-
- sinon, un lien pour escalader le ticket vers Mantis est affiché
24-
25-
-- quand on clique sur ce lien, on affiche un formulaire permettant au chef de projet de choisir :
26-
---> choisir le projet Mantis
27-
---> le résumé Mantis, la description Mantis et les étapes à reproduire Mantis
28-
---> envoyer les pièces jointes GLPI vers le Mantis
29-
---> les informations du ticket GLPI sont mises dans le champ Informations complémentaires GLPI
30-
---> l'url du ticket GLPI est dans à mettre dans le champ "Ref WINCALL"
31-
32-
Etat (fermé) dans Mantis -> Passe le ticket en "Résolu" dans GLPI.
33-
34-
http://mantis.conseil-etat.fr/api/soap/mantisconnect.php?wsdl
35-
36-
http://mantis.conseil-etat.fr/api/soap/mantisconnect.php

‎docs/README_FR.asciidoc‎

Lines changed: 190 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,190 @@
1+
= Documentation pour le plugin MantisBT
2+
3+
Cette documentation vous permettra de configurer rapidement le plugin MantisBT
4+
5+
== Prérequis
6+
Glpi version 0.84
7+
8+
== Configuration
9+
10+
=== Configuration du plugin
11+
image::config.png[Configuration du plugin MantisBT]
12+
13+
IP du serveur Mantis ::
14+
Fait référence à l'adresse IP du Serveur qui heberge votre MantisBT.
15+
Chemin du fichier WSDL ::
16+
Fait référence un chemin du fichier WSDL (par defaut :mantis/api/soap/mantisconnect.php?wsdl.
17+
Login utilisateur MantisBT ::
18+
Login de l'utilisateur MantisBT qui va éffectuer les requêtes.
19+
Password de l'utilisateur MantisBT ::
20+
Password de l'utilisateur MantisBT qui va éffectuer les requêtes.
21+
Champ MantisBT pour le lien vers le ticket Glpi ::
22+
Champ MantisBT qui va accueillir le lien vers le ticket Glpi (informations additionnels ou note).
23+
Champ MantisBT pour les champs Glpi ::
24+
Champ MantisBT qui va accueillir le infos du ticket Glpi (informations additionnels ou note).
25+
Résoudre le ticket Glpi que le statut du ticket Mantis BT est ::
26+
Au choix -> new, confirmed, assigned, resolved, closed.
27+
Une tâche automatique va interroger tous les tickets MantisBT liés à un ticket Glpi. Lorsque
28+
tout les tickets MantisBT ont le statut choisi par l'utilisateur,
29+
la tâche va alors changer le statut du ticket Glpi en "résolu" et intégrer à la solution
30+
l'ensemble des notes de tout les tickets MantisBT.
31+
Tester la connexion ::
32+
Après avoir renseigné l'IP, le chemin du WSDL, le login et le password vous pouver tenter
33+
une connection à votre MantisBT
34+
35+
36+
37+
Lorsque tout les champs sont renseigné et que la connexion fonctionne vous pouvez sauvegarder
38+
votre configuration.
39+
40+
Le plugin MantisBT est prêt à être utilisé.
41+
42+
43+
=== Configuration des droits
44+
45+
La gestion des droit ce fait par profils utilisateurs
46+
47+
Allez dans Administration -> Profils
48+
49+
Selectionnez le profil pour qui ont va donner les droits
50+
51+
52+
3 choix s'offre à vous ::
53+
* Aucun droit -> l'utilisateur ne verra pas le nouvel onglet MantisBT dans le ticket Glpi.
54+
* Droit de lecture -> l'utilisateur peut juste voir le tableau qui recense les tickets MantisBT
55+
liés au ticket Glpi.
56+
* Droit d'écriture -> l'utilisateur voit le tableau qui recense les tickets MantisBT liés au
57+
ticket Glpi ainsi que les deux boutons permettant de lier un ticket Glpi à MantisBT.
58+
59+
image::droit.png[Configuration des droits du plugin MantisBT]
60+
61+
62+
63+
=== Configuration de la tâche automatisé
64+
65+
Allez dans Configuration -> actions automatiques
66+
67+
68+
choisissez dans la liste la tâche automatique appelé "mantis".
69+
70+
71+
image::listTask.png[Liste des tâches Glpi]
72+
73+
Vous serez redirigez vers la partie configuration de la tâche automatique du plugin MantisBT
74+
75+
image::task.png[Configuration du plugin MantisBT]
76+
77+
78+
Fréquence d'éxécution ::
79+
Vous pouvez choisir la fréquence à laquelle la tâche va être exécuté.
80+
Statut ::
81+
Programmé ou désactivé.
82+
Mode d'éxécution ::
83+
* GLPI -> Exécuté tant qu'il y a de l'activité sur l'application.
84+
* CLI -> Exécuté même s'il n'y a pas d'activité sur l'application (cf : php-cli).
85+
Plage horaire ::
86+
Fourchette de temps durant laquelle la tâche peut s'éxécuter.
87+
88+
[NOTE]
89+
===============================
90+
Vous pouvez égalament éxécuter la tâche de manière manuel grâçe au boutton "éxecuter"
91+
===============================
92+
93+
94+
95+
== Utilisation du plugin
96+
97+
Lorsque vous ouvrez un ticket Mantis si vous avez les droits de lecture OU d'écriture
98+
un nouvel onglet est apparut
99+
100+
image::headerTicket.png[Onglet du ticket Glpi]
101+
102+
103+
Selectionnez l'onglet MantisBT, vous verez apparaître deux nouveaux bouton
104+
105+
image::btnMantis.png[Boutton du plugin MantisBT]
106+
107+
108+
109+
=== Lier un ticket Glpi à un ticket MantisBT
110+
image::linkToIssue.png[Lier à un ticket MantisBT]
111+
112+
113+
Renseigner l'identifiant du ticket MantisBT et cliquez sur image:boutton.png[]
114+
115+
116+
=== Créer un ticket MantisBT en liant un ticket Glpi à un projet MantisBT
117+
image::linkToProject.png[Lier à un project MantisBT]
118+
119+
Nom du projet ::
120+
Renseigner le nom du projet MantisBT auquel vous voulez rattaché le ticket Glpi.
121+
122+
[NOTE]
123+
===============================
124+
Cliquez sur la petite loupe pour que le plugin puisse le trouver au sein de votre MantisBT et
125+
ainsi rappatrié les catégories liées au projet.
126+
===============================
127+
128+
Catégorie ::
129+
Choisissez la catégorie.
130+
131+
Titre ::
132+
Titre du ticket MantisBT.
133+
134+
Description ::
135+
Description du ticket MantisBT.
136+
137+
Etapes pour reproduire ::
138+
Description des étape pour reproduire le bug.
139+
140+
Pièce(s) jointe(s) ::
141+
Vous pouvez faire suivre les pièces jointe du ticket Glpi vers le ticket MantisBT en cochant la
142+
case "faire suivre les pièces jointes".
143+
144+
145+
146+
147+
Cliquez sur image:boutton.png[] pour que le plugin ajoute un nouveau ticket à votre projet
148+
MantisBT.
149+
150+
[NOTE]
151+
===============================
152+
153+
Le champs "titre" et "description" sont des champs obligatoires
154+
155+
===============================
156+
157+
158+
=== Suivi des tickets MantisBT
159+
160+
Lorsque vous avez lié un ticket Glpi à un ticket MantisBT le lien entre les deux ticket apparait
161+
dans le tableau en dessous des boutons.
162+
163+
image::tableau.png[tableau recensant les tickets MantisBT liés au ticket Glpi]
164+
165+
Vous retrouverez dans ce tableau : ::
166+
* le titre du ticket MantisBT
167+
* sa catégorie
168+
* son État dans MantisBT
169+
* sa date d'escalade vers MantisBT
170+
* l'utilisateur qui l'a escaladé.
171+
172+
[NOTE]
173+
===============================
174+
175+
image:arrowRight16.png[] La flèche verte vous permet d'ouvrir le ticket MantisBT.
176+
177+
image:bin16.png[] La poubelle vous permet de supprimer au choix le lien entre le
178+
ticket Glpi et le ticket Mantis OU le ticket Mantis directement (ce qui implique également la suppression du lien)
179+
180+
===============================
181+
182+
=== Suppression du lien ou du ticket MantisBT
183+
image::supprimer.png[supprimer un lien ou un ticket MantisBT]
184+
185+
Lorsque vous cliquez sur la petite poubelle deux choix s'offre à vous :
186+
187+
* Supprimer le lien entre le ticket Glpi et le ticket Mantis -> le lien n'apparaitra plus dans
188+
le tableau mais le ticket MantisBT existera toujours
189+
* Supprimer le ticket MantisBT -> le ticket MantisBT sera supprimé ainsi que le lien qui l'uni
190+
au ticket Glpi (ne sera plus visible dans le tableau)

0 commit comments

Comments
 (0)