Sources de données de filtres enregistrés
Les données d'un rapport proviennent des filtres enregistrés Jira. Vous ajoutez chaque filtre une fois, vous lui donnez un nom, et vous liez des composants à ce nom.
Les filtres enregistrés sont la seule source de données de cette version. Il n'y a pas de JQL libre, pas de source REST, SQL ou CSV, et pas de connecteur tiers.
Ajouter une source
Dans l'éditeur de rapport, Ajouter une source de données liste les filtres enregistrés que Jira vous montre. Choisissez-en un et donnez-lui un nom d'affichage local — « Backlog du support », « Escalades ingénierie » — que vous retrouverez dans le sélecteur de source de l'éditeur.
Vous pouvez aussi saisir directement un identifiant numérique de filtre enregistré. Si Jira est injoignable, le sélecteur le dit au lieu de bloquer l'éditeur.
Un rapport accepte jusqu'à 8 sources de données. Les noms doivent être uniques.
Exportelier stocke un identifiant de filtre, pas une requête
C'est le point le plus important à comprendre au sujet des rapports.
Quand vous ajoutez un filtre enregistré, Exportelier stocke son identifiant numérique et votre nom d'affichage. Rien de plus. Il ne stocke pas :
- le JQL du filtre — il n'est jamais lu, copié, journalisé ni concaténé ;
- les résultats du filtre — aucun instantané des tickets n'est conservé.
Au moment de l'export, Exportelier construit un unique prédicat strictement
numérique, filter = 12345, et demande à Jira la réponse de maintenant.
Trois conséquences en découlent, toutes délibérées :
- Le rapport suit le filtre. Modifiez le filtre enregistré dans Jira et l'export suivant le reflétera. Il n'y a rien à resynchroniser dans Exportelier.
- Les règles de partage Jira du filtre s'appliquent automatiquement. Exportelier ne devient jamais un canal détourné pour les contourner.
- Aucune copie obsolète ne peut fuiter. Un rapport détient une référence, pas des données.
Comme la référence est vivante, modifier un filtre enregistré largement partagé change tous les rapports qui y sont liés — y compris ceux d'autres administrateurs.
Chaque export s'exécute en votre nom
Exportelier lit Jira en tant que la personne qui a lancé l'export, jamais en tant qu'application ni en tant que la personne qui a construit le rapport.
Deux personnes peuvent donc exporter le même rapport le même jour et recevoir légitimement des documents différents. Chacune voit exactement les tickets que ses propres permissions Jira autorisent — ni plus, ni moins. C'est le comportement correct, pas un bug : l'alternative serait une application qui montre à quelqu'un des données que Jira lui refuse.
L'administrateur qui construit le rapport voit les filtres qu'il peut voir. Cela n'élargit jamais ce que reçoit quelqu'un d'autre.
Deux sources, un filtre, une recherche
Si deux sources de données pointent vers le même filtre enregistré, Jira est interrogé une seule fois et le résultat est remis aux deux. Les champs dont les composants ont réellement besoin sont collectés sur l'ensemble du rapport et demandés ensemble, plutôt que de récupérer « tout » ou d'interroger par composant.
Vous pouvez donc ajouter le même filtre deux fois sous des noms différents — pour des composants différents — sans le payer deux fois.
Pré-vérification : ce que l'export va trouver
Avant le lancement d'un export, Exportelier contrôle chaque source et signale l'un de ces états :
| État | Signification | Bloque l'export ? |
|---|---|---|
| Prête | Le filtre a été lu et a trouvé des tickets. | Non |
| Vide | Le filtre ne correspond actuellement à aucun ticket. | Non — un rapport vide est une réponse honnête. |
| Indisponible | Le filtre ne vous est pas accessible. | Oui |
| Limitée par le débit | Jira limite les requêtes ; réessayez sous peu. | Temporairement |
| Erreur | Le filtre n'a pas pu être vérifié. | Temporairement |
La pré-vérification affiche aussi un nombre approximatif de tickets par source et avertit lorsqu'une source sera coupée au plafond par source.
Pourquoi « indisponible » ne dit pas « supprimé »
Jira répond 404 aussi bien pour un filtre qui n'existe plus que pour un
filtre qui existe mais n'est pas partagé avec vous. L'API ne permet pas de
distinguer les deux, donc Exportelier ne devine pas. Affirmer une suppression
qu'il ne peut pas prouver enverrait les gens chercher le mauvais problème ; le
message nomme les deux possibilités et suggère de demander à un administrateur de
partager le filtre.
Une source indisponible arrête l'export
Un rapport dont une source manque n'est pas exporté. La tâche échoue et nomme la source. C'est un choix délibéré : un rapport auquel manque silencieusement une de ses sources de données est matériellement faux et impossible à distinguer d'un rapport complet.
Limites applicables aux sources
- 8 sources de données par rapport, et au plus 8 recherches de filtres distinctes.
- 500 tickets par source, et 2 000 tickets uniques sur l'ensemble du rapport.
- 2 recherches Jira simultanées — les rapports sont des tâches d'arrière-plan, pas des lectures interactives, et partagent le budget de débit Jira du site.
Quand une limite tronque des données, le document final le dit, source par source. Voir la référence des limites.