Manuale di KTimetracker

# Manuale di KTimetracker

Jonathan Singer `<jsinger@leeta.net>`

Mark Bucciarelli `<mark@hubcapconsulting.com>`

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

Revisore: Lauri Watts
Traduzione e revisione del documento: Valter Mura
Traduzione del documento: Salvatore Brigaglia
Revisione 4.11 pre (KDE
4.11) (2013-05-26)

Diritto d'autore © 2000-2004 Jonathan Singer

Diritto d'autore © 2004-2005 Mark Bucciarelli

Nota Legale

KTimetracker cronometra il tempo usato per vari impieghi.

Lista degli esempi

2.1. Script bash che mostra la versione di KTimetracker
2.2. Mostra l'interfaccia D-Bus di KTimetracker nella console

Capitolo 1. Introduzione
Introduzione

# Capitolo 1. Introduzione

KTimetracker cronometra il tempo usato per vari impieghi. È utile per calcolare ore fatturabili e può riassumerle giorno per giorno, per i singoli lavori eseguiti.

Questa cronologia può essere esportata per essere utilizzata in altri programmi di fatturazione o gestione progetti.

KTimetracker riconosce quando la tastiera e il mouse non sono utilizzati e può associare diversi lavori a diversi desktop virtuali, per aiutarti a calcolare correttamente il tempo per ogni lavoro.

KTimetracker è stato in origine scritto da Sirtaj Singh Kang. La sua pagina web è https://userbase.kde.org/KTimeTracker.

Capitolo 2. Uso di KTimetracker
Uso di KTimetracker

# Capitolo 2. Uso di KTimetracker

## Avvio di KTimetracker

Digita ktimetracker nel prompt dei comandi oppure seleziona Segnatempo personale dal gruppo Applicazioni → Accessori del menu di KDE. Le opzioni standard a riga di comando di Qt™ e KDE sono disponibili, ne puoi vedere la lista digitando `ktimetracker `--help`` al prompt dei comandi.

KTimetracker mette a disposizione una opzione che ti permette di impostare il nome di un file iCalendar che contiene la storia dei tuoi impieghi. Puoi immettere l'indirizzo di un file iCalendar sia HTTP sia FTP, per esempio, https://www.mysite.com/mydata/mylabor.ics.

Impieghi
Impieghi

## Impieghi

Problema: sei un consulente freelance con molti clienti. Alcuni dei quali hanno diversi progetti. Durante il giorno sposti continuamente l'attenzione da un progetto all'altro. Hai bisogno di sapere quanto tempo dedichi ad ogni progetto per calcolare le parcelle mensili.

Soluzione: crea una nuova attività per ogni cliente e un'attività secondaria per ogni progetto del cliente. Per i progetti che richiedono un conteggio del tempo più dettagliato, aggiungi più attività secondarie. Segna il tempo premendo sul nome del progetto per il quale stai iniziando a calcolare il tempo.

KTimetracker dispone di grande flessibilità nel contare il tuo tempo, permettendoti di segnare attività illimitate e per un tempo illimitato. Il tempo segnato può essere attribuito a ogni attività e a più di un'attività allo stesso tempo.

KTimetracker ti consente di modificare la cronologia delle tue attività e inserire un commento per ciascun evento che ha fermato.

Per creare un'attività di primo livello scegli Attività → Nuova attività... (Ctrl+T). Per creare un'attività secondaria, evidenzia l'attività principale e scegli Attività → Nuova attività secondaria... (Ctrl+Alt+N).

Quando si chiude KTimetracker la lista delle attività viene salvata sul disco. Al successivo avvio esso caricherà automaticamente la lista delle attività dallo stesso file.

KTimetracker può importare ed esportare attività per minimizzare il tuo lavoro. Consulta la sezione chiamata «Altri sistemi».

Cronometri
Cronometri

## Cronometri

Problema: per sbarcare il lunario devi fatturare una media di cinque ore al giorno. Per sapere a che punto sei guarda i totali giornalieri e settimanali.

Soluzione: azzera i cronometri della sessione ogni giorno e i cronometri totali all'inizio di ogni settimana.

KTimetracker rende facile segnare il tempo. Per iniziare il conteggio del tempo per un'attività premi due volte sull'attività per la quale vuoi iniziare a contare il tempo. Per fermare il conteggio premi ancora due volte sull'attività. Le attività per le quali si sta calcolando il tempo mostrano un piccolo orologio che gira nella colonna Tempo della sessione.

