Timesheet automatico per Jira: come smettere di compilare il foglio ore a memoria

Cos’è il timesheet in Jira e perché pesa così tanto

Nelle società di consulenza IT e nelle software house italiane la parola che si sente più spesso non è «timesheet» ma consuntivazione: a fine giornata, settimana o mese ogni persona dichiara quante ore ha lavorato e su quale commessa. Da quel consuntivo dipendono la fatturazione dei progetti a tempo e materiale, il controllo dei progetti a corpo (quante ore ci sono costati davvero rispetto all’offerta?), lo stato di avanzamento lavori da presentare al cliente e le stime del prossimo preventivo.

Quando il team lavora in Jira, il foglio ore vive dentro le issue. Ogni volta che registri del tempo crei un worklog: una durata, una data, un autore e, se lo scrivi, un commento. Il «timesheet» di una persona è l’elenco dei suoi worklog in un periodo; il consuntivo di una commessa è la somma dei worklog sulle issue di quella commessa, che di solito corrisponde a un progetto Jira, a un epic o a un campo personalizzato «Cliente».

Il problema non è inserire i numeri, che richiede pochi secondi. Il problema è sapere quali numeri inserire. Il venerdì pomeriggio, o peggio l’ultimo giorno del mese, devi ricostruire giornate fatte di ticket, code review, call con il cliente, messaggi su Teams o Slack e «domande al volo» dei colleghi. Così le ore finiscono spalmate sui ticket più plausibili.

Come si registrano le ore in Jira (il metodo manuale)

Per capire cosa automatizzare conviene ripassare come funziona la registrazione manuale, uguale nella sostanza su Jira Cloud e Jira Server / Data Center:

1. Il time tracking deve essere attivo nelle impostazioni di amministrazione di Jira. Lì si definiscono anche le ore di una giornata e i giorni di una settimana lavorativa: i valori predefiniti sono 8 e 5, per cui 1d vale 8 ore e 1w 40.
2. Apri la issue, scegli Log work (nell’interfaccia italiana «Registra lavoro») e inserisci il tempo nel formato di Jira: 2h 30m, 45m, 1d.
3. Imposta la data di inizio (fondamentale se registri il venerdì il lavoro del martedì) e scrivi una descrizione.

Esistono due scorciatoie. Gli smart commit, se il repository è collegato a Jira, permettono di registrare il tempo dal messaggio di commit:

PROJ-123 #time 1h 30m Refactoring del servizio di autenticazione

E la REST API, che consente a script e strumenti esterni di creare worklog per conto tuo, con il tuo account. Per controllare cosa hai già registrato in settimana basta una ricerca JQL:

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

Tutto questo funziona, ma resta manuale: devi comunque ricordare quanto tempo hai passato su ogni issue.

Tre livelli di automazione del foglio ore

«Timesheet automatico» viene usato per strumenti molto diversi. Conviene distinguerli in tre livelli:

Il livello 3 è l’unico che elimina davvero la ricostruzione a memoria, perché lavora su ciò che è successo sul tuo computer e non su ciò che ricordi.

Come funziona una rilevazione ore automatica, passo per passo

1. Registrazione dell’attività

Un’app in background annota quale programma è in primo piano, il titolo della finestra, per il browser il dominio del sito, e i periodi di inattività o di schermo bloccato. Ne esce una sequenza di blocchi: «09:05–10:40 VS Code, auth-service · feature/PROJ-123-token-refresh», «13:00–13:45 schermo bloccato».

2. Abbinamento tramite le chiavi Jira

Le chiavi delle issue compaiono ovunque nel lavoro di uno sviluppatore: nei nomi dei branch, nei titoli delle pull request, negli URL /browse/PROJ-123, nei titoli delle schede di Jira e Confluence. Un’espressione regolare basta a trovarle, senza IA e senza mandare nulla fuori dal PC. Con una convenzione di branch condivisa dal team, gran parte della giornata di sviluppo si abbina in questo modo.

3. Il resto: regole o IA

Restano i blocchi senza chiave: un file Figma, un thread su Slack, una bozza su Confluence, una call. Qui servono regole («Teams con il cliente X va sulla commessa X») o un modello linguistico che proponga l’issue più probabile in base a titolo e contesto, con un grado di affidabilità. L’importante è che sia una proposta, non una scrittura diretta in Jira.

4. Revisione e invio

Prima dell’invio vedi la giornata intera: cosa è già assegnato, cosa non era lavoro (pranzo, una telefonata personale) e cosa resta in dubbio. Correggi, confermi, e solo allora i worklog vengono scritti in Jira con il tuo account. Un buon strumento deve anche evitare i duplicati se reinvii la stessa giornata.

Buone pratiche per un foglio ore per commessa affidabile

