Résolution de l’erreur : JQL query get subtasks under issue in specific epic (Jira Server)

Aperçu de l’Erreur

L’erreur “JQL query get subtasks under issue in specific epic (Jira Server)” se produit lorsque les utilisateurs tentent d’exécuter une requête JQL (Jira Query Language) pour obtenir des sous-tâches sous un problème spécifique dans un épique donné sur Jira Server. Cette situation peut être frustrante, surtout si vous avez besoin d’accéder à des informations précises sur vos sous-tâches liées à un épique particulier.

Causes Courantes

Il existe plusieurs raisons pour lesquelles cette erreur peut survenir :

1. Requête JQL Incorrecte : La syntaxe de la requête JQL peut être incorrecte, entraînant une incapacité à récupérer les données souhaitées.
2. Filtres Manquants : Les filtres nécessaires pour isoler les sous-tâches d’un épique spécifique peuvent ne pas être correctement configurés.
3. Permissions Insuffisantes : Les utilisateurs peuvent ne pas avoir les autorisations nécessaires pour visualiser certains problèmes ou sous-tâches.
4. Problèmes de Configuration : La configuration du projet ou des épics dans Jira peut ne pas être appropriée.
5. Limites de Performance : Des requêtes trop complexes ou excessives peuvent dépasser les limites de performance de Jira.

Méthodes de Solution

Pour résoudre ce problème, plusieurs méthodes peuvent être appliquées. Voici les solutions détaillées :

Méthode 1: Utilisation de Filtres JQL

Cette méthode consiste à créer plusieurs filtres pour obtenir les sous-tâches de manière structurée.

1. Créer un filtre pour tous les problèmes dans un épique spécifique :
   jql
"Epic Link" = PROJECT-00001
   Cela vous permet de récupérer tous les problèmes qui sont liés à l’épopée spécifiée.
2. Créer un filtre pour les sous-tâches sous des problèmes spécifiques :
   jql
issueFunction in subtasksOf("filter = 1234")
   Ici, “filter = 1234” fait référence au filtre créé à l’étape précédente.
3. Combiner les filtres pour obtenir tous les problèmes et sous-tâches :
   jql
filter = 1234 OR filter = 5678
   Cela vous permet d’obtenir à la fois les problèmes et les sous-tâches.

Méthode 2: Vérification des Permissions

Assurez-vous que vous avez les permissions appropriées pour voir les problèmes et sous-tâches. Pour ce faire :

1. Accédez à la section d’administration de votre projet Jira.
2. Vérifiez les permissions sous “Permissions du Projet”.
3. Assurez-vous que votre rôle a accès à la visualisation des sous-tâches.

Méthode 3: Simplification de la Requête JQL

Parfois, la complexité de la requête peut causer des erreurs. Essayez de simplifier votre requête en exécutant des parties séparément pour identifier où l’erreur se produit. Par exemple, exécutez d’abord le filtre pour les épics, puis pour les sous-tâches.

1. Testez chaque partie de votre requête JQL individuellement.
2. Identifiez quel filtre ne retourne pas les résultats escomptés.
3. Apportez les modifications nécessaires à ce filtre.

Conseils de Prévention

Pour éviter de rencontrer l’erreur “JQL query get subtasks under issue in specific epic (Jira Server)” à l’avenir :

• Vérifiez régulièrement vos filtrages JQL pour vous assurer qu’ils sont correctement configurés.
• Formez-vous sur les meilleures pratiques JQL pour optimiser vos requêtes.
• Testez vos requêtes dans un environnement de développement avant de les exécuter en production.
• Consultez la documentation officielle de Jira pour vous tenir informé des mises à jour et des modifications de syntaxe.

Résumé

L’erreur “JQL query get subtasks under issue in specific epic (Jira Server)” peut être résolue en utilisant des filtres JQL appropriés, en vérifiant les permissions et en simplifiant les requêtes. En suivant ces étapes, vous pourrez récupérer efficacement vos sous-tâches liées à un épique spécifique. Si vous continuez à rencontrer des problèmes, envisagez de consulter la documentation de Jira ou de demander de l’aide à votre administrateur Jira.