Un altro indicatore grafico del cronometraggio è l'icona di KTimetracker nel vassoio di sistema. Quando un lavoro è attivo, la lancetta dei secondi dell'icona si muove. Se tieni il puntatore del mouse sull'icona, comparirà il nome dell'attività che stai cronometrando. Se più di un lavoro è attivo compariranno i nomi di tutte le attività separati da virgole.

KTimetracker mantiene due cronometri differenti per ogni applicazione: uno per il tempo della sessione, l'altro per il tempo totale del lavoro. Nella configurazione predefinita, KTimetracker mostra due colonne per ogni cronometro, per un totale quattro colonne per ogni attività:

Tempo della sessione

  Il tempo impiegato per il lavoro dall'inizio della sessione.

Ora

  Il tempo impiegato globalmente, dall'avvio dei cronometri.

Tempo totale della sessione

  Il tempo impiegato per il lavoro e per ogni attività secondaria, dall'inizio della sessione.

Tempo totale

  Tempo impiegato nell'attività principale e tutte le sue attività secondarie dal riavvio del cronometro.

Per iniziare una nuova sessione, seleziona File → Inizia nuova sessione

Per azzerare tutti i conteggi, seleziona File → Azzera tutti i tempi

### Conteggio per desktop

Problema: hai due progetti principali tra i quali ti muovi ogni giorno. Per aiutarti nell'organizzazione del lavoro tieni i file del lavoro 1 nel desktop 1 e i file del lavoro 2 nel desktop 2.

