# Manuel de &ktimetracker;

## Introduction

&ktimetracker; chronomètre le temps passé sur différentes activités. Il est utile pour définir les heures pouvant être facturées et permet de relater les heures effectuées par activité et par jour.

Cet historique du temps peut être exporté vers un fichier CSV (dont les valeurs sont séparées par des virgules) pour être ensuite importé dans un autre outil de facturation ou de gestion de projet.

&ktimetracker; détecte lorsque le clavier ainsi que la souris sont inactifs, et peut associer différentes activités avec différents bureaux. Cela permet de maintenir le chronomètre en fonction sur la bonne activité.

&ktimetracker; a été initié par &Sirtaj.Singh.Kang;. Sa page d'accueil est http://userbase.kde.org/KTimeTracker.

## Utiliser &ktimetracker;

### Démarrer &ktimetracker;

Saisissez `ktimetracker` en ligne de commande ou choisissez Suivi du temps dans le groupe Applications Utilitaires du menu de démarrage de KDE. Les options standard des commandes &Qt; et &kde; sont disponibles et peuvent être listées en saisissant ``ktimetracker``--help`` en ligne de commande.

&ktimetracker; fournit une option supplémentaire de ligne de commande qui vous permet de définir le nom du fichier iCalendar à utiliser pour enregistrer l'historique de votre travail. Vous pouvez définir un fichier distant iCalendar en utilisant http ou ftp dans le nom de fichier. Par exemple : http://www.monsite.com/mesdonnées/montravail.ics.

### Activités

Problème : Vous êtes consultant indépendant en logiciels, avec plusieurs clients. Certains de vos clients ont de nombreux projets. Durant vos journées, vous ne cessez de basculer d'un projet à un autre. Vous avez besoin de suivre votre répartition du temps, afin de pouvoir établir vos factures mensuelles.

Solution : Créez une activité au niveau le plus haut pour chaque client, et une sous-activité pour chaque projet client. Pour les projets qui nécessitent un suivi plus détaillé, créez une liste de sous-activités de projet. Chronométrez le temps en double-cliquant l'activité sur laquelle vous allez travailler.

&ktimetracker; fournit une grande souplesse dans le suivi de votre temps, en autorisant une quantité infinie d'activités et de niveaux. Le temps peut être mesuré pour n'importe quelle activité, et plusieurs activités peuvent être actives simultanément.

&ktimetracker; vous permet d'éditer l'historique de vos activités et de commenter chaque évènement que vous avez arrêté.

Pour créer une activité au niveau le plus haut, sélectionnez &Ctrl;T Activité Nouvelle activité... . Pour créer une sous-activité, cliquez sur l'activité parent et sélectionnez &Ctrl;&Alt;N Activité Nouvelle sous-activité... .

Lorsque &ktimetracker; est arrêté, la liste des activités est enregistrée dans un fichier sur votre disque. Au prochain démarrage, la liste des activités sera ainsi reprise.

&ktimetracker; peut importer et exporter les activités, afin de faciliter votre travail. veuillez vous référer aux Autres systèmes.

### Chronomètres

Problème : Pour rester solvable, vous devez pouvoir facturer une moyenne de cinq heures journalières. Pour cela, vous observez vos totaux quotidiens et hebdomadaires.

Solution : Mettez à zéro le chronomètre de session au commencement de chaque journée ouvrée, et mettez à zéro tous les chronomètres au commencement de chaque semaine.

&ktimetracker; facilite le chronométrage. Pour démarrer le chronométrage d'une activité, il vous suffit de double-cliquer dessus. Pour arrêter le chronométrage, double-cliquez à nouveau sur l'activité. Les activités actives affichent une petite horloge dans la colonne Durée de la session

Un autre indicateur visuel de l'activité de &ktimetracker; est l'icône dans la boîte à miniatures. Lorsqu'une activité est active, la deuxième main de l'icône bouge. Si vous passez le pointeur de la souris sur l'icône, alors le nom de l'activité active s'affichera dans une infobulle. Lorsque plusieurs activités sont actives, leurs noms sont affichés dans l'infobulle, séparés par une virgule.

Chaque activité dans &ktimetracker; possède deux minuteries : une pour la durée de la session, et une autre pour la durée totale. Dans la configuration par défaut, &ktimetracker; affiche deux colonnes pour chaque minuterie, soit un total de quatre colonnes pour chaque activité :

Durée de la session

- Le temps passé sur l'activité depuis que la session a été démarrée.

Durée

- Le temps passé sur l'activité depuis que tous les temps ont été remis à zéro.

Durée totale de la session

- Le temps passé sur l'activité et toutes ses sous-activités depuis que la session a été démarrée.

Durée totale

- Le temps passé sur l'activité et toutes ses sous-activités depuis que tous les temps ont été remis à zéro.

