El manual del KTimetracker

# El manual del KTimetracker

Singer, Jonathan `<jsinger@leeta.net>`

Bucciarelli, Mark `<mark@hubcapconsulting.com>`

Kang, Sirtaj `<taj@kde.org>`

Revisor: Lauri Watts
Traductor: Antoni Bella
revisió 5.0 (19 de novembre de 2019)

Dret de reproducció © 2000-2004 Singer, Jonathan

Dret de reproducció © 2004-2005 Mark Bucciarelli

Avís legal

El KTimetracker segueix el temps dedicat a diferents tasques.

Llistat d'exemples

2.1. Script de Bash que mostra la versió del KTimetracker
2.2. Llistar la interfície de D-Bus del KTimetracker a la consola

Capítol 1. Introducció
Introducció

# Capítol 1. Introducció

El 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.

Aquest 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ó.

El 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.

El KTimetracker va ser escrit originalment per en Kang, Sirtaj. La seva pàgina web és https://userbase.kde.org/KTimeTracker.

Capítol 2. Usar el KTimetracker
Usar el KTimetracker

# Capítol 2. Usar el KTimetracker

## Començar amb el KTimetracker

Escriviu ktimetracker a l'indicatiu d'ordres o seleccioneu Seguiment horari personal des del grup Aplicacions → Utilitats en el Llançador d'aplicacions del Plasma. Les opcions d'ordres de les Qt™ i els Frameworks 5 del KDE estan disponibles, vegeu les pàgines man qt5options i kf5options.

El 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, https://www.mysite.com/mydata/mylabor.ics.

Tasques
Tasques

## 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.

El 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.

El 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 Tasca → Tasca nova... (Ctrl+T). Per crear una subtasca, ressalteu la tasca principal i seleccioneu Tasca → Subtasca nova... (Ctrl+B).

Quan sortiu del 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.

El KTimetracker pot importar i exportar tasques per a reduir al mínim el vostre treball. Vegeu «Altres sistemes».

Temporitzadors
Temporitzadors

## 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.

El 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 la sessió.

Un altre indici visual de l'activitat a l'historial és la icona del 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.

El 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, el KTimetracker mostra dues columnes per cada temporitzador, donant com a resultat un total de quatre columnes per a cada tasca:

Temps de la 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 la 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 sessió nova, 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à, el KTimetracker aturarà automàticament la tasca de projecte i iniciarà l'altra.

Per associar una tasca amb un o més escriptoris, seleccioneu Tasca → Propietats (Ctrl+E). 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, el 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 a la pàgina Comportament del diàleg de configuració.

El 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, el KTimetracker mostrarà el següent diàleg:

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
Altres sistemes

## Altres sistemes

### KOrganizer

El KTimetracker, com el KOrganizer i iCal de Apple, utilitzen el format iCalendar estàndard de la indústria per a les seves dades. El 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 Planner) i importar les seves tasques al 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 el KOrganizer, i comptar el vostre temps en el KTimetracker. Aquesta és una manera d'ajudar-vos a assegurar que el vostre projecte es manté en el temps i sota el pressupost.

### D-Bus

El KTimetracker té suport per a nombrosos mètodes que es poden utilitzar amb D-Bus.

Hi ha dues maneres d'utilitzar la interfície de D-Bus: L'IGU de les Qt™ és qdbusviewer i la línia d'ordres qdbus.

Exemple 2.1. Script de Bash que mostra la versió del KTimetracker

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

La interfície de D-Bus actual del KTimetracker actualment és utilitzada principalment per a realitzar proves automatitzades, pel que és molt limitada. Per a una completa definició de la interfície, vegeu l'Apèndix A, Interfície de D-Bus.

Per a veure la interfície de D-Bus completa de la versió del KTimetracker instal·lada al vostre sistema, executeu el següent script:

Exemple 2.2. Llistar la interfície de D-Bus del KTimetracker a la consola

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

### Exportar els totals com a CSV

El 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... i el KTimetracker mostrarà el diàleg d'exportació:

Seleccioneu l'opció Temps com a CSV al grup Tipus d'informe. El diàleg tindrà un aspecte com segueix:

Si cal, modifiqueu els valors predeterminats del diàleg. Obtindreu una vista prèvia de la sortida CSV al costat dret del diàleg. Feu clic a Desa com a...i el KTimetracker exportarà els totals de totes les tasques cap al fitxer que introduïu en un diàleg de fitxers.

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

Vet aquí un altre 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 la 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... i el KTimetracker mostrarà el mateix diàleg d'exportació com es mostra a dalt. Seleccioneu l'opció Historial com a CSV en el grup Tipus d'informe.