Soluzione: associa un'attività a ogni desktop e KTimetracker inizierà il conteggio dell'attività 1 quando rendi attivo il desktop 1 e inizierà (fermando il conteggio per l'attività precedente) il conteggio dell'attività 2 quando ti sposterai al desktop 2.

Per associare un'attività a uno o più desktop scegli Attività → Modifica... (Ctrl+E). Attiva Tracking automatico e seleziona il desktop o i desktop da associare all'attività. Quando uno qualsiasi dei desktop selezionati diventa attivo, dopo qualche secondo KTimetracker inizierà a cronometrare il tempo dell'attività impostata.

### Rilevamento di inattività

Problema: lasci il lavoro presto il venerdì per andare da qualche parte e dimentichi di fermare il cronometro. Quando torni in ufficio lunedì il cronometro sta ancora andando.

Soluzione: attiva il rilevamento automatico di inattività nella pagina Comportamento della finestra di dialogo delle impostazioni.

KTimetracker può essere configurato per accorgersi quando il mouse e la tastiera diventano inattivi. Se la tastiera e il mouse sono inattivi per un tempo più lungo di quello impostato KTimetracker mostra la seguente finestra di dialogo:

Continua la misurazione del tempo

  Applica il tempo inattivo a tutti i cronometri attivi e li mantiene in esecuzione.

  Stavi lavorando a quelle attività anche se non stavi usando il computer e ancora ci stai lavorando.

Riavvia il cronometro

  Sottrae la quantità di tempo di inattività da tutti i cronometri attivi e ferma la misurazione.

  Significa che non stavi lavorando sulle attività impostate mentre il computer era inattivo e non stai lavorando nemmeno ora.

Altri sistemi
Altri sistemi

## Altri sistemi

### KOrganizer

KTimetracker, come KOrganizer e iCal della Apple, usa il formato standard industriale iCalendar per i suoi dati. KTimetracker può leggere e scrivere la lista delle cose da fare creata da queste due applicazioni.

Puoi anche lavorare in modo sincronizzato su un file con KOrganizer e KTimetracker. Se un programma cambia il file, le modifiche saranno automaticamente riportate nell'altra applicazione.

### Planner

Un tipico esempio di utilizzo: vuoi pianificare un progetto con il programma Planner e importare le attività in KTimetracker per averle nel formato standard industriale iCalendar. Fatto questo, puoi impostare le attività in KOrganizer e tener conto del tempo che ti occupano con KTimetracker. Questo è un metodo per aiutarti a tenere il tuo progetto nei tempi e nel budget.

### D-Bus

D-Bus è il meccanismo che i programmi sviluppati per KDE usano per comunicare tra loro. Un programma per KDE fornisce un elenco di funzioni che altri programmi (uno script di Bash, per esempio) possono usare.

Esempio 2.1. Script bash che mostra la versione di KTimetracker

    qdbus org.kde.ktimetracker /KTimeTracker version 2
    >/dev/null || echo "ktimetracker non in esecuzione"

L'interfaccia D-Bus corrente di KTimetracker è attualmente usata principalmente per test automatici, quindi è molto limitata. Per la definizione completa dell'interfaccia, consulta Appendice A, Interfaccia D-Bus.

Per visualizzare l'interfaccia D-Bus completa della versione di KTimetracker installata nel tuo sistema, esegui lo script bash che segue:

Esempio 2.2. Mostra l'interfaccia D-Bus di KTimetracker nella console

    qdbus org.kde.ktimetracker /KTimeTracker 2
    >/dev/null || echo "ktimetracker non in esecuzione"

### Esporta i totali su CSV

KTimetracker può esportare i totali e la cronologia in un file CSV. Per l'esportazione dei totali seleziona File → Importa/Esporta → Esporta in un file CSV... e KTimetracker mostrerà la finestra di dialogo seguente:

Indica il nome del file nel quale vuoi esportare i dati. Modifica anche le altre impostazioni se necessario. Fai clic su Esporta e KTimetracker esporterà la cronologia per tutte le attività nel file che hai scelto.

Usa il pulsante Copia negli appunti per esportare i tempi negli appunti

Un esempio dell'output:

`
"kde",,,,,0.00,0.00,6.88,9.83
,"ktimetracker",,,,6.88,8.70,6.88,9.83
,,"3.2 pianificazione caratteristiche",,,0.00,0.00,0.00,0.00
,,"bugs",,,0.00,1.13,0.00,1.13
,,"verifica cambiamenti - traduzione stringhe",,,0.00,0.00,0.00,0.00
,,"lavo il gatto",,,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
`

Le attività principali sono riportate nella prima colonna, le attività secondarienella seconda e così via. La quantità di tempo è riportata dopo il nome dell'attività (sono cinque in questo esempio). La prima colonna del tempo è Tempo della sessione, la seconda è Tempo, la terza Tempo totale di sessione la quarta Tempo totale.

### Esporta la cronologia in CSV

Per esportare la cronologia delle attività, seleziona File → Importa/Esporta → Esporta cronologia in un file CSV... e KTimetracker mostrerà la stessa finestra di prima.

Indica il nome del file nel quale vuoi esportare i dati e indica l'intervallo di tempo per il quale desideri esportare la cronologia. Modifica anche le altre impostazioni se necessario. Fai clic su Esporta e KTimetracker esporterà la cronologia delle attività nel file che hai scelto.

Usa il pulsante Copia negli appunti per esportare la cronologia negli appunti.

Un esempio dell'output:

`
Cronologia Attività
Da giovedì 06 luglio 2004 a giovedì 13 luglio 2004
Generato il: 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 pianificazione caratteristiche"
,1.13,,,,,,,1.13,,,"bugs"
,,,,,,,,0.00,,,"verifica cambiamenti - traduzione stringhe"
,,,,,,,,0.00,,,"resoconto tempo"
,,,,,,,,0.00,,"kopete"
,,,,,,,,0.00,,"promo"
,,,,,,,,0.00,,"web stuff"
`

Le prime tre righe definiscono quando il rapporto è stato generato e per quale intervallo di tempo. La quarta è un elenco delle date nell'intervallo di tempo definito, nel formato ISO 8601 (AAAA-MM-GG). Tutte le righe successive indicano il tempo impiegato in ogni attività. L'ultima colonna in formato numerico indica il totale per quell'attività, per tutti i giorni dell'intervallo di tempo. Il nome dell'attività è riportato dopo la colonna del totale e, a seconda della quantità del rientro rispetto al margine, indica le relazioni tra attività e attività secondarie. I nomi delle attività principali appaiono nelle prime colonne, dopo i totali.

Capitolo 3. L'interfaccia di KTimetracker
L'interfaccia di KTimetracker

# Capitolo 3. L'interfaccia di KTimetracker

La finestra principale di KTimetracker ha i seguenti componenti: barra dei menu, barra degli strumenti, barra della ricerca, finestra tempo/attività e la barra di stato.

La barra di ricerca è un campo di testo multifunzione. Digitando una frase qui verranno visualizzate solo le attività corrispondenti al testo inserito. Premendo Invio una nuova attività verrà creata e prenderà il nome dal testo che hai inserito.

Scegli Configurazione per PDA nella pagina Aspetto della finestra di dialogo delle impostazioni se hai uno schermo a sfioramento e lo spazio del tuo schermo è prezioso. Disabiliterà la barra di ricerca e a ogni clic si aprirà un menu contestuale.

## La finestra tempo/attività

Le varie attività sono riportate in questa finestra assieme al tempo cronometrato, per ognuna di esse, nella sessione corrente e in totale. Le attività che vengono cronometrate hanno una piccola icona di orologio vicino al tempo di sessione.

Possono essere create delle attività secondarie per ogni attività. Facendo clic sul segno più e meno di ogni attività principale si espande o contrae la visualizzazione delle sue attività secondarie. Il tempo totale riportato per ogni attività principale contiene i tempi delle sue rispettive attività secondarie, compreso il tempo dell'attività stessa.

La barra degli strumenti e la barra di stato
La barra degli strumenti e la barra di stato

## La barra degli strumenti e la barra di stato

La barra degli strumenti contiene le icone corrispondenti ai seguenti comandi:

### Nota

Tutte si comportano esattamente come i comandi da menu.

- Nuova attività

- Nuova attività secondaria

- Avvia

- Ferma

- Elimina

- Modifica

- Apri

- Salva

La barra di stato mostra il nome del file dove sono stati salvati i dati.

Capitolo 4. Riconoscimenti e licenza
Riconoscimenti e licenza

# Capitolo 4. Riconoscimenti e licenza

KTimetracker

Copyright del programma:

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

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

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

Contributi (in ordine alfabetico)

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

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

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

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

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

- Jesper Pedersen `(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)`

KTimetracker è stato ispirato dall'utilissimo programma titrax di Harald Tveit Alvestrand, la cui unica mancanza è di essere basato sul toolkit Xt.

Copyright documentazione 2000-2004 Jonathan Singer `(jsinger AT leeta.net)` e Sirtaj Singh Kang `(taj AT kde.org)`.

Valter Mura `(valtermura AT gmail.com)`

Questa documentazione è concessa in licenza sotto i termini della GNU Free Documentation License.

Questo programma è concesso in licenza sotto i termini della GNU General Public License.

Glossario
Glossario

# Glossario

### A

Attività in corso

  Un'attività per la quale si sta cronometrando il tempo.

### D

D-Bus

  Il protocollo di comunicazione tra processi usato in KDE. È l'abbreviazione di Desktop Bus.

desktop

  GNU/Linux®, FreeBSD e altri sistemi che utilizzano X-Windows, hanno più desktop virtuali. Normalmente hai quattro desktop presenti per impostazione predefinita. Ogni desktop può visualizzare il suo insieme di programmi e file. Quando KDE si avvia, il desktop in uso è il numero 1. Se premi Ctrl+F2, vedrai il desktop numero 2. Premendo Ctrl+F1 tornerai al desktop 1.

### H

cronologia

  Se è configurato per registrare la cronologia, KTimetracker registrerà ogni volta che avvii o fermi un cronometro. Questa cronologia non viene cancellata quando i tempi vengono azzerati e rimane finché l'attività stessa non viene eliminata.

### S

sessione

  Avvio dei cronometri della sessione definito dall'utente. Una nuova sessione inizia quando selezioni File → Inizia nuova sessione. Quando crei una nuova sessione, i dati della sessione non vengono salvati.

Tempo della sessione

  Il tempo impiegato per il lavoro dall'inizio della sessione.

vassoio di sistema

  Il vassoio di sistema è nella barra che, per impostazione predefinita, appare nella parte bassa dello schermo. Nel vassoio di sistema l'icona di KTimetracker è in fondo a destra.

### T

attività principali

  Un'attività che non discende da nessun'altra attività.

Tempo totale della sessione

  Il tempo impiegato per il lavoro e per ogni attività secondaria, dall'inizio della sessione.

Ora

  Il tempo impiegato globalmente, dall'avvio dei cronometri.

Tempo totale

  Tempo impiegato nell'attività principale e tutte le sue attività secondarie dal riavvio del cronometro.

Appendice A. Interfaccia D-Bus
Interfaccia D-Bus

# Appendice A. Interfaccia D-Bus

version
version

## Nome

version — Restituisce la versione di KTimetracker.

## Sinossi

    QString version()

## Descrizione

`version()` è una chiamata D-Bus che restituisce il numero di versione di KTimetracker, per esempio 4.3.1. Il numero di versione è restituito come stringa nel formato tipico GNU, major.minor.bugfix.

quit
quit

## Nome

quit — Esci da KTimetracker'.

## Sinossi

    QString quit()

## Descrizione

`quit()` è una chiamata D-Bus che consente a un programma esterno di chiudere KTimetracker in maniera corretta.

addTask
addTask

## Nome

addTask — Aggiungi una nuova attività.

## Sinossi

    QString addTask(QString nomeattività)

### Parametri

`taskname`

  Il nome della nuova attività.

## Descrizione

`addTask(QString nomeattività)` è una chiamata D-Bus che aggiunge una nuova attività da svolgere principale alle altre già presenti. Viene restituito l'UID della nuova attività.