La guida di KArm

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

KArm 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 KArm mostra la seguente finestra di dialogo:

---

---

Per generare il rapporto dei tempi totali per la stampa, seleziona File->Stampa (Ctrl+P). Verrà generato un rapporto completo su tre colonne di tutti i lavori. La prima colonna è il nome del lavoro, la seconda è la durata totale della sessione e la terza colonna è il Tempo totale.

Per generare negli appunti il rapporto dei tempi totali, seleziona File->Copia i totali negli appunti (Ctrl+C).

Questo rapporto sarà generato per il lavoro selezionato e tutti i suoi sottolavori. Se il lavoro corrente è un lavoro principale KArm ti chiederà se vorrai generare il rapporto per il lavoro corrente e i suoi sottolavori, oppure per tutti i lavori.

---

---

Una volta che il rapporto viene generato apri Kedit, oppure un altro editor di testo e incolla il rapporto generato.

La prima colonna è Tempo totale ed usa i rientri (come il nome delle attività) per indicare le relazioni tra attività e sottoattività. I tempi riportati includono i tempi delle sottoattività.

Per generare negli appunti il rapporto dei totali, seleziona File->Copia cronologia negli appunti (Ctrl+Alt+C).

Questo rapporto sarà generato per il lavoro selezionato e tutti i suoi sottolavori. Potrai anche scegliere se generare il rapporto per per tutti i lavori.

Quando selezioni di creare un rapporto dalla cronologia, KArm ti chiederà di scegliere un periodo di tempo per il rapporto:

---

---

Dopo aver inserito un intervallo date, apri KEdit o un altro elaboratore di testi e incolla il rapporto creato.

La lista delle attività ha un totale per ogni giorno e attività, raggruppati per ogni settimana. Le prime sette colonne vanno dal lunedì alla domenica. L'ottava colonna rappresenta i totali della settimana e la nona è il nome dell'attività. I nomi delle attività sono fatti rientrare per indicare le relazioni fra attività e sottoattività.

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

Un tipico esempio di utilizzo. Puoi voler pianificare un progetto con il programma Imendio Planner (da planner.imendio.org) e importare le attività su KArm per averle nel formato standard ICalendar. Fatto questo puoi impostare le attività in KOrganizer, e tener conto del tempo che ti prendono con KArm. Questo è un metodo per aiutarti a tenere il tuo progetto nei tempi e nel budget.

DCOP è il meccanismo che i programmi sviluppati per KDE usano per comunicare tra loro. Un programma per KDE fornisce una lista di funzioni che altri programmi (uno script di Bash, per esempio) possono usare.

DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                VERS=`dcop $DCOPID KarmDCOPIface version`
                echo "La versione di KArm è la $VERS"
        else
                echo "KArm non è in esecuzione"
        fi

L'interfaccia DCOP corrente di KArm è attualmente usata principalmente per test automatici, perciò è molto limitata. Per la definizione completa della interfaccia vadi DCOP Appendice interfaccia.

Per visualizzare l'interfaccia DCOP completa della versione di KArm installata nel tuo sistema, esegui lo script Bash che segue:

DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                dcop $DCOPID KarmDCOPIface
        else
                echo "KArm non è in esecuzione"
        fi

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

---

---

Indica il file nel quale desideri esportare i dati, e modifica le opzioni della finestra di dialogo, se necessario. Da notare che la casella di controllo dell'intervallo di tempo è disabilitata perché stai esportando i totali, non la cronologia. Fai clic su Esporta e KArm esporterà i totali nel file indicato in precedenza.

Un esempio dell'output:

Le attività principali sono riportate nella prima colonna, le sottoattività nella 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.

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

Indica il 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 KArm esporterà la cronologia per tutte le attività nel file che hai scelto.

Un esempio dell'output:

Le tre linee iniziali definiscono quando il rapporto è stato generato e per quale intervallo di tempo. La quarta è una lista 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 sottoattività. I nomi delle attività principali appaiono nelle prime colonne, dopo i totali.