{"id":95672,"date":"2021-06-22T15:15:56","date_gmt":"2021-06-22T13:15:56","guid":{"rendered":"https:\/\/artigianodelsoftware.it\/blog\/?p=95672"},"modified":"2021-06-22T15:15:58","modified_gmt":"2021-06-22T13:15:58","slug":"jql-worklog","status":"publish","type":"post","link":"https:\/\/artigianodelsoftware.it\/blog\/2021\/06\/22\/jql-worklog\/","title":{"rendered":"JQL & Worklog"},"content":{"rendered":"
\"image_pdf\"<\/a><\/a><\/div>\n

In questo post andremo ad esaminare come possiamo sfruttare il JQL per ottenere informazioni sul Worklog delle issue Jira.<\/p>\n\n\n\n

\"Un
Un esempio di caricamento di worklog<\/figcaption><\/figure>\n\n\n\n

Cosa offre il JQL standard<\/h2>\n\n\n\n

Partiamo come sempre dallo standard e cerchiamo di descrivere nel dettaglio quello che abbiamo a disposizione sul Worklog. <\/p>\n\n\n\n

L’opzione deve essere attiva<\/h3>\n\n\n\n

Jira memorizza il Worklog nativamente. L’opzione deve naturalmente essere attivata (di default la abbiamo gi\u00e0 abilitata) e questa possibilit\u00e0 la abbiamo a disposizione nella sezione di amministrazione della nostra instanza Jira (men\u00f9 Issue).<\/p>\n\n\n\n

\"Come
Sezione di Jira Cloud dedicata al Time Tracking<\/figcaption><\/figure><\/div>\n\n\n\n

I campi che referenziamo<\/h3>\n\n\n\n

Le informazioni che Jira memorizza sono le seguenti:<\/p>\n\n\n\n

\n\n\n\n
\n
\n

Original estimate<\/em><\/strong><\/p>\n\n\n\n

Si tratta della stima che andiamo a impostare nelle nostre issue. Il formato \u00e8 : <\/p>\n\n\n\n

1w 2d 3h 4m (1 settimana, 2 giorni, 3 ore, 4 minuti)<\/p>\n<\/div>\n\n\n\n

\n

Remaining estimate<\/em><\/strong><\/p>\n\n\n\n

Nel caso di ore caricate, il campo ci indica quanta stima abbiamo ancora a disposizione. Il formato \u00e8:<\/p>\n\n\n\n

1w 2d 3h 4m (1 settimana, 2 giorni, 3 ore, 4 minuti)<\/p>\n<\/div>\n\n\n\n

\n

Time spent<\/em><\/strong><\/p>\n\n\n\n

Tempo speso dall’operatore nel task. Il formato \u00e8:<\/p>\n\n\n\n

1w 2d 3h 4m (1 settimana, 2 giorni, 3 ore, 4 minuti)<\/p>\n<\/div>\n<\/div>\n\n\n\n

\n\n\n\n
\n
\n

Worklog comment<\/em><\/strong><\/p>\n\n\n\n

Commento che \u00e8 stato inserito dall’operatore per specificare il dettaglio delle operazioni eseguite. Si tratta di una stringa.<\/p>\n<\/div>\n\n\n\n

\n

Worklog date<\/em><\/strong><\/p>\n\n\n\n

Data in cui \u00e8 stata svolta l’attivit\u00e0. Si tratta di una data. <\/p>\n<\/div>\n\n\n\n

\n

Work ratio<\/em><\/strong><\/p>\n\n\n\n

Percentuale di lavoro svolta (in %)<\/p>\n\n\n\n

workRatio = timeSpent \/ originalEstimate) x 100<\/strong><\/p>\n\n\n\n

Si tratta di un numerico.<\/p>\n<\/div>\n<\/div>\n\n\n\n

\n\n\n\n

Che operazioni possiamo fare?<\/h3>\n\n\n\n

Con i primi tre campi che ho indicato, possiamo verificare quali issue presentano :<\/p>\n\n\n\n

  • Original estimate<\/em><\/strong> – Verificare quali issue presentano un particolare valore di stima impostata (valore esatto oppure maggiore o inferiore ad un valore)<\/li>
  • Remaining estimate <\/em><\/strong> – Verificare quali issue presentano una stima rimanente pari ad un valore esatto o maggiore o inferiore ad un valore<\/li>
  • Time spent<\/em><\/strong> – Verificare quali issue presentano un worklog caricato pari ad un valore esatto o maggiore o inferiore ad un valore;<\/li><\/ul>\n\n\n\n

    In questo caso possiamo eseguire delle interrogazioni JQL del tipo: <\/p>\n\n\n\n

    <CAMPO> = <Valore> | <CAMPO> > <Valore> | <CAMPO> < <Valore><\/p>

    <CAMPO> != <Valore> | <CAMPO> >= <Valore> | <CAMPO> <= <Valore><\/p>esempi di alcuni possibili interrogazioni <\/cite><\/blockquote>\n\n\n\n

    Alcuni esempi<\/h3>\n\n\n\n

    Riporto alcuni esempi di interrogazioni JQL per capire che cosa possiamo arrivare ad ottenere.<\/p>\n\n\n\n

    \n
    \n

    Capire quali issue per cui non abbiamo un worklog caricato<\/em><\/strong><\/p>\n\n\n\n

    project = <KEY> and timespent is EMPTY<\/p>\n<\/div>\n\n\n\n

    \n

    Capire quali issue presentano un worklog maggiore di un determinato limite<\/em><\/strong> (8 ore)<\/em><\/strong><\/p>\n\n\n\n

    project = <KEY> and timespent > 8h<\/p>\n<\/div>\n<\/div>\n\n\n\n

    \n
    \n

    Capire quali issue presentano una stima superiore al tempo usato<\/em><\/strong><\/p>\n\n\n\n

    project = <KEY> and timespent > 0 and remainingEstimate > 0<\/p>\n<\/div>\n\n\n\n

    \n

    <\/p>\n\n\n\n

    <\/p>\n<\/div>\n<\/div>\n\n\n\n

    Cosa non possiamo fare<\/h3>\n\n\n\n

    Non possiamo confrontare questi campi tra di loro. Se ad esempio impostiamo un JQL come nella seguente immagine:<\/p>\n\n\n\n

    \"evudenza
    L’errore che andiamo a riscontrare<\/figcaption><\/figure><\/div>\n\n\n\n

    lo standard purtroppo non ci supporta e ci restituisce un errore.<\/p>\n\n\n\n

    Per i restanti campi ….<\/h2>\n\n\n\n

    …. possiamo eseguire delle operazioni di diverso tipo. Andiamo nel dettaglio.<\/p>\n\n\n\n

    \n\n\n\n
    \n
    \n

    Worklog Comment<\/em><\/strong><\/p>\n<\/div>\n\n\n\n

    \n

    Quando inseriamo un worklog, abbiamo la possibilit\u00e0 di poter inserire una stringa per descrivere il tipo di attivit\u00e0. Le operazioni che possiamo eseguire possono essere quelle di verificare la presenza di determinate stringhe usando l’operatore ~<\/em><\/code><\/strong> <\/p>\n\n\n\n

    worklogComment ~\u00a0\"<qui inseriamo il nostro testo>\"<\/code><\/p>Esempio di utilizzo<\/cite><\/blockquote>\n<\/div>\n<\/div>\n\n\n\n

    \n\n\n\n
    \n
    \n
    \n
    \n

    Quando vogliamo accertarci che esista un worklogrelativo ad un lavoro svolto ad una determinata data, allora andiamo a referenziare questo campo, sfruttando tutte le funzioni relative alle date. <\/p>\n\n\n\n

    worklogDate = \"<Inserisci_qui_la_data>\"<\/code><\/p>

    Il formato della data \u00e8: yyyy-mm-dd<\/p>Esempio di utilizzo<\/cite><\/blockquote>\n<\/div>\n\n\n\n

    \n

    Worklog Date<\/em><\/strong><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n

    \n\n\n\n
    \n
    \n

    Work ratio<\/em><\/strong><\/p>\n<\/div>\n\n\n\n

    \n

    Il campo esprime la percentuale di lavoro svolto rispetto alla stima impostata. In questo caso \u00e8 particolarmente utile per capire la % di lavoro svolto dall’operatore.<\/p>\n\n\n\n

    workratio < <valore_numerico><\/p>Esempio di utilizzo<\/cite><\/blockquote>\n\n\n\n

    Nella seguente immagine vediamo un utilizzo interessante:<\/p>\n\n\n\n

    \"Un
    Punto di attenzione<\/figcaption><\/figure>\n\n\n\n

    In questo caso vediamo una issue in cui abbiamo stimato 5 ore ma abbiamo speso 7 ore con un surplus di 2 ore rispetto alla stima. In questo caso, abbiamo visto un esempio di come rintracciare le issue che sono risultate sottostimate. <\/p>\n<\/div>\n<\/div>\n\n\n\n

    Conclusione<\/h2>\n\n\n\n

    Abbiamo visto alcuni esempi di utilizzo dello standard di JQ, dedicati al worklog. Se volete avere maggiori ragguagli, vi suggerisco di acquistare il mio libro su JQL:<\/p>\n\n\n\n

    \n