JQL-spiekbriefje
Gebruik dit JQL-spiekbriefje van Jira als je uitgebreide handleiding om Jira Query Language onder de knie te krijgen voor geavanceerd zoeken en filteren in de projectbeheertool van Atlassian.
Introductie van Jira Query Language (JQL)
JQL is een krachtige zoektaal die speciaal is ontworpen voor Jira en waarmee gebruikers complexe query's kunnen maken voor tracering van issues, geavanceerde filtering en rapportage. De flexibiliteit van JQL in Jira helpt projectmanagers en agile teams bij het navigeren door grote datasets.
Basisstructuur van JQL-query's
Een typische JQL-query bestaat uit de volgende componenten:
- Veld: JQL-velden vertegenwoordigen verschillende soorten informatie, zoals prioriteit, fixVersion of issuetype.
- Operator: operators vormen de kern van de query, waarbij het veld wordt gekoppeld aan de waarde, met veelvoorkomende voorbeelden zoals is gelijk aan (=), niet gelijk aan (!=), en minder dan (<).
- Waarde en functie: waarden zijn de specifieke gegevenspunten waarnaar je op zoek bent. JQL-functies voeren berekeningen uit of leveren dynamische resultaten op.
- Trefwoorden: JQL-trefwoorden zijn speciale woorden met vooraf gedefinieerde betekenissen, zoals EN en OF. Ze worden gebruikt om complexere query's op te stellen.
Voorbeeld: project = 'Marketingcampagne' EN status = 'In uitvoering'
Met deze structuur kunnen gebruikers snel query's formuleren die gericht zijn op specifieke issues of groepen binnen Jira.
Veelgebruikte JQL-operators
Om effectieve query's te maken, is het heel belangrijk om te weten wat de JQL-operators zijn. Ze vormen de ruggengraat van JQL, waardoor gebruikers nauwkeurige zoekopdrachten kunnen uitvoeren waarbij grote hoeveelheden gegevens kunnen worden gefilterd om precies te vinden wat ze nodig hebben. Veelgebruikte operators in JQL zijn:
=
: exacte overeenkomst. Voorbeeld:Project = 'Marketingcampagne'
. Hiermee worden alle issues weergegeven die tot het project 'Marketingcampagne' behoren.!=
: niet gelijk aan. Voorbeeld:uitvoerder != currentUser( )
. Hiermee worden alle issues gevonden die niet aan de huidige gebruiker zijn toegewezen, wat helpt bij het identificeren van taken die mogelijk aandacht van anderen nodig hebben.EN
: combineert meerdere voorwaarden (ze moeten allemaal 'true' (waar) zijn). Voorbeeld:prioriteit = hoog EN status = open
. Hiermee worden alleen issues met een hoge prioriteit in een open status weergegeven, wat helpt bij het identificeren van kritieke taken die onmiddellijke aandacht vereisen.OF
: combineert meerdere voorwaarden (minstens één moet 'true' (waar) zijn). Voorbeeld:component = 'Gebruikersinterface' OF component = 'API'
. Hiermee worden issues gevonden die verband houden met de gebruikersinterface- of API-componenten, zodat je gerelateerd werk in verschillende systeemonderdelen kunt bekijken.IN
: komt overeen met elke waarde in een bepaalde lijst. Voorbeeld:status IN ('In uitvoering', 'Wordt beoordeeld', 'Testen')
. Hiermee worden alle issues gevonden met een van deze drie statussen, zodat je snel alle actieve werkitems kunt zien.
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:
-
SORTEREN OP
: sorteert de resultaten. Voorbeeld:project = 'Marketing' SORTEREN OP heeft DESC gemaakt
. Hiermee worden alle issues in het marketingproject weergegeven, gesorteerd op aanmaakdatum van nieuw naar oud, zodat je snel de meest recente taken kunt identificeren. WAS
: vindt issues die zich in een bepaalde staat voordeden. Voorbeeld:status WAS 'Opgelost' EN status = 'Open.'
Hiermee worden alle issues gevonden die zijn opgelost maar die sindsdien zijn heropend, wat helpt om terugkerende problemen op te sporen.GEWIJZIGD
: identificeert issues die binnen een bepaald tijdsbestek zijn gewijzigd. Voorbeeld:status GEWIJZIGD NA -1w
. Hiermee worden alle issues gevonden waarvan de status in de afgelopen week is gewijzigd, wat handig is om de recente voortgang of wijzigingen in je project te bekijken.MEMBERSOF
: filtert op basis van groepslidmaatschap. Voorbeeld:uitvoerder IN MEMBERSOF ('ontwikkelaars')
. Hiermee worden alle issues gevonden die zijn toegewezen aan iedereen in de groep 'ontwikkelaars', zodat je de werklast in een team kunt zien.
JQL-voorbeelden voor veelgebruikte Jira-usecases
Hier zijn enkele manieren waarop je JQL kunt gebruiken in Jira.
- Alle issues met hoge prioriteit vinden die aan jou zijn toegewezen:
prioriteit = hoog EN uitvoerder = currentUser()
- Achterstallige issues in een specifiek project vermelden:
project = 'klantenondersteuning' EN einddatum < nu() EN status != afgesloten
- Recent aangemaakte issues weergeven:
aangemaakt >= -7d SORTEREN OP aangemaakt DES
Geavanceerde JQL-technieken
Gebruik geavanceerd zoeken met JQL om gebruik te maken van aangepaste velden en complexe query's.
- Aangepaste velden gebruiken:
'naam Aangepast veld' ~ 'zoekterm'
. Gebruik JQL om in aangepaste velden te zoeken, zodat je meer aangepaste en specifieke query's kunt maken op basis van de unieke gegevensstructuur van je bedrijf. - Subquery's:
project IN subTaskIssueTypes() EN uitvoerder = currentUser()
. Gebruik JQL om geneste query's te maken, zodat je issues kunt filteren op basis van de resultaten van een andere query, wat vooral handig is voor complexe hiërarchische relaties in je projecten. - Specifieke issuetypes:
issuetype = Epic EN status != gereed
. Gebruik JQL om bepaalde issuetypes en hun status te targeten, zodat je specifieke categorieën werk in al je projecten kunt volgen en beheren.
JQL-expert worden
Met dit JQL-spiekbriefje van Atlassian ben je klaar om geavanceerd te zoeken met JQL en je vaardigheden op het gebied van projectbeheer te verbeteren.
Als je JQL onder de knie hebt, verkrijg je belangrijke projectinzichten en kun je cruciale vragen beantwoorden die relevant zijn voor je team. Er zijn drie manieren om te zoeken in Jira: snel, eenvoudig en geavanceerd. Deze kunnen je helpen om cruciale informatie over je projecten te vinden. Je kunt query-resultaten in heel Jira (dus ook in borden) opslaan en gebruiken als filters en weergaven.
Klaar om meer te ontdekken over de flexibiliteit van JQL in Jira?