Règles
Les règles construisent une partie d'un arbre à partir des données de Jira et la tiennent à jour. Une hiérarchie peut mêler des lignes placées par des règles et des lignes que vous avez placées à la main.
Dans cette page
Fonctionnement des règles
Une règle est une ligne de l'arbre et s'applique là où elle se trouve : une règle au premier niveau agit sur toute la hiérarchie, et une règle placée sous une ligne n'agit que sur ce qui se trouve sous cette ligne. Les règles s'exécutent dans l'ordre de la liste. Une règle d'ajout doit donc précéder les règles qui étendent, filtrent, regroupent ou trient ce qu'elle a ajouté.
L'application calcule les résultats des règles en arrière-plan et les actualise quand des tickets changent dans Jira. Quand un nouveau ticket répond à une règle, ou qu'un ticket est déplacé dans Jira, il apparaît à sa place peu après. Chaque personne qui ouvre la hiérarchie ne voit que les tickets que Jira l'autorise à voir.
Pour modifier les règles, il vous faut l'accès Automatiser à la hiérarchie. Votre administrateur Jira peut aussi limiter, pour tout le site, les personnes autorisées à modifier les règles, dans Droits d'automatisation.
Le panneau Règles
Ouvrez Panneaux dans l'en-tête de la hiérarchie et choisissez Règles. Si la hiérarchie a des règles, le menu indique leur nombre, par exemple Règles (3).
Le panneau liste les règles dans l'ordre, chacune avec Modifier et Retirer. En haut, une ligne indique si les résultats sont à jour ou en cours de mise à jour, et Actualiser les résultats les reconstruit à la demande.
Pour ajouter une règle, sélectionnez Ajouter une règle, choisissez le Type de règle et remplissez ses champs. Les nouvelles règles se placent au premier niveau. Pour en placer une sous une ligne, rendez d'abord cette ligne active, puis cochez Appliquer sous « … » seulement. Une règle ne peut pas se placer dans les résultats d'autres règles.
Types de règles
Ajouter des tickets
| Règle | Ce qu'elle ajoute | Options |
|---|---|---|
| Ajouter des tickets par JQL | Les tickets trouvés par une requête JQL. | Nombre maximal de tickets, jusqu'à la limite du site. |
| Ajouter les tickets d'un tableau | Les tickets d'un tableau. | Tickets : tout le tableau, ceux des sprints actifs et futurs, ceux du backlog, ou les epics. Un tableau Kanban n'a ni sprints ni backlog. |
| Ajouter des tickets trouvés par texte | Les tickets qui contiennent ces mots dans un champ texte (résumé, description, commentaires), tels que les trouve la recherche de Jira. | Mots, Nombre maximal de tickets. |
| Ajouter une autre hiérarchie | Les tickets d'une autre hiérarchie, disposés comme dans celle-ci. Ses dossiers sont laissés de côté. | Seules les personnes autorisées à ouvrir cette hiérarchie voient ses tickets. Une hiérarchie ne peut pas se contenir elle-même. |
Une requête dont le résultat dépend de la personne qui l'exécute, par exemple une requête avec currentUser() ou sur les tickets consultés récemment, est calculée pour chaque personne à l'ouverture de la hiérarchie. C'est plus lent, et le formulaire vous en avertit.
Ajouter des tickets apparentés
| Règle | Ce qu'elle ajoute | Options |
|---|---|---|
| Ajouter les tickets enfants | Les enfants de chaque ticket : les sous-tâches, les tickets de chaque epic et les enfants à tous les niveaux du champ parent de Jira. | Niveaux : le nombre de niveaux à descendre. |
| Ajouter les tickets liés | Les tickets liés à chaque ticket par un type de lien. | Type de lien, Sens (sortant, entrant ou les deux), Niveaux. |
Filtrer, regrouper et trier
| Règle | Ce qu'elle fait | Options |
|---|---|---|
| Garder les tickets qui répondent au JQL | Ne garde que les tickets qui répondent à la requête. | Garder les parents des tickets qui répondent. |
| Garder les tickets contenant un texte | Ne garde que les tickets qui contiennent le texte. | Garder les parents des tickets qui répondent. |
| Grouper par champ | Place les tickets sous une ligne pour chaque valeur d'un champ : projet, version corrigée, responsable, statut, sprint, composant, étiquette, option de champ personnalisé, objet Assets, etc. | Mêmes noms ensemble, par exemple pour les versions qui portent le même nom dans plusieurs projets. |
| Grouper par ticket lié | Place chaque ticket sous le premier ticket auquel il est lié par un type de lien. Chaque groupe porte la clé de ce ticket. | Type de lien, Sens. |
| Trier par champ | Trie les tickets selon n'importe quel champ, ou selon le rang du tableau. | Décroissant. |
Les règles ne filtrent que par JQL et par texte. Les autres filtres, par exemple selon la valeur d'un champ, le sprint ou une requête d'arbre, sont des transformations, qui ne modifient que votre propre vue. Pour trier ou regrouper selon une colonne comme une formule ou un total, utilisez le menu d'en-tête de cette colonne.
Limites et avis
Les administrateurs du site fixent la taille maximale des résultats des règles : le nombre de lignes d'une hiérarchie, le nombre de tickets qu'une règle peut ajouter, le niveau le plus profond que les règles peuvent remplir, et le nombre de niveaux qu'une règle d'ajout d'enfants ou de liens peut ajouter. Une hiérarchie contient au plus 2 500 tickets et exécute au plus 30 règles. Parmi elles, au plus 5 peuvent être des règles qui lisent chaque ligne atteinte : Garder les tickets contenant un texte, Grouper par champ, Grouper par ticket lié et Trier par champ. Une règle au-delà de l'un ou l'autre plafond ne s'exécute pas et l'indique.
Quand une règle atteint une limite, l'application conserve ce qu'elle a déjà construit, et un avis à côté du nombre de lignes nomme la limite, par exemple « certains résultats des règles ont été laissés de côté (limite de lignes atteinte) ». Les avis de la limite de 2 500 tickets et de la limite de temps s'affichent pour tout le monde. Un avis de limite de lignes, de tickets par règle, de profondeur ou de niveaux n'apparaît qu'aux personnes qui peuvent voir au moins un des tickets laissés de côté. Le panneau Règles signale la règle qui s'est arrêtée. Les administrateurs peuvent relever les limites dans Limites des règles.
Déplacer des lignes placées par des règles
Les lignes placées par des règles proviennent des données de Jira : vous ne pouvez donc pas les déplacer librement. Quand vous en déplacez une, l'application modifie ces données dans Jira en votre nom, puis les règles affichent le ticket à sa nouvelle place :
- Monter ou descendre un ticket parmi ses voisins modifie son rang dans Jira. Une liste triée selon un autre champ garde cet ordre.
- Déplacer un ticket vers un autre groupe du même regroupement définit le champ de regroupement. Un statut change par la transition du workflow qui y mène, et un sprint par les actions de sprint et de backlog de Jira.
- Déplacer un ticket sous un autre ticket change son parent, ou son lien, pour qu'il soit placé comme les autres tickets à cet endroit.
L'application vérifie le déplacement avant de modifier quoi que ce soit, et refuse ceux qu'elle ne peut pas mener à bien proprement, par exemple un déplacement entre des groupes formés par nom ou par ticket lié, ou un déplacement qui changerait un champ comme le type de ticket ou le projet. Pour un lien, l'application crée le nouveau lien avant de retirer l'ancien. Une ligne sous la barre d'outils indique ce qui a changé dans Jira et nomme les tickets que Jira a refusés, avec la raison.
Les lignes placées à la main et les lignes placées par des règles ne peuvent pas être déplacées ensemble.
Modifications dans le résultat des règles
Les personnes ayant le niveau Contrôler sur une hiérarchie peuvent permettre aux personnes ayant le niveau Modifier d'ajuster ce que les règles ont placé. Le paramètre s'appelle Permettre aux personnes ayant Modifier de changer à la main le résultat des règles et se trouve dans l'onglet Accès des paramètres de la hiérarchie. Quand il est activé, vous pouvez :
- déplacer des lignes placées par les règles parmi leurs voisines, sans changer leur rang dans Jira (marquées ↕) ;
- masquer des tickets placés par les règles ;
- placer vos propres lignes, par exemple des dossiers ou d'autres tickets, sous les lignes placées par les règles.
Rien de tout cela ne modifie Jira. Le bouton Dans le résultat des règles de la barre d'outils indique le nombre de modifications et ouvre un panneau qui les liste. Vous pouvez y afficher de nouveau les tickets masqués, choisir Effacer mes modifications, ou Effacer toutes les modifications…, quelle que soit la personne qui les a faites. Si vous désactivez le paramètre, les modifications sont conservées, mais restent sans effet jusqu'à ce que vous le réactiviez.
Une ligne placée à la main dont la ligne de règle n'existe plus s'affiche au premier niveau, marquée ⇡.
Préréglages de règles
Un préréglage est un ensemble de règles enregistré que vous pouvez appliquer en une seule étape à un autre endroit, dans la même hiérarchie ou dans une autre. Au bas du panneau Règles, Enregistrer les règles comme préréglage… conserve les règles du premier niveau, ou celles qui se trouvent sous la ligne active. Cochez Partager avec tout le monde pour que d'autres personnes puissent l'utiliser. Elles voient les règles, mais rien d'autre de votre hiérarchie.
Pour utiliser un préréglage, choisissez-le sous Préréglages et sélectionnez Appliquer le préréglage. Ses règles passent les mêmes vérifications que les règles ajoutées à la main. Une règle qui ne convient plus au site, par exemple parce qu'elle mentionne un champ supprimé, est laissée de côté avec une note.
L'agent Rovo peut aussi proposer des règles à partir d'une description en langage courant.
Des questions sur l’application? Écrivez à info@plugincraft.ca.