Importer depuis un tableau de bord Jira
Exportelier peut lire un tableau de bord Jira et en construire un rapport. Vous choisissez un tableau de bord, Exportelier vous dit gadget par gadget ce qu'il a compris, vous complétez ce que Jira n'a pas fourni, et vous obtenez un rapport modifiable ordinaire.
Deux points méritent d'être connus avant de commencer, car ils déterminent tout le reste de cette page.
Exportelier importe la configuration du tableau de bord — quel filtre, quel champ, quel type de graphique — et la reconstruit avec ses propres composants. Le résultat n'est ni une capture d'écran, ni une copie fidèle au pixel, ni une page Jira intégrée. Les largeurs de colonnes, les cadres des gadgets et l'espacement exact ne sont pas reproduits, car l'API publique de Jira ne les expose pas.
Atlassian ne garantit pas que les réglages d'un gadget intégré soient lisibles via une API publique. Lorsqu'un réglage ne l'est pas, Exportelier vous demande de le choisir. Il ne devine jamais quel filtre ou quel champ vous vouliez.
Ce qui peut être importé
| Gadget Jira | Devient | Remarques |
|---|---|---|
| Filter Results | Tableau de tickets | Conserve les colonnes choisies et leur ordre |
| Pie Chart | Graphique de catégories (secteurs) | Utilise le type de statistique du gadget |
| Work Item Statistics | Graphique de catégories (barres) | Utilise le type de statistique du gadget |
| Two Dimensional Filter Statistics | Matrice | Utilise les champs des deux axes |
| Created vs. Resolved Chart | Graphique de séries chronologiques | Conserve la période et l'historique du gadget — voir les limites ci-dessous |
| Sprint Burndown | — | Nécessite des données historiques de sprint qu'Exportelier ne propose pas encore |
| Tout le reste | — | Nommé et exclu, jamais écarté en silence |
Chaque gadget du tableau de bord reçoit exactement un statut :
- Prêt — reconnu, et tout le nécessaire était lisible.
- Réparation requise — reconnu, mais vous devez fournir un réglage manquant.
- Disponible plus tard — reconnu, mais le composant Exportelier correspondant n'existe pas encore. Sprint Burndown est dans ce cas.
- Non pris en charge — un gadget tiers ou inconnu. Il est nommé pour vous, pas masqué.
- Erreur — Jira n'a pas laissé Exportelier le lire, ou ce qui a été lu était contradictoire. Ce statut bloque l'import tant que vous ne l'avez pas corrigé dans Jira.
La reconnaissance repose sur l'identité technique du gadget, jamais sur son titre. Renommer un gadget dans Jira, ou utiliser Jira dans une autre langue, ne change rien à ce qu'Exportelier en fait — et appeler un gadget maison « Pie Chart » n'en fait pas un.
Ce que montre un graphique « créés / résolus »
Un graphique « créés / résolus » importé compte les dates de création et de résolution des tickets que son filtre enregistré renvoie aujourd'hui. Il ne reconstitue pas les tickets que le filtre renvoyait par le passé.
Cela compte lorsque le contenu du filtre a changé. Si un ticket a quitté le projet couvert par le filtre, il disparaît de toutes les périodes du graphique, y compris celles antérieures au déplacement. Le gadget de Jira se comporte de la même façon et pour la même raison, mais mieux vaut le savoir avant de comparer deux exports séparés de plusieurs mois.
Trois autres différences sont possibles, et chacune est nommée dans l'avis d'exhaustivité du rapport lorsqu'elle s'applique :
- Période du rapport. Quotidien, hebdomadaire et mensuel sont reproduits à l'identique. Horaire devient quotidien, trimestriel et annuel deviennent mensuels : les totaux ne changent pas, seule la largeur des périodes diffère.
- La courbe de tendance des non résolus. Jira peut superposer une troisième courbe des tickets ouverts dans le temps. Le graphique d'Exportelier n'affiche que les séries « créés » et « résolus ».
- Historique. Une période de plus de 366 jours est ramenée à 366 jours.
Tout le reste — le filtre, le mode cumulatif, les chiffres eux-mêmes — est repris tel quel, et vous pouvez modifier chacun de ces réglages dans le concepteur ensuite.
L'import
- Ouvrez Rapports et choisissez Importer depuis un tableau de bord Jira.
- Choisissez un tableau de bord. Seuls ceux que Jira vous montre déjà apparaissent ici — être administrateur du site dans Exportelier n'élargit pas la liste.
- Lisez l'analyse. Chaque gadget est listé avec son statut.
- Réparez ce qui doit l'être. Vous choisissez le filtre enregistré et les champs via les sélecteurs habituels ; il n'y a volontairement pas de champ JQL brut.
- Vérifiez l'exhaustivité. Tout ce qui sera laissé de côté est listé par son nom, et vous devez confirmer explicitement les exclusions avant de pouvoir créer le rapport.
- Créez le rapport. Il s'ouvre dans l'éditeur habituel, entièrement modifiable.
Tout ce qui reste marqué Réparation requise ou Erreur bloque la création. Exportelier préfère refuser plutôt que produire un rapport omettant en silence la moitié d'un tableau de bord.
L'avis d'exhaustivité
Tout rapport importé commence par un avis d'exhaustivité — un véritable composant du document, pas une indication dans l'interface. Il nomme le tableau de bord source, la date d'import, combien de gadgets sont inclus et tous ceux qui ne le sont pas, par titre.
C'est une note d'information quand tout a été importé, un avertissement dès que quelque chose a été laissé de côté. Il apparaît en PDF, Word et Markdown.
Tant que le rapport reste lié à son import, Exportelier gère cet avis : vous pouvez réorganiser librement le reste de la mise en page, mais ni le supprimer ni le réécrire. S'il est malgré tout retiré ou modifié, le rapport ne s'exportera pas — un document prétendant représenter un tableau de bord tout en en omettant silencieusement une partie est pire que pas de document du tout.
Si vous voulez un rapport sans cet avis, dupliquez-le. Un duplicata est un rapport ordinaire, sans import derrière lui et sans avis géré.
Suivre l'évolution du tableau de bord
L'import est un instantané de la configuration du tableau de bord. Les données restent vivantes : un rapport relit ses filtres enregistrés au moment de l'export, les chiffres sont donc à jour même des mois après l'import.
Ce qui ne se met pas à jour tout seul, c'est la mise en page et la configuration. Si quelqu'un ajoute un gadget dans Jira, ou en pointe un vers un autre filtre, votre rapport continue exactement comme avant jusqu'à ce que vous en décidiez autrement.
Ouvrez le rapport et utilisez Rechercher les modifications. Exportelier relit le tableau de bord et classe chaque gadget comme ajouté, retiré, déplacé, configuration modifiée ou inchangé. Réimporter applique ensuite le résultat :
- les gadgets inchangés et déplacés gardent ce qu'ils ont ;
- ce que vous avez ajouté au rapport à la main reste intact ;
- les gadgets modifiés et ajoutés reçoivent un contenu neuf ;
- un gadget dont la nouvelle configuration ne peut pas être résolue automatiquement interrompt la réimportation et part en réparation, plutôt que d'écraser votre travail par une supposition ;
- un gadget exclu comme « disponible plus tard » qu'une version plus récente d'Exportelier sait désormais importer apparaît comme modifié, et la réimportation l'ajoute à la fin du rapport. Un rapport existant ne gagne jamais un composant du simple fait qu'une version est sortie — vous devez le demander.
Une version du modèle est enregistrée automatiquement avant chaque réimportation : Restaurer une version l'annule donc.
Il n'y a ni planificateur ni synchronisation en arrière-plan. La réimportation a lieu quand vous la demandez.
Permissions
Importer, réimporter et supprimer un import sont des actions d'administrateur du site.
Chaque lecture de tableau de bord, de gadget et de filtre pendant un import s'exécute en tant que la personne qui le réalise : un administrateur ne peut pas importer un tableau de bord que Jira ne lui montre pas. Les exports ultérieurs relisent les filtres du rapport en tant que la personne qui exporte, l'import n'élargit donc l'accès de personne aux données Jira. Voir Permissions et rôles.
Limites
| Limite | Valeur |
|---|---|
| Gadgets analysés par import | 12 |
| Gadgets proposés à la sélection au-delà de ce plafond | 60 |
Un tableau de bord de plus de douze gadgets n'est pas tronqué. On vous demande quels gadgets importer, et ceux que vous laissez de côté sont nommés dans l'avis d'exhaustivité comme toute autre exclusion.
Un rapport importé est un rapport ordinaire et hérite de toutes les limites de rapport — sources de données, composants, tickets par source. Voir la référence des limites.
À propos de l'API Jira utilisée
Exportelier lit les tableaux de bord uniquement via l' API REST des tableaux de bord Jira Cloud documentée par Atlassian. Il n'analyse pas les pages web de Jira, ne lit pas les iframes des gadgets, ne prend pas de captures d'écran et n'utilise aucun endpoint non documenté.
L'une de ces opérations — Get gadgets, qui liste les gadgets d'un tableau de bord — est marquée Experimental par Atlassian. Atlassian peut donc la modifier sans les garanties de stabilité qui valent pour le reste de l'API. Si elle change d'une manière qu'Exportelier ne reconnaît pas, l'import de tableau de bord se désactive de lui-même et le signale, plutôt que d'importer quelque chose qu'il aurait mal lu. Vos rapports, modèles et exports existants ne sont pas affectés.