Scheda di riferimento di Jira Query Language (JQL)

Jira Query Language (JQL) ti consente di cercare, filtrare e segnalare i ticket all'interno di uno spazio di lavoro Jira utilizzando query flessibili ed efficaci per ottenere risultati precisi. È il modo per effettuare ricerche in Jira quando non basta selezionare i filtri.

JQL è pensato per chiunque abbia bisogno di ricerche precise e ripetibili tra i ticket: project manager che estraggono un report sullo stato, amministratori che effettuano verifiche in un backlog o ingegneri che cercano tutti i bug collegati a un rilascio specifico.

Ottieni Jira gratis

I 4 elementi fondamentali di una query JQL

Ogni espressione JQL è composta dagli stessi quattro elementi:

Parte

Che cosa fa

Esempio

Campo

L'attributo in base a cui effettui la ricerca

priority, assignee, fixVersion

Operatore

Mette in relazione il campo con un valore

=, !=, <, IN

Valore o funzione

L'elemento con cui stai facendo il confronto

"High", currentUser()

Parola chiave

Collega più espressioni tra loro

AND, OR, ORDER BY

Operatori comuni

Gli operatori definiscono il modo in cui Jira confronta un campo con il valore che stai cercando. Usali per trovare corrispondenze esatte, combinare le condizioni, effettuare ricerche in un elenco di valori o controllare se un campo è vuoto.

Operatore

Significato

Esempio

=

Corrispondenza esatta

project = "Marketing Campaign"

!=

Diverso da

assignee != currentUser()

AND

Combina le condizioni, tutte devono essere vere

priority = High AND status = Open

OPPURE

Combina le condizioni, una delle due può essere vera

status = Open OR status = Reopened

IN

Corrisponde a qualsiasi valore in un elenco

priority IN (High, Highest)

~

Contiene (ricerca di testo)

summary ~ "login error"

IS EMPTY

Il campo non ha alcun valore

assignee IS EMPTY

Funzioni JQL chiave e come usarle

Le funzioni JQL migliorano le capacità di invio delle query consentendo agli utenti di eseguire operazioni più complesse, ordinare i risultati e filtrare in base a criteri dinamici. Queste funzioni includono:

Funzione

Descrizione

Esempio

ORDER BY

Ordina i risultati in base a un campo.

project = "Marketing" ORDER BY created DESC

WAS

Trova i ticket che precedentemente erano in uno stato specifico.

status WAS "Resolved" AND status = "Open"

CHANGED

Identifica i ticket modificati in un intervallo di tempo.

status CHANGED AFTER -1w

MEMBERSOF

Filtra i ticket in base all'appartenenza al gruppo.

assignee IN MEMBERSOF("developers")

Esempi di casi d'uso comuni di JQL in Jira

Ecco alcuni modi in cui puoi usare JQL in Jira.

Caso d'uso

Query JQL

Trovare tutti i ticket ad alta priorità assegnati a te

priority = High AND assignee = currentUser()

Elencare i ticket scaduti in un progetto specifico

project = "Customer Support" AND duedate < now() AND status != Closed

Visualizzare i ticket creati di recente

created >= -7d ORDER BY created DES

Tecniche JQL avanzate

Usa la ricerca avanzata con JQL per sfruttare campi personalizzati e query complesse.

Tecnica

Esempio

Come si usa

Uso di campi personalizzati

"Custom Field Name" ~ "search term"

Cerca nei campi personalizzati per eseguire query più mirate.

Sottoquery

project IN subTaskIssueTypes() AND assignee = currentUser()

Filtra i ticket in base ai risultati di un'altra query.

Tipi di ticket specifici

issuetype = Epic AND status != Done

Seleziona tipi di ticket e stati specifici.

Come individuare gli errori prima di eseguire una ricerca

Rilevamento degli errori nell'editor JQL

L'attuale editor JQL in Jira Cloud è progettato per individuare i problemi mentre digiti, invece che dopo aver avviato la ricerca:

  • Controllo degli errori: la sintassi non valida viene segnalata immediatamente con indicazioni per la correzione

  • Evidenziazione della sintassi: campi, operatori, valori e funzioni sono codificati mediante colori

  • Completamento automatico: mentre digiti, vengono visualizzate le parole chiave e le funzioni pertinenti

  • Modifica su più righe: espandi l'editor e usa il numero di riga per trovare gli errori

  • Riferimenti utente leggibili: nomi e avatar sostituiscono gli ID account non elaborati

  • Debugger JQL: quando una query restituisce un errore, Rovo suggerisce una query corretta che puoi rivedere e accettare

Cerca con Rovo

Per eseguire una ricerca precisa, non hai bisogno di memorizzare alcun elemento di sintassi JQL riportato sopra. Rovo, l'IA di Atlassian, traduce automaticamente ciò che digiti in JQL. Dalla barra di ricerca di Jira, seleziona Chiedi a Rovo e digita la domanda così come la formuleresti ad alta voce. Ad esempio:

"Trova tutti i bug segnalati nel progetto dell'app per dispositivi mobili questo mese"

Rovo lo converte nel JQL corrispondente, esegue la ricerca e mostra sia i risultati sia il JQL che ha generato al di sotto. Quest'ultima parte è importante: è un modo davvero utile per imparare JQL tramite esempi, perché puoi vedere esattamente a quali campi, operatori e funzioni è stata associata la tua domanda in linguaggio naturale. Se è troppo complessa perché Rovo possa risolverla in modalità Basic, la query passa automaticamente alla modalità JQL per darti un risultato più accurato. Puoi tornare alla modalità Basic in qualsiasi momento dal menu delle altre azioni.

Quando Ricerca Rovo funziona al meglio

Quando passare direttamente a JQL

Sai più o meno cosa vuoi, ma non i nomi esatti dei campi o la sintassi

Hai bisogno di query precise e ripetibili per le board, le dashboard o i filtri salvati

Stai effettuando la ricerca usando il linguaggio comune e parole chiave di ticket, spazi o board

La query richiede funzioni o logica che non possono essere espresse in modo affidabile nel linguaggio naturale

Vuoi imparare la sintassi JQL man mano che procedi

Stai usando una lingua diversa dall'inglese

JQL: domande frequenti

In che modo JQL può aiutarmi a trovare ticket specifici in Jira?

JQL ti consente di creare query personalizzate per filtrare i ticket in base a campi come Assignee (Assegnatario), Status (Stato), Project (Progetto) o Date (Data), così puoi individuare rapidamente i ticket più importanti per te.

Posso salvare e condividere le mie query JQL con il team?

Puoi salvare le tue ricerche JQL come filtri e condividerle con i colleghi del team, così sarà facile per tutti accedere allo stesso insieme di ticket.

Quali sono alcuni casi d'uso comuni di JQL nella gestione dei progetti?

Spesso i team usano JQL per monitorare i task in ritardo, seguire i progressi degli sprint, identificare i blocchi e generare report adatti al loro flusso di lavoro.

Esistono suggerimenti per scrivere query JQL più avanzate?

Usando operatori e funzioni e combinando più criteri con AND/OR, puoi creare query complesse per monitorare con precisione i ticket e creare report dettagliati.