KArmi käsiraamat

Ülesande sidumiseks ühe või enama töölauaga vali menüükäsk Ülesanne->Muuda (Ctrl+E). Lülita sisse Automaatne jälgimine ning vali töölaud/töölauad, mille soovid ülesandega siduda. Kui mõni valitud töölaudadest nüüd aktiivseks muutub, alustab KArm väikese viivitusega automaatselt antud ülesande ajaarvestust.

KArmi saab panna tuvastama, kas hiir ja klaviatuur on rakkes või mitte. Kui hiir ja klaviatuur on olnud jõude enam kui määartud arv minuteid, näitab KArm järgmist dialoogi:

---

---

Printerisse saadetava koguajaaruande loomiseks vali menüükäsk Fail->Trüki (Ctrl+P). See loob kõigi ülesannete kohta kolmeveerulise aruande. Esimeses veerus seisab ülesande nimi, teine veerg on seansi koguaeg ja kolmas koguaeg.

Lõikepuhvrisse saadetava koguajaaruande loomiseks vali menüükäsk Fail->Kopeeri kogusumma lõikepuhvrisse (Ctrl+C).

Aruanne luuakse parajasti valitud ülesande ja kõigi selle alamülesannete kohta. Kui valitud on tipptaseme ülesanne, pärib KArm, kas soovid luua aruande antud ülesande ja selle alamülesannete või kogu ülesannete nimekirja kohta.

---

---

Kui aruanne on loodud, ava KEdit või mõni muu tekstiredaktor ja aseta sinna aruande andmed.

Esimene veerg on koguaeg ning siin on kasutatud ülesannete nimede puhul treppimist, mis osutab ülesannete ja nende alamülesannete seostele. Aja hulka arvestatakse ka alamülesannete aeg.

Lõikepuhvrisse saadetava koguaruande loomiseks vali menüükäsk Fail->Kopeeri ajalugu lõikepuhvrisse (Ctrl+Alt+C).

Aruanne luuakse parajasti valitud ülesande ja kõigi selle alamülesannete kohta. Võimalik on valida ka aruande koostamine kõigi ülesannete kohta.

Kui valid ajalooaruande loomise võimaluse, palub KArm sul kõigepealt määrata kindlaks aruandesse kaasatav ajavahemik:

---

---

Pärast ajavahemiku sisestamist luuakse aruanne ning sa võid avada KEditi või mõne muu tekstiredaktori ja aruande andmed sinna asetada.

Ülesande ajalugu näitab kogusummat iga päeva ja iga ülesande kohta nädala kaupa. Esimesed seitse tulpa on nädalapäevad esmaspäevast pühapäevani. Kaheksandas veerus on nädala kogusumma ning üheksandas ülesande nimi. Ülesannete nimed on trepitud, mis osutab ülesannete ja nende alamülesannete seosele.

KArm kasutab sarnaselt KOganizeri ja Apple'i iCaliga oma andmete puhul üldlevinud standardit iCalendar. KArm võib nii avada kui salvestada nende kahe rakenduse loodud ülesannete nimekirju.

Üsna tüüpiline on ka projekti planeerimine projektihalduri Imendio Planneriga (vaata planner.imendio.org) ning selle ülesannete importimine KArmi, et need oleksid standardses iCalendari vormingus. Sellisel juhul saab ajastada oma ülesandeid KOrganizeris ning arvestada neile kuluvat aega KArmiga. Nii on võimalik kontrollida, kas projekt püsib ikka ettenähtud eelarve ja aja piirides.

DCOP on mehhanism, millega KDE rakendused saavad üksteisega shelda. KDE rakendused pakuvad selleks välja teatud funktsioonid, mida teised programmid (näiteks bash'i skript) saavad ära kasutada.

DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                VERS=`dcop $DCOPID KarmDCOPIface version`
                echo "KArmi versioon on $VERS"
        else
                echo "KArm ei tööta"
        fi

KArmi praegune DCOP-liides on mõeldud peamiselt automaatseks testimiseks, mistõttu see on ka üpris piiratud. Liidese täieliku ülevaate annab DCOP-liidese lisa.

Kogu KArmi DCOP-liidese nägemiseks konsoolil käivita järgmine bash'i skript:

DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                dcop $DCOPID KarmDCOPIface
        else
                echo "KArm ei tööta"
        fi

KArm võib nii kogusumma kui ajaloo eksportida komadega eraldatud failivormingusse (CSV). Kogusumma eksportimiseks vali menüükäsk Fail->Import/eksport->Ekspordi CSV faili... ning KArm avab järgmise dialoogi:

---

---

Määra fail, kuhu soovid andmed eksportida, ning muuda vajaduse korral ka muid etteantud väärtusi. Pane tähele, et ajavahemikku ei saa siin muuta, sest tegemist on ju aja kogusumma, mitte ajalooandmete eksportimisega. Klõpsa nupule Eksport ning KArm salvestabki kõigi ülesannete koguaja sinu valitud faili.

Toome siin näite väljundi vormindusest:

Tipptaseme ülesanded on esimeses veerus, alamülesanded teises ja nii edasi. Ajaandmed salvestatakse ülesande maksimaalse sügavuse järel (antud juhul viis). Esimeses veerus on seansi aeg, teises aeg, kolmandas seansi koguaeg ja neljandas koguaeg.

Ajaloo eksportimiseks vali menüükäsk Fail->Import/eksport->Ekspordi ajalugu CSV faili... ning KArm avab eespool näidatud eksportimisdialoogi.

Määra fail, kuhu soovid andmed eksportida, ja vali vajalik ajavahemik. Vajaduse korral võid muuta ka muid etteantud väärtusi. Klõpsa nupule Eksport ning KArm salvestabki kõigi ülesannete ajaloo sinu valitud faili.

Toome siin näite väljundi vormindusest:

Kolm rida näitavad, millal aruanne on loodud ja millist ajavahemikku see hõlmab. Neljandas reas on komadega eraldatud ajavahemikku kaasatud kuupäevade loetelu ISO-8601 vormingus (YYYY-MM-DD). Ülejäänud ridades on kirjas ülesannetele kulutatud aeg. Viimane numbriveerg kujutab endast rea kõigi päevade kogusummat. Ülesande nimi seisab pärast kogusumma veergu ning nimed on trepitud, et näidata ülesande ja selle alamülesannete seoseid. Tipptaseme ülesannete nimed seisavad esimeses veerus pärast kogusummat.