Lavorare con i report

Questa guida percorre le attività quotidiane della pagina Report: generare e pubblicare un report, scaricarlo e definire che cosa contengono i report con modelli, capitoli e metriche. Come funziona tutto questo, e perché, lo spiegano Report e Metriche; le domande più comuni trovano risposta nelle FAQ sui report.

Prima di iniziare

• Generare e pubblicare i report di un impianto è consentito ai ruoli di mansione Operatore, Technical Manager, Asset Manager e Visualizzatore su quell'impianto. Rigenera richiede Operatore, Technical Manager o Asset Manager; eliminare un report richiede Operatore.
• Un modello con capitoli di importi (ricavi, indennizzi, conteggi) richiede in più il permesso contabile sull'impianto: Operatore o Asset Manager.
• Modelli, capitoli e metriche li crea e li modifica un Admin dell'organizzazione; tutti gli altri membri li usano.
• Il tuo ruolo nell'organizzazione ti dà un ruolo di mansione sugli impianti dell'organizzazione — vedi Sistema di permessi.

Generare un report

Apri in Mirox: Report ▸ Report

1. Fai clic su Genera report in alto nella pagina. In alternativa, fai clic su un mese concluso nel calendario Disponibilità dei dati: la finestra si apre con il modello e il mese già compilati.
2. Scegli l'Impianto. Da quel momento la finestra offre solo i modelli che si applicano a quell'impianto.
3. Scegli la Lingua del report. Parte dalla lingua della tua interfaccia.
4. Scegli il Periodo — mese, trimestre o anno — e quale, poi il Modello.
5. Leggi le righe sotto la tua scelta:
   • se i dati del periodo sono definitivi — in caso contrario il report sarà contrassegnato come Provvisorio (puoi generarlo comunque);
   • quali capitoli questo impianto non riceverà e di che cosa hanno bisogno.
6. Fai clic su Genera per costruire il report direttamente dal modello, oppure su Personalizza prima per modificare i capitoli di questo solo report nell'editor prima della generazione — il modello resta invariato.

Dopo pochi secondi il report si apre nell'anteprima come Bozza.

Verificare e pubblicare

Una bozza è completa ma non ancora rilasciata. Pubblicala dopo averla verificata.

1. Apri la bozza: si apre da sola dopo la generazione; più tardi, fai clic sulla sua riga nell'elenco o su Verifica e pubblica nella colonna Download.
2. Scorri l'anteprima.
3. Per aggiungere le tue parole, fai clic su Modifica nell'editor. L'editor mostra le pagine del report così come vengono stampate. Lì puoi scrivere una nota in copertina, aggiungere un commento o un testo tra i blocchi, aggiungere una nota a piè di pagina, rinominare un titolo, nascondere un blocco o dare a questo report una propria intestazione e piè di pagina. I numeri sono calcolati e non si possono modificare. Le modifiche vengono salvate mentre scrivi; Pagine mostra il risultato impaginato esattamente come il PDF.
4. Fai clic su Pubblica e conferma. Il report viene congelato così com'è, e i suoi download diventano disponibili a tutte le persone della tua organizzazione autorizzate a leggere i report di quell'impianto. Nell'editor, Pubblicato prende ora il posto del pulsante, finché non cambi qualcosa. L'elenco mostra sotto la data, nella colonna Pubblicato, chi ha pubblicato il report.

Per aggiornare in seguito un report pubblicato — dopo un conteggio tardivo, un valore di mercato rivisto o quando i dati provvisori diventano definitivi — scegli Rigenera nel menu della riga o nei Dettagli del report. Il report torna in bozza; l'ultima versione pubblicata resta scaricabile finché non pubblichi di nuovo. Il testo che hai scritto viene mantenuto.

Scaricare un report

1. Nell'elenco, usa i pulsanti della colonna Download: PDF, Word, Excel, CSV (un archivio ZIP con un file per tabella) o JSON. Gli stessi pulsanti si trovano nell'anteprima e nei Dettagli del report.
2. Per ogni valore dietro al report alla massima risoluzione, usa Esportazione completa dei dati accanto ai download: scegli il formato e fai clic su Prepara; dopo un momento il file è pronto da scaricare.

I download forniscono sempre l'ultima versione pubblicata, anche mentre una bozza più recente attende la pubblicazione. Un report mai pubblicato non ha ancora né download né Esportazione completa dei dati: pubblicalo prima.

Costruire un modello

Apri in Mirox: Report ▸ Modelli

