Utilisation du logiciel trac sur http://dev.communesplone.org
Note: Return to tutorial view.
Login
Pour visualiser les sources des produits (le codee) ou les tickets existants, le login n'est pas nécessaire.
Par contre, afin d'encoder un nouveau ticket, il est nécessaire d'être identifié.
Pour ce faire, vous pouvez cliquer sur le lien "Login" situé dans la partie supérieure droite et entrer le nom d'utilisateur et le mot de passe qui vous a été fourni.
Si vous ne disposez pas de ces éléments, vous pouvez prendre contact avec Stéphan Geulette.
Email
Lorsque vous créez un ticket, il est possible de recevoir une copie du ticket par email.
Vous pouvez également recevoir un email lors de chaque modification du ticket et à chaque étape de son traitement.
Pour disposer de cette fonctionnalité, il est nécessaire de spécifier une adresse email dans vos préférences personnelles.
Pour cela, vous devez vous identifier et cliquer sur le lien "Settings" situé dans la partie supérieure droite.
Un formulaire est présenté dans lequel vous pouvez encoder votre adresse email.
Nouveau ticket
Avant de pouvoir encoder un ticket, il est nécessaire de s'identifier préalablement (premier point du tutoriel).
Vous pouvez encoder un nouveau ticket en cliquant sur le bouton "New ticket" situé dans la partie supérieure droite.
Les champs du formulaire présenté sont les suivants:
- Short summary : un bref résumé
- Type : type du ticket (bug, enhancement = amélioration, task = tâche)
- Full description : description la plus complète possible
- Priority : priorité de traitement (blocker = bloquant --> très urgent, major = important, minor = moins important)
- Component : partie concernée (un produit particulier, une tâche sur le serveur, autre)
- Keywords : possibilité de rajouter des mots clés utilisables lors d'une recherche
- Assign to : assigner le ticket à une personne précise (son nom d'utilisateur doit être connu)
- Cc : possibilité d'ajouter une adresse email pour envoyer une copie du ticket à quelqu'un d'autre
- I have files to attach to this ticket : en cochant cette case, il est possible également de joindre des fichiers attachés au ticket comme par exemple une capture d'écran pour un bug, etc.
Dès que votre ticket est encodé, vous recevrez une copie de celui-ci par email à la condition d'avoir introduit une adresse email dans vos préférences personnelles (voir point précédent du tutoriel).
Vous recevrez également une copie du ticket par email à chaque modification de celui-ci.
Visualiser les tickets
Avant d'encoder un nouveau ticket, il est préférable de vérifier qu'aucun ticket n'existe déjà concernant la demande que vous voulez faire.
Il est possible de rechercher les tickets de plusieurs façons :
En utilisant des recherches prédéfinies
Pour cela vous devez cliquer sur le bouton "View Tickets" situé dans la partie supérieure droite.
Une liste de plusieurs recherches prédéfinies est proposée:
- Active tickets : les tickets qui ne sont pas encore clôturés
- All tickets : tous les tickets encodés
- My tickets : les tickets encodés par l'utilisateur connecté
- Tickets I must treat : les tickets que l'utilisateur connecté doit traiter (concerne les administrateurs)
- Tickets I have already treated : les tickets que l'utilisateur connecté a déjà traité (concerne les administrateurs)
- Tickets of ... : les tickets en relation d'un composant particulier (un produit, le serveur, ...)
Le résultat est présenté sous forme de tableau.
Il est possible de modifier le tri par défaut en cliquant sur le titre de la colonne qui doit servir de critère de tri.
En utilisant une recherche personnalisée
Pour cela vous devez cliquer sur le bouton "View Tickets" situé dans la partie supérieure droite.
Vous avez alors accès à un lien intitulé "Custom query" (dans la partie supérieure droite).
L'écran présenté propose dans sa partie supérieure des filtres (des critères) qui peuvent être ajoutés ou supprimés.
Par défaut 2 filtres sont affichés:
- un concernant le owner (la personne qui traite le ticket et non celle qui l'a créé)
- un concernant le statut du ticket
Il est possible de supprimer un filtre avec le bouton "-".
Il est possible d'ajouter un filtre avec le bouton "Add filter" (dans la liste des filtres, la plupart des termes ont été expliqués dans la partie du tutoriel "nouveau ticket". La notion de reporter correspond à la personne qui a créé le ticket).
En utilisant la recherche globale
La recherche globale est située dans la partie supérieure droite.
Cette recherche s'effectue dans tout le logiciel trac et peut donc ramener des résultats autres que des tickets.
Il est cependant possible de filtrer le résultat par après.
Code source
Il est possible de visualiser le code source des différents produits en cliquant sur le bouton "Browse source" situé dans la partie supérieure droite et de parcourir l'arborescence des produits.
Attention : le trac ne permet pas de télécharger un produit dans sa globalité.
Pour récupérer un produit afin de l'installer localement, reportez-vous au how-to concernant l'installation d'un produit.
Suivi du code source
Vous pouvez visualiser les changements effectués dans certains produits en cliquant sur le bouton "Browse Source" situé dans la partie supérieure droite et en parcourant l'arborescence des produits.
Au niveau désiré , cliquer sur le lien "Revision log" situé dans la partie supérieure droite.
Une liste concernant les changements (révisions) apparaît.
En cliquant dans la colonne "Chgset", les modifications effectuées pour cette révision sont mises en évidence dans chaque source concernée.