= Utilisation du Gestionnaire des Tickets =
[[TracNav]]

[[TOC(inline)]]

== Principale Fonctionnalités ==

Trac fournit un gestionnaire de ticket pour faire le suivi de "problèmes" ou d'actions. Dans la version actuelle (10.x), Trac fournit un modèle de "workflow" (gestion du cycle de traitement) très simple : il ne permet pas d'obliger le passage par des états successifs (par exemple on peut mettre un ticket directement dans l'etat `Fixed` sans l'assigner) ni de restreindre les droits d'édition d'un ticket aux personnes à qui il a été assigné.

Une fois créé, un ticket ne peut pas être détruit. Les différentes étapes du traitement du ticket sont représentées par un `ChangeLog` auquel on ajoute des entrées avec la partie `Add Comment` ou le bouton `Reply` du formulaire d'affichage du ticket. Les entrées du ChangeLog sont '''non modifiables'''. Seule la description du ticket peut être mise à jour, une fois le ticket créé.

En plus de sa description, un ticket peut être associé à un "composant" ou un "milestone" ou avoir une sévérité. Le "milestone" correspond à une entrée de la `Roadmap` et doit avoir été créé avant, via le menu `Roadmap`. Dans le gestionnaire de roadmap, chaque milestone a son propre décompte de tickets ouverts ou fermés.

En plus des attributs standards, on peut ajouter des attributs spécifiques au projet qui seront pris en compte automatiquement dans le formulaire de saisie ou d'affichage de ticket. On définit ces champs à travers l'interface d'administration (`Admin`).

== Definition des Composants ==

Les composants auquels peuvent être associés des tickets sont créés via le menu `Admin`, réservé aux administrateurs du projet. Lors de la création d'un composant, on peut lui assigner un "owner" : cette personne se verra automatiquement assignée le ticket. Si le champ "owner" contient une adresse email (de préférence entre `<>`), le owner sera notifié par mail de l'arrivée du ticket (si la notification est activée au niveau du projet).

Le "owner" n'a aucun droit particulier sur le ticket et son nom n'a pas nécessairement à correspondre au nom d'utilisateur utilisé par cette personne pour se connecter à Trac.


== Visualisation des Tickets ==

Il y a 3 façon de visualiser les tickets et leur état :

- `View Tickets` reports (TracReports) : c'est le mode historique, avec des reports pré-définis. On peut configurer de nouveaux reports en utilisant n'importe quel partie de la base de donnée du projet mais c'est assez complexe car il faut écrire les requêtes SQL. A n'utiliser que s'il n'y a aucune autre solution.

- `View Tickets` queries (TracQueries) : on sélectionne les tickets à partir d'un formulaire Web. On peut utiliser des critères sur tous les caractéristiques du ticket. Par contre le format de l'affichage est peu configurable.

- `Roadmap` : en sélectionnant un milestone, on a un résumé par composants des tickets en cours. C'est le mode le plus simple, si on utilise la roadmap et les milestones.


== Utilisation avec Eclipse ==

[http://www.eclipse.org Eclipse] est un environnent intégré de développement (IDE). Il peut être utilisé comme interface de Trac pour [wiki:Doc/Wiki/Edit#EditiondunePage éditer les pages du Wiki] et pour gérer les tickets (création, modification, association à un contexte Eclipse...).

Pour utiliser Eclipse comme interface du gestionnaire de ticket, à la place d'un browser Web (les 2 peuvent être utilisés simultanément), il faut installer le plugin Eclipse `Mylyn` depuis le ''Eclipse Discovery Site'' (configuré automatiquement par Eclipse, ''Europa Discovery Site'' pour Eclipse 3.3).

''Remarque : comme pour l'édition des pages Wiki, la gestion des tickets depuis Eclipse requiert que la permission `XML_RPC` soit donnée à `anonymous` pour le projet Trac concerné.''