1. Nella scheda Modelli, fai clic su Nuovo modello — oppure duplica un modello esistente, ad esempio quello incluso Panoramica dell'impianto, e modifica la copia.
2. L'editor di report si apre con un impianto e un periodo di anteprima, su pagine che somigliano al report stampato. Aggiungi capitoli: uno Dalla libreria dei capitoli oppure uno nuovo scritto direttamente nel modello.
3. In un capitolo, aggiungi blocchi: scegli i dati, poi decidi accanto all'anteprima dal vivo come vengono stampati — come tabella, grafico o elenco. Aggiungi blocchi di testo per i tuoi paragrafi.
4. Trascina i capitoli nell'elenco dei capitoli per riordinarli; se vuoi, dai a un capitolo un titolo proprio in questo modello.
5. Controlla l'elenco dei capitoli: un capitolo che l'impianto di anteprima non riceve è barrato, con ciò di cui ha bisogno. Cambia impianto di anteprima per vedere come appare il modello su altri impianti.
6. Fai clic su Salva modello e assegnagli un nome e una descrizione. I suoi tipi di impianto sono mostrati in sola lettura: derivano dai capitoli. Su uno schermo stretto, le azioni del modello si trovano nel menu ⋯ accanto al pulsante principale.

Un modello può avere una propria intestazione e un proprio piè di pagina — vedi Modificare intestazione e piè di pagina. Anche un report personalizzato può diventare un modello: nell'editor di report, Salva come modello trasforma i capitoli sullo schermo in un nuovo modello.

Modificare intestazione e piè di pagina

Intestazione e piè di pagina vengono stampati su ogni pagina tranne la copertina, nel PDF come nel file Word. Impostali in un modello per ogni report generato da esso, oppure solo per un report. Come funzionano: Intestazione e piè di pagina.

1. Apri le pagine:
   • per un modello, aprilo dalla scheda Modelli — modificare un modello richiede il ruolo organizzativo Admin;
   • per un solo report, apri il report e fai clic su Modifica nell'editor.
2. Punta l'intestazione o il piè di pagina di una pagina qualsiasi e fai clic (Modifica l’intestazione / Modifica il piè di pagina). Le impostazioni si aprono accanto. L'etichetta in alto dice di chi sono ora: Predefinito della piattaforma, Dal modello o Propri di questo report.
3. Scrivi nelle posizioni — Sinistra, Centro e Destra nell'intestazione; Sinistra, Destra e Seconda riga, centrata nel piè di pagina. Una posizione contrassegnata come predefinito mostra il testo della piattaforma finché non scrivi; la freccia accanto a una posizione riporta il predefinito, e una posizione che svuoti non stampa nulla. La riga sotto ogni posizione mostra che cosa stampa.
4. Per un valore che cambia da un report all'altro, metti il cursore al punto giusto e fai clic su un pulsante sotto Inserisci al cursore: Impianto, Periodo, Modello, Titolo del report, Organizzazione, Dati aggiornati al, Anno, Numero di pagina o Numero di pagine.
5. Imposta gli interruttori se serve: Stampa l’intestazione o Stampa il piè di pagina, Logo sul bordo destro, Numeri di pagina a destra.
6. Fai clic su Fatto. L'intestazione e il piè di pagina di ogni pagina mostrano già il risultato.
7. Conservalo:
   • in un modello, fai clic su Salva modello — da ora ogni report generato da esso stampa questa intestazione e questo piè di pagina;
   • in un report, viene salvato mentre scrivi e il modello resta invariato. Pubblica il report perché i suoi download riportino la nuova intestazione e il nuovo piè di pagina.

Per annullare intestazione e piè di pagina propri di un report, riapri le impostazioni e fai clic su Usa quelli del modello — oppure su Torna al predefinito della piattaforma quando il modello non ne ha di propri. In un modello, Torna al predefinito della piattaforma rimuove i suoi. Intestazione e piè di pagina propri di un report può impostarli chiunque sia autorizzato a generare e pubblicare i report dell'impianto; con Personalizza prima, l'intestazione e il piè di pagina che imposti entrano nel nuovo report quando fai clic su Genera report.

Creare un capitolo

Un capitolo di libreria si può inserire in qualsiasi modello, e ogni sua modifica si vede in tutti.

1. Nella scheda Modelli, sotto Modelli di capitolo, fai clic su Nuovo capitolo.
2. Dagli un nome, poi aggiungi blocchi: Scegli i dati e, accanto all'anteprima, la sua forma.
3. Decidi che cosa succede quando un impianto non può fornire i dati (Se non disponibile): il report segnala che i dati mancano, oppure omette il capitolo.
4. Osserva Compare per: man mano che aggiungi dati mostra i tipi di impianto di cui il capitolo ha bisogno. Se l'impianto di anteprima non è idoneo, il foglio indica «Non incluso per impianto: richiede …» — scegli un altro impianto per vedere il contenuto.
5. Fai clic su Crea capitolo. Ora è nella libreria dei capitoli e qualsiasi modello può aggiungerlo.

Per modificare un capitolo di libreria, fai clic sulla sua riga. Per salvare nella libreria un capitolo scritto all'interno di un modello, usa il suo badge nell'editor di report e scegli Salva come nuovo capitolo di libreria.

