# El manual de &ktimetracker;

## Introducció

&ktimetracker; segueix el temps dedicat a diferents tasques. És útil per al seguiment de les hores facturables i informar de les hores registrades per treball i per dia.

Aquesta historial del temps es pot exportar a un fitxer de text delimitat per comes per a la seva importació a altres eines de gestió de projectes i/o de facturació.

&ktimetracker; detecta quan el teclat i el ratolí estan inactius i pot associar diferents tasques amb diferents escriptoris, dues eines que poden ajudar a mantenir el temporitzador en la tasca correcta.

&ktimetracker; va ser escrit originalment per en &Sirtaj.Singh.Kang;. La seva pàgina web és http://userbase.kde.org/Special:MyLanguage/KTimeTracker.

## Usar &ktimetracker;

### Començar amb &ktimetracker;

Escriviu `ktimetracker` a l'indicatiu d'ordres o seleccioneu Seguiment horari personal des del grup Aplicacions Utilitats en el menú d'inici de KDE. Les opcions d'ordres de &Qt; i &kde; estan disponibles i es poden enumerar mitjançant la introducció de ``ktimetracker` `--help`` a la línia d'ordres.

&ktimetracker; proporciona una opció d'ordre addicional que us permet introduir el nom del fitxer iCalendar que s'utilitza per emmagatzemar l'historial. Introduïu un fitxe de iCalendar remot mitjançant http o ftp, com a part del nom de fitxer, per exemple, http://www.mysite.com/mydata/mylabor.ics.

### Tasques

Problema: Sou un consultor independent de programari amb molts clients. Alguns clients tenen múltiples projectes. Durant el transcurs d'un dia, alterneu entre diferents projectes. Necessiteu controlar el temps per generar les factures mensuals.

Solució: Creeu una tasca de nivell superior per a cada client i una subtasca per a cada projecte del client. Per a projectes que requereixen un seguiment més detallat, creeu una llista de subtasques del projecte. Controlareu el temps fent doble clic sobre la tasca en la que esteu treballant actualment.

&ktimetracker; proporciona una gran flexibilitat en el seguiment del vostre temps, permetent tasques i profunditat il·limitades. El temps pot estar annexat a qualsevol tasca, i pot estar activa més d'una tasca en un moment donat.

&ktimetracker; us permet editar l'historial de la vostra tasca i posar un comentari per a tots els esdeveniments que s'han aturat.

Per crear una tasca de nivell superior, seleccioneu &Ctrl;T Tasca Tasca nova... . Per crear una subtasca, ressalteu la tasca principal i seleccioneu &Ctrl;&Alt;N Tasca Subtasca nova... .

Quan sortiu de &ktimetracker;, la llista de tasques serà desada a un fitxer en el disc. La propera vegada que s'obri, es tornarà a carregar la llista de tasques des del mateix fitxer.

&ktimetracker; pot importar i exportar tasques per reduir al mínim el vostre treball. Veure Altres sistemes.

### Temporitzadors

Problema: Per ser solvent, heu de facturar una mitjana de cinc hores al dia. Per mantenir-vos en el camí, veieu els totals diaris i setmanals.

Solució: Reinicieu el temporitzador de la sessió al començament de cada jornada de treball i reinicieu tots els cronòmetres al començament de cada setmana.

&ktimetracker; fa un seguiment de temps simple. Per iniciar el registre de temps contra una tasca, feu doble clic a la tasca. Per aturar el registre de temps, feu doble clic a la tasca de nou. Les tasques actives mostren un petit rellotge a la columna de Temps de sessió.

Un altre indici visual de l'activitat a l'historial és la icona de &ktimetracker; a la safata del sistema. Quan una tasca està activa, es mourà la segona mà a la icona. Si situeu el punter del ratolí sobre aquesta icona, es mostrarà el nom de la tasca activa en un consell. Si està activa més d'una tasca, els noms de les tasques en el consell se separen amb comes.

&ktimetracker; manté dos temporitzadors per a cada tasca: una per al temps de la sessió i un altre per al temps total. En la configuració per defecte, &ktimetracker; mostra dues columnes per cada temporitzador, donant com a resultat un total de quatre columnes per a cada tasca:

Temps de sessió

- El temps dedicat a la tasca des que va començar la sessió.

Temps

- El temps dedicat a la tasca ja que tot el temps es van restablir.

Temps total de sessió

- El temps dedicat a la tasca i totes les seves subtasques des que va començar la sessió.

Temps total

- El temps dedicat a la tasca i totes les seves subtasques des que es van restablir tots els temps.

Per iniciar una nova sessió, seleccioneu Fitxer Inicia una sessió nova .

Per reiniciar tots els temps, seleccioneu Fitxer Reinicialitza tots els temps .

#### Seguiment a l'escriptori

Problema: Teniu dos projectes principals entre els que canvieu cada dia. Per ajudar-vos a organitzar el vostre treball, manteniu els fitxers del projecte 1 a l'escriptori 1 i els del projecte 2 a l'escriptori 2.

Solució: Associeu una tasca de projecte 1 amb l'escriptori 1 i una tasca de projecte 2 amb l'escriptori 2. Quan canvieu entre els escriptoris aquesta s'activarà, &ktimetracker; aturarà automàticament la tasca de projecte i iniciarà l'altra.

Per associar una tasca amb un o més escriptoris, seleccioneu &Ctrl;E Tasca Edita... . Activeu el Seguiment automàtic i seleccioneu l'escriptori o escriptoris a associar amb aquesta tasca. Quan algun dels escriptoris seleccionats es converteixi en actiu, després d'un breu retard &ktimetracker; iniciarà automàticament el registre de temps contra aquesta tasca.

#### Detecció d'inactivitat

Problema: Sortiu del treball el divendres per fer un encàrrec i oblideu aturar el temporitzador. Quan torneu el dilluns, el temporitzador segueix funcionant.

Solució: Activeu la detecció d'inactivitat.

&ktimetracker; es pot configurar per detectar quan el ratolí i el teclat estan inactius. Si el ratolí i el teclat estan inactius per més d'un nombre especificat de minuts, &ktimetracker; mostrarà el següent diàleg:

Detecció d'inactivitat de &ktimetracker; Diàleg de detecció d'inactivitat de &ktimetracker;

Continua cronometrant

- Aplica el temps d'inactivitat a tots els temporitzadors actius i els manté en funcionament.

  Quan esteu treballant en la tasca(ques) mentre l'ordinador estava inactiu i encara ho està.

Reverteix el cronometratge

- Resta la quantitat de temps d'inactivitat de tots els temporitzadors actius i els atura.

  Quan no esteu treballant en la tasca(ques) mentre l'ordinador estava inactiu i encara no ho està.

### Altres sistemes

#### &korganizer;

&ktimetracker;, com &korganizer; i iCal de Apple, utilitzen el format iCalendar estàndard de la indústria per a les seves dades. &ktimetracker; pot llegir i escriure les llistes de tasques pendents creades per aquestes dues aplicacions.

Fins i tot podeu treballar de forma sincrònica sobre un fitxer amb &korganizer; i &ktimetracker;. Si un programa canvia el fitxer, els canvis es propagaran a l'altra aplicació de forma automàtica.

#### Planificador

Com un típic cas d'ús, és possible que vulgueu planificar un projecte amb l'eina de gestió de projectes Imendio Planner (de live.gnome.org/Planner) i importar les seves tasques a &ktimetracker; amb Fitxer Importa Importa les tasques des del Planner... , al format iCalendar estàndard de la industria. Un cop fet, sereu capaç de programar tasques en &korganizer;, i comptar el vostre temps en &ktimetracker;. Aquesta és una manera d'ajudar-vos a assegurar que el vostre projecte es manté en el temps i sota el pressupost.

#### &DBus;

&DBus; és el mecanisme que els programes &kde; utilitzen per comunicar amb els altres. Un programa &kde; proporciona un llistat de funcions que els altres programes (&pex;, un script de Bash) poden utilitzar.

