1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<book>
<title>Documentation redMine</title>
<chapter>
<title>Administration</title>
<section>
<title>Utilisateurs</title>
<para>Ces écrans vous permettent de gérer les utilisateurs de
l'application.</para>
<section>
<title>Liste des utilisateurs</title>
<para></para>
<screenshot>
<screeninfo>Liste des utilisateurs</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="images/users_list.png" />
</imageobject>
</mediaobject>
</screenshot>
<para>Les boutons Lock/Unlock vous permettent de
vérouiller/dévérouiller les comptes utilisateurs.</para>
<para>Un utilisateur dont le compte est vérouillé ne peut plus
s'identifier pour accéder à l'application.</para>
</section>
<section>
<title>Création ou modification d'un utilisateur</title>
<para>En mode modification, laissez le champ Password vide pour
laisser le mot de passe de l'utilisateur inchangé.</para>
<para>Un utilisateur déclaré comme administrateur dispose de toutes
les permissions sur l'application et sur tous les projets.</para>
<itemizedlist>
<listitem>
<para><guilabel>Administrateur</guilabel>: déclare l'utilisateur
comme administrateur de l'application.</para>
</listitem>
<listitem>
<para><guilabel>Notifications par mail</guilabel>: permet
d'activer ou non l'envoi automatique de notifications par mail
pour cet utilisateur</para>
</listitem>
<listitem>
<para><guilabel>Vérouillé</guilabel>: désactive le compte de
l'utilisateur</para>
</listitem>
</itemizedlist>
<para></para>
</section>
</section>
<section>
<title>Rôles et permissions</title>
<para>Les rôles permettent de définir les permissions des différents
membres d'un projet. Chaque membre d'un projet dispose d'un rôle unique
au sein d'un projet. Un utilisateur peut avoir différents rôles au sein
de différents projets.</para>
<para>Sur l'écran d'édition du rôle, cochez les actions que vous
souhaitez autoriser pour le rôle.</para>
</section>
<section>
<title>Trackers</title>
<para>Les trackers permettent de typer les demandes et de définir des
workflows spécifiques pour chacun de ces types.</para>
</section>
<section>
<title>Champs personnalisés</title>
<para>Les champs personnalisés vous permettent d'ajouter des
informations supplémentaires sur les projets, les demandes ou les
utilisateurs. Un champ personnalisé peut être de l'un des types
suivants:</para>
<itemizedlist>
<listitem>
<para><guilabel>Entier</guilabel>: entier positif ou négatif</para>
</listitem>
<listitem>
<para><guilabel>Chaîne</guilabel>: chaîne de caractère</para>
</listitem>
<listitem>
<para><guilabel>Date</guilabel>: date</para>
</listitem>
<listitem>
<para><guilabel>Booléen</guilabel>: booléen (case à cocher)</para>
</listitem>
<listitem>
<para><guilabel>Liste</guilabel>: valeur à sélectionnée parmi une
liste prédéfinie (liste déroulante)</para>
</listitem>
</itemizedlist>
<para>Des éléments de validation peuvent être définis:</para>
<itemizedlist>
<listitem>
<para><guilabel>Obligatoire</guilabel>: champ dont la saisie est
obligatoire sur les demandes</para>
</listitem>
<listitem>
<para><guilabel>Pour tous les projects</guilabel>: champ
automatiquement associé à l'ensemble des projets</para>
</listitem>
<listitem>
<para><guilabel>Min - max length</guilabel>: longueurs minimales et
maximales pour les champs en saisie libre (0 signifie qu'il n'y a
pas de restriction)</para>
</listitem>
<listitem>
<para><guilabel>Expression régulière</guilabel>: expression
régulière permettant de valider la valeur saisie</para>
<para>Exemples:</para>
<para><code>^\[A-Z]{4}\d+$</code> : 4 lettres majuscules suivies
d'un ou plusieurs chiffres</para>
<para><code>^[^0-9]*$</code> : chaîne ne comportant pas de
chiffres</para>
</listitem>
<listitem>
<para><guilabel>Valeurs possibles</guilabel>: valeurs possibles pour
les champs de type "Liste". Les valeurs sont séparées par le
caractère |</para>
</listitem>
</itemizedlist>
<para></para>
<section>
<title>Champs pour les projets</title>
<para></para>
<itemizedlist>
<listitem>
<para><guilabel>Obligatoire</guilabel>: champ dont la saisie est
obligatoire</para>
</listitem>
</itemizedlist>
<para></para>
</section>
<section>
<title>Champs pour les demandes</title>
<para></para>
<itemizedlist>
<listitem>
<para><guilabel>Pour tous les projects</guilabel>: champ
automatiquement associé aux demandes de l'ensemble des
projets</para>
<para>Si cette option n'est pas activée, chaque projet pourra
choisir d'utiliser ou non le champ pour ses demandes (voir
configuration du projet).</para>
</listitem>
</itemizedlist>
<para></para>
</section>
<section>
<title>Champs pour les utilisateurs</title>
<para></para>
<itemizedlist>
<listitem>
<para><guilabel>Obligatoire</guilabel>: champ dont la saisie est
obligatoire</para>
</listitem>
</itemizedlist>
<para></para>
</section>
</section>
<section>
<title>Statut des demandes</title>
<para>Ces écrans vous permettent de définir les différents statuts
possibles des demandes.</para>
<itemizedlist>
<listitem>
<para><guilabel>Demande fermée</guilabel>: indique que le statut
correspond à une demande considérée comme fermée</para>
</listitem>
<listitem>
<para><guilabel>Statut par défaut</guilabel>: statut appliqué par
défaut aux nouvelles demandes (seul un statut peut être déclaré
comme statut par défaut)</para>
</listitem>
<listitem>
<para><guilabel>Couleur</guilabel>: code couleur HTML (6 caractères)
représentant le statut à l'affichage</para>
</listitem>
</itemizedlist>
<para></para>
</section>
<section>
<title>Workflow</title>
<para>Le workflow permet de définir les changements que les différents
membres d'un projet sont autorisés à effectuer sur les demandes, en
fonction de leur type.</para>
<para>Sélectionnez le rôle et le tracker pour lesquels vous souhaitez
modifier le workflow, puis cliquez sur Edit. L'écran vous permet alors
de modifier, pour le rôle et le tracker choisi, les changements
autorisés. Les lignes représentent les statuts initiaux des demandes.
Les colonnes représentent les statuts autorisés à être appliqués.</para>
<para><remark>Remarque: pour qu'un rôle puisse changer le statut des
demandes, la permission doit lui être explicitement donnée
indépendemment de la configuration du workflow.</remark></para>
<para></para>
<screenshot>
<screeninfo>Exemple de configuration d'un workflow</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="images/workflow.png" />
</imageobject>
</mediaobject>
</screenshot>
<para>Dans l'exemple ci-dessus, les demandes de type Bug au statut
Nouveau pourront être passées au statut Assignée ou Résolue par le rôle
Développeur. Celles au statut Assignée pourront être passées au statut
Résolue. Le statut de toutes les autres demandes de type Bug ne pourra
pas être modifié par le Développeur.</para>
</section>
<section>
<title>Listes de valeurs</title>
<para>Les listes de valeurs utilisées par l'application (exemple: les
priorités des demandes) peuvent être personnalisées. Cet écran vous
permet de définir les valeurs possibles pour chacune des listes
suivantes:</para>
<itemizedlist>
<listitem>
<para>Priorités des demandes</para>
</listitem>
<listitem>
<para>Catégories de documents</para>
</listitem>
</itemizedlist>
<para></para>
</section>
<section>
<title>Notifications par mail</title>
<para>Cet écran vous permet de sélectionner les actions qui donneront
lieu à une notification par mail aux membres du projet.</para>
<para>Remarque: l'envoi de mails doit être activé dans la configuration
de l'application si souhaitez effectuer des notifications.</para>
</section>
<section>
<title>Authentification</title>
<para>Par défaut, redMine s'appuie sur sa propre base de données pour
authentifier les utilisateurs, à l'aide d'un mot de passe
spécifique.</para>
<para>Si vous disposez déjà d'un ou plusieurs référentiels externes
d'utilisateurs (annuaires LDAP), vous pouvez les déclarer afin qu'ils
soient utilisés pour l'authentification sur redMine. Cela permet aux
utilisateurs d'accéder à redMine avec leurs identifiants et mots de
passe habituels.</para>
<para>Pour chaque référentiel déclaré, vous pouvez spécifier si les
comptes peuvent être créés à la volée dans redMine. Si c'est le cas, les
comptes utilisateurs sont automatiquement créés à la première connexion
de l'utilisateur (sans droits spécifiques sur les projets), à partir des
informations disponibles dans le référentiel. Sinon, l'administrateur
doit au préalable créer le compte de l'utilisateur dans redMine.</para>
<para></para>
<section>
<title>Déclaration d'un annuaire LDAP</title>
<para></para>
<itemizedlist>
<listitem>
<para><guilabel>Nom</guilabel>: nom d'affichage du
référentiel</para>
</listitem>
<listitem>
<para><guilabel>Hôte</guilabel>: nom d'hôte du serveur LDAP</para>
</listitem>
<listitem>
<para><guilabel>Port</guilabel>: port de connexion au serveur
LDAP</para>
</listitem>
<listitem>
<para><guilabel>Compte</guilabel>: DN du compte de connexion au
LDAP (laisser vide si l'annuaire autorise l'accès anonyme en
lecture)</para>
</listitem>
<listitem>
<para><guilabel>Mot de passe</guilabel>: mot de passe du compte de
connexion</para>
</listitem>
<listitem>
<para><guilabel>Base DN</guilabel>: DN de base utilisé pour la
recherche des utilisateur dans l'annuaire</para>
</listitem>
<listitem>
<para><guilabel>Filtre LDAP</guilabel>: Filtre de recherche des
utilisateurs dans l'annuaire (optionnel)</para>
</listitem>
<listitem>
<para><guilabel>Attributs LDAP</guilabel>:</para>
<itemizedlist>
<listitem>
<para><guilabel>Identifiant</guilabel>: nom de l'attribut LDAP
utilisé comme identifiant de l'utilisateur (ex: uid)</para>
</listitem>
<listitem>
<para><guilabel>Prénom</guilabel>: nom de l'attribut LDAP
contenant le prénom de l'utilisateur (ex: givenName)</para>
</listitem>
<listitem>
<para><guilabel>Nom</guilabel>: nom de l'attribut LDAP
contenant le nom de l'utilisateur (ex: sn)</para>
</listitem>
<listitem>
<para><guilabel>Email</guilabel>: nom de l'attribut LDAP
contenant l'adresse mail de l'utilisateur (ex: mail)</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
<para>Les attributs "<guilabel>Prénom</guilabel>",
"<guilabel>Nom</guilabel>" et "<guilabel>Email</guilabel>" ne sont
utilisés que lorsque les comptes sont créés à la volée.</para>
</section>
</section>
<section>
<title>Informations</title>
<para>Affiche des informations relatives à l'application et à son
environnement.</para>
</section>
</chapter>
<chapter>
<title>Projets</title>
<section>
<title>Aperçu du projet</title>
<para>L'aperçu vous présente les informations générales relatives au
projet, les principaux membres, les dernières annonces, ainsi qu'une
synthèse du nombre de demandes ouvertes par tracker.</para>
<para></para>
</section>
<section>
<title>Gestion des demandes</title>
<para></para>
<section>
<title>Liste des demandes</title>
<para>Par défaut, l'ensemble des demandes ouvertes du projet sont
affichées. Différents filtres vous permettent de sélectionner les
demandes à afficher. Si le projet comporte des sous-projets, vous avez
la possibilité d'afficher également les demandes relatives aux
sous-projets (non affichées par défaut).</para>
<para>Une fois appliqué, un filtre reste valable durant toute votre
session. Vous pouvez le redéfinir, ou le supprimer en cliquant sur
Annuler.</para>
<para></para>
<screenshot>
<screeninfo>Liste des demandes</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="images/issues_list.png" />
</imageobject>
</mediaobject>
</screenshot>
<para></para>
</section>
</section>
<section>
<title>Rapports</title>
<para>Cet écran présente la synthèse du nombre de demandes par statut et
selon différents critères (tracker, priorité, catégorie). Des liens
directs permettent d'accéder à la liste détaillée des demandes pour
chaque critère.</para>
</section>
<section>
<title>Historique</title>
<para>Cette page présente l'ensemble des demandes résolues dans chacune
des versions du projet. Certains types de demande peuvent être exclus de
cet affichage.</para>
</section>
<section>
<title>Annonces</title>
<para>Les nouvelles vous permettent d'informer les utilisateurs sur
l'activité du projet.</para>
</section>
<section>
<title>Documents</title>
<para>Les documents sont groupés par catégories (voir Listes de
valeurs). Un document peut contenir plusieurs fichiers (exemple:
révisions ou versions successives).</para>
</section>
<section>
<title>Fichiers</title>
<para>Ce module vous permet de publier les différents fichiers (sources,
binaires, ...) pour chaque version de l'application.</para>
</section>
<section>
<title>Configuration du projet</title>
<para></para>
<section>
<title>Propriétés du projet</title>
<para></para>
<itemizedlist>
<listitem>
<para><guilabel>Public</guilabel>: si le projet est public, il
sera visible (consultation des demandes, des documents, ...) pour
l'ensemble des utilisateurs, y compris ceux qui ne sont pas
membres du projet. Si le projet n'est pas public, seuls les
membres du projet y ont accès, en fonction de leur rôle.</para>
</listitem>
<listitem>
<para><guilabel>Champs personnalisés</guilabel>: sélectionner les
champs personnalisés que vous souhaitez utiliser pour les demandes
du projet. Seul l'administrateur peut définir de nouveaux champs
personnalisés.</para>
</listitem>
</itemizedlist>
<para></para>
</section>
<section>
<title>Membres</title>
<para>Cet écran vous permet de définir les membres du projet ainsi que
leurs rôles respectifs. Un utilisateur ne peut avoir qu'un rôle au
sein d'un projet donné. Le rôle d'un membre détermine les permissions
dont il bénéficie sur le projet.</para>
</section>
<section>
<title>Versions</title>
<para>Les versions vous permettent de suivre les changements survenus
tout au long du projet. A la fermeture d'une demande, vous pouvez par
exemple indiquer quelle version la prend en compte. Vous pouvez par
ailleurs publier les différentes versions de l'application (voir
Fichiers).</para>
</section>
<section>
<title>Catégories des demandes</title>
<para>Les catégories de demande vous permettent de typer les demandes.
Les catégories peuvent par exemple correspondre aux différents modules
du projet.</para>
</section>
</section>
</chapter>
</book>
|