Het handboek van KArm

Om een taak met één of meer bureaubladen te verbinden, kiest u het menu Taak->Bewerken (Ctrl+E). Schakel Automatisch volgen in en kies de bureaubladen waaraan u de taak wilt verbinden. Als één van de gekozen bureaubladen actief wordt, begint KArm na korte tijd automatisch de tijd voor die taak bij te houden.

KArm kan ingesteld worden om inactiviteit van muis en toetsenbord te detecteren. Als de muis en het toetsenbord langer dan de ingestelde tijd inactief zijn, toont KArm het volgende dialoogvenster:

---

---

Om het totalenrapport voor de printer te genereren, kiest u het menu Bestand->Afdrukken (Ctrl+P). Dit genereert een rapport met drie kolommen voor de complete takenlijst. De eerste kolom is de taaknaam, de tweede kolom is de Totale sessietijd en de derde kolom is de Totale tijd.

Om het totalenrapport naar het klembord te kopiëren, kiest u Bestand->Totalen kopiëren naar klembord (Ctrl+C).

Dit rapport wordt gegenereerd voor de huidige taak en alle subtaken ervan. Als de huidige taak een topniveau-taak is, vraagt KArm u of u het rapport voor de huidige taak en subtaken wilt genereren, of voor de gehele takenlijst.

---

---

Als het rapport gegenereerd is, opent u KEdit of een andere editor en plakt u de rapportdata.

De eerste kolom is de Totale tijd en is ingesprongen (net als de taaknamen) om taak-/subtaak-relaties aan te geven. De gerapporteerde tijden zijn inclusief subtaaktijden.

Om het totalenrapport op het klembord te plaatsen, kiest u het menu Bestand->Geschiedenis kopiëren naar klembord (Ctrl+R).

Dit rapport wordt voor de huidige taak en subtaken gegenereerd. In tegenstelling tot het totalenrapport kunt u bij dit rapport niet de hele takenlijst laten rapporteren. U kunt alleen rapporteren op de huidige taak en subtaken.

Als u het geschiedenisrapport kiest, vraagt KArm u eerst om het datumbereik voor het rapport in te voeren.

---

---

Na het invoeren van een datumbereik opent u KEdit of een andere editor en plakt u daar de rapportdata.

De taakgeschiedenis wordt opgeteld voor elke dag en taak, gegroepeerd per week. De eerste zeven kolommen zijn maandag tot en met zondag. De achtste kolom is het weektotaal en de negende kolom is de taaknaam. De taaknamen worden ingesprongen om de taak-/subtaak-relaties aan te geven.

KArm gebruikt net als KOrganizer en Apple's iCal de industriestandaard iCalendar als formaat voor gegevens. KArm kan takenlijsten van deze twee toepassingen lezen en schrijven.

Als een typisch voorbeeld wilt u wellicht een project plannen met het projectbeheergereedschap Imendio Planner (van planner.imendio.org) en de taken daaruit importeren in KArm, om ze in het industrie-standaardformaat iCalendar te hebben. Als u dat gedaan hebt, kunt u de taken in KOrganizer inroosteren en de tijd die u aan de taken besteed hebt in KArm bijhouden. Dat is één manier om ervoor te zorgen dat uw project op tijd en binnen het budget afkomt.

DCOP is het mechanisme waarmee KDE-programma's met elkaar communiceren. Een KDE-programma biedt een lijst van functies (zoals een Bash-script) die andere programma's kunnen gebruiken.

DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                VERS=`dcop $DCOPID KarmDCOPIface version`
                echo "KArm versie is $VERS"
        else
                echo "KArm niet actief"
        fi

KArm's huidige DCOP-interface wordt momenteel vooral gebruikt voor geautomatiseerd testen en is dus erg beperkt. Zie voor de volledige interfacedefinitie DCOP-interface appendix.

Om de volledige DCOP-interface te zien van de KArm-versie die op uw systeem staat, voert u het volgende Bash-script uit:

DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                dcop $DCOPID KarmDCOPIface
        else
                echo "KArm niet actief"
        fi

KArm kan zowel totalen als geschiedenis naar een komma-gescheiden bestand exporteren. Om totalen te exporteren, kiest u het menu Bestand->Importeren/Exporteren->Exporteren naar CSV-bestand... en KArm toont het volgende dialoogvenster:

---

---

Voer de bestandsnaam in waarnaar u de data wilt exporteren, en wijzig de andere instellingen indien nodig. Merk op dat het datumbereik niet ingesteld kan worden aangezien u de totalen exporteert, niet de geschiedenis. Klik op de knop Exporteren en KArm exporteert de totalen voor alle taken naar het gekozen bestand.

Hier is een voorbeeld van het uitvoerformaat:

Topniveau-taken staan in de eerste kolom, subtaken in de tweede, en zo door. De tijdsgegevens worden vermeld na de maximale taakdiepte (vijf in dit voorbeeld). De eerste tijdkolom is Sessietijd, de tweede Tijd, de derde Totale sessietijd en de vierde de Totale tijd.

Om de taakgeschiedenis te exporteren, kiest u het menu Bestand->Importeren/exporteren->Geschiedenis naar CSV-bestand exporteren... en KArm toont hetzelfde dialoogvenster als hierboven.

Voer de bestandsnaam in waarnaar u de data wilt exporteren, en kies een datumbereik waarvan u de taakgeschiedenis wilt. Wijzig de andere instellingen indien nodig. Klik op de knop Exporteren en KArm exporteert de taakgeschiedenis voor alle taken naar het gekozen bestand.

Hier is een voorbeeld van het uitvoerformaat:

De eerste drie regels geven aan wanneer het rapport gegenereerd is en voor welk datumbereik. De vierde regel is een komma-gescheiden lijst met de datums in het bereik in ISO 8601 formaat (jjjj-mm-dd). Alle volgende rijen geven de tijd weer die per taak gelogd is. De laatste numerieke kolom is het rijtotaal over alle dagen. De taaknaam wordt afgedrukt na de totaalkolom en is ingesprongen om taak-/subtaakrelaties aan te geven. Namen van topniveau taken verschijnen in de eerste kolom na het totaal.