Urenregistratie voor Jira: zo houd je je uren bij per issue en per project

Waarom urenregistratie in Jira zo vaak misgaat

Bijna iedereen in een softwareteam kent het: het is vrijdagmiddag, de sprint loopt af en Jira wil weten waar je deze week je tijd aan hebt besteed. In veel organisaties is tijdschrijven geen formaliteit. Uren op issues bepalen wat er aan de klant wordt gefactureerd, hoe een fixed-price-project ervoor staat en of de schattingen voor de volgende sprint realistisch zijn.

Voor zzp’ers, freelancers en gedetacheerde developers speelt nog iets mee. Je schrijft je uren vaak twee keer: in de Jira van de klant, omdat het team daarop stuurt, en op een urenstaat of urenbriefje voor je eigen facturatie of voor het detacheringsbureau. Klopt het een niet met het ander, dan krijg je vragen over je factuur.

Het probleem is zelden onwil. Een werkdag bestaat uit tientallen contextwissels: een code review tussendoor, een vraag in Slack, een incident, een refinement. Aan het eind van de week weet niemand meer precies hoe lang dat allemaal duurde. Goede urenregistratie begint dus met een goede inrichting, en wordt pas echt betrouwbaar als je niet meer op je geheugen hoeft te vertrouwen.

Stap 1: tijdregistratie in Jira aanzetten

Kun je nergens tijd boeken op een issue, dan ligt dat bijna altijd aan de configuratie. Drie dingen moeten kloppen. De menunamen hieronder zijn de Engelse, omdat de meeste teams Jira in het Engels gebruiken.

1. Tijdregistratie staat aan. In Jira Cloud gaat een sitebeheerder naar Settings → Issues → Time tracking (in nieuwere Cloud-versies heten issues work items). In Jira Server en Data Center is het Administration → Issues → Time tracking. Hier stel je ook in hoeveel uur een dag is: standaard 8 uur per dag en 5 dagen per week. Werkt je organisatie met dagen van 7,5 of 9 uur, pas het dan aan, anders betekent 1d niet wat iedereen denkt.
2. Je mag tijd boeken. In het permission scheme van het project heet dat meestal Work on issues. Aparte permissies bepalen of je je eigen worklogs (of die van anderen) mag wijzigen en verwijderen.
3. Het veld Time tracking staat op de schermen. In company-managed projecten moet het veld op het scherm van het issuetype staan; in team-managed projecten zet je de functie aan in de projectinstellingen.

Stap 2: uren boeken op een issue

In Jira Cloud klik je in het issue op het veld Time tracking, of je kiest Log work in het menu met de drie puntjes. In Data Center is het More → Log work. Het venster vraagt om:

• Time spent — in de notatie van Jira: w, d, h en m. Dus 45m, 2h 15m of 1d.
• Date started — standaard is dat nu. Vul je op maandagochtend de vrijdag in, pas de datum dan aan, anders staan je uren op de verkeerde dag.
• Remaining estimate — laat Jira de resterende schatting automatisch verlagen, of vul zelf een nieuwe waarde in.
• Work description — de omschrijving. Die leest je projectleider, en soms je klant.

Wil je uren boeken vanuit je commits, dan kan dat met smart commits als je repository aan Jira is gekoppeld: git commit -m "CASE-1423 #time 1h 30m Token-refresh hersteld". Handig, maar alleen voor tijd die je echt in code doorbrengt; overleg en reviews vallen erbuiten.

Uren bijhouden per project en per klant

Jira registreert tijd per issue. Wil je weten hoeveel uur er naar een klant of project ging, dan hangt dat af van hoe je Jira hebt ingericht:

• Eén Jira-project per klant of opdracht. Het eenvoudigst: alle worklogs in project ACME zijn uren voor die klant.
• Epics, components of labels. Werk je in één groot project, groepeer dan op epic (bijvoorbeeld per deelproject) of op component. Zorg dat elk issue er een heeft, anders vallen uren buiten je overzicht.
• Accounts in Tempo. Teams die per klant of per budget factureren, gebruiken vaak de add-on Tempo Timesheets, waarmee je worklogs aan een account koppelt.

Voor je eigen overzicht is JQL je beste vriend. Deze zoekopdracht toont alle issues waarop jij deze week tijd hebt geboekt:

worklogAuthor = currentUser() AND worklogDate >= startOfWeek()

Een kanttekening: de kolom Time Spent in de zoekresultaten is de totale tijd op het issue, van alle collega’s en over de hele looptijd. Een nette urenstaat per persoon per week bouw je daarmee niet. Daarvoor heb je een rapport uit een add-on nodig, de worklog-API, of een tool die je uren per dag per taak bijhoudt en exporteert.

