Générateur de rapports
La plupart des exports Exportelier partent de ce que vous avez sous les yeux : un ticket, un tableau, un sprint. Un rapport fonctionne à l'inverse : c'est un objet enregistré qui nomme ses propres données. Vous le construisez une fois, et quiconque a le droit de l'exporter obtient les chiffres du moment.
Un rapport, c'est exactement deux choses :
- Un modèle — un modèle de l’éditeur visuel. Il n'y a pas de « modèle de rapport » distinct ni de second éditeur.
- Une ou plusieurs sources de données nommées — chacune un filtre enregistré Jira.
Les composants du modèle sont ensuite liés à une source par son nom, si bien qu'un même rapport peut afficher « Backlog du support » à côté d'« Escalades ingénierie » dans le même document.
Special Reports : rapports enregistrés dans l’onglet Dashboard.
Partir d'un tableau de bord Jira
Vous pouvez construire un rapport de zéro — choisir les filtres, poser les composants de rapport, lier chacun d'eux — ou partir d'un tableau de bord Jira que vous avez déjà.
Importer depuis un tableau de bord Jira lit la configuration du tableau de bord et en construit un rapport ordinaire. Il importe ce qu'un gadget est configuré pour afficher, pas une image de celui-ci, et le résultat ne reste pas synchronisé ensuite : les données des filtres restent vivantes, mais la mise en page et la configuration ne changent que lorsque vous réimportez explicitement.
Où vivent les rapports
Les rapports ont leur propre page dans l'Export Center, à côté de vos vues d'export. La liste affiche le nom, la description, le nombre de sources de données, le modèle, la portée, la dernière mise à jour et si le rapport est disponible à l'export.
Toute personne qui peut utiliser Exportelier voit la liste. Ce que vous pouvez y faire dépend de votre rôle.
Qui peut faire quoi
| Action | Administrateur du site | Tout utilisateur Jira authentifié |
|---|---|---|
| Voir la liste des rapports | ✅ | ✅ |
| Exporter un rapport activé | ✅ | ✅ |
| Créer, modifier, dupliquer, supprimer un rapport | ✅ | — |
| Ouvrir l'éditeur du rapport | ✅ | — |
| Ajouter ou modifier des sources de données | ✅ | — |
Les actions d'administration ne sont pas seulement masquées aux non-admins : le serveur les refuse, appeler l'API directement n'y change rien.
Un administrateur du site peut construire un rapport à partir de n'importe quel filtre qu'il voit. Cela n'accorde l'accès à personne d'autre. Chaque export relit Jira en tant que la personne qui exporte — voir résultats par utilisateur.
Construire un rapport
L'éditeur de rapport comporte quatre parties, dans l'ordre d'utilisation :
- Détails du rapport — nom, description, portée et activation pour l'export.
- Sources de données — ajoutez chaque filtre enregistré et donnez-lui un nom parlant dans votre organisation. Voir Sources de données de filtres enregistrés.
- Éditeur — l'éditeur visuel habituel. Chaque composant de données gagne un sélecteur de source listant vos sources nommées.
- Aperçu et export — vérifiez la liaison, puis exportez.
Un rapport ne peut pas être enregistré tant qu'un composant n'a pas de source de données valide. L'éditeur nomme les composants concernés au lieu de les lier silencieusement à la première source venue.
Une source qu'aucun composant n'utilise est autorisée — vous préparez peut-être une liaison — mais l'éditeur le signale, et l'export final aussi.
Partir du modèle fourni
Nouveau rapport à partir de Dashboard Report Standard est la voie la plus rapide. Il copie le modèle système fourni en un modèle modifiable, demande au moins un filtre enregistré, puis demande quelle source de données alimente chacun des trois graphiques standard.
Avec un seul filtre, la réponse est pré-remplie. Avec plusieurs, rien n'est deviné : le rapport ne peut être créé tant que chaque graphique n'est pas affecté, car un graphique mal lié produit un rapport qui a l'air juste et ne l'est pas.
Le modèle système lui-même n'est jamais modifié.
Exporter un rapport
Les exports de rapports s'exécutent toujours en arrière-plan, car lire plusieurs filtres et rendre un document ne tient pas dans une requête interactive.
Avant le lancement, une pré-vérification contrôle chaque source de données et montre ce qu'elle a trouvé — prête, vide ou indisponible, avec une estimation du nombre de tickets et un avertissement quand une source atteindra le plafond par source. Vous choisissez ensuite PDF, Word (DOCX) ou Markdown et lancez l'export.
Pendant l'exécution, vous voyez des phases honnêtes — planification, lecture des filtres Jira, rendu, préparation du téléchargement — et vous pouvez annuler à tout moment. Les exports de rapports apparaissent dans Exports actifs à côté des exports ordinaires, chacun étiqueté du nom de son rapport, et une liste Vos exports de rapports récents permet de rouvrir une tâche après avoir fermé la boîte de dialogue.
Le document final rend compte de ce qu'il contenait réellement : combien de tickets chaque source a fournis, où une limite l'a tronqué, et quelles sources le rapport définit sans qu'aucun composant ne les utilise.
Si l'un des filtres enregistrés du rapport ne vous est pas accessible, l'export échoue et nomme cette source. Il ne rend pas silencieusement un rapport plus petit — un document auquel manque une source de données ressemble exactement à un document complet.
Limites
Les rapports ont leurs propres plafonds : sources par rapport, tickets par source, lignes par tableau, etc. Chacun est appliqué côté serveur et nommé dans la sortie lorsqu'il tronque effectivement quelque chose. Voir la référence des limites.