Requêtes d'arbre et recherche

Une requête d'arbre retient des lignes selon leur place dans une hiérarchie. Cette page présente le langage, le mode requête, la recherche des tickets d'une hiérarchie dans Jira et les règles de workflow qui s'appuient sur cette recherche.

Le langage des requêtes d'arbre

Une requête d'arbre combine des conditions sur le type d'une ligne, sa position et son contenu. Elle ne tient pas compte de la casse.

Combinez les conditions avec not, and et or, qui ont priorité dans cet ordre, et regroupez-les avec des parenthèses. Une relation s'applique à la condition qui la suit immédiatement. Le texte se met entre guillemets doubles ou simples, avec \ pour échapper un guillemet.

Exemples :

Une requête compte au plus 2 000 caractères et 5 conditions JQL, et son imbrication ne dépasse pas 32 niveaux (parenthèses, relations et not comptent chacun pour un niveau). Quand une requête ne peut pas être lue, le message indique ce qui était attendu et à quel endroit. Jira vérifie d'abord chaque partie JQL de façon stricte : un champ mal orthographié produit une erreur plutôt qu'un résultat vide.

Où utiliser les requêtes d'arbre

• Chercher des lignes : choisissez Requête d'arbre à côté de la zone de recherche. Les correspondances se mettent à jour pendant la saisie. Voir Chercher des lignes.
• Transformations : Garder les lignes correspondant à une requête d'arbre garde les correspondances et les lignes au-dessus d'elles. Voir Transformations.
• Colonnes : Répond à une requête… affiche Oui ou Non pour chaque ligne.
• Formules : TQL{leaves} est vrai sur les lignes qui correspondent. Voir Formules.
• Mode requête, recherche Jira et règles de workflow, plus bas.

Mode requête

Rechercher des tickets, dans la liste à gauche de la page de l'application, ouvre une hiérarchie temporaire à partir d'une requête. Rien n'est enregistré. Choisissez où chercher avec Chercher dans :

• Jira : tapez du texte, des clés de tickets ou du JQL. Des clés donnent la liste de ces tickets, une requête JQL est utilisée telle quelle, et les autres mots sont cherchés comme du texte. Si la zone est vide, vous voyez les tickets consultés récemment. Cochez Avec les tickets enfants pour ajouter leurs enfants.
• Une hiérarchie : choisissez une hiérarchie et tapez une requête d'arbre. Les lignes qui correspondent s'ouvrent avec les lignes au-dessus d'elles.

Sélectionnez Afficher pour lancer la recherche. Le résultat montre ses 500 premières lignes et en lit 500 de plus chaque fois que vous approchez de la fin. Les colonnes, les vues, les transformations, l'exportation et l'impression y fonctionnent toutes.

Enregistrer comme hiérarchie… conserve une recherche Jira sous la forme d'une nouvelle hiérarchie faite de règles, qui reste ainsi à jour. Le résultat d'une requête d'arbre ne peut pas être enregistré ainsi, car une requête d'arbre n'est pas une règle. Ouvrez plutôt la hiérarchie et utilisez Chercher des lignes ou une transformation par requête d'arbre.

Trouver les tickets d'une hiérarchie dans la recherche Jira

Les personnes ayant l'accès Contrôler peuvent activer Trouver ses tickets dans la recherche Jira dans l'onglet Recherche Jira des paramètres de la hiérarchie. Ses tickets se trouvent alors partout où Jira accepte du JQL, y compris la recherche de tickets, les filtres, les tableaux et les tableaux de bord :

issue in treecraftHierarchy(42)
issue in treecraftHierarchy("Product roadmap")
issue not in treecraftHierarchy(42)

Les paramètres affichent la recherche par numéro de hiérarchie, qui continue de fonctionner après un changement de nom. La recherche par nom fonctionne tant que le nom est unique. La recherche trouve les tickets que contient la hiérarchie, qu'ils y aient été placés à la main ou par ses règles.

Un second argument, une requête d'arbre, limite la recherche à une partie de l'arbre :

issue in treecraftHierarchy(42, "children of key = PLAN-1")

Dans la recherche Jira, une requête d'arbre ne peut utiliser que des positions dans l'arbre et des clés de tickets : les types, top, leaves, level, row, key et les relations. La recherche Jira refuse les conditions jql et text. Une requête d'arbre nomme au plus 50 clés de tickets, et une hiérarchie garde au plus 10 requêtes d'arbre différentes pour la recherche. Les personnes ayant l'accès Contrôler voient, dans le même onglet, les requêtes d'arbre utilisées dans les recherches et peuvent effacer n'importe laquelle. Un filtre enregistré qui utilisait une requête effacée indique alors qu'elle a été effacée.

Jira garde les résultats de recherche pendant un certain temps : une modification de la hiérarchie peut mettre quelques minutes à apparaître dans la recherche. Une requête d'arbre utilisée pour la première fois ne trouve rien tant que ses tickets n'ont pas été calculés, ce qui prend généralement moins d'une minute.

Ce que l'activation de la recherche révèle

Toute personne qui peut faire des recherches dans Jira peut utiliser cette recherche, même sans pouvoir ouvrir la hiérarchie. Jira ne lui montre toujours que les tickets qu'elle peut parcourir, mais elle peut savoir que ces tickets se trouvent dans la hiérarchie et où ils s'y trouvent, et elle peut tester, avec une requête d'arbre, des clés de tickets qu'elle devine. Elle ne voit jamais le détail des tickets qu'elle ne peut pas parcourir. C'est pourquoi la recherche reste désactivée tant qu'une personne ayant l'accès Contrôler ne l'active pas, et les paramètres le signalent au moment de l'activer.

Dépannage des requêtes

Quand une recherche trouve moins que prévu, ouvrez Aide et sélectionnez Dépannage des requêtes. Choisissez la hiérarchie, tapez la requête d'arbre s'il y en a une, puis sélectionnez Vérifier. La page vous indique :

• la recherche à taper dans Jira ;
• si la recherche est activée pour la hiérarchie, et si la requête d'arbre se lit correctement, avec l'endroit où elle bloque sinon ;
• si la recherche Jira a déjà utilisé cette requête d'arbre ou si elle est nouvelle ;
• le JQL et les clés de tickets qu'utilise la requête.

L'essayer dans Jira demande à Jira, en votre nom, combien de tickets il trouve. Toute personne qui peut consulter la hiérarchie peut utiliser cette page. Les administrateurs Jira et les administrateurs de l'application voient aussi où en est l'index de recherche : combien de tickets contient la hiérarchie, combien la recherche Jira en trouve actuellement, et combien restent à ajouter ou à retirer.

Condition et validateur de workflow

Les administrateurs Jira peuvent utiliser une hiérarchie dans un workflow. Les deux règles s'appellent Le ticket est dans une hiérarchie dans l'éditeur de workflow de Jira :

• La condition n'affiche une transition que pour les tickets qui sont, ou ne sont pas, dans la hiérarchie choisie. Elle se contente de masquer la transition.
• Le validateur refuse la transition pour les tickets qui ne correspondent pas et affiche un message qui le dit. Ajoutez-le quand vous voulez faire respecter la règle.

Seules les hiérarchies dont la recherche Jira est activée peuvent être choisies. Une requête d'arbre facultative limite la règle à une partie de la hiérarchie, avec les mêmes restrictions que dans la recherche Jira : positions et clés seulement, et au plus 50 clés. Tant que la recherche d'une hiérarchie est désactivée, aucun ticket n'est considéré comme s'y trouvant. Si une personne ayant l'accès Contrôler efface une requête d'arbre utilisée par une règle de workflow, le validateur refuse la transition concernée jusqu'à ce qu'un administrateur Jira configure la règle de nouveau. Les paramètres de la hiérarchie signalent ces requêtes par la mention Utilisée par une règle de workflow.

Des questions sur l’application? Écrivez à info@plugincraft.ca.