Importare da una dashboard Jira
Exportelier può leggere una dashboard Jira e costruirci un report. Scegli una dashboard, Exportelier ti dice gadget per gadget che cosa ha capito, tu completi ciò che Jira non ha fornito e ottieni un normale report modificabile.
Due cose vale la pena sapere prima di iniziare, perché determinano tutto il resto di questa pagina.
Exportelier importa la configurazione della dashboard — quale filtro, quale campo, quale tipo di grafico — e la ricostruisce con i propri componenti. Il risultato non è uno screenshot, né una copia fedele al pixel, né una pagina Jira incorporata. Larghezze di colonna, cornici dei gadget e spaziatura esatta non vengono riprodotte, perché l'API pubblica di Jira non le espone.
Atlassian non garantisce che le impostazioni di un gadget integrato siano leggibili tramite un'API pubblica. Quando un'impostazione non lo è, Exportelier ti chiede di sceglierla. Non indovina mai quale filtro o quale campo intendevi.
Che cosa si può importare
| Gadget Jira | Diventa | Note |
|---|---|---|
| Filter Results | Tabella dei ticket | Mantiene le colonne scelte e il loro ordine |
| Pie Chart | Grafico per categoria (torta) | Usa il tipo di statistica del gadget |
| Work Item Statistics | Grafico per categoria (barre) | Usa il tipo di statistica del gadget |
| Two Dimensional Filter Statistics | Matrice | Usa i campi di entrambi gli assi |
| Created vs. Resolved Chart | Grafico a serie temporali | Mantiene periodo e intervallo storico del gadget — vedi i limiti qui sotto |
| Sprint Burndown | — | Richiede dati storici di sprint che Exportelier non offre ancora |
| Tutto il resto | — | Viene nominato ed escluso, mai scartato in silenzio |
Ogni gadget della dashboard riceve esattamente uno stato:
- Pronto — riconosciuto, e tutto il necessario era leggibile.
- Richiede riparazione — riconosciuto, ma devi fornire un'impostazione mancante.
- Disponibile più avanti — riconosciuto, ma il componente Exportelier corrispondente non esiste ancora. Sprint Burndown è qui.
- Non supportato — un gadget di terze parti o sconosciuto. Viene nominato, non nascosto.
- Errore — Jira non ha permesso a Exportelier di leggerlo, oppure ciò che ha letto era contraddittorio. Questo stato blocca l'importazione finché non lo correggi in Jira.
Il riconoscimento avviene tramite l'identità tecnica del gadget, mai tramite il titolo. Rinominare un gadget in Jira, o usare Jira in un'altra lingua, non cambia ciò che Exportelier ne fa — e chiamare «Pie Chart» un gadget personalizzato non lo rende tale.
Cosa mostra un grafico creati/risolti
Un grafico creati/risolti importato conta le date di creazione e di risoluzione dei ticket che il suo filtro salvato restituisce oggi. Non ricostruisce quali ticket il filtro restituiva in passato.
Questo conta quando il contenuto del filtro è cambiato. Se un ticket è uscito dal progetto coperto dal filtro, sparisce da tutti i periodi del grafico, compresi quelli precedenti allo spostamento. Il gadget di Jira si comporta allo stesso modo e per lo stesso motivo, ma è bene saperlo prima di confrontare due esportazioni distanti mesi.
Sono possibili altre tre differenze, e ciascuna viene indicata nell'avviso di completezza del report quando si applica:
- Periodo del report. Giornaliero, settimanale e mensile sono riprodotti esattamente. Orario diventa giornaliero, trimestrale e annuale diventano mensili: i totali non cambiano, cambia solo l'ampiezza dei periodi.
- La linea di tendenza dei non risolti. Jira può sovrapporre una terza linea con i ticket aperti nel tempo. Il grafico di Exportelier mostra solo le serie dei creati e dei risolti.
- Intervallo storico. Un periodo superiore a 366 giorni viene ridotto a 366 giorni.
Tutto il resto — il filtro, la modalità cumulativa, i numeri stessi — viene riportato invariato, e puoi modificare ognuna di queste impostazioni nel designer in seguito.
L'importazione
- Apri Report e scegli Importa da una dashboard Jira.
- Scegli una dashboard. Qui compaiono solo le dashboard che Jira già ti mostra: essere amministratore del sito in Exportelier non allarga l'elenco.
- Leggi l'analisi. Ogni gadget è elencato con il suo stato.
- Ripara ciò che va riparato. Filtro salvato e campi si scelgono dai selettori consueti; un campo per JQL grezzo non c'è, per scelta.
- Verifica la completezza. Tutto ciò che resterà fuori è elencato per nome, e devi confermare le esclusioni esplicitamente prima di poter creare il report.
- Crea il report. Si apre nell'editor normale, completamente modificabile.
Qualsiasi cosa ancora marcata Richiede riparazione o Errore blocca la creazione. Exportelier preferisce rifiutare piuttosto che produrre un report che ometta in silenzio metà dashboard.
L'avviso di completezza
Ogni report importato inizia con un avviso di completezza: un componente reale del documento, non un suggerimento nell'interfaccia. Nomina la dashboard di origine, quando è stata importata, quanti gadget sono inclusi e tutti quelli che non lo sono, per titolo.
È una nota informativa quando è stato importato tutto e un avviso quando qualcosa è rimasto fuori. Compare in PDF, Word e Markdown allo stesso modo.
Finché il report resta collegato alla sua importazione, Exportelier gestisce l'avviso: puoi riorganizzare liberamente il resto del layout, ma non eliminarlo né riscriverlo. Se viene comunque rimosso o alterato, il report non si esporta — un documento che dichiara di rappresentare una dashboard omettendone in silenzio una parte è peggio di nessun documento.
Se vuoi un report senza l'avviso, duplicalo. Un duplicato è un report normale, senza importazione alle spalle e senza avviso gestito.
Stare al passo con la dashboard
L'importazione è un'istantanea della configurazione della dashboard. I dati restano live: un report rilegge i suoi filtri salvati al momento dell'esportazione, quindi i numeri sono aggiornati anche mesi dopo.
Ciò che non si aggiorna da solo sono layout e configurazione. Se qualcuno aggiunge un gadget in Jira, o ne punta uno a un altro filtro, il tuo report continua esattamente come prima finché non decidi diversamente.
Apri il report e usa Verifica modifiche. Exportelier rilegge la dashboard e classifica ogni gadget come aggiunto, rimosso, spostato, configurazione modificata o invariato. Reimporta applica poi il risultato:
- i gadget invariati e spostati mantengono ciò che hanno;
- ciò che hai aggiunto al report a mano resta intatto;
- i gadget modificati e aggiunti ricevono contenuto nuovo;
- un gadget la cui nuova configurazione non può essere risolta automaticamente interrompe la reimportazione e passa alla riparazione, invece di sovrascrivere il tuo lavoro con una supposizione;
- un gadget escluso come «disponibile più avanti» che una versione più recente di Exportelier è ora in grado di importare compare come modificato, e la reimportazione lo aggiunge in fondo al report. Un report esistente non acquisisce mai un componente solo perché è uscita una versione: devi chiederlo tu.
Prima di ogni reimportazione viene salvata automaticamente una versione del modello, quindi Ripristina versione la annulla.
Non c'è nessuno scheduler e nessuna sincronizzazione in background. La reimportazione avviene quando la chiedi tu.
Permessi
Importare, reimportare ed eliminare un'importazione sono azioni da amministratore del sito.
Ogni lettura di dashboard, gadget e filtro durante un'importazione viene eseguita come la persona che la esegue: un amministratore non può importare una dashboard che Jira non gli mostra. Le esportazioni successive rileggono i filtri del report come chi esporta, quindi l'importazione non allarga l'accesso di nessuno ai dati Jira. Vedi Permessi e ruoli.
Limiti
| Limite | Valore |
|---|---|
| Gadget analizzati per importazione | 12 |
| Gadget offerti in selezione oltre quel limite | 60 |
Una dashboard con più di dodici gadget non viene troncata. Ti viene chiesto quali gadget importare, e quelli che lasci fuori vengono nominati nell'avviso di completezza come qualsiasi altra esclusione.
Un report importato è un report normale ed eredita tutti i limiti dei report — sorgenti dati, componenti, ticket per sorgente. Vedi il riferimento dei limiti.
Sull'API Jira utilizzata
Exportelier legge le dashboard esclusivamente tramite l' API REST delle dashboard di Jira Cloud documentata da Atlassian. Non analizza pagine web di Jira, non legge iframe dei gadget, non cattura screenshot e non usa endpoint non documentati.
Una di queste operazioni — Get gadgets, che elenca i gadget di una dashboard — è contrassegnata come Experimental da Atlassian. Significa che Atlassian può modificarla senza le garanzie di stabilità valide per il resto dell'API. Se cambia in un modo che Exportelier non riconosce, l'importazione delle dashboard si disattiva da sola e lo dichiara, invece di importare qualcosa che ha letto male. I tuoi report, modelli ed esportazioni esistenti non ne risentono.