# &ktimetracker; Priročnik

## Uvod

&ktimetracker; spremlja čas, porabljen za različna opravila. Uporaben je za sledenje plačljivim uram in lahko poroča o zabeleženih urah glede na opravilo in dan.

To časovno zgodovino je mogoče izvoziti v besedilno datoteko, ločeno z vejicami, za uvoz v druga orodja za obračunavanje in/ali upravljanje projektov.

&ktimetracker; zazna, kdaj sta tipkovnica in miška nedejavni in lahko poveže različna opravila z različnimi namizji, dve orodji, ki lahko pomagata, da časovnik deluje pri pravilnem opravilu.

&ktimetracker; je prvotno napisal &Sirtaj.Singh.Kang;. Njegova domača stran je https://userbase.kde.org/KTimeTracker.

## Uporaba &ktimetracker;

### Zagon &ktimetracker;

Vnesite `ktimetracker` v ukazni poziv ali izberite Osebni sledilnik časa v Aplikacije Pripomočki skupino v Zaganjalnik aplikacij Plasma. Generični &Qt; in &kf5-full; na voljo so ukazne možnosti, glejte priročnik strani qt5options in kf5options.

&ktimetracker; ponuja dodatno ukazno možnost, ki vam omogoča vnos imena datoteke iCalendar, ki se uporablja za shranjevanje vaše zgodovine dela. Oddaljeno datoteko iCalendar vnesete z &HTTP; ali &FTP; kot del imena datoteke; na primer https://www.mysite.com/mydata/mylabor.ics.

### Opravila

Težava: Ste samostojni svetovalec za programsko opremo s številnimi strankami. Nekatere stranke imajo več projektov. Tekom dneva preklapljate med različnimi projekti. Za ustvarjanje mesečnih računov morate spremljati svoj čas.

Rešitev: Ustvarite eno opravilo najvišje ravni za vsako stranko in podopravilo za vsak projekt stranke. Za projekte, ki zahtevajo podrobnejše sledenje, ustvarite seznam projektnih podopravil. Sledite času tako, da dvokliknete opravilo, ki ga trenutno opravljate.

&ktimetracker; zagotavlja veliko prilagodljivost pri sledenju vašemu času, kar omogoča neomejene naloge in globino nalog. Čas se lahko zabeleži za katero koli opravilo in v danem trenutku je lahko aktivnih več kot eno opravilo.

&ktimetracker; omogoča urejanje zgodovine vašega opravila in dodajanje komentarja za vsak dogodek, ki ste ga ustavili.

Če želite ustvariti opravilo na najvišji ravni, izberite &Ctrl;T Naloga Novo opravilo... . Če želite ustvariti podopravilo, označite nadrejeno opravilo in izberite &Ctrl;B Task Novo podopravilo... .

Ko &ktimetracker; zapusti, se seznam opravil shrani v datoteko na vašem disku. Ko se naslednjič odpre, znova naloži seznam opravil iz iste datoteke.

&ktimetracker; lahko uvozi in izvozi naloge, da zmanjša vaše delo. Glejte interfaces.

### Časovniki

Težava: Če želite ostati plačilno sposobni, morate zaračunavati povprečno po pet ur na dan. Če želite ostati, opazujte svoje dnevne in tedenske skupne vrednosti.

Rešitev: Ponastavite časovnik seje na začetku vsakega delovnega dne in ponastavite vse časovnike na začetku vsakega tedna.

&ktimetracker; omogoča enostavno sledenje času. Če želite začeti beležiti čas za opravilo, dvokliknite opravilo. Če želite ustaviti beleženje časa, znova dvokliknite opravilo. Aktivna opravila prikazujejo majhno uro v stolpcu Čas seje.

Drug vizualni namig o dejavnosti beleženja je &ktimetracker; ikona sistemske vrstice. Ko je opravilo aktivno, se sekundni kazalec v ikoni premakne. Če miškin kazalec postavite nad to ikono, se bo v opisu orodja prikazalo ime aktivnega opravila. Če je aktivnih več kot eno opravilo, so imena opravil v opisu orodja ločena z vejicami.

&ktimetracker; vzdržuje dva časovnika za vsako opravilo: enega za čas seje in enega za skupni čas. V privzeti konfiguraciji &ktimetracker; prikaže dva stolpca za vsak časovnik, kar pomeni skupno štiri stolpce za vsako opravilo:

Čas seje

- Čas, porabljen za opravilo od začetka seje.

Čas

- Čas, porabljen za opravilo od ponastavitve vseh časov.

Skupni čas seje

- Čas, porabljen za opravilo in vse njegove podnaloge od začetka seje.

Skupni čas

- Čas, porabljen za opravilo in vse njegove podopravila, odkar so bili vsi časi ponastavljeni.

Za začetek nove seje izberite Datoteka Začni novo sejo

Če želite ponastaviti vse čase, izberite Datoteka Ponastavi vse čase

#### Sledenje namizju

Težava: Imate dva glavna projekta, med katerima vsak dan preklapljate. Za lažje organiziranje dela hranite datoteke projekta 1 na namizju 1 in datoteke projekta 2 na namizju 2.

Rešitev: Povežite opravilo projekta 1 z namizjem 1 in opravilo projekta 2 z namizjem 2. Ko preklopite iz namizja 2 na namizje 1, &ktimetracker; samodejno ustavi nalogo projekta 2 in zažene nalogo projekta 1.

Če želite nalogo povezati z enim ali več namizji, izberite &Ctrl;E Opravilo Lastnosti . Vklopite Samodejno sledenje in izberite namizje ali namizja, ki jih želite povezati s to nalogo. Ko postane katero od izbranih namizij aktivno, po kratkem zamiku &ktimetracker; bo samodejno začel beležiti čas za to opravilo.

#### Zaznavanje nedejavnosti

Težava: V petek zgodaj odidete iz službe po opravku in pozabite ustaviti časovnik. Ko se vrnete v ponedeljek, časovnik še teče.

Rešitev: Vklopite zaznavanje nedejavnosti na strani Vedenje pogovornega okna z nastavitvami.

&ktimetracker; lahko konfigurirate tako, da zazna, ko miška in tipkovnica postaneta nedejavni. Če sta miška in tipkovnica nedejavni dlje od podanega števila minut, &ktimetracker; prikaže naslednje pogovorno okno:

&ktimetracker; Zaznavanje nedejavnosti &ktimetracker; Pogovorno okno za zaznavanje nedejavnosti

Nadaljujte z merjenjem časa

- Uporabi čas nedejavnosti za vse aktivne časovnike in pusti, da tečejo.

  Delali ste na nalogah, medtem ko je bil vaš računalnik v mirovanju in še vedno ste.

Povrni čas

- Od vseh aktivnih časovnikov odštejte čas nedejavnosti in jih zaustavite.

  Niste delali na nalogah, medtem ko je bil vaš računalnik nedejaven, in še vedno ne delate.

### Drugi sistemi

#### &korganizer;

&ktimetracker;, kot &korganizer; in Applov iCal, za svoje podatke uporablja industrijsko standardno obliko iCalendar. &ktimetracker; lahko bere in piše sezname opravil, ki jih ustvarita ti dve aplikaciji.

Lahko celo sinhrono delate na eni datoteki z &korganizer; in &ktimetracker;. Če en program spremeni datoteko, se posodobitve samodejno prenesejo v drugo aplikacijo.

#### Planer

Kot tipičen primer uporabe bi morda želeli načrtovati projekt z orodjem za upravljanje projektov &Planner; in uvoziti njegove naloge v &ktimetracker; z Datoteka Uvoz Uvozi opravila iz načrtovalnika... , da so v industrijskem standardu iCalendar. Ko to storite, lahko načrtujete naloge v &korganizer; in svoj čas zanje upoštevate v &ktimetracker;. To je eden od načinov, kako zagotoviti, da bo vaš projekt potekal pravočasno in v okviru proračuna.

#### &DBus;

&ktimetracker; podpira številne metode, ki jih je mogoče uporabiti z &DBus;.

Obstajata dva načina za uporabo &DBus; vmesnik: &Qt;'s &GUI; qdbusviewer in ukazna vrstica qdbus.

##### Bash skript, ki vrne različico &ktimetracker;

    qdbus org.kde.ktimetracker /KTimeTracker različica 2
    >/dev/null || echo "ktimetracker ne teče"

trenutni &DBus; &ktimetracker; vmesnik se trenutno uporablja predvsem za avtomatsko testiranje, zato je zelo omejen. Za celotno definicijo vmesnika glejte dbusappendix.

Za ogled celotnega &DBus; vmesnik programa &ktimetracker; različico, nameščeno v vašem sistemu, zaženite naslednji skript Bash:

##### Seznam &DBus; &ktimetracker; vmesnik do konzole

    qdbus org.kde.ktimetracker /KTimeTracker 2
    >/dev/null || echo "ktimetracker ne teče"

#### Izvozi skupne vrednosti v CSV

&ktimetracker; lahko izvozi vsote in zgodovino v obliko datoteke ločeno z vejicami. Če želite izvoziti vsote, izberite Datoteka Izvozi... in &ktimetracker; prikaže pogovorno okno za izvoz.

Izberite možnost Časi kot CSV v skupini Vrsta poročila. Pogovorno okno bo videti takole:

Izvozi čase kot CSV Izvozi čase kot CSV

Po potrebi spremenite privzete nastavitve pogovornega okna. Izpis CSV si lahko ogledate na desni strani pogovornega okna. Kliknite Shrani kot... in &ktimetracker; izvozi vsote za vsa opravila v datoteko, ki jo vnesete v pogovorno okno datoteke.

Za izvoz časov v odložišče uporabite gumb Kopiraj v odložišče.

Tukaj je še en primer izhodnega formata:

    "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

Opravila najvišje ravni so izpisane v prvem stolpcu, podopravila v drugem itd. Časovni podatki se izpišejo po največji globini opravila (pet v tem primeru). Prvi časovni stolpec je Čas seje, drugi Čas, tretji Skupni čas seje in četrti Skupni čas .

#### Izvoz zgodovine v CSV

Za izvoz zgodovine opravil izberite Datoteka Izvoz Izvoz... in &ktimetracker; prikaže isto pogovorno okno za izvoz, kot je prikazano zgoraj. Izberite možnost Zgodovina kot CSV v skupini Vrsta poročila.

Izberite časovno obdobje, za katerega želite, da zajema zgodovina opravil. Po potrebi spremenite privzete nastavitve pogovornega okna. Izpis CSV si lahko ogledate na desni strani pogovornega okna. Kliknite Shrani kot... in &ktimetracker; izvozi vsote za vsa opravila v datoteko, ki jo vnesete v pogovorno okno datoteke.

Za izvoz časov v odložišče uporabite gumb Kopiraj v odložišče.

Tukaj je primer izhodnega formata:

    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"

Prve tri vrstice določajo, kdaj je bilo poročilo ustvarjeno in za katero časovno obdobje. Četrta vrstica je z vejicami ločen seznam datumov v časovnem obdobju v formatu ISO 8601 (LLLL-MM-DD). Vse naslednje vrstice navajajo čas, zabeležen za vsako nalogo. Zadnji številski stolpec je vsota vrstic za vse dni. Ime opravila je natisnjeno za stolpcem s skupnim zneskom in je zamaknjeno, da označuje razmerje opravilo/podopravilo. Imena opravil na najvišji ravni so prikazana v prvem stolpcu za skupno vsoto.

## &ktimetracker; vmesnik

Glavni &ktimetracker; ima naslednje komponente: menijsko vrstico, orodno vrstico, iskalno vrstico, opravilno/časovno okno in vrstico stanja.

Iskalna vrstica je kombinirano polje. Dokler ne pritisnete &Enter;, deluje kot filter. Nato so prikazana samo opravila, ki se ujemajo z vašim vnosom. Takoj ko pritisnete &Enter;, se vaš vnos uporabi kot ime za ustvarjanje novega opravila..

Izberite Konfiguracija za PDA na strani Videz v pogovornem oknu z nastavitvami, če imate zaslon na dotik in je površina vašega zaslona dragocena. Onemogočil bo iskalno vrstico in ob vsakem kliku se bo pojavil kontekstni meni.

&ktimetracker; Zaslon &ktimetracker; Zaslon

### Okno Opravila/Čas

V tem oknu so prikazane različna opravila, skupaj s časom, zbranim za vsako v trenutni seji in skupaj. Opravila, ki se časovno določajo, imajo poleg časa seje majhno ikono ure.

Za vsako opravilo je mogoče ustvariti podopravila. Če kliknete znak plus in znak minus pred glavnim opravilom, preklopite pogled povezanih podopravil. Skupni čas, zbran za opravilo, vključuje čase za njegova podopravila in lasten skupni čas.

### Orodna vrstica in vrstica stanja

Orodna vrstica vsebuje ikone za naslednje ukaze:

Vsi se obnašajo enako kot menijski ukaz.

- Novo opravilo

- Novo podopravilo

- Začetek

- Ustavi

- Izbriši

- Uredi

- Odpri

- Shrani

Vrstica stanja poroča o imenu datoteke, v katero so bili shranjeni podatki.

## Zasluge in licenca

&ktimetracker;

Avtorske pravice programa:

- 1997-2000 &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;

- 2001-2002 Tomas Pospisek tpo_deb@sourcepole.ch

- 2003-2004 Mark Bucciarelli mark@hubcapconsulting.com

- 2004-2011 Thorsten Stärk dev@staerk.de

- 2019 Aleksander Potašev aspotashev@gmail.com

Sodelujoči (po abecednem vrstnem redu)

- Aleksander Potašev aspotashev@gmail.com

- Allen Winter winter@kde.org

- &David.Faure; &David.Faure.mail;

- &Espen.Sand; espen@kde.org

- Gioele Barabucci gioele@gioelebarabucci.com

- Jan Schaumann jschauma@netmeister.org

- &Jesper.Pedersen; blackie@ifad.dk

- Kalle Dalheimer &Matthias.Kalle.Dalheimer.mail;

- Klarälvdalens Datakonsult AB

- Mark Bucciarelli mark@hubcapconsulting.com

- Thorsten Stärk dev@staerk.de

- Tomas Pospisek tpo_deb@sourcepole.ch

- Willi Richert w.richert@cox.net

&ktimetracker; je bil navdihnjen z zelo uporabnim pripomočkom Haralda Tveita Alvestranda, imenovanim titrax, katerega edina pomanjkljivost je, da temelji na orodju Xt.

Avtorske pravice za dokumentacijo 2000-2004 &Jonathan.Singer; &Jonathan.Singer.mail; in &Sirtaj.Singh.Kang; &Sirtaj.Singh.Kang.mail;.

Prevod: Matjaž Jeranmatjaz.jeran@amis.net

&underFDL; &underGPL;

## Glosar

## A

aktivno opravilo

Opravilo, pri katerem teče časovnik.

## D

&DBus;

Medprocesni komunikacijski protokol. Okrajšava za Desktop Bus.

namizje

&GNU;/&Linux;, FreeBSD in drugi sistemi, ki poganjajo X.Org Server, imajo več namizij. Običajno imate lahko privzeto nameščena štiri različna namizja. Vsako namizje lahko prikaže svoj niz programov in datotek. Ko &kde; &plasma; ko se prvič zažene, je namizje, ki ga vidite, Namizje 1. Če pritisnete &Ctrl;F2, boste videli Namizje 2. S pritiskom &Ctrl;F1 bo vrnil Namizje 1.

## H

zgodovina

Če &ktimetracker; je konfiguriran za beleženje zgodovine, bo zabeležil vsak dogodek časovnika za zagon/ustavitev. Ta zgodovina se ne izbriše, ko se časi ponastavijo, in ostane v datoteki, dokler opravilo ni izbrisano.

## S

seja

Uporabniško določena začetna točka za časovnike seje. Nova seja se začne, ko izberete Datoteka Začni novo sejo . Podatki o seji se ne shranijo, ko ustvarite novo sejo.

Čas seje

Čas, porabljen za opravilo od začetka seje.

sistemski pladenj

Sistemski pladenj je v vrstici, ki se (privzeto v &kde; &plasma;) prikaže na dnu zaslona. V tem sistemskem pladnju &ktimetracker; ikona je skrajno desno.

## T

opravilo na najvišji ravni

Opravilo brez nadrejenih opravil.

Skupni čas seje

Čas, porabljen za opravilo in vse njegove podnaloge od začetka seje.

Čas

Čas, porabljen za opravilo od ponastavitve vseh časov.

Skupni čas

Čas, porabljen za opravilo in vse njegove podopravila, odkar so bili vsi časi ponastavljeni.

## &DBus; Vmesnik

različica

različica

Vrni različico &ktimetracker;.

    Različica QString()

#### Opis

`version()` je &DBus; klic, ki vrne številko različice &ktimetracker; na primer 4.3.1. Številka različice je vrnjena kot niz v tipičnem &GNU; oblika major.minor.bugfix.

zapusti

zapusti

Končaj &ktimetracker;'.

    QString quit()

#### Opis

`quit()` je &DBus; klic, ki omogoča, da lahko zunanji program elegantno zaustavi &ktimetracker;.

addTask

addTask

Dodajte novo nalogo.

    QString addTask(QString ime opravila)

#### Parametri

`ime opravila`

- Ime novega opravila.

#### Opis

`addTask(QString taskname)` je &DBus; klic, ki trenutnemu pomnilniku doda novo opravilo na najvišji ravni. Vrne se UID novega opravila.

&documentation.index;