Pour commencer une nouvelle session, sélectionnez Fichier Démarrer une nouvelle session

Pour mettre à zéro tous les compteurs, Sélectionnez Fichier Réinitialiser toutes les durées

#### Chronométrage du bureau

Problème : Vous travaillez simultanément sur deux projets. Afin de mieux organiser votre travail, vous maintenez tous les fichiers du projet 1 sur le Bureau 1, et tous les fichiers du projet 2 sur le Bureau 2.

Solution : Associez l'activité du projet 1 avec le Bureau 1, et l'activité du projet 2 avec le Bureau 2. Lorsque vous basculez du Bureau 2 vers le Bureau 1, &ktimetracker; arrête immédiatement l'activité du projet 2 et démarre l'activité du projet 1.

Pour associer une activité avec un ou plusieurs bureaux, sélectionnez &Ctrl;E Activité Modifier... . Validez le Suivi automatique et choisissez le ou les bureaux à associer avec cette activité. Lorsque l'un de ces bureaux devient actif, &ktimetracker; démarrera automatiquement après un court délai le chronomètre de cette activité.

#### Détection d'inactivité

Problème : Vous quittez tôt le bureau le vendredi pour faire vos courses, et oubliez d'arrêter le chronomètre. Lorsque vous revenez le lundi, le compteur tourne toujours.

Solution : Validez la détection d'inactivité dans la page Comportement de la boîte de configuration.

&ktimetracker; peut être configuré pour reconnaître lorsque le clavier et la souris deviennent inactifs. S'ils restent inactifs pendant un nombre spécifié de minutes, &ktimetracker; affiche la boîte de dialogue suivante :

Détection d'inactivité de &ktimetracker; Boîte de dialogue de détection d'inactivité de &ktimetracker;

Continuer à chronométrer

- Applique la durée d'inactivité à tous les compteurs actifs, et continue à chronométrer.

  Vous travailliez sur les activités lorsque votre ordinateur était en veille, et continuez à travailler sur celles-ci.

Revenir en arrière

- Soustrait la durée d'inactivité de tous les compteurs, et les arrête.

  Vous ne travailliez pas sur les activités lorsque votre ordinateur était en veille, et ne l'êtes toujours pas.

### Autres systèmes

#### &korganizer;

&ktimetracker;, comme &korganizer; et l'application d'Apple iCal, utilise le format standard iCalendar pour ses données. &ktimetracker; peut lire et écrire les listes de tâches créées par ces deux applications.

Vous pouvez même travailler sur le même fichier, de manière synchronisée, avec &korganizer; et &ktimetracker;. Si un de ces deux programmes modifie le fichier, ses changements seront automatiquement propagés à l'autre application.

#### Agenda

Un exemple d'utilisation typique est lorsque vous voulez planifier un projet avec l'outil de gestion de projets Imendio Planner (depuis live.gnome.org/Planner). Vous voulez importer ses activités dans &ktimetracker; avec Fichier Importer Importer les activités depuis Planner..., pour les avoir dans le format standard iCalendar. Cela vous permet de planifier les activités avec &korganizer;, et y affecter vos heures avec &ktimetracker;. C'est là un moyen pour vous aider à maintenir votre projet dans les délais et dans le budget.

#### &DBus;

&DBus; est le mécanisme que les applications de &kde; utilisent pour communiquer entre elles. Un programme de &kde; fournit une liste de fonctions (par exemple un script Bash) que les autres programmes peuvent utiliser.

##### Script Bash qui retourne la version de &ktimetracker;

    qdbus org.kde.ktimetracker /KTimeTracker version 2
    >/dev/null || echo « ktimetracker non lancé »

L'interface actuelle &DBus; de &ktimetracker; est essentiellement utilisée pour effectuer des tests automatiques ; elle est donc encore très limitée. Pour la définition complète de l'interface, veuillez vous référer à l'annexe sur l'interface &DBus;

Pour afficher la totalité de l'interface &DBus; de la version de &ktimetracker; installée sur votre système, veuillez exécuter le script Bash suivant :

##### Lister sur une console l'interface &DBus; de &ktimetracker;

    qdbus org.kde.ktimetracker /KTimeTracker 2
    >/dev/null || echo « ktimetracker non lancé »

#### Exporter les totaux vers CSV

&ktimetracker; peut exporter les totaux ainsi que l'historique vers un fichier CSV, dont les valeurs sont séparées par des virgules. Pour exporter les totaux, sélectionnez Fichier Exporter Exporter les temps... . &ktimetracker; affichera alors la boîte de dialogue suivante :

La boîte de dialogue Exporter CSV de &ktimetracker; La boîte de dialogue Exporter CSV de &ktimetracker;

