Spiekbriefje voor Jira Query Language (JQL)

Met Jira Query Language (JQL) kun je issues in een Jira-workspace zoeken, filteren en er rapporten over maken met flexibele, krachtige query's voor nauwkeurige resultaten. Zo zoek je in Jira wanneer door filters klikken niet toereikend is.

JQL is gemaakt voor iedereen die nauwkeurige, herhaalbare zoekopdrachten nodig heeft voor werkitems: projectmanagers die een statusrapport ophalen, beheerders die een backlog controleren, of engineers die op zoek zijn naar elke bug die is gekoppeld aan een specifieke release.

Krijg Jira gratis

De 4 bouwstenen van een JQL-query

Elke JQL-clausule bestaat uit dezelfde vier onderdelen:

Onderdeel

Wat het doet

Voorbeeld

Veld

Het attribuut waarop je zoekt

priority, assignee, fixVersion

Operator

Koppelt het veld aan een waarde

=, !=, <, IN

Waarde of functie

Waarmee je vergelijkt

"High", currentUser()

Trefwoord

Koppelt meerdere clausules aan elkaar

AND, OR, ORDER BY

Veelgebruikte operators

Operators bepalen hoe Jira een veld vergelijkt met de waarde waarnaar je zoekt. Gebruik ze om exacte overeenkomsten te vinden, voorwaarden te combineren, te zoeken binnen een lijst met waarden of te controleren of een veld leeg is.

Operator

Betekenis

Voorbeeld

=

Exacte overeenkomst

project = "Marketing Campaign"

!=

Is niet gelijk aan

assignee != currentUser()

AND

Combineert voorwaarden, ze moeten allemaal waar zijn

priority = High AND status = Open

OF

Combineert voorwaarden, beide kunnen waar zijn

status = Open OR status = Reopened

IN

Komt overeen met een willekeurige waarde in een lijst

priority IN (High, Highest)

~

Bevat (tekstzoeken)

summary ~ "login error"

IS EMPTY

Veld heeft geen waarde

assignee IS EMPTY

Belangrijkste JQL-functies en hoe je ze gebruikt

JQL-functies verbeteren de query-mogelijkheden door gebruikers in staat te stellen complexere bewerkingen uit te voeren, resultaten te sorteren en te filteren op basis van dynamische criteria. Deze functies omvatten:

Functie

Beschrijving

Voorbeeld

ORDER BY

Sorteert resultaten op een veld.

project = "Marketing" ORDER BY created DESC

WAS

Zoekt werkitems die zich eerder in een bepaalde status bevonden.

status WAS "Resolved" AND status = "Open"

CHANGED

Identificeert werkitems die binnen een bepaald tijdsbestek zijn gewijzigd.

status CHANGED AFTER -1w

MEMBERSOF

Filtert werkitems op groepslidmaatschap.

assignee IN MEMBERSOF("developers")

JQL-voorbeelden voor veelgebruikte Jira-usecases

Dit zijn enkele manieren waarop je JQL kunt gebruiken in Jira.

Usecase

JQL-query

Alle werkitems met hoge prioriteit zoeken die aan je zijn toegewezen

priority = High AND assignee = currentUser()

Achterstallige werkitems in een specifiek project weergeven

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

Recent gemaakte werkitems tonen

created >= -7d ORDER BY created DES

Geavanceerde JQL-technieken

Gebruik geavanceerd zoeken met JQL om gebruik te maken van aangepaste velden en complexe query's.

Techniek

Voorbeeld

Hoe gebruik je het?

Aangepaste velden gebruiken

"Naam van aangepast veld" ~ "zoekterm"

Zoek binnen aangepaste velden voor meer gerichte query's.

Subquery's

project IN subTaskIssueTypes() AND assignee = currentUser()

Filter werkitems op basis van de resultaten van een andere query.

Specifieke typen werkitems

issuetype = Epic AND status != Done

Target specifieke typen werkitems en statussen.

Fouten opsporen voordat je een zoekopdracht uitvoert

Fouten opsporen in JQL-editor

De huidige JQL-editor in Jira Cloud is ontworpen om problemen al tijdens het typen te signaleren, in plaats van pas nadat je op zoeken hebt geklikt:

  • Controleren op fouten: ongeldige syntaxis wordt direct gemarkeerd met richtlijnen om deze op te lossen

  • Syntaxis markeren: velden, operators, waarden en functies hebben elk een eigen kleur

  • Automatisch aanvullen: relevante trefwoorden en functies verschijnen terwijl je typt

  • Bewerken op meerdere regels: vouw de editor uit en gebruik regelnummers om fouten te vinden

  • Leesbare gebruikersverwijzingen: namen en avatars vervangen onbewerkte account-ID's

  • JQL-debugger: wanneer een query een fout retourneert, stelt Rovo een gecorrigeerde query voor die je kunt controleren en accepteren

Zoeken met Rovo

Je hoeft niets van de bovenstaande JQL-syntaxis uit het hoofd te leren om nauwkeurig te zoeken. Rovo, de AI van Atlassian, vertaalt wat je typt automatisch naar JQL. Selecteer in de zoekbalk van Jira Vraag het aan Rovo en typ je vraag zoals je die hardop zou stellen. Bijvoorbeeld:

"Zoek alle bugs die deze maand zijn gerapporteerd in het mobiele app-project"

Rovo zet dat om in de bijbehorende JQL, voert de zoekopdracht uit en toont zowel de resultaten als de JQL die het heeft gegenereerd. Dat laatste is belangrijk: het is een zeer nuttige manier om JQL aan de hand van voorbeelden te leren, omdat je precies kunt zien aan welke velden, operators en functies je vraag in gewone taal is gekoppeld. Als een query te complex is voor Rovo om in de basismodus op te lossen, schakelt het automatisch over naar de JQL-modus om een nauwkeuriger resultaat te geven. Je kunt op elk moment terugschakelen naar de basismodus via het menu Meer acties.

Wanneer Rovo-zoeken het beste werkt

Wanneer je rechtstreeks naar JQL moet overschakelen

Je weet ongeveer wat je wilt, maar niet precies welke veldnamen of syntaxis je moet gebruiken

Je hebt nauwkeurige, herhaalbare query's nodig voor opgeslagen filters, borden of dashboards

Je zoekt met alledaagse taal en trefwoorden uit je werkitems, spaces of borden

Je query vereist functies of logica die niet betrouwbaar in natuurlijke taal kunnen worden uitgedrukt

Je wilt gaandeweg de JQL-syntaxis leren

Je zoekt in een andere taal dan het Engels

JQL: veelgestelde vragen

Hoe kan JQL me helpen specifieke werkitems in Jira te vinden?

Met JQL kun je aangepaste query's maken om werkitems te filteren op velden zoals toegewezen aan, status, project of datum, zodat je snel de werkitems kunt vinden die voor jou het belangrijkst zijn.

Kan ik mijn JQL-query's opslaan en delen met mijn team?

Je kunt je JQL-zoekopdrachten opslaan als filters en ze delen met teamgenoten, zodat iedereen eenvoudig toegang heeft tot dezelfde set werkitems.

Wat zijn enkele veelvoorkomende use cases voor JQL in projectbeheer?

Teams gebruiken JQL vaak om achterstallige taken te bij te houden, de voortgang van sprints te bewaken, blockers te identificeren en rapporten te genereren die aansluiten bij hun workflow.

Zijn er tips voor het schrijven van geavanceerdere JQL-query's?

Door operators en functies te gebruiken en meerdere criteria met AND/OR te combineren, kun je complexe query's maken voor gedetailleerde tracking en rapportage van werkitems.