Het handboek van KTimetracker

# Het handboek van KTimetracker

Jonathan Singer `<jsinger@leeta.net>`

Mark Bucciarelli `<mark@hubcapconsulting.com>`

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

Nalezer: Lauri Watts
Vertaler/Nalezer: Tom Albers
Vertaler/Nalezer: Alexander S. Koning
Vertaler/Nalezer: Natalie Koning
herziening 5.0 (2019-11-19)

Copyright © 2000-2004 Jonathan Singer

Copyright © 2004-2005 Mark Bucciarelli

Juridische kennisgeving

KTimetracker houdt de tijd bij die besteed wordt aan verschillende taken.

Lijst van voorbeelden

2.1. Bash-script dat de versie van KTimetracker weergeeft
2.2. KTimetracker's D-Bus-interface op het scherm weergeven

Hoofdstuk 1. Inleiding
Inleiding

# Hoofdstuk 1. Inleiding

KTimetracker houdt de tijd bij die besteed wordt aan verschillende taken. Het kan gebruikt worden om de tijd bij te houden van taken die bijvoorbeeld aan klanten gefactureerd moet worden, de tijd kan per taak en per dag gerapporteerd worden.

Deze tijdsgeschiedenis kan naar een komma-gescheiden tekstbestand geëxporteerd worden om dit in andere facturerings- of projectbeheer-hulpmiddelen te importeren.

KTimetracker detecteert wanneer uw toetsenbord en muis ongebruikt zijn en kan verschillende taken aan diverse bureaubladen koppelen, twee hulpmiddelen die kunnen helpen bij het correct bijhouden van de taken.

KTimetracker is oorspronkelijk geschreven door Sirtaj Singh Kang. Zijn homepagina is https://userbase.kde.org/KTimeTracker.

Hoofdstuk 2. KTimetracker gebruiken
KTimetracker gebruiken

# Hoofdstuk 2. KTimetracker gebruiken

## KTimetracker starten

Typ ktimetracker in op de commandoregel of kies Tijdsregistratie uit de groep Applicaties Hulpmiddelen van het Plasma starter van toepassingen. De generieke Qt™ en KDE-frameworks; 5 opdrachtparameters zijn beschikbaar, zie man-pagina's qt5options en kf5options.

KTimetracker biedt een additionele opdrachtoptie waarmee u de naam van het iCalendar-bestand kunt opgeven dat gebruikt wordt om uw werkgeschiedenis in op te slaan. U kunt een extern iCalendar-bestand opgeven door HTTP of FTP als deel van de bestandsnaam te gebruiken, bijvoorbeeld https://www.mijnsite.com/mijndata/mijnwerk.ics

Taken
Taken

## Taken

Probleem: U bent een freelance software-consultant met veel klanten. Sommige klanten hebben meerdere projecten. Gedurende een dag schakelt u heen en weer tussen de verschillende projecten. U moet uw tijd bijhouden om maandelijkse rekeningen te kunnen maken.

Oplossing: Maak een topniveau-taak voor elke klant en een subtaak voor elk project. Voor projecten die gedetailleerder bijgehouden moeten worden, maakt u een lijst van project-subtaken. U houdt de tijd bij door te dubbelklikken op de taak waar u op het moment aan werkt.

KTimetracker biedt grote flexibiliteit in het bijhouden van uw tijd door een ongelimiteerd aantal taken en taakniveaus. Tijd kan bij elke taak worden bijgehouden en er kunnen meerdere taken tegelijkertijd actief zijn.

KTimetracker stelt u in staat de geschiedenis van uw taken te bewerken en een toelichting te zetten bij elke gebeurtenis die u hebt gestopt.

Om een topniveau-taak aan te maken kiest u Taak → Nieuwe taak... (Ctrl+T). Om een subtaak aan te maken activeert u de bovenliggende taak en kiest u Taak → Nieuwe subtaak... (Ctrl+B).

Als u KTimetracker afsluit wordt de takenlijst opgeslagen in een bestand op uw schijf. Bij de volgende start wordt de takenlijst uit hetzelfde bestand geladen.

KTimetracker kan taken importeren en exporteren om uw werk te minimaliseren. Zie de paragraaf met de naam “Andere systemen”.

Timers
Timers

## Timers

Probleem: Om al uw uitgaven te kunnen doen moet u een gemiddelde van vijf uur per dag factureren. Om ervoor te zorgen dat u dit haalt, houdt u uw dag- en weektotalen in de gaten.

Oplossing: Reset de sessie-timer aan het begin van elke werkdag en reset alle timers aan het begin van elke week.