• Chiave Jira nel nome del branch. feature/PROJ-123-descrizione è la convenzione più utile in assoluto: serve all’integrazione con Bitbucket, GitHub o GitLab e rende automatico l’abbinamento delle ore.
• Issue dedicate per ciò che non è un ticket. Riunioni interne, formazione, presales, amministrazione: concordate con il team poche issue fisse, per esempio una per commessa e una interna. Meglio una riga onesta «Riunioni» che ore spalmate sui ticket di sviluppo.
• Granularità coerente. Scegliete 15 o 30 minuti e applicatela sempre. Se fatturate a ore, verificate prima nel contratto le regole su arrotondamenti e unità minime.
• Descrizioni che si capiscono tra tre mesi. Formula: verbo + oggetto + risultato. «Corretto calcolo IVA in fattura elettronica, test verdi, PR aperta» vale molto più di «sviluppo».
• Niente ore gonfiate. Se hai lavorato 37 ore, il foglio ore dice 37. Le ore gonfiate nascondono i problemi veri (troppe riunioni, ambienti lenti) e rendono inaffidabili le stime della prossima offerta.
• Due minuti al giorno invece di un’ora al mese. Confermare la giornata la sera stessa costa pochissimo; ricostruire un mese intero è il motivo per cui il timesheet è così odiato.

Privacy: timesheet non vuol dire controllo

Un time tracker che registra le finestre del PC tocca dati delicati: titoli di e-mail, nomi di clienti, siti visitati. In Italia, poi, il controllo a distanza dei lavoratori è un tema regolato con attenzione e sensibile nei rapporti sindacali. Se l’azienda valuta uno strumento per tutto il team, è il caso di coinvolgere fin dall’inizio l’ufficio legale o il DPO.

Per uno strumento personale, che usi per compilare il tuo foglio ore, le domande da fare sono semplici:

• Dove resta la registrazione grezza? Sul mio PC o sul cloud del fornitore?
• Cosa esce dal PC, quando e verso chi? Titoli completi o mascherati? URL o solo domini?
• Fa screenshot? Registra i tasti premuti? Se la risposta è sì, non è uno strumento per il timesheet.
• Il responsabile vede la mia attività o solo i worklog che confermo?
• Posso escludere programmi, mettere in pausa e lavorare senza IA?

Come lo fa Timesheet Tracker

Timesheet Tracker (nel Microsoft Store: «Registro ore e timesheet - IA per Jira») è un’app per Windows costruita esattamente su questo flusso. Sta nell’area di notifica e registra programma attivo, titolo della finestra, dominio del browser e inattività, tutto in un database locale sul tuo PC. Le chiavi Jira nei titoli, negli URL e nei branch git vengono abbinate in locale, senza IA.

Quando premi «Ordina la mia giornata», l’IA assegna i blocchi rimanenti alle tue attività Jira e scrive un testo di worklog per attività, anche in italiano. All’IA arrivano solo titoli mascherati (e-mail, numeri, token e percorsi vengono nascosti), nomi dei programmi, domini e durate; mai screenshot, URL completi, ciò che digiti o il tuo token Jira. Con «Cambia attività» e «Non lavoro» correggi ciò che non torna, poi «Conferma giornata» e «Invia a Jira»: i worklog vanno su Jira Cloud o Jira Server / Data Center senza duplicati. In alternativa, «Esporta CSV» ti dà il foglio ore della giornata. Se preferisci, la modalità «Senza IA» lavora solo con le chiavi Jira e l’assegnazione manuale.

Non ci sono dashboard per il responsabile né report del team: è uno strumento per chi registra le proprie ore, non un sistema di rilevazione presenze.

Domande frequenti

Che differenza c’è tra timesheet e rilevazione presenze?

La rilevazione presenze registra quando una persona entra ed esce dal lavoro e serve all’ufficio del personale. Il timesheet, o foglio ore, dice su quali attività, progetti o commesse sono state spese le ore lavorate e serve a fatturare, a controllare i budget e a stimare meglio. In Jira il timesheet è fatto di worklog sulle singole issue.

Come si registrano le ore di lavoro in Jira?

Si apre la issue, si sceglie Log work (Registra lavoro), si indica il tempo nel formato di Jira, per esempio 1h 30m, la data e una descrizione. Ogni registrazione è un worklog. Le ore si possono registrare anche tramite smart commit, con la sintassi #time nel messaggio di commit, o tramite REST API.

Si può avere un timesheet automatico senza mandare tutto nel cloud?

Sì. Alcuni strumenti registrano l’attività solo sul PC dell’utente e inviano a Jira esclusivamente i worklog confermati. Timesheet Tracker, per esempio, salva la registrazione in locale, abbina le chiavi Jira senza IA e invia all’IA un riepilogo mascherato solo quando premi «Ordina la mia giornata»; esiste anche la modalità «Senza IA».

Dove registro riunioni e attività senza ticket?

Le riunioni legate a un’attività vanno sulla issue di quell’attività. Per stand-up, retrospettive, formazione e lavoro amministrativo conviene concordare con il team alcune issue dedicate, una per commessa o una interna, così le ore restano visibili senza essere spalmate a caso sui ticket.

Posso esportare il foglio ore in Excel?

Jira non ha un timesheet nativo esportabile, ma i worklog si possono estrarre con i report degli add-on, via API o da strumenti esterni. Timesheet Tracker esporta qualsiasi giornata in CSV, che si apre in Excel; l’esportazione diretta in XLSX è in programma.