Saisissez le fichier vers lequel vous souhaitez exporter les données, et modifiez si nécessaire les autres paramètres de la boîte de dialogue. Cliquez sur Exporter ; &ktimetracker;exportera vers ce fichier les totaux pour chaque activité.

Utilisez le bouton Exporter vers le presse-papiers pour exporter les durées vers le presse-papier

Voici un exemple du format de sortie :

    "kde",,,,,0.00,0.00,6.88,9.83
    ,"ktimetracker",,,,6.88,8.70,6.88,9.83
    ,,"3.2 feature plan",,,0.00,0.00,0.00,0.00
    ,,"",,,0.00,1.13,0.00,1.13
    ,,"checkin changes - translation strings",,,0.00,0.00,0.00,0.00
    ,,"time card report",,,0.00,0.00,0.00,0.00
    ,"kopete",,,,0.00,0.00,0.00,0.00
    ,"promo",,,,0.00,0.00,0.00,0.00
    ,"web stuff",,,,0.00,0.00,0.00,0.00

Les activités au niveau le plus haut apparaissent dans la première colonne, les sous-activités dans la seconde, et ainsi de suite. Les données de durée apparaissent après le niveau d'activité le plus faible (cinq dans cet exemple). La première colonne de durée indique la Durée de session, la seconde la Durée, la troisième la Durée totale de session, et la quatrième la Durée totale.

#### Exporter l'historique vers CSV

Pour exporter l'historique des activités, sélectionnez Fichier Exporter Exporter l'historique... . &ktimetracker; affiche la même boîte de dialogue que précédemment.

Saisissez le fichier vers lequel vous souhaitez exporter les données, et sélectionnez la période de temps que l'historique d'activité doit couvrir. Modifiez si nécessaire les autres paramètres de la boîte de dialogue. Cliquez sur Exporter ; &ktimetracker; exportera l'historique vers ce fichier.

Utilisez le bouton Exporter vers le presse-papiers pour exporter l'historique vers le presse-papier.

Voici un exemple du format de sortie :

    Task History
    From Tuesday 06 July 2004 to Tuesday 13 July 2004
    Printed on: 2004-07-13 18:10
    2004-07-06,2004-07-07,2004-07-08,2004-07-09,2004-07-10,2004-07-11,2004-07-12,2004-07-13,
    ,,,,,,,,0.00,"kde"
    ,,1.77,3.23,1.73,,1.37,0.82,8.95,,"ktimetracker"
    ,,,,,,,,0.00,,,"3.2 feature plan"
    ,1.13,,,,,,,1.13,,,"bugs"
    ,,,,,,,,0.00,,,"checkin changes - translation strings"
    ,,,,,,,,0.00,,,"time card report"
    ,,,,,,,,0.00,,"kopete"
    ,,,,,,,,0.00,,"promo"
    ,,,,,,,,0.00,,"web stuff"

Les trois premières lignes identifient la date de création du rapport, et la période de temps. La quatrième ligne est une liste délimitée par des virgules contenant les dates dans la période de temps, au format ISO 8601 (AAAA-MM-JJ). Toutes les lignes suivantes indiquent les temps relevés pour chaque activité. La dernière colonne numérique indique le total de la ligne sur toute la période de temps. Le nom de l'activité est écrit après la colonne des totaux, et est indentée de manière à indiquer la relation entre une activité et les sous-activités. Les activités au niveau le plus haut apparaissent donc dans la première colonne après le total.

## L'interface de &ktimetracker;

La fenêtre principale de &ktimetracker; présente les composants suivants : barre de menus, barre d'outils, barre de recherche, fenêtre de tâches et de durées, et barre d'état.

La barre de recherche est un champ combiné. Tant que vous ne saisissez pas &Enter;, ce champ agit comme un champ de filtrage. Ainsi, seules les activités correspondant au nom que vous avez saisi sont affichées. Mais dès que vous saisissez &Enter;, une nouvelle activité est créée avec le nom que vous avez saisi.

Choisissez Configuration pour PDA dans la page Apparence de la boîte de configuration si vous possédez un écran tactile qui est délicat. Cette option désactivera la barre de recherche, et à chaque clic s'affichera un menu contextuel.

L'écran de &ktimetracker; L'écran de &ktimetracker;

### La fenêtre de tâches et de durées

Les différentes tâches sont affichées dans cette fenêtre, avec le temps accumulé pour chacune dans la session en cours et au total. Les tâches en cours de chronométrage ont une icône en forme d'horloge à côté du temps associé à la session.

Des sous-tâches peuvent être créées pour chaque tâche. Cliquez sur les signes + ou - en regard de chaque tâche pour afficher ou cacher ses sous-tâches associées. La durée totale de la tâche inclut les durées des différentes sous-tâches, ainsi que sa propre durée accumulée.