Van Jira-worklogs naar een urenstaat voor je klant of bureau

Gedetacheerde professionals en zzp’ers moeten hun uren vaak wekelijks of maandelijks laten aftekenen op een urenstaat. Een paar gewoontes maken dat een stuk makkelijker:

• Boek dagelijks, niet wekelijks. Vijf minuten aan het eind van de dag is nauwkeuriger dan een uur op vrijdag reconstrueren.
• Houd één bron van waarheid. Laat je urenstaat uit dezelfde gegevens komen als je Jira-worklogs, zodat er geen verschillen ontstaan tussen wat het team ziet en wat je factureert.
• Bewaar een eigen kopie. Na afloop van een opdracht wordt je account in de Jira van de klant meestal gedeactiveerd. Exporteer je uren per dag en per taak naar CSV, zodat je later nog kunt laten zien wat je hebt gedaan.
• Vergeet de niet-declarabele uren niet. Acquisitie, administratie en opleiding staan niet in de Jira van je klant. Wie als ondernemer gebruik wil maken van de zelfstandigenaftrek, moet aannemelijk kunnen maken dat hij aan het urencriterium voldoet (de Belastingdienst noemt minimaal 1.225 uur per jaar aan je onderneming). Daar tellen ook die indirecte uren voor mee, dus houd die apart bij.

Worklogteksten die iets zeggen

‘Development’ of ‘overleg’ helpt niemand. Een goede omschrijving is één zin die zegt wat er is gedaan en waaraan:

• Token-refresh in auth-service gerefactord, integratietests toegevoegd
• PR’s #412 en #418 in billing gereviewd, opmerkingen verwerkt
• Post-mortem billing-incident geschreven, drempels van alerts aangepast

Schrijf in de taal die je team en je klant gebruiken. In veel Nederlandse IT-teams is dat Engels, ook als iedereen Nederlands spreekt; spreek dat aan het begin van een opdracht af.

Veelgemaakte fouten

• Alles op één issue boeken. Eén ‘algemeen’ ticket voor alles maakt je uren onbruikbaar voor planning en facturatie.
• Pauzes meetellen. Een timer die doorloopt tijdens de lunch levert te veel uren op; corrigeren kost daarna meer tijd dan het scheelt.
• Dubbel boeken. Wie handmatig en via een integratie boekt, of een export twee keer draait, ziet ineens dubbele uren in Jira.
• Schattingen negeren. Laat je Remaining estimate nooit bijwerken, dan zegt je burndown niets meer.

Urenregistratie automatiseren

Er zijn grofweg drie manieren om je uren bij te houden zonder alles handmatig in te typen: een stopwatch-app die je per taak start en stopt, een Jira-add-on zoals Tempo die suggesties doet, of een desktop-tracker die je werkdag automatisch vastlegt. Een stopwatch werkt alleen als je hem niet vergeet; automatische tijdregistratie werkt altijd, maar je moet goed kijken waar je gegevens heen gaan.

Dat is het idee achter Timesheet Tracker, een urenregistratie app voor Jira op Windows. De app draait in het systeemvak en legt het actieve programma, de venstertitel, het domein in de browser en je inactiviteit vast — lokaal op je pc, zonder screenshots en zonder keylogger. Staat er een Jira-sleutel zoals CASE-1423 in een venstertitel of git-branch, dan gaat die tijd meteen naar die taak, zonder AI. Aan het eind van de dag klik je op Mijn dag sorteren: AI wijst de overige blokken toe aan je Jira-taken en schrijft per taak één worklogtekst. Alleen gemaskeerde titels, programmanamen, domeinen en tijdsduur gaan daarvoor de deur uit; met de modus Zonder AI gaat er helemaal niets naar AI.

Daarna controleer jij: met Taak wijzigen zet je een blok op een andere taak, met Geen werk haal je het uit je uren, en met Dag bevestigen keur je de dag goed. Naar Jira sturen zet de worklogs in Jira Cloud of Jira Server / Data Center, zonder dubbele boekingen als je opnieuw verstuurt. Met CSV exporteren houd je je eigen urenstaat per taak. Het is een persoonlijke tool, geen prikklok of tijdregistratiesysteem voor je werkgever: er zijn geen rapporten voor je leidinggevende. Wil je eerst kijken? De Demomodus laat het hele proces zien op een voorbeelddag, zonder Jira.

Veelgestelde vragen