Jira : Les 5 requêtes JQL les plus utiles
Certains d’entre vous qui êtes des utilisateurs Jira doivent déjà connaître et maitriser les requêtes JQL (Jira Query Language).
Pour les autres, JQL est le langage Jira qui vous permet de faire des recherches avancées dans Jira.
Même en organisant proprement son backlog, en triant ses issues dans des épics ou en créant des rapports etc…, le problème vient souvent des autres.
En effet, ce n’est déjà pas facile de se rappeler tout ce que l’on a fait, mais il faut aussi être informé de tous les mouvements réalisés par vos collègues.
Si vous avez besoin d’organisation dans votre Jira, voici un petit post simple qui peut vous être utile dans votre quotidien de PO.
Préambule :
Je ne vais pas vous faire un cours sur le JQL, il y a déjà plein de tutoriaux Jira sur le web pour ça.
Tout ce que vous devez savoir, c’est que pour tapez vos recherches JQL vous devez :
- Cliquez sur l’onglet “Tickets” dans la barre de navigation
- Choisir l’option “Cherchez des tickets” dans le menu déroulant
- Puis sur la page recherche, cliquez sur le bouton “Avancée”
Et voilà, c’est tout.
Avec ça vous allez pouvoir copier / coller que je vous donne dans la barre de recherche.
Requête JQL numéro 1 :
Celui là c’est un classique.
Vous venez de faire une recette et vous et votre testeur avez déniché des tonnes de bugs urgents.
Vous voulez les assigner immédiatement à vos développeurs.
Plutôt que de leur envoyer les liens par Slack ou par e-mail pour être sur qu’ils ne les loupent pas, voici une petite requête à coller dans la barre de recherche.
assignee = currentUser() AND type = Bogue AND priority = 1 AND status != Done
PS:
J’ordonne mes priorités par numéro. Si vous avez un autre système, remplacer le chiffre 1 par le nom de votre valeur (ça peut être haut, élevé, prioritaire…).
Astuces :
- La valeur “currentUser()” permet de désigner la personne connectée à Jira.
En gros si vous avez 3 développeurs à qui envoyer cette requête, plutôt que de taper 3 requêtes différentes et de changer l’assigné à chaque fois, cette valeur s’adapte à l’utilisateur qui ouvre la requête sur son Jira. - Pour partager cette requête directement via Jira :
- Enregistrer cette recherche dans un filtre
- Cliquer sur le bouton “Partager” en haut de la page recherche et indiquer la personne à qui vous voulez partager ce filtre
Avec ça, impossible de louper les bugs importants.
Requête JQL numéro 2 :
Vous avez été absent 1 jour du bureau et vous voulez connaître les tickets qui ont bougés pendant votre absence :
TAPEZ :
created >= -24h ou encore updated >= -24h resolved >= -24h
Si vous avez été absent 2 jours, tapez
created >= -2d
ou encore
updated >= -2d
resolved >= -2d
Si vous avez été absent 1 semaine, tapez
created >= -1w
ou encore
updated >= -1w
resolved >= -1w
Et ainsi de suite…
Requête JQL numéro 3 :
Il est 18h et vous voulez savoir ce qui a été résolu dans votre sprint dans la journée.
TAPEZ :
resolved >= -12h AND Sprint = nomdevotresprint
Même scénario mais vous voulez savoir ce qui a bougé dans votre sprint dans la journée.
TAPEZ :
updated >= -12h AND Sprint = nomdevotresprint
Requête JQL numéro 4 :
Vous voulez connaître toutes les Stories qui restent à faire dans votre projet et qui demandent le plus de points d’effort
TAPEZ :
project = nomduprojet AND "Story points" = 8 AND status != Done
Ici, j’ai mis 8 points car ça représente mon maximum pour un chiffrage d’une US.
S’il vous arrive de chiffrer des US à 13 ou 21, indiquez le nombre qui représente la plus haute valeur d’effort pour vous.
Cette requête est très utile pour planifier les gros chantier restant à faire.
- A l’inverse vous voulez identifier les quick wins, tapez la même requête et changer le nombre de points en indiquant votre minimum (1, 2 ou 3)
Requête JQL numéro 5 :
Un dernier classique pour terminer.
Des bugs ont été créé par le testeur pendant votre sprint mais vous ne les avez pas encore priorisé.
TAPEZ :
Sprint = nomdevotresprint AND status = "To Do" and type = Bogue AND priority is EMPTY
C’est une requête très utile pour s’assurer que tous vos bugs soient priorisés.
Dans le même genre, des bugs ont été créé par le testeur pendant votre sprint mais vous ne les avez pas encore assigné.
TAPEZ :
assignee is EMPTY AND Sprint = nomdevotresprint AND status = "To Do" and type = Bogue
C’est fini !
Voilà j’espère que ces petits conseils pourront être utiles à ceux qui n’utilisent pas encore le langage JQL dans Jira.
Pour les moins techniques d’entre vous, cela peut être intimidant au départ mais je vous garantis que les bases s’apprennent très vite.
Si vous maîtrisez déjà les bases et que vous souhaitez faire des recherches plus poussées, je vous recommande de télécharger Scriprunner qui est le plugin de référence pour optimiser ses requêtes JQL.
Hello Julien
Très bon article!
Une petite suggestion basée sur les fonctions. Plutôt que created >= -24h, je préfère utiliser created >= startOfDay(-1).
Parce que si tu es en retard au bureau à cause d’un RER qui n’avance pas, et que tu arrives à 10h, tu rates les créations de la veille à 9h30.
Stéphane
Bien joué Stéphane.
Merci pour le tip. Tu me permets de l’ajouter dans l’article ? Ça peut etre très utile
Bonjour Julien,
Saurais-tu si c’est possible d’avoir un tri en fonction de l’ordre de mes tickets dans le tableau backlog ?
Mon besoin : extraire mes story du sprint en cours avec critères d’acceptation trié dans l’ordre qu’ils ont dans le backlog.
–> type = Story and sprint in openSprints() order by ???
Merci pour ton aide !