### La barre d'outils et la barre d'état

La barre d'outils contient des icônes pour les commandes suivantes :

Toutes se comportent exactement comme les commandes des menus.

- Nouvelle activité

- Nouvelle sous-activité

- Démarrer

- Arrêter

- Supprimer

- Modifier

- Ouvrir

- Enregistrer

La barre d'état indique le nom du fichier d'enregistrement des données.

## Remerciements et licence

&ktimetracker;

Copyright du programme :

- 1997-2000 &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;.

- 2001-2002 Tomas Pospisek tpo_deb@sourcepole.ch

- 2003-2004 Mark Bucciarelli mark@hubcapconsulting.com

Contributeurs :

- Allen Winter winter@kde.org

- &David.Faure; &David.Faure.mail;

- &Espen.Sand; espen@kde.org

- Gioele Barabucci gioele@gioelebarabucci.com

- Jan Schaumann jschauma@netmeister.org

- &Jesper.Pedersen; blackie@ifad.dk

- Kalle Dalheimer &Matthias.Kalle.Dalheimer.mail;

- Klarälvdalens Datakonsult AB

- Mark Bucciarelli mark@hubcapconsulting.com

- Thorsten Stärk dev@staerk.de

- Tomas Pospisek tpo_deb@sourcepole.ch

- Willi Richert w.richert@cox.net

&ktimetracker; a été inspiré par l'utilitaire titrax de Harald Tveit Alvestrand, dont le seul défaut est d'utiliser la boîte à outils XT.

Copyright de la documentation 2000-2004 &Jonathan.Singer; &Jonathan.Singer.mail; et &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;.

Traduction française par &AlviseCavallari;, &GerardDelafond;, &LudovicGrossard;

&underFDL; &underGPL;

## Glossaire

## A

activité active

Une activité dont le chronomètre est en fonction

## D

&DBus;

Le protocole de communication inter-processus utilisé par &kde;. Raccourci pour Desktop Bus

bureau

&GNU;/&Linux;, FreeBSD et d'autres systèmes utilisant X-Windows permettent d'avoir plusieurs bureaux. Généralement, quatre bureaux sont définis par défaut. Chaque bureau peut afficher son propre ensemble de programmes et de fichiers. Au démarrage de &kde;, le bureau affiché est le Bureau 1. En appuyant sur &Ctrl;F2, vous passez au Bureau 2. En appuyant sur &Ctrl;F1, vous revenez au Bureau 1.

## H

historique

Si &ktimetracker; est configuré pour enregistrer l'historique, il enregistrera chaque évènement de démarrage / arrêt. Cet historique n'est pas effacé lorsque les compteurs sont remis à zéro ; il reste dans le fichier tant que l'activité n'est pas supprimée.

## S

session

Un point de départ défini par les utilisateurs pour les chronomètres de session. Une nouvelle session débute lorsque vous sélectionnez Fichier Démarrer une nouvelle session . Les données de session ne sont pas enregistrées lorsque vous créez une nouvelle session.

Durée de la session

Le temps passé sur l'activité depuis que la session a été démarrée.

boîte à miniatures

La boîte à miniatures se trouve dans la barre qui apparaît par défaut en bas de votre écran. Dans cette boîte à miniatures L'icône de &ktimetracker; se trouve à l'extrémité droite.

## T

activité au niveau le plus haut

Une activité sans activité parent.

Durée totale de la session

Le temps passé sur l'activité et toutes ses sous-activités depuis que la session a été démarrée.

Durée

Le temps passé sur l'activité depuis que tous les temps ont été remis à zéro.

Durée totale

Le temps passé sur l'activité et toutes ses sous-activités depuis que tous les temps ont été remis à zéro.

## Installation

### Comment obtenir &ktimetracker;

&install.intro.documentation; &install.compile.documentation;

## L'interface &DBus;

version

version

Retourne la version de &ktimetracker;.

    QString version()

#### Description

`version()` est un appel &DBus; qui retourne la version de &ktimetracker;, par exemple 4.3.1. La version est retournée sous forme de chaîne de caractères, dont le format majeure.mineure.correction est caractéristique de &GNU;.

quit

quit

Retourne l'action quitter &ktimetracker;.

    QString quit()

#### Description

`quit()` est un appel &DBus; qui permet à un programme externe de terminer élégamment &ktimetracker;.

addTask

addTask

Ajoute une nouvelle activité.

    QString addTask(QString taskname)

#### Paramètres

`taskname`

- Le nom d'une activité.

#### Description

`addTask(QString taskname)` est un appel &DBus; qui ajoute une nouvelle tâche au niveau le plus haut dans l'enregistrement actuel. Cette fonction retourne l'UID de la nouvelle tâche.

&documentation.index;