Conventions de nommage

Une convention de nommage est facultative et c'est vous qui la faites : elle dit comment écrire les noms de vos filtres et de vos tableaux de bord (et, dans Tableaux et sprints, de vos sprints). Un administrateur Jira la définit, et TuneCraft montre combien de noms la suivent, suggère un nouveau nom pour les autres et en renomme plusieurs à la fois.

Où le trouver

Définir une convention

Rien n'est signalé tant que vous n'en enregistrez pas une. Enregistrer ou supprimer une convention ne change que TuneCraft.

Étape 1 : ouvrir la convention

Ouvrez Convention de nommage et choisissez Définir une convention. Pour la changer plus tard, choisissez Modifier la convention.

Étape 2 : choisir comment l'écrire

Sous L'écrire avec, choisissez Des blocs ou Une expression régulière (avancé).

Étape 3 : l'écrire

Avec des blocs, utilisez les boutons Ajouter (clé d'espace, mot d'équipe, texte libre, date et séparateur) ou saisissez-la, avec un séparateur ou un texte fixe entre deux blocs. Chaque bloc peut servir une fois, et la convention peut avoir 120 caractères au plus.

• {Space} est une clé d'espace : une majuscule, puis des majuscules, des chiffres ou des tirets bas, 2 à 10 caractères, comme ABC.
• {Team} est un mot : des lettres, des chiffres ou des tirets bas.
• {Text} est un texte quelconque qui ne commence ni ne finit par une espace.
• {Date} est une date écrite AAAA-MM-JJ. {Date:YYYY-MM} et {Date:YYYY} en écrivent moins ; {Date:YYYYMMDD} et {Date:YYYYMM} n'ont pas de tirets.

Avec une expression régulière, le nom entier doit correspondre, en 160 caractères au plus. Une répétition dans une répétition, comme (a+)+, et les références arrière ne sont pas acceptées, et un test avec limite de temps s'exécute dans votre navigateur avant l'enregistrement.

Étape 4 : lire l'aperçu

Aperçu sur vos noms utilise vos propres noms, lus dans Jira en votre nom et jamais conservés. L'utiliser reprend la forme que la plupart de vos noms ont déjà en commun.

Étape 5 : l'enregistrer

Choisissez Enregistrer la convention. Supprimer la convention l'efface.

Astuce : Sur les sites avec Rovo, Demander à Rovo vous aide à écrire une convention à partir d'une phrase simple. TuneCraft la vérifie comme la vôtre, et n'enregistre rien tant que vous ne le faites pas.

Trouver les noms qui ne la suivent pas

Étape 1 : lire les noms

Choisissez Lire les noms. TuneCraft lit 50 noms par requête, en votre nom, à environ 51 points Jira la requête (estimé), et s'arrête après 1 000 noms pour que le reste du travail garde ses points. Poursuivre la lecture continue, jusqu'à 5 000 noms. Les noms sont affichés ici et jamais conservés. Jira liste les tableaux de bord dont vous êtes propriétaire et ceux qui sont partagés avec vous ; les autres ne sont pas listés.

Étape 2 : choisir quoi afficher

Utilisez Afficher pour voir Noms qui ne suivent pas, Les vôtres qui ne la suivent pas, Noms qui suivent ou Tous les noms.

Étape 3 : compléter les parties manquantes

Sous Compléter ce qu'un nom ne donne pas, saisissez une Clé de l'espace, un Mot d'équipe ou une Date pour les suggestions. Ces valeurs servent uniquement sur cette page et rien n'est conservé.

Renommer des noms

Jira ne laisse que le propriétaire renommer un filtre ou un tableau de bord. Les noms dont vous n'êtes pas propriétaire sont listés et laissés tels quels.

Étape 1 : choisir les noms

Cochez jusqu'à 25 noms et vérifiez chaque Nouveau nom. TuneCraft signale un nouveau nom vide, trop long, identique au nom actuel, ou donné à deux noms choisis.

Étape 2 : choisir Renommer N filtres

Pour des tableaux de bord, choisissez Renommer N tableaux de bord. Un panneau liste chaque renommage.

Étape 3 : lire la liste et cocher la case

Téléchargez le fichier d'archive. Pour des filtres, si le panneau montre une case qui dit que vous comprenez quels filtres et flux peuvent cesser de correspondre (il le fait quand un filtre ou un flux écrit l'un de ces filtres par son nom, ou quand TuneCraft ne peut pas tous les voir), cochez-la.

Étape 4 : confirmer

La fenêtre nomme le site et, hors production, l'environnement. TuneCraft renomme dans Jira en votre nom, et renvoie chaque description, chaque JQL et chaque partage tel qu'il était. Le résultat dit, pour chaque nom, renommé ou laissé, et pourquoi.

• Un nom changé depuis votre lecture est laissé tel quel.
• Jira peut refuser un nom déjà utilisé, ou un filtre dont il n'accepte plus le JQL : réparez d'abord le JQL, dans Filtres et tableaux de bord.
• Un tableau de bord est renommé après que TuneCraft l'a lu et a renvoyé sa description, sa liste de partage et sa liste de modification. Un tableau de bord partagé avec n'importe qui sur le web, ou avec un partage que TuneCraft ne peut pas renvoyer, est laissé intact, et sa ligne le dit.

Important : Un filtre écrit par son nom dans le JQL d'un autre filtre (filter = "Nom") ou dans un flux cesse de correspondre après un renommage. TuneCraft liste les filtres de sa dernière lecture et les flux de sa dernière analyse qui l'écrivent par son nom, autant qu'il a pu les lire, et vous demande de cocher une case quand il ne peut pas tout voir.

Remarque : Un filtre utilisé par son numéro, par exemple dans des tableaux, des tableaux de bord et des abonnements, devrait continuer à fonctionner après un renommage, mais cela n'a pas encore été vérifié sur un site d'essai.

Ce que cela change dans Jira et comment l'annuler

Pour annuler, ouvrez Modifications, choisissez Annuler, puis le fichier d'archive que vous avez téléchargé : il contient les noms d'avant, et TuneCraft ne garde qu'un code pour vérifier le fichier. Seul le propriétaire d'un objet peut lui rendre son nom : un objet dont vous n'êtes pas propriétaire est laissé tel quel, et son propriétaire peut annuler depuis Modifications. Un objet dont le nom a de nouveau changé depuis est laissé aussi.

Pages liées

• Filtres et tableaux de bord : les pages où se définit une convention, et Réparer.
• Tableaux et sprints : la convention des noms de sprints.

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