Écritures vers Jira

Une écriture inscrit dans Jira des valeurs tirées d'une hiérarchie : par exemple, copier le total des points de story de chaque epic dans l'un de ses champs, ou faire passer un parent à Terminé quand tous ses enfants le sont. Elle ne s'exécute que lorsque quelqu'un la lance, montre d'abord ce qu'elle va changer et peut être annulée.

Qui peut faire quoi

Le panneau Écritures est ouvert aux personnes ayant l'accès Modifier : elles peuvent exécuter les écritures et consulter leurs exécutions et leurs modifications. Pour configurer, modifier ou supprimer une écriture, il faut l'accès Automatiser. Les administrateurs Jira peuvent restreindre ces deux droits sur tout le site dans Droits d'automatisation.

L'application effectue chaque modification au nom de la personne qui lance l'écriture. Jira applique donc ses permissions, ses écrans, ses validateurs et ses workflows. Une écriture ne permet jamais à quiconque de modifier un ticket qu'il ne pourrait pas modifier dans Jira.

Configurer une écriture

Ouvrez Panneaux et choisissez Écritures. Sélectionnez Ajouter une écriture, puis choisissez un type.

Définir un champ

Un champ ne peut être copié que dans un champ qui contient le même genre de valeur. Une valeur fixe sans aucune valeur choisie vide le champ. Une estimation se saisit en heures.

Statut des parents selon leurs enfants

Pour chaque ticket qui a des tickets en dessous de lui dans la hiérarchie, le premier cas auquel ses enfants correspondent donne le statut vers lequel le faire passer :

• Quand chaque enfant est terminé
• Quand certains enfants ont commencé
• Quand aucun enfant n'a commencé

Chaque parent suit son propre workflow. Un parent sans transition vers ce statut apparaît dans l'aperçu et reste tel quel.

Ajouter un commentaire

Ce type ajoute le même commentaire, en votre nom, à chaque ticket concerné. L'annulation ne retire que les commentaires que personne n'a modifiés depuis.

Décaler des dates

Ce type déplace d'un à cinq champs de date ou de date et heure d'un nombre entier de Jours, de Jours ouvrés ou de Semaines. Un nombre négatif avance les dates. Les champs de date et heure gardent leur heure. Les jours ouvrés suivent le calendrier de travail du site : les fins de semaine et les jours fériés sont sautés.

Champs qu'une écriture peut définir

Responsable, priorité, résumé, description, environnement, résolution, échéance, rapporteur, étiquettes, composants, versions corrigées, versions affectées, sprint, estimations initiale et restante, ainsi que les champs personnalisés des types courants : texte, texte enrichi, nombre, date, date et heure, choix unique et choix multiple, choix en cascade, utilisateur, groupe, version, projet, étiquettes, objets Assets et équipes. Le statut ne change que par l'écriture du statut des parents.

Pour un champ Équipe ou Objets Assets, les valeurs proposées viennent des tickets affichés. Si aucun d'eux n'a encore de valeur dans ce champ, définissez-en d'abord une sur un ticket, ou copiez la valeur d'un autre champ.

Exécuter une écriture

Sélectionnez Aperçu sur une écriture. L'application lit en votre nom ce que contient actuellement chaque ticket et liste toutes les modifications qu'elle ferait, sous la forme ancienne valeur → nouvelle valeur. La liste omet les tickets qui ont déjà la valeur et ceux que vous ne pouvez pas voir. Un ticket qui apparaît plusieurs fois dans la hiérarchie n'est modifié qu'une fois.

Décochez les modifications dont vous ne voulez pas, puis sélectionnez Appliquer. L'application effectue les modifications une à une :

• Si Jira refuse une modification, l'application la consigne avec la raison donnée par Jira, et l'exécution continue.
• Avant chaque lot, l'application relit Jira. Si une valeur a changé depuis l'aperçu, l'application n'y touche pas.
• Arrêter met fin à l'exécution entre deux modifications.

Gardez la page ouverte pendant une exécution. Celle-ci se déroule dans votre navigateur, car Jira n'applique vos propres permissions qu'aux modifications faites en votre nom. Une exécution effectue au plus 2 000 modifications. Une exécution laissée inachevée est marquée comme arrêtée au bout de 30 minutes.

Une écriture s'exécute sur les lignes telles qu'elles sont affichées. Pour l'exécuter sur une partie de l'arbre, filtrez d'abord la vue avec une transformation ou une requête d'arbre.

Tout exécuter

Tout exécuter prévisualise toutes les écritures de la hiérarchie, dans leur ordre, en un seul aperçu qui comporte une section par écriture. Quand plusieurs écritures modifieraient le même champ d'un ticket, l'aperçu signale les deux modifications. Appliquer les exécute ensuite l'une après l'autre, chacune comme une exécution distincte. Si une écriture précédente du même lancement a changé une valeur, l'application la traite comme n'importe quel autre changement survenu depuis l'aperçu et n'y touche pas.

Exécutions et annulation

Exécutions liste chaque exécution avec la personne qui l'a lancée, le moment, son statut (En cours, Terminée, Terminée en partie, Échouée, Annulée ou Arrêtée) et le nombre de modifications faites, refusées ou laissées. Modifications sert de piste d'audit : on y trouve chaque modification d'une exécution, avec la valeur avant et après, pour les tickets que vous pouvez voir.

Annuler rétablit les valeurs qu'une exécution a changées, en commençant par les plus récentes, là où personne ne les a changées depuis. Les valeurs modifiées depuis restent telles quelles et sont comptées. Seule la personne qui a lancé l'exécution, ou une personne qui peut modifier les règles, peut l'annuler, et une seule fois. Une annulation est elle-même consignée comme une exécution.

Tester avant d'exécuter

Ajoutez la colonne Essai d'une réécriture… pour voir, sur chaque ligne, la valeur qu'une écriture définirait, sans rien écrire. Voir Essai.

Une hiérarchie peut compter jusqu'à 20 écritures. Supprimer une hiérarchie supprime ses écritures et leur historique.

Transformer des éléments de planification en tickets

Pour convertir des éléments de planification, des dossiers et des mémos en tickets Jira, sélectionnez-les et utilisez Convertir en ticket. Voir Transformer des éléments en tickets.

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