KTimetracker maakt het bijhouden van tijd eenvoudig. Om de tijd die aan een taak besteed wordt bij te houden dubbelklikt u op de taak. Om het bijhouden te stoppen, dubbelklikt u opnieuw op de taak. Actieve taken worden aangegeven door een klokje in de kolom Sessietijd.

Een andere visuele aanwijzing van activiteit is het systeemvakpictogram van KTimetracker. Als er een taak actief is, beweegt de secondewijzer in het pictogram. Als u de muiswijzer op dit pictogram laat rusten, wordt de naam van de actieve taak in een hulpballon weergegeven. Als er meer dan één taak actief is, worden de taaknamen in de hulpballon gescheiden door komma's.

KTimetracker houdt twee timers bij voor elke taak: één voor de sessietijd en één voor de totale tijd. In de standaardinstelling geeft KTimetracker twee kolommen voor elke timer weer, hetgeen op vier kolommen voor elke taak uitkomt:

Sessietijd

  De tijd die aan de taak is besteed sinds het begin van de sessie.

Tijd

  De tijd die aan de taak is besteed sinds alle tijden gereset zijn.

Totale sessietijd

  De tijd die aan de taak en alle subtaken ervan besteed is sinds het begin van de sessie.

Totale tijd

  De tijd die aan de taak en alle subtaken ervan is besteed sinds alle tijden gereset zijn.

Om een nieuwe sessie te starten, kiest u het menu Bestand → Nieuwe sessie starten.

Om alle tijden te resetten, kiest u het menu Bestand → Alle tijden resetten.

### Bureaubladen volgen

Probleem: U hebt twee hoofdprojecten waartussen u elke dag heen en weer schakelt. Om uw werk te organiseren houdt u de bestanden van project 1 op bureaublad 1 en die van project 2 op bureaublad 2.

Oplossing: Verbind de taak van project 1 met bureaublad 1 en de taak van project 2 met bureaublad 2. Als u van bureaublad 2 naar bureaublad 1 overschakelt, stopt KTimetracker automatisch de taak van project 2 en start de taak van project 1.