##### Script de Bash que mostra la versió de &ktimetracker;

    qdbus org.kde.ktimetracker /KTimeTracker version 2
    >/dev/null || echo "ktimetracker no s'està executant"

La interfície de &DBus; actual de &ktimetracker; actualment és utilitzada principalment per realitzar proves automatitzades, pel que és molt limitada. Per a una completa la definició de la interfície, veure l'apèndix Interfície de &DBus;.

Per veure la interfície de &DBus; completa de la versió de &ktimetracker; instal·lada al vostre sistema, executeu el següent script:

##### Llistar la interfície de &DBus; de &ktimetracker; a la consola

    qdbus org.kde.ktimetracker /KTimeTracker 2
    >/dev/null || echo "ktimetracker no s'està executant"

#### Exportar els totals com a CSV

&ktimetracker; pot exportar els totals i l'historial d'ambdós a un format de fitxer separat per comes. Per exportar els totals, seleccioneu Fitxer Exporta Exporta els temps... i &ktimetracker; mostrarà el diàleg d'exportació:

Diàleg d'exportació CSV de &ktimetracker; Diàleg d'exportació CSV de &ktimetracker;

Introduïu el nom de fitxer que voleu per exportar les dades, i modifiqueu si és necessari els paràmetres per omissió del diàleg. Feu clic a Exporta i &ktimetracker; exportarà els totals de totes les tasques cap al fitxer seleccionat.

Utilitzeu el botó Exporta al porta-retalls per exportar els temps al porta-retalls.

Vet aquí un exemple del format de sortida:

    "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
    ,,"bugs",,,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 tasques de nivell superior surten a la primera columna, les sub-tasques a la segona, i així successivament. Les dades de temps surten després de la profunditat de tasques màxima (cinc en aquest exemple). La primera columna de temps és Temps de sessió, la segona és Hora, la tercera és Temps total de la sessió i la quarta és Temps total.

#### Exportar l'historial a CSV

Per exportar l'historial de tasques, seleccioneu Fitxer Exporta Exporta l'historial... i &ktimetracker; mostrarà el diàleg d'exportació com es mostra a dalt.

Introduïu el nom de fitxer que voleu per exportar les dades, i seleccioneu un rang de dates del qual voleu prendre l'historial. Modifiqueu si és necessari els paràmetres per omissió de l'altre diàleg. Feu clic a Exporta i &ktimetracker; exportarà l'historial de tasques cap al fitxer seleccionat.

Utilitzeu el botó Exporta al porta-retalls per exportar l'historial al porta-retalls.

Vet aquí un exemple del format de sortida:

    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 tres primeres línies identifiquen quan es va generar l'informe i per a quin rang de dates. La quarta fila és una llista separada per comes de les dates en el rang de dates, en format ISO 8601 (AAAA-MM-DD). Totes les files posteriors llisten el temps registrat contra cada tasca. L'última columna numèrica és el total de files per a tots els dies. El nom de la tasca s'imprimeix després de la columna de totals, i se sagna per indicar la relació entre tasca/sub-tasca. Els noms de les tasques de nivell superior apareixen a la primera columna després del total.

## La interfície de &ktimetracker;

La finestra principal té &ktimetracker; disposa dels següents components: barra de menú, barra d'eines, barra de cerca, finestra de tasca/hora i barra d'estat.

La barra de cerca és un camp combinat. Sempre que no premeu &Intro;, actua com un filtre. Llavors, només es mostren les tasques que coincideixen amb l'entrada. Tan aviat com premeu &Intro;, la vostra entrada s'utilitzarà com a nom per crear una nova tasca.

Escolliu Configuració per a la PDA en el diàleg de configuració si teniu una pantalla tàctil i l'espai de la pantalla és preuat. Es deshabilitarà la barra de cerca i haureu de fer clic a un menú contextual per a que aparegui.

Pantalla de &ktimetracker; Pantalla de &ktimetracker;

### La finestra de tasca/hora

Les diverses tasques que es mostren en aquesta finestra, juntament amb el temps acumulat per a cadascuna en la sessió actual i en total. Les tasques que heu programat tenen una petita icona de rellotge al costat del temps de la sessió.

Es poden crear subtasques per a cada tasca. Fent clic als signes més i menys davant de la tasca principal commuteu la vista de les seves subtasques associades. El temps total acumulat per a una tasca inclou els temps de les seves subtasques, així com el seu propi temps acumulat.

### La barra d'eines i la barra d'estat

La barra d'eines conté icones per a les següents ordres:

Totes es comporten de forma idèntica al menú d'ordres.

- Tasca nova

- Subtasca nova

- Inici

- Atura

- Esborra

- Edita

- Obre

- Desa

La barra d'estat informa del nom del fitxer on es desen les dades.

## Crèdits i llicència

&ktimetracker;

Copyright del programa:

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

- 2001-2002 Tomas Pospisek tpo_deb@sourcepole.ch

- 2003-2004 Mark Bucciarelli mark@hubcapconsulting.com

Col·laboradors (en ordre alfabètic)

- 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; es va inspirar en una molt efectiva utilitat d'en Harald Tveit Alvestrand anomenada titrax, la qual no només està basada en el conjunt d'eines Xt.

Copyright de la documentació 2000-2004 &Jonathan.Singer; &Jonathan.Singer.mail; i &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;.

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

## Glossari

## A

tasca activa

Una tasca que té un funcionament automàtic.

## D

&DBus;

El protocols de comunicació entre processos utilitzat en &kde;. Nom curt per a «Desktop Bus» (bus d'escriptori).

escriptori

&GNU;/&Linux;, FreeBSD i altres sistemes que executen les X-Windows tenen múltiples escriptoris. Típicament podeu tenir fins a quatre escriptoris diferents instal·lats. Cada escriptori pot mostrar el seu propi conjunt de programes i fitxers. Quan s'inicia el &kde; per primera vegada, l'escriptori que es veu és Escriptori 1. Si premeu &Ctrl;F2, veureu Escriptori 2. En prémer &Ctrl;F1 anireu de tornada a Escriptori 1.

## H

historial

Si &ktimetracker; està configurat per registrar l'historial, registrarà cada vegada que inicieu/atureu l'esdeveniment temporitzador. Aquest historial no es netejarà quan es reiniciïn els temps i es mantindrà al fitxer fins que la tasca sigui eliminada.

## S

sessió

Un punt de partida definit per l'usuari per als temporitzadors de sessió. Una nova sessió comença quan seleccioneu Fitxer Inicia una nova sessió . Les dades de sessió no es desen quan creeu una nova sessió.

Temps de sessió

El temps dedicat a la tasca des que va començar la sessió.

safata del sistema

La safata del sistema està a la barra que (per omissió) apareix a la part inferior de la pantalla. En aquesta safata del sistema la icona de &ktimetracker; es troba al costat dret.

## T

tasca de nivell superior

Una tasca sense tasques pares.

Temps total de sessió

El temps dedicat a la tasca i totes les seves subtasques des que va començar la sessió.

Temps

El temps dedicat a la tasca ja que tot el temps es van restablir.

Temps total

El temps dedicat a la tasca i totes les seves subtasques des que es van restablir tots els temps.

## Instal·lació

### Com obtenir &ktimetracker;

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

## Interfície de &DBus;

version

version

Retorna la versió de &ktimetracker;.

    QString version()

#### Descripció

`version()` és una crida de &DBus; que retorna el nombre de versió de &ktimetracker;, per exemple 4.3.1. El nombre de versió es retorna com una cadena en el format típic de GNU major.menor.bugfix.

quit

quit

Surt de &ktimetracker;.

    QString quit()

#### Descripció

`quit()` és una crida de &DBus; que proporciona una manera amb la que un programa extern pot sortir de &ktimetracker; amb.

addTask

addTask

Afegeix nova tasca.

    QString addTask(QString nom_tasca)

#### Paràmetres

`nom_tasca`

- El nom de la nova tasca.

#### Descripció

`addTask(QString nom_tasca)` és una crida de &DBus; que afegeix un nova tasca pendent de nivell superior al l'emmagatzematge actual. Es retorna l'UID de la nova tasca.

&documentation.index;