Creare una metrica

Apri in Mirox: Report ▸ Metriche

1. Nella scheda Metriche, fai clic su Nuova metrica — oppure apri un Esempio incluso e duplicalo.
2. In alto, sotto Valuta su, scegli l'impianto su cui verificare la metrica. La verifica, il campione di ieri, l'anteprima, gli elementi disponibili e l'assistente usano tutti questo impianto; la metrica in sé non appartiene a nessun impianto.
3. Compila nome, id, unità e descrizione, e scrivi l'espressione — oppure descrivi il valore che vuoi all'Assistente e lascia che scriva l'espressione con te. Ogni modifica viene salvata mentre scrivi.
4. Leggi il verdetto. Finché l'espressione ha un problema, la metrica mostra Non convalidata e non si può usare da nessuna parte; correggi ciò che l'editor elenca.
5. Controlla Vale per: i tipi di impianto di cui la metrica ha bisogno. Un capitolo che la usa compare solo su quegli impianti.
6. Fai clic su Calcola anteprima per vedere i valori su un mese, un trimestre o un anno.
7. Usala: nel selettore dati di un capitolo la tua metrica compare come metrica propria.

Ripristinare una versione

I modelli e i capitoli di libreria conservano una cronologia delle loro versioni. Tutti i membri dell'organizzazione possono leggerla; il ripristino richiede il ruolo organizzativo Admin.

1. Apri la Cronologia delle versioni: nella scheda Modelli, apri il menu della riga del modello — o della riga del capitolo sotto Modelli di capitolo — e scegli Cronologia delle versioni. Nell'editor di report o nell'editor di capitolo, fai clic su Cronologia nell'intestazione.
2. Leggi l'elenco, con la versione più recente in cima: ogni versione mostra il numero, la data, chi l'ha salvata e che cosa è cambiato. Attuale contrassegna la versione in uso.
3. Fai clic su una versione per aprirla. Vedi i suoi capitoli o blocchi com'erano; un capitolo di libreria indica quale sua versione aveva allora e se un ripristino colloca il suo contenuto attuale o riporta questa copia come capitolo proprio del modello. Tutte le versioni ti riporta all'elenco.
4. Fai clic su Ripristina la versione 3 e conferma con Ripristina. Se la versione legge dati che non esistono più, la finestra li nomina prima: Ripristina senza di esse li omette, Annulla non cambia nulla.
5. Una nota sopra l'elenco conferma il nuovo numero di versione e nomina ciò che Mirox ha dovuto adattare — un nome mantenuto, un capitolo tornato come capitolo proprio del modello, dati omessi.

Il ripristino aggiunge una nuova versione; non si perde nulla e puoi tornare indietro allo stesso modo. Un ripristino in un editor sostituisce ciò che è sullo schermo, quindi salva prima le tue modifiche. Ripristinare un capitolo di libreria modifica tutti i modelli che lo usano. I report già generati conservano i propri capitoli; quelli generati da una versione precedente mostrano Non aggiornato, e Cosa è cambiato nel modello nei loro Dettagli apre questa cronologia. Un modello o un capitolo incluso non si può ripristinare — Duplica per modificare ti dà una copia su cui lavorare.

Vedere chi ha fatto cosa

• Chi ha pubblicato un report e chi l'ha generato: nell'elenco, sotto la data nella colonna Pubblicato; nei Dettagli del report (Pubblicato, Ultima generazione, Ultima modifica della bozza); e nella riga sotto la descrizione nell'anteprima.
• Tutto ciò che è accaduto ai report di un impianto — generati, rigenerati, pubblicati, eliminati, esportati: apri la pagina Dati anagrafici dell'impianto e la sua scheda Attività, oppure la pagina Attività per tutti i tuoi impianti, e filtra per la categoria Report.
• Ogni modifica a modelli, capitoli e metriche: Organizzazione ▸ Attività. Questa scheda è aperta ai ruoli organizzativi Admin e Moderatore.

Che cosa registra ogni voce è descritto nel registro delle attività.

Fare ordine

• Ritira un modello o un capitolo che non ti serve più: resta conservato ma non viene più offerto; Attiva lo rimette in uso.
• Eliminare è possibile solo finché nulla ne dipende. La finestra di dialogo indica ciò che ne dipende ancora — i report generati da un modello, oppure i modelli e i capitoli che usano un capitolo o una metrica — ciascuno con un link per aprirlo. Rimuovi prima l'uso, poi elimina.

Pagine correlate

• Report — modelli, tipi di impianto, bozze, disponibilità dei dati, versioni, intestazione e piè di pagina, download, lingue e registro delle attività
• Metriche — definire i valori propri della tua organizzazione
• FAQ sui report — domande frequenti
• Sistema di permessi — ruoli e ruoli di mansione
• Attività e Audit Trail — chi ha fatto cosa, e quando