Generatore di report
La maggior parte delle esportazioni di Exportelier parte da qualcosa che stai già guardando: un ticket, una bacheca, uno sprint. Un report funziona al contrario: è un oggetto salvato che nomina i propri dati. Lo costruisci una volta, e chiunque abbia il permesso di esportarlo ottiene i numeri attuali.
Un report è esattamente due cose:
- Un modello — un normale modello del designer. Non esiste un «modello di report» separato né un secondo designer.
- Una o più sorgenti dati con nome — ciascuna un filtro salvato di Jira.
I componenti del modello vengono poi collegati a una sorgente per nome, così che un solo report possa mostrare «Backlog del supporto» accanto a «Escalation di ingegneria» nello stesso documento.
Special Reports: report salvati nella scheda Dashboard.
Partire da una dashboard Jira
Puoi costruire un report da zero — scegli i filtri, inserisci i componenti di report, colleghi ciascuno — oppure partire da una dashboard Jira che hai già.
Importa da una dashboard Jira legge la configurazione della dashboard e ne costruisce un report normale. Importa ciò che un gadget è configurato per mostrare, non un'immagine di esso, e il risultato non resta sincronizzato in seguito: i dati dei filtri restano live, ma layout e configurazione cambiano solo quando reimporti esplicitamente.
Dove vivono i report
I report hanno una pagina propria nell'Export Center, accanto alle tue viste di esportazione. L'elenco mostra nome, descrizione, numero di sorgenti dati, modello, ambito, ultimo aggiornamento e se il report è disponibile per l'esportazione.
Chiunque possa usare Exportelier vede l'elenco. Ciò che puoi fare lì dipende dal tuo ruolo.
Chi può fare cosa
| Azione | Amministratore del sito | Qualsiasi utente Jira autenticato |
|---|---|---|
| Vedere l'elenco dei report | ✅ | ✅ |
| Esportare un report abilitato | ✅ | ✅ |
| Creare, modificare, duplicare, eliminare un report | ✅ | — |
| Aprire il designer del report | ✅ | — |
| Aggiungere o modificare sorgenti dati | ✅ | — |
Le azioni amministrative non sono soltanto nascoste ai non amministratori: il server le rifiuta, quindi chiamare l'API direttamente non serve.
Un amministratore del sito può costruire un report da qualunque filtro lui veda. Questo non concede accesso a nessun altro. Ogni esportazione rilegge Jira come la persona che esporta — vedi risultati per utente.
Costruire un report
L'editor del report ha quattro parti, nell'ordine in cui si usano:
- Dettagli del report — nome, descrizione, ambito e se il report è abilitato all'esportazione.
- Sorgenti dati — aggiungi ogni filtro salvato e dagli un nome che abbia senso nella tua organizzazione. Vedi Sorgenti dati da filtri salvati.
- Designer — il consueto designer visuale. Ogni componente dati acquisisce un selettore di sorgente con le tue sorgenti con nome.
- Anteprima ed esportazione — controlla il collegamento, poi esporta.
Un report non può essere salvato finché un componente non ha una sorgente dati valida. L'editor nomina i componenti interessati invece di collegarli in silenzio alla prima sorgente disponibile.
Una sorgente che nessun componente usa è ammessa — potresti voler preparare un collegamento — ma l'editor lo segnala, e anche l'esportazione finale.
Partire dal modello incluso
Nuovo report da Dashboard Report Standard è la via più rapida. Copia il modello di sistema incluso in uno modificabile, chiede almeno un filtro salvato e poi chiede quale sorgente dati alimenta ciascuno dei tre grafici standard.
Con un solo filtro la risposta viene precompilata. Con più filtri non si indovina nulla: il report non può essere creato finché ogni grafico non è assegnato, perché un grafico collegato male produce un report che sembra corretto e non lo è.
Il modello di sistema non viene mai modificato.
Esportare un report
Le esportazioni di report vengono sempre eseguite in background, perché leggere più filtri e produrre un documento non rientra in una richiesta interattiva.
Prima dell'avvio, un controllo preliminare verifica ogni sorgente dati e mostra cosa ha trovato — pronta, vuota o non disponibile, con una stima dei ticket e un avviso quando una sorgente raggiungerà il tetto per sorgente. Poi scegli PDF, Word (DOCX) o Markdown e avvii l'esportazione.
Durante l'esecuzione vedi fasi oneste — pianificazione, lettura dei filtri Jira, rendering, preparazione del download — e puoi annullare in qualsiasi momento. Le esportazioni di report compaiono in Esportazioni attive accanto a quelle ordinarie, ciascuna etichettata con il nome del report, e un elenco delle esportazioni di report recenti consente di riaprire un lavoro dopo aver chiuso la finestra.
Il documento finale riporta ciò che conteneva davvero: quanti ticket ha fornito ogni sorgente, dove un limite lo ha troncato e quali sorgenti il report definisce senza che alcun componente le usi.
Se uno dei filtri salvati del report non è disponibile per te, l'esportazione fallisce e nomina quella sorgente. Non produce in silenzio un report più piccolo: un documento a cui manca una sorgente dati è identico a uno completo.
Limiti
I report hanno i propri tetti: sorgenti per report, ticket per sorgente, righe per tabella e così via. Ognuno è applicato lato server e nominato nell'output quando tronca davvero qualcosa. Vedi il riferimento dei limiti.