Documentation
Administration
Projets
Ces écrans vous permettent de gérer les projets.
Liste des projets
Sur cet écran, vous pouvez archiver ou supprimer un
projet.
Un projet archivé est conservé mais n'est plus visible, y
compris par ses membres. Il peut être restauré par
l'administrateur.
Création ou modification d'un projet
Propriétés du projet
Public: si le projet est public, il
sera visible par tous les 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.
Sous-projet de: permet de définir le
projet parent. La hiérarchie des projets est limitée à 2
niveaux. Un projet parent ne peut pas être lui-même un
sous-projet.
Nom: nom d'affichage du projet (doit
être unique)
Description: texte qui apparaît sur
l'écran d'aperçu du projet
Identifiant: nom du projet utilisé de
manière interne par l'application (doit être unique). Une fois
le projet créé, cet identifiant ne peut pas être modifié.
Champs personnalisés: 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.
Dépôt
Un dépôt de sources peut être associé à chaque projet. Une
fois le dépôt du projet configuré, vous pourrez le parcourir et
consulter les révisions. Les révisions du dépôt apparaissent dans la
vue Activité du projet.
Pour associer un dépôt au projet, cocher l'option
Dépôt dans la configuration du projet. Choisir
le type de dépôt et saisir ses propriétés (exemple:
svn://hote/mondepot/
pour un dépôt SVN).
Wiki
Chaque projet peut bénéficier d'un wiki.
Pour l'activer, cocher l'option Wiki dans
la configuration du projet. Un nom de page principale doit être
identiqué. Cette page sera la première page affichée lors de la
consultation du wiki.
Membres
Cett section 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.
Versions
Les versions vous permettent de suivre les changements
survenus tout au long du projet. La date figurant sur la version
correspond à sa date d'échéance. Les versions pour lesquelles la
date n'est pas encore passée sont affichées sur la vue
"Roadmap".
Vous pouvez associer une page wiki à chaque version du projet.
Le contenu de chaque page apparaîtra sur la
Roadmap.
Sur chaque demande, vous pouvez indiquer quelle version la
prend en compte. La demande apparaîtra alors sur l'
Historique (lorsque la demande sera fermée) et
la Roadmap.
Vous pouvez également publier les fichiers associés aux
différentes versions de l'application (voir Fichiers).
Catégories des demandes
Les catégories de demande vous permettent de typer les
demandes. Les catégories peuvent par exemple correspondre aux
différents modules du projet.
Une catégorie référencée sur des demandes ne peut pas être
supprimée.
Forums
Chaque projet peut contenir un ou plusieurs forums de
discussion.
Utilisateurs
Ces écrans vous permettent de gérer les utilisateurs de
l'application.
Liste des utilisateurs
Liste des utilisateurs
Statut des comptes:
L'icône
signifie que le compte est vérouillé. Un
utilisateur dont le compte est vérouillé ne peut plus s'identifier
pour accéder à l'application.
L'icône
signifie que le compte n'a pas encore été
activé par l'utilisateur (Voir S'enregistrer).
Les boutons Vérouiller/Dévérouiller vous permettent de bloquer
ou débloquer les comptes utilisateurs. Le bouton Activer vous permet
d'activer manuellement le compte d'un utilisateur qui s'est enregistré
en ligne.
Création ou modification d'un utilisateur
En mode modification, laissez le champ Mot de
passe vide pour laisser le mot de passe de l'utilisateur
inchangé.
Un utilisateur déclaré comme administrateur dispose de toutes
les permissions sur l'application et sur tous les projets.
Administrateur: déclare l'utilisateur
comme administrateur de l'application.
Notifications par mail: permet
d'activer ou non l'envoi automatique de notifications par mail
pour cet utilisateur
Vérouillé: désactive le compte de
l'utilisateur
Rôles et permissions
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.
Sur l'écran d'édition du rôle, cochez les actions que vous
souhaitez autoriser pour le rôle.
Rôle et permissions
Trackers
Les trackers permettent de typer les demandes et de définir des
workflows spécifiques pour chacun de ces types de demandes (voir
Workflow). Un tracker peut être exclu des vues "Historique" et "Roadmap"
(en décochant les options correspondantes dans les paramètres du
tracker).
Lorsque vous créez un nouveau tracker, vous pouvez choisir de
copier le workflow d'un tracker existant. Cela permet d'initialiser
facilement le workflow du nouveau tracker et de n'y apporter que les
modifications nécessaires.
Si aucun workflow n'est défini pour un tracker, aucun utilisateur
ne pourra changer le statut des demandes liés à ce tracker.
Champs personnalisés
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:
Entier: entier positif ou négatif
Texte: chaîne de caractères
Texte long: chaîne de caractères
(saisissable sur plusieurs lignes)
Date: date
Booléen: oui/non (case à cocher)
Liste: valeur à sélectionner parmi une
liste prédéfinie (liste déroulante)
Des éléments de validation peuvent être définis:
Min - max length: longueurs minimales et
maximales pour les champs en saisie libre (0 signifie qu'il n'y a
pas de restriction)
Expression régulière: expression
régulière permettant de valider la valeur saisie
Exemples:
^\[A-Z]{4}\d+$
: 4 lettres majuscules suivies
d'un ou plusieurs chiffres
^[^0-9]*$
: chaîne ne comportant pas de
chiffres
Valeurs possibles: valeurs possibles pour
les champs de type "Liste". Cliquer sur l'icône + pour ajouter une
nouvelle valeur possible.
Champs pour les projets
Obligatoire: champ dont la saisie est
obligatoire
Champs pour les demandes
Pour tous les projects: champ
automatiquement associé aux demandes de tous les projets
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).
Obligatoire: champ dont la saisie est
obligatoire sur chaque demande
Utilisé comme filtre: si l'option est
cochée, le champ pourra être utilisé comme filtre sur l'écran des
demandes
Champs pour les utilisateurs
Obligatoire: champ dont la saisie est
obligatoire
Statut des demandes
Ces écrans vous permettent de définir les différents statuts
possibles des demandes.
Demande fermée: indique que le statut
correspond à une demande considérée comme fermée
Statut par défaut: statut appliqué par
défaut aux nouvelles demandes (seul un statut peut être déclaré
comme statut par défaut)
Couleur: code couleur HTML (6 caractères)
représentant le statut à l'affichage
Workflow
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.
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.
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.
Exemple de configuration d'un workflow
Dans l'exemple ci-dessus, les demandes de type Anomalie qui sont
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
Anomalie ne pourra pas être modifié par le Développeur.
Listes de valeurs
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:
Activités (utilisées pour le suivi du temps passé)
Priorités des demandes
Catégories de documents
Notifications par mail
Cet écran vous permet de sélectionner les actions qui donneront
lieu à une notification par mail aux membres du projet.
Remarque: l'envoi de mails doit être activé dans la configuration
de l'application si souhaitez effectuer des notifications.
Authentification
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.
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.
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.
Annuaire LDAP
Nom: nom d'affichage du
référentiel
Hôte: nom d'hôte du serveur LDAP
Port: port de connexion au serveur
LDAP
Compte: DN du compte de connexion au
LDAP (laisser vide si l'annuaire autorise l'accès anonyme en
lecture)
Mot de passe: mot de passe du compte de
connexion
Base DN: DN de base utilisé pour la
recherche des utilisateur dans l'annuaire
Filtre LDAP: Filtre de recherche des
utilisateurs dans l'annuaire (optionnel)
Attributs LDAP:
Identifiant: nom de l'attribut LDAP
utilisé comme identifiant de l'utilisateur (ex: uid)
Prénom: nom de l'attribut LDAP
contenant le prénom de l'utilisateur (ex: givenName)
Nom: nom de l'attribut LDAP
contenant le nom de l'utilisateur (ex: sn)
Email: nom de l'attribut LDAP
contenant l'adresse mail de l'utilisateur (ex: mail)
Les attributs "Prénom",
"Nom" et "Email" doivent
être renseigné si les comptes sont créés à la volée.
Configuration
Cet écran vous permet de modifier les paramètres de configuration
de l'application. Tous ces paramètres sont conservés dans la base de
données de l'application. Ils sont donc conservés lorsque vous effectuez
une mise à jour de votre installation.
Titre de l'application
Titre qui apparaît en en-tête des pages de
l'application.
Sous-titre de l'application
Sous-titre qui apparaît en en-tête des pages de
l'application.
Texte d'accueil
Texte affiché sur la page d'accueil de l'application. Ce texte
peut contenir des balises HTML.
Langue par défaut
La langue par défaut est sélectionnée lorsque l'application
n'a pas pu déterminer la langue définie au niveau du navigateur de
l'utilisateur.La langue par défaut est également utilisée lors de
l'envoi de mail à plusieurs utilisateurs.
Défaut: Anglais
Format de date
Cette option permet de choisir le format d'affichage des dates
dans l'application:
Basé sur la langue : les dates seront affichées selon le
format de date défini pour chaque langue (JJ/MM/AAAA pour le
français)
ISO 8601: les dates seront toujours affichées au format
ISO (AAAA-MM-JJ)
Défaut: Basé sur la langue
Authentif. obligatoire
Si cette option est cochée, aucune page de l'application n'est
accessible sans s'être identifié. Elle permet donc ne rendre
accessible l'application qu'aux utilisateurs qui disposent d'un
compte valide.
Défaut: Non
Enregistrement autorisé
Si cette option est cochée, la procédure d'enregistrement en
ligne est disponible. L'envoi de mails doit être correctement
configuré pour que les utilisateurs puissent activer leur compte
(voir S'enregistrer)
Défaut: Oui
Mot de passe perdu
Si cette option est cochée, la procédure de changement de mot
de passe est disponible. L'envoi de mails doit être correctement
configuré pour que les utilisateurs puissent choisir un nouveau mot
de passe.
Défaut: Oui
Taille max des fichiers
Taille maximale des fichiers pouvant être envoyés à
l'application (en kilo-octets).
Défaut: 2048 (soit 2Mo)
Limite export demandes
Nombre maximale de demandes contenues dans les exports CSV et
PDF.
Défaut: 500
Adresse d'émission
Adresse mail utilisée comme adresse d'émission (champ From des
mails) lors de l'envoi de messages aux utilisateurs.
Nom d'hôte
Nom d'hôte de l'application. Ce nom est utilisé pour
l'écriture des URL dans les mails envoyés aux utilisateurs.
Formatage du texte
Définit la méthode de formatage appliquée aux champs
"description" des demandes, annonces, documents...
L'option "Textile" n'est disponible que si la libraire ruby
RedColth est installée. Consulter la page d'information pour savoir
si vous disposez de cette librairie.
Compression historique wiki
Permet d'activer la compression de l'historique des pages wiki
stockées dans la base de données (diminution de l'espace
occupé).
Défaut: désactivé
Limite du contenu des flux RSS
Nombre maximal d'enregistrements contenus dans les flux
RSS.
Défaut: 15
Récupération auto. des commits
Si cette option est activée, l'application récupère
automatiquement les nouvelles révisions apportées sur le dépôt de
sources du projet lorsqu'un utilisateur consulte le dépôt.
Défaut: Oui
Vous pouvez désactiver cette option et automatiser l'appel à
Repository#fetch_changesets pour récupérer régulièrement les
révisions de l'ensemble des dépôts en arrière plan.
Exemple : ruby script/runner
"Repository.fetch_changesets"
Activer les WS de gestion des
dépôts
Cette option ne doit être activée que si vous avez installé le
script de création automatique des dépôts.
Défaut: Non
Informations
Affiche des informations relatives à l'application et à son
environnement.
Projets
Aperçu du projet
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.
Planning
Calendrier du projet
Le calendrier présente les tâches qui commencent ou se terminent
au cours du mois sélectionné (mois en cours par défaut). Les tâches
correspondent aux demandes pour lesquelles la date de début et
d'échéance sont renseignées.
Le symoble
représente le début d'une tâche
Le symbole
représente la fin d'une tâche
Le symbole
représente une tâche qui débute et se
termine le jour même
En cliquant sur le lien Options, vous
pouvez sélectionner les trackers que vous souhaitez afficher. Si le
projet contient des sous-projets, vous pouvez également afficher
l'ensemble des demandes du projet et de ses sous-projets.
Diagramme de Gantt
Le diagramme de Gantt représente pour la période choisie
l'ensemble des tâches et leurs taux d'avancement.
L'avancement est représenté en bleu. Le retard en rouge.
Diagramme de Gantt
En cliquant sur le lien Options, vous
pouvez sélectionner les trackers que vous souhaitez afficher. Si le
projet contient des sous-projets, vous pouvez également afficher
l'ensemble des demandes du projet et de ses sous-projets.
Gestion des demandes
Liste des demandes
Par défaut, l'ensemble des demandes ouvertes du projet sont
affichées. Différents filtres vous permettent de sélectionner les
demandes à afficher.
Une fois appliqué, un filtre reste valable durant toute votre
session. Vous pouvez le redéfinir, ou le supprimer en cliquant sur
Effacer.
Liste des demandes
Rapports
Cet écran présente la synthèse du nombre de demandes par statut et
selon différents critères (tracker, sous-projet, priorité, catégorie,
auteur). Des liens permettent d'accéder à la liste détaillée des
demandes pour chaque critère.
Activité
Cette page présente par mois (le mois en cours par défaut) et par
jour, les événements intervenus sur le projet.
Nouvelles demandes
Révisions apportées sur le dépôt (si le projet dispote d'un
dépôt SVN)
Annonces publiées
Fichiers ajoutés
Documents ajoutés
Modifications apportées aux pages wiki (sir le projet a activé
son wiki)
Historique
Cette page présente l'ensemble des demandes résolues dans chacune
des versions du projet.
Remarque: certains trackers peuvent être exclus de la vue
"Historique". Les demandes correpondantes n'y seront alors pas
affichées.
Roadmap
Cette page présente la liste des versions du projets dont la date
n'est pas encore passée. Pour chaque version, la liste des demandes
liées à cette version est affichée. Le ratio demandes fermées / demandes
ouvertes est représenté sous forme d'une barre de progression.
Remarque: certains trackers peuvent être exclus de la vue
"Roadmap". Les demandes correpondantes n'y seront alors pas
affichées.
Annonces
Les nouvelles vous permettent d'informer les utilisateurs sur
l'activité du projet. Les membres autorisés peuvent soumettre des
commentaires sur les annonces publiées.
Documents
Les documents sont groupés par catégories (voir Listes de
valeurs). Un document peut contenir plusieurs fichiers (exemple:
révisions ou versions successives).
Fichiers
Ce module vous permet de publier les différents fichiers (sources,
binaires, ...) pour chaque version du projet.
Comptes utilisateurs
Mon compte
Informations
Cet écran vous permet de modifier les informations relatives à
votre compte: nom, prénom, adresse mail, langue (Anglais, Allemand,
Espagnol ou Français).
Si la case Notifications par mail est
décochée, aucune notification par mail ne vous sera envoyée.
Changement de mot de passe
Pour changer votre mot de passe, saisissez votre mot de passe
actuel et le nouveau mot de passe souhaité (double saisie pour
confirmation). Le mot de passe doit avoir une longueur comprise entre
4 et 12 caractères.
Si votre compte utilise une authentification externe (un
annuaire LDAP), vous ne pouvez pas changer votre mot de passe dans
redMine.
Ma page
Cette page vous permet d'afficher de manière synthétique des
informations sur vos projets.
Pour personnaliser votre page, cliquer sur le lien
Personnaliser cette page. Vous pouvez alors
sélectionner les informations à afficher et les positionner où vous le
souhaitez sur la page, par glisser-déposer.
Mot de passe perdu
En cas de perte de votre mot de passe, une procédure par mail vous
permet d'en choisir un nouveau.
Sur l'écran d'authentification, cliquez sur Mot de passe
perdu. Saisissez ensuite votre adresse mail dans le champ
prévu et validez. Un mail vous est alors transmis. Il contient un lien
qui vous permettra d'accéder à la page de choix du nouveau mot de
passe.
Si votre compte utilise une authentification externe (un annuaire
LDAP), cette procédure n'est pas disponible.
S'enregistrer
L'enregistrement vous permet d'obtenir un compte sans intervention
de l'administrateur.
Sur l'écran d'authentification, cliquez sur
S'enregistrer. Complétez le formulaire
d'inscription et validez. Un mail vous est alors transmis. Pour activer
votre compte, utilisez le lien présent dans le mail qui vous a été
envoyé.
La possibilité de s'enregistrer peut avoir été désactivée par
l'administrateur.