Aide-mémoire pour le langage Jira Query Language (JQL)

Le Jira Query Language (JQL) vous permet de rechercher des tickets d'un espace de travail Jira, de les filtrer et de générer des rapports sur ceux-ci à l'aide de requêtes flexibles et puissantes, pour obtenir des résultats précis. C'est la méthode à utiliser pour effectuer une recherche dans Jira lorsque cliquer sur les filtres ne suffit pas.

Le langage JQL est conçu pour tous ceux qui ont besoin d'effectuer des recherches précises et reproductibles parmi les tickets : qu'il s'agisse de chefs de projet préparant un rapport d'état, d'administrateurs auditant un backlog ou d'ingénieurs recherchant tous les bugs liés à une version spécifique.

Télécharger Jira gratuitement

Les 4 éléments constitutifs d'une requête JQL

Chaque clause JQL est composée des quatre éléments suivants :

Partie

Ce qu'elle accomplit

Exemple

Champ

L'attribut sur lequel porte votre recherche

priority, assignee, fixVersion

Opérateur

Associe le champ à une valeur

=, !=, <, IN

Valeur ou fonction

Ce que vous comparez

"High", currentUser()

Mot clé

Relie plusieurs propositions entre elles

AND, OR, ORDER BY

Opérateurs courants

Les opérateurs définissent la manière dont Jira compare un champ à la valeur que vous recherchez. Utilisez-les pour trouver des correspondances exactes, combiner des conditions, effectuer une recherche dans une liste de valeurs ou vérifier si un champ est vide.

Opérateur

Signification

Exemple

=

Correspondance exacte

project = "Marketing Campaign"

!=

Non égal à

assignee != currentUser()

AND

Combine plusieurs conditions ; toutes doivent être vraies

priority = High AND status = Open

OR

Combine plusieurs conditions ; l'une ou l'autre peut être vraie

status = Open OR status = Reopened

IN

Correspond à n'importe quelle valeur dans une liste

priority IN (High, Highest)

~

Contient (recherche de texte)

summary ~ "login error"

IS EMPTY

Le champ n'a pas de valeur

assignee IS EMPTY

Les principales fonctions JQL et leur utilisation

Les fonctions JQL améliorent les fonctionnalités de requête en permettant aux utilisateurs d'effectuer des opérations plus complexes, de trier les résultats et de les filtrer en fonction de critères dynamiques. Ces fonctions incluent :

Fonction

Description

Exemple

ORDER BY

Trie les résultats par champ.

project = "Marketing" ORDER BY created DESC

WAS

Identifie les tickets qui se trouvaient auparavant dans un état particulier.

status WAS "Resolved" AND status = "Open"

CHANGED

Identifie les tickets modifiés sur une période donnée.

status CHANGED AFTER -1w

MEMBERSOF

Filtre les tickets par appartenance à un groupe.

assignee IN MEMBERSOF("developers")

Exemples JQL pour les cas d'utilisation courants de Jira

Voici quelques manières d'utiliser JQL dans Jira.

Cas d'usage

Requête JQL

Trouver tous les tickets hautement prioritaires qui vous sont assignés

priority = High AND assignee = currentUser()

Répertorier les tickets dépassés dans un projet en particulier

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

Afficher les tickets récemment créés

created >= -7d ORDER BY created DES

Techniques JQL avancées

Utilisez la recherche avancée avec JQL pour tirer parti des champs personnalisés et des requêtes complexes.

Technique

Exemple

Comment l'utiliser ?

Utilisation des champs personnalisés

"Custom Field Name" ~ "search term"

Effectuez une recherche dans les champs personnalisés pour obtenir des résultats plus ciblés.

Sous-requêtes

project IN subTaskIssueTypes() AND assignee = currentUser()

Filtrez les tickets en fonction des résultats d'une autre requête.

Types de tickets spécifiques

issuetype = Epic AND status != Done

Ciblez des types et des états de tickets spécifiques.

Comment détecter les erreurs avant d'effectuer une recherche

Détection des erreurs dans l'éditeur JQL

L'éditeur JQL actuel dans Jira Cloud est conçu pour détecter les problèmes lors de la saisie, plutôt qu'après avoir lancé la recherche :

  • Vérification des erreurs : toute syntaxe non valide est immédiatement signalée, accompagnée de conseils pour la corriger

  • Mise en évidence de la syntaxe : les champs, les opérateurs, les valeurs et les fonctions sont identifiés par des codes couleur

  • Saisie semi-automatique : les fonctions et mots clés pertinents s'affichent au fur et à mesure de votre saisie

  • Édition multiligne : élargissez l'éditeur et utilisez les numéros de ligne pour repérer les erreurs

  • Références utilisateur lisibles : les noms et avatars remplacent les identifiants de compte bruts

  • Débogueur JQL : lorsqu'une requête renvoie une erreur, Rovo suggère une requête corrigée que vous pouvez passer en revue et accepter

Rechercher avec Rovo

Vous n'avez pas besoin de mémoriser la syntaxe JQL ci-dessus pour effectuer une recherche précise. Rovo, l'IA d'Atlassian, convertit automatiquement ce que vous saisissez en JQL. Depuis la barre de recherche de Jira, sélectionnez Demander à Rovo et saisissez votre question comme vous la poseriez à haute voix. Par exemple :

« Trouve tous les bugs signalés dans le projet de l'application mobile ce mois-ci »

Rovo convertit cette phrase en JQL correspondant, lance la recherche et vous affiche à la fois les résultats et la requête JQL qu'il a générée en dessous. Ce dernier point est important : c'est un moyen vraiment utile d'apprendre le langage JQL par l'exemple, puisque vous pouvez voir exactement à quels champs, opérateurs et fonctions votre question en français courant a été associée. Si une requête est trop complexe pour que Rovo puisse la traiter en mode Basique, il passe automatiquement en mode JQL afin de vous fournir un résultat plus précis. Vous pouvez revenir au mode Basique à tout moment depuis le menu Plus d'actions.

Quand la Recherche Rovo est la plus efficace

Quand passer directement au JQL

Vous savez à peu près ce que vous voulez, mais vous ne connaissez pas les noms exacts des champs ni la syntaxe

Vous avez besoin de requêtes précises et reproductibles pour les filtres, les tableaux ou les tableaux de bord enregistrés

Vous effectuez votre recherche en utilisant un langage courant et des mots clés issus de vos tickets, espaces ou tableaux

Votre requête nécessite des fonctions ou une logique qui ne peuvent pas être exprimées de manière fiable en langage naturel

Vous souhaitez apprendre la syntaxe JQL au fur et à mesure

Vous effectuez votre recherche dans une langue autre que l'anglais

JQL : Foire aux questions

Comment le JQL peut-il m'aider à trouver des tickets spécifiques dans Jira ?

Le JQL vous permet de créer des requêtes personnalisées pour filtrer les tickets selon des critères, tels que la personne assignée, l'état, le projet ou la date, afin que vous puissiez rapidement localiser les tickets qui vous importent le plus.

Puis-je enregistrer et partager mes requêtes JQL avec mon équipe ?

Vous pouvez enregistrer vos recherches JQL sous forme de filtres et les partager avec vos coéquipiers, ce qui permet à tout le monde d'accéder facilement au même ensemble de tickets.

Quels sont les cas d'usage courants de JQL dans la gestion de projet ?

Les équipes utilisent souvent JQL pour suivre les tâches en retard, surveiller l'avancement des sprints, identifier les obstacles et générer des rapports adaptés à leur workflow.

Existe-t-il des astuces pour rédiger des requêtes JQL plus avancées ?

En utilisant des opérateurs, des fonctions et en combinant plusieurs critères avec AND/OR, vous pouvez créer des requêtes complexes pour un suivi détaillé des tickets et le reporting.