Seleccioneu un interval de dates amb el que voleu cobrir l'historial de tasques. Si cal, modifiqueu els valors predeterminats del diàleg. Obtindreu una vista prèvia de la sortida CSV al costat dret del diàleg. Feu clic a Desa com a...i el KTimetracker exportarà els totals de totes les tasques cap al fitxer que introduïu en un diàleg de fitxers.

Utilitzeu el botó Copia al porta-retalls per exportar els temps 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 interval de dates. La quarta fila és una llista separada per comes de les dates en l'interval 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.

Capítol 3. La interfície del KTimetracker
La interfície del KTimetracker

# Capítol 3. La interfície del KTimetracker

La finestra principal del 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 Retorn, actua com un filtre. Llavors, només es mostren les tasques que coincideixen amb l'entrada. Tan aviat com premeu Retorn, la vostra entrada s'utilitzarà com a nom per crear una tasca nova.

Escolliu Configuració per a la PDA a la pàgina Aparença 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.

## 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 i la barra d'estat

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

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

### Nota

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

- Tasca nova

- Subtasca nova

- Inicia

- Atura

- Esborra

- Edita

- Obre

- Desa

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

Capítol 4. Crèdits i llicència
Crèdits i llicència

# Capítol 4. Crèdits i llicència

KTimetracker

Copyright del programa:

- 1997-2000 Kang, Sirtaj `(taj AT kde.org)`

- 2001-2002 Tomas Pospisek `(tpo_deb AT sourcepole.ch)`

- 2003-2004 Mark Bucciarelli `(mark AT hubcapconsulting.com)`

- 2004-2011 Thorsten Stärk `(dev AT staerk.de)`

- 2019 Alexander Potashev `(aspotashev AT gmail.com)`

Col·laboradors (en ordre alfabètic)

- Alexander Potashev `(aspotashev AT gmail.com)`

- Allen Winter `(winter AT kde.org)`

- Faure, David `(faure AT kde.org)`

- Sand, Espen `(espen AT kde.org)`

- Gioele Barabucci `(gioele AT gioelebarabucci.com)`

- Jan Schaumann `(jschauma AT netmeister.org)`

- Pedersen, Jesper `(blackie AT ifad.dk)`

- Kalle Dalheimer `(kalle AT kde.org)`

- Klarälvdalens Datakonsult AB

- Mark Bucciarelli `(mark AT hubcapconsulting.com)`

- Thorsten Stärk `(dev AT staerk.de)`

- Tomas Pospisek `(tpo_deb AT sourcepole.ch)`

- Willi Richert `(w.richert AT cox.net)`

El 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 Singer, Jonathan `(jsinger AT leeta.net)` i Kang, Sirtaj `(taj AT kde.org)`.

Traductor de la documentació: Antoni Bella `(antonibella5 AT yahoo.com)`

Aquesta documentació està llicenciada d'acord amb les clàusules de la Llicència de Documentació Lliure de GNU.

Aquest programa està llicenciat d'acord amb les clàusules de la Llicència Pública General de GNU.

Glossari
Glossari

# Glossari

### A

tasca activa

  Una tasca que té un funcionament automàtic.

### D

D-Bus

  Un protocol de comunicació entre processos. Nom curt per a «Desktop Bus» (bus d'escriptori).

escriptori

  GNU/Linux®, FreeBSD i altres sistemes que executen el sevidor X.Org 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 Plasma del 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 el 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 sessió nova comença quan seleccioneu Fitxer → Inicia una sessió nova. Les dades de sessió no es desen quan creeu una sessió nova.

Temps de la sessió

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

safata del sistema

  La safata del sistema es troba a la barra que (de manera predeterminada en el Plasma del KDE) apareix a la part inferior de la pantalla. En aquesta safata del sistema apareix la icona del KTimetracker que es troba al costat dret.

### T

tasca de nivell superior

  Una tasca sense tasques pares.

Temps total de la 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.

Apèndix A. Interfície de D-Bus
Interfície de D-Bus

# Apèndix A. Interfície de D-Bus

version
version

## Nom

version — Retorna la versió del KTimetracker.

## Sinopsi

    QString version()

## Descripció

`version()` és una crida de D-Bus que retorna el nombre de versió del 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

## Nom

quit — Sortir del KTimetracker

## Sinopsi

    QString quit()

## Descripció

`quit()` és una crida de D-Bus que proporciona una manera amb la que un programa extern pot sortir del KTimetracker amb.

addTask
addTask

## Nom

addTask — Afegeix una tasca nova.

## Sinopsi

    QString addTask(QString nom_tasca)

### Paràmetres

`nom_tasca`

  El nom de la tasca nova.

## Descripció

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