Om een taak met één of meer bureaubladen te verbinden, kiest u het menu Taak → Eigenschappen (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 KTimetracker na korte tijd automatisch de tijd voor die taak bij te houden.

### Inactiviteitsdetectie

Probleem: U gaat vroeg van uw werk weg op vrijdag om een bericht te bezorgen en vergeet de timer stop te zetten. Als u terugkomt op maandag loopt de timer nog steeds.

Oplossing: Schakel inactiviteitsdetectie in op de pagina Gedrag van de instellingendialoog.

KTimetracker 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 KTimetracker het volgende dialoogvenster:

Tijdsmeting voortzetten

  Pas de inactieve tijd toe op alle actieve timers en laat ze lopen.

  U was aan de taken aan het werk toen uw computer inactief was en bent nog steeds aan het werk.

Tijdsmeting terugdraaien

  Trek de hoeveelheid inactieve tijd van alle actieve timers af en stop de timers.

  U was niet aan de taken aan het werken toen uw computer inactief was en u bent nog steeds niet aan het werk.

Andere systemen
Andere systemen

## Andere systemen

### KOrganizer

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

U kunt zelfs synchroon op één bestand werken met KOrganizer en KTimetracker. Als een programma het bestand wijzigt, dan worden die automatisch doorgestuurd naar de andere toepassing.

### Planner

Als een typisch voorbeeld wilt u wellicht een project plannen met het projectbeheergereedschap Imendio Planner (van Planner) en de taken daaruit importeren in KTimetracker met Bestand → Importeren → Taken van planner importeren..., 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 KTimetracker bijhouden. Dat is één manier om ervoor te zorgen dat uw project op tijd en binnen het budget afkomt.

### D-Bus

KTimetracker ondersteunt vele methoden die gebruikt kunnen worden met D-Bus.

Er zijn twee manieren om het D-Bus-interface te gebruiken: Qt™'s GUI qdbusviewer en de commandoregel qdbus.

Voorbeeld 2.1. Bash-script dat de versie van KTimetracker weergeeft

    qdbus org.kde.ktimetracker /KTimeTracker version 2
    >/dev/null || echo "ktimetracker not running"

KTimetracker's huidige D-Bus-interface wordt momenteel vooral gebruikt voor geautomatiseerd testen en is dus erg beperkt. Zie voor de volledige interfacedefinitie Bijlage A, D-Bus-interface.

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

Voorbeeld 2.2. KTimetracker's D-Bus-interface op het scherm weergeven

    qdbus org.kde.ktimetracker /KTimeTracker 2
    >/dev/null || echo "ktimetracker not running"

### Totalen exporteren naar CSV

KTimetracker kan zowel totalen als geschiedenis naar een komma-gescheiden bestand exporteren. Om totalen te exporteren, kiest u het menu Bestand → Exporteren... → Tijden exporteren... en KTimetracker toont de exportdialoog.

Selecteer de optie Tijden als CSV in groep Type rapport. De dialoog zal er als volgt uitzien:

Wijzig de standaarden van de dialoog indien nodig. U kunt de CSV-uitvoer bekijken aan de rechterkant van de dialoog. Klik op Opslaan als... en KTimetracker exporteert de totalen voor alle taken naar het ingevoerde bestand.

Gebruik de knop Naar klembord kopiëren om de tijden naar het klembord te exporteren.

Hier is nog een voorbeeld van het uitvoerformaat:

`
"kde",,,,,0.00,0.00,6.88,9.83
,"ktimetracker",,,,6.88,8.70,6.88,9.83
,,"3.2 plan",,,0.00,0.00,0.00,0.00
,,"bugs",,,0.00,1.13,0.00,1.13
,,"wijzigingen - vertalingen",,,0.00,0.00,0.00,0.00
,,"tijdrapport",,,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-dingen",,,,0.00,0.00,0.00,0.00
`

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.

### Geschiedenis naar CSV exporteren

Om de taakgeschiedenis te exporteren, kiest u Bestand → Exporteren → Exporteren... en KTimetracker toont hetzelfde dialoogvenster als hierboven. Selecteer optie Geschiedenis als CSV in groep Type rapport.

Selecteer een datumreeks waarvan u wilt dat de takengeschiedenis wordt gedekt. Wijzig de standaarden van de dialoog indien nodig. U kunt de CSV-uitvoer bekijken aan de rechterkant van de dialoog. Klik op Opslaan als... en KTimetracker exporteert de totalen voor alle taken naar het ingevoerde bestand.

Gebruik de knop Naar klembord kopiëren om de tijden naar het klembord te exporteren.

Hier is een voorbeeld van het uitvoerformaat:

`
Taakgeschiedenis
Van dinsdag 06 juli 2004 tot dinsdag 13 juli 2004
Afgedrukt op: 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 plan"
,1.13,,,,,,,1.13,,,"bugs"
,,,,,,,,0.00,,,"wijzigingen - vertalingen"
,,,,,,,,0.00,,,"tijdrapportt"
,,,,,,,,0.00,,"kopete"
,,,,,,,,0.00,,"promo"
,,,,,,,,0.00,,"web-dingen"
`

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.

Hoofdstuk 3. Het uiterlijk van KTimetracker
Het uiterlijk van KTimetracker

# Hoofdstuk 3. Het uiterlijk van KTimetracker

Het hoofdvenster van KTimetracker bestaat uit de volgende onderdelen: menubalk, werkbalk, zoekbalk, taak- en tijdvak en een statusbalk.

De zoekbalk is een gecombineerd veld. Zolang u Enter niet indrukt zal het veld zich als een filter gedragen. Alleen de taken die met uw invoer overeen komen worden dan getoond. Zodra u op Enter hebt gedrukt zal uw invoer als naam voor een nieuwe taak worden beschouwd.

Kies Instellingen voor PDA in de pagina Uiterlijk van de instellingendialoog bij gebruik van een aanraakscherm met beperkte afmetingen. Het schakelt de zoekbalk uit en elke klik laat een contextmenu verschijnen.

## Het taak- en tijdvak

De verschillende taken worden in dit vak weergegeven, tezamen met de tijd die aan deze taak is besteed. Zowel de tijd van de sessie als de totaal besteedde tijd. Taken die op dit moment bijgehouden worden hebben een klokje bij de sessietijd staan.

Voor iedere taak kunnen er subtaken gecreërd worden. Door het plus- en minteken voor de hoofdtaak kan de weergave van de subtaken aan- en uitgezet worden. De totale tijd van een hoofdtaak is de tijd van de taak zelf tezamen met de tijden van de subtaken.

De werkbalk en statusbalk
De werkbalk en statusbalk

## De werkbalk en statusbalk

De werkbalk bevat pictogrammen voor de volgende acties:

### Opmerking

De functionaliteit is overigens identiek aan de opties uit het menu.

- Nieuwe taak

- Nieuwe subtaak

- Starten

- Stoppen

- Verwijderen

- Bewerken

- Openen

- Opslaan

De statusbalk rapporteert de naam van het bestand waarin de gegevens zijn opgeslagen.

Hoofdstuk 4. Dankbetuigingen en licentie
Dankbetuigingen en licentie

# Hoofdstuk 4. Dankbetuigingen en licentie

KTimetracker

Programma copyright:

- 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)`

- 2004-2011 Thorsten Stärk `(dev AT staerk.de)`

- 2019 Alexander Potashev `(aspotashev AT gmail.com)`

Bijdragen door (in alfabetische volgorde)

- Alexander Potashev `(aspotashev AT gmail.com)`

- 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)`

De auteur van KTimetracker is geinspireerd door de toepassing titrax van Harald Tveit Alvestrand. Het nadeel van die toepassing is echter dat het gebaseerd is op de Xt-toolkit.

Documentatie copyright 2000-2004 Jonathan Singer `(jsinger AT leeta.net)` en Sirtaj Singh Kang `(taj AT kde.org)`.

Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op http://www.kde.nl/bugs.

Dit document is vertaald in het Nederlands door Tom Albers.

Dit document is vertaald in het Nederlands door Alexander S. Koning.

Dit document is vertaald in het Nederlands door Natalie Koning.

Dit document is vertaald in het Nederlands door Freek de Kruijf.

Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie.

Deze toepassing valt onder de bepalingen van de GNU General Public License.

Woordenlijst
Woordenlijst

# Woordenlijst

### A

actieve taak

  Een taak waarvan een timer loopt.

### D

D-Bus

  Een communicatieprotocol tussen processen. Afkorting van Desktop Bus.

bureaublad

  GNU/Linux®, FreeBSD en andere systemen die X.org Server draaien hebben meerdere bureaubladen. U hebt normaal gesproken vier verschillende bureaubladen. Elk bureaublad kan een eigen verzameling programma's en bestanden weergeven. Als KDE Plasma opstart ziet u bureaublad 1. Als u Ctrl+F2 drukt, ziet u bureaublad 2. Met Ctrl+F1 brengt u bureaublad 1 terug.

### H

geschiedenis

  Als KTimetracker ingesteld is om geschiedenis bij te houden, wordt elke start- of stopgebeurtenis onthouden. Deze geschiedenis wordt niet gewist als de tijden worden gereset en wordt onthouden totdat de taak wordt verwijderd.

### S

sessie

  Een gebruikergedefinieerd beginpunt voor de sessietimers. Een nieuwe sessie begint als u het menu Bestand → Nieuwe sessie starten kiest. Sessiegegevens worden niet opgeslagen als u een nieuwe sessie start.

Sessietijd

  De tijd die aan de taak is besteed sinds het begin van de sessie.

systeemvak

  Het systeemvak bevindt zich in de balk die (standaard in KDE Plasma) onderaan uw scherm verschijnt. In dit systeemvak bevindt het KTimetracker-pictogram zich uiterst rechts.

### T

topniveau-taak

  Een taak zonder bovenliggende taken.

Totale sessietijd

  De tijd die aan de taak en alle subtaken ervan besteed is sinds het begin van de sessie.

Tijd

  De tijd die aan de taak is besteed sinds alle tijden gereset zijn.

Totale tijd

  De tijd die aan de taak en alle subtaken ervan is besteed sinds alle tijden gereset zijn.

Bijlage A. D-Bus-interface
D-Bus-interface

# Bijlage A. D-Bus-interface

version
version

## Name

version — Retourneer de versie van KTimetracker

## Samenvatting

    QString version()

## Beschrijving

`version()` is een D-Bus-aanroep die KTimetracker's versienummer retourneert; bijvoorbeeld 4.3.1. Het versienummer wordt geretourneerd als een tekenreeks in het standaard GNU-formaat hoofdversie.subversie.bugfix.

quit
quit

## Name

quit — KTimetracker afsluiten.

## Samenvatting

    QString quit()

## Beschrijving

`quit()` is een D-Bus-aanroep die een manier biedt waarmee een extern programma KTimetracker beschaafd kan afsluiten.

addTask
addTask

## Name

addTask — Nieuwe taak toevoegen.

## Samenvatting

    QString addTask(QString taskname)

### Parameters

`taskname`

  De naam van de nieuwe taak.

## Beschrijving

`addTask(QString taaknaam)` is een D-Bus-aanroep die een nieuwe topniveau-taak aan het huidige bestand toevoegt. De UID van de nieuwe taak wordt geretourneerd.