Aide-mémoire JQL

Cet aide-mémoire pour Jira JQL est un guide complet pour maîtriser Jira Query Language afin d'effectuer des recherches et des filtrages avancés dans l'outil de gestion de projet d'Atlassian.

Présentation de Jira Query Language (JQL)

JQL est un puissant langage de recherche spécialement conçu pour Jira qui permet aux utilisateurs de créer des requêtes complexes à des fins de suivi des tickets, de filtrage avancé et de création de rapports. De par sa flexibilité, JQL dans Jira aide les responsables de projet et les équipes agiles à gérer de grands ensembles de données.

Obtenir Jira gratuitement

Structure de base des requêtes JQL

Une requête JQL classique comprend les composants suivants :

Champ : les champs JQL représentent différents types d'informations, tels que la priorité, la version corrigée ou le type de ticket.
Opérateur : les opérateurs sont au cœur de la requête. Ils associent le champ à la valeur, avec des exemples courants tels que « égal » (=), « différent » (! =) et « inférieur à » (<).
Valeur et fonction : les valeurs sont les points de données spécifiques que vous recherchez. Les fonctions JQL effectuent des calculs ou renvoient des résultats dynamiques.
Mots clés : les mots clés JQL sont des mots spéciaux ayant une signification prédéfinie, comme AND et OR. Ils sont utilisés pour créer des requêtes plus complexes.

Exemple : project = “Campagne Marketing” AND status = “En cours”

Cette structure permet aux utilisateurs de formuler rapidement des requêtes ciblant des tickets ou des groupes spécifiques au sein de Jira.

Opérateurs JQL courants

Il est essentiel de comprendre les opérateurs JQL pour créer des requêtes efficaces. Ils constituent l'épine dorsale de JQL, en permettant aux utilisateurs d'effectuer des recherches précises en filtrant de grandes quantités de données pour trouver exactement ce dont ils ont besoin. Les opérateurs courants dans JQL sont :

= : correspondance exacte. Exemple : Project = “Campagne Marketing”. Cela renverra tous les tickets relatifs au projet « Campagne Marketing ».
! = : non égal à. Exemple : assignee != currentUser( ). Cela permet de détecter tous les tickets qui ne sont pas attribués à l'utilisateur actuel et d'identifier les tâches qui pourraient nécessiter l'attention d'autres personnes.
AND : combine plusieurs conditions (toutes doivent être vraies). Exemple : priority = High AND status = Ouvert. Cela ne renverra que les tickets prioritaires ouverts, ce qui est utile pour identifier les tâches critiques nécessitant une attention immédiate.
OR : combine plusieurs conditions (au moins une doit être vraie). Exemple : component = “Interface utilisateur” OR component = “API”. Cela permet de détecter les problèmes liés à l'interface utilisateur ou aux composants de l'API, et ainsi de consulter les tickets connexes pour les différentes parties du système.
IN : correspond à n'importe quelle valeur d'une liste spécifiée. Exemple : status IN (“En cours”, “En cours de revue”, “Tests”). Cela renverra tous les tickets ayant n'importe lequel de ces trois états, ce qui permet de voir rapidement tous les tickets actifs.

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 :

ORDER BY : trie les résultats. Exemple : project = "Marketing" ORDER BY created DESC. Cela renverra tous les tickets du projet Marketing, triés par date de création, du plus récent au plus ancien, ce qui vous permet d'identifier rapidement les tâches les plus récentes.
WAS : identifie les tickets qui se trouvaient dans un état particulier. Exemple : status WAS "Résolu" AND status = "Ouvert." Cela permet de trouver tous les tickets qui ont été résolus, mais qui ont été rouverts depuis, de façon à suivre les problèmes récurrents.
CHANGED : identifie les tickets modifiés sur une période donnée. Exemple : statut CHANGED AFTER -1w. Cela renverra tous les tickets dont l'état a changé la semaine passée, ce qui est utile pour passer en revue les récents progrès ou les modifications apportées à votre projet.
MEMBERSOF : filtre par appartenance à un groupe. Exemple : assignee IN MEMBERSOF("developers"). Cela permet de trouver tous les tickets attribués à un membre du groupe « développeurs », et ainsi de voir la charge de travail d'une équipe.

Exemples JQL pour les cas d'utilisation courants de Jira

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

Trouver tous les tickets prioritaires qui vous sont assignés : priority = High AND assignee = currentUser()
Répertorier les tickets dépassés dans un projet en particulier : project = "Assistance" AND duedate < now() AND status != Traité
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.

Utilisation de champs personnalisés : "Custom Field Name" ~ "search term". Utilisez JQL pour effectuer des recherches dans des champs personnalisés, afin de répondre à des requêtes plus personnalisées et plus spécifiques en fonction de la structure de données unique de votre entreprise.
Sous-requêtes : project IN subTaskIssueTypes() AND assignee = currentUser(). Utilisez JQL pour créer des requêtes imbriquées et ainsi filtrer les tickets en fonction des résultats d'une autre requête. Cette fonction est particulièrement utile pour les relations hiérarchiques complexes dans vos projets.
Types de tickets spécifiques: issuetype = Epic AND status != Terminé. Utilisez JQL pour cibler des types de tickets spécifiques et leurs états, afin de vous aider à suivre et à gérer des catégories de ticket spécifiques dans le cadre de vos projets.

Devenir expert en JQL

Grâce à cet aide-mémoire Atlassian pour JQL, vous serez parfaitement équipé pour maîtriser la recherche avancée avec JQL et améliorer vos compétences en gestion de projet.

La maîtrise de JQL vous permet d'obtenir des informations clés sur les projets et de répondre à des questions cruciales concernant votre équipe. Les trois types de recherche dans Jira (rapide, de base et avancée) peuvent vous aider à trouver des informations importantes sur vos projets. Vous pouvez également enregistrer les résultats de la recherche et les utiliser comme des filtres ou des vues dans Jira (y compris dans les tableaux).

Vous souhaitez en savoir plus sur la flexibilité de JQL dans Jira ?

Obtenir Jira gratuitement

Aide-mémoire JQL

Présentation de Jira Query Language (JQL)

Structure de base des requêtes JQL

Opérateurs JQL courants

Les principales fonctions JQL et leur utilisation

Exemples JQL pour les cas d'utilisation courants de Jira

Techniques JQL avancées

Devenir expert en JQL

produits

Ressources

Apprendre