Sorgenti dati da filtri salvati
I dati di un report provengono dai filtri salvati di Jira. Aggiungi ogni filtro una volta, gli dai un nome e colleghi componenti a quel nome.
I filtri salvati sono l'unica sorgente dati in questa versione. Non esiste JQL libero, né sorgenti REST, SQL o CSV, né connettori di terze parti.
Aggiungere una sorgente
Nell'editor del report, Aggiungi sorgente dati elenca i filtri salvati che Jira mostra a te. Scegline uno e dagli un nome visualizzato locale — «Backlog del supporto», «Escalation di ingegneria» — che è quello che vedrai nel selettore di sorgente del designer.
Puoi anche digitare direttamente un ID numerico di filtro salvato. Se Jira non è raggiungibile, il selettore lo dice invece di bloccare l'editor.
Un report può contenere fino a 8 sorgenti dati. I nomi devono essere univoci.
Exportelier memorizza un ID di filtro, non una query
È la cosa più importante da capire sui report.
Quando aggiungi un filtro salvato, Exportelier memorizza il suo ID numerico e il tuo nome visualizzato. Nient'altro. Non memorizza:
- il JQL del filtro — non viene mai letto, copiato, registrato né concatenato;
- i risultati del filtro — non viene conservata alcuna istantanea dei ticket.
Al momento dell'esportazione, Exportelier costruisce un unico predicato
rigorosamente numerico, filter = 12345, e chiede a Jira la risposta di adesso.
Ne derivano tre conseguenze, tutte volute:
- Il report segue il filtro. Modifica il filtro salvato in Jira e la successiva esportazione lo rifletterà. In Exportelier non c'è nulla da risincronizzare.
- Le regole di condivisione di Jira valgono automaticamente. Exportelier non diventa mai un canale laterale per aggirarle.
- Non esiste una copia obsoleta che possa trapelare. Un report contiene un riferimento, non dati.
Poiché il riferimento è live, modificare un filtro salvato molto condiviso cambia ogni report collegato a esso, compresi quelli di altri amministratori.
Ogni esportazione viene eseguita come te
Exportelier legge Jira come la persona che ha avviato l'esportazione, mai come l'app e mai come chi ha costruito il report.
Due persone possono quindi esportare lo stesso report lo stesso giorno e ricevere legittimamente documenti diversi. Ciascuna vede esattamente i ticket consentiti dai propri permessi Jira: né più, né meno. È il comportamento corretto, non un bug: l'alternativa sarebbe un'app che mostra alle persone dati che Jira nega loro.
L'amministratore che costruisce il report vede i filtri che lui può vedere. Questo non amplia mai ciò che riceve qualcun altro.
Due sorgenti, un filtro, una ricerca
Se due sorgenti dati puntano allo stesso filtro salvato, Jira viene interrogato una sola volta e il risultato viene consegnato a entrambe. I campi di cui i componenti hanno davvero bisogno vengono raccolti sull'intero report e richiesti insieme, anziché richiedere «tutto» o interrogare per componente.
Puoi quindi aggiungere lo stesso filtro due volte con nomi diversi — per componenti diversi — senza pagarlo due volte.
Controllo preliminare: cosa troverà l'esportazione
Prima di avviare un'esportazione, Exportelier verifica ogni sorgente e segnala uno di questi stati:
| Stato | Significato | Blocca l'esportazione? |
|---|---|---|
| Pronta | Il filtro è stato letto e ha trovato ticket. | No |
| Vuota | Il filtro al momento non corrisponde ad alcun ticket. | No — un report vuoto è una risposta veritiera. |
| Non disponibile | Il filtro non è disponibile per te. | Sì |
| Limitata dal rate limit | Jira sta limitando le richieste; riprova a breve. | Temporaneamente |
| Errore | Non è stato possibile verificare il filtro. | Temporaneamente |
Il controllo preliminare mostra anche un conteggio approssimativo per sorgente e avvisa quando una sorgente verrà tagliata al tetto per sorgente.
Perché «non disponibile» non dice «eliminato»
Jira risponde 404 sia per un filtro che non esiste più sia per uno che
esiste ma non è condiviso con te. I due casi non sono distinguibili tramite
l'API, quindi Exportelier non tira a indovinare. Affermare un'eliminazione che
non può dimostrare manderebbe le persone a cercare il problema sbagliato; il
messaggio nomina entrambe le possibilità e suggerisce di chiedere a un
amministratore di condividere il filtro.
Una sorgente non disponibile ferma l'esportazione
Un report con una sorgente mancante non viene esportato. Il lavoro fallisce e nomina la sorgente. È una scelta deliberata: un report a cui manca in silenzio una delle sue sorgenti dati è materialmente falso e indistinguibile da uno completo.
Limiti che valgono per le sorgenti
- 8 sorgenti dati per report e al massimo 8 ricerche di filtro distinte.
- 500 ticket per sorgente e 2.000 ticket univoci nell'intero report.
- 2 ricerche Jira in parallelo — i report sono lavori in background, non letture interattive, e condividono il budget di rate limit Jira del sito.
Quando un limite tronca i dati, il documento finale lo dichiara, per sorgente. Vedi il riferimento dei limiti.