Esportazioni Personalizzate - Amministratore Scuola

Che cos'è il Generatore Esportazioni Personalizzate?

Il Generatore Esportazioni Personalizzate è uno strumento avanzato che permette agli amministratori scolastici di creare esportazioni dati completamente personalizzate. Utilizzando un wizard guidato, è possibile selezionare sorgenti dati, colonne specifiche, applicare filtri e salvare template riutilizzabili.

Che cosa fa?

Il sistema permette di:

Selezionare tra diverse sorgenti dati (alunni, fatture, presenze, ecc.)
Scegliere colonne specifiche da esportare
Applicare filtri avanzati per periodo, stato, sezione
Includere dati da tabelle correlate (relazioni)
Salvare configurazioni come template riutilizzabili
Generare file Excel con layout professionale

Come utilizzare le Esportazioni Personalizzate

Accesso al Generatore

Accedi alla piattaforma Scuola In Cloud come amministratore scolastico
Naviga al menu "Reporting"
Seleziona "Esportazioni Personalizzate" dal menu laterale

Processo di Creazione Esportazione (Wizard 3 Passi)

Passo 1: Selezione Sorgente Dati

Scelta Tipo Dati

Alunni: Dati anagrafici, scolastici e familiari studenti
Genitori/Tutori: Informazioni contatti e dati familiari
Fatture: Documenti finanziari con stati pagamento
Presenze: Registri frequenza giornaliera
Tariffe: Configurazioni costi e sconti
Libri: Catalogo biblioteca con stati prestito
Messaggi: Comunicazioni inviate/ricevute
Appuntamenti: Prenotazioni colloqui e incontri

Descrizioni Disponibili: Ogni sorgente mostra descrizione dettagliata dei dati contenuti

Passo 2: Configurazione Colonne e Filtri

Selezione Colonne

Checkbox List: Seleziona campi da includere
Ricerca: Campo ricerca per trovare colonne velocemente
Selezione Multipla: Toggle globale per selezionare/deselezionare tutto
Colonne Dinamiche: 3 colonne per layout responsive

Relazioni (Opzionale)

Inclusione Dati Correlati: Checkbox per tabelle collegate
Esempi: Per alunni includi dati genitori, per fatture includi dati studenti
Caricamento Automatico: Relazioni caricate per ogni record

Filtri Disponibili

Date: Intervallo data inizio/fine
Anno Scolastico: Filtro per anno accademico specifico
Sezioni: Selezione multipla sezioni scolastiche
Stato: Attivo, non attivo, in attesa (per entità applicabili)
Solo Elementi Attivi: Toggle per escludere record disattivati
Stato Pagamento: Pagato, non pagato, scaduto (per fatture)

Passo 3: Opzioni Esportazione

Dettagli Esportazione

Nome Esportazione: Titolo file (obbligatorio, max 255 caratteri)
Descrizione: Note aggiuntive per identificare esportazione

Salvataggio Template

Toggle "Salva come Template": Abilita salvataggio configurazione
Nome Template: Identificativo per template (visibile quando abilitato)
Riutilizzo: Template accessibile da "Template Salvati"

Anteprima Configurazione

Riepilogo: Mostra sorgente dati, numero colonne, relazioni incluse
Validazione: Controllo configurazione prima generazione

Generazione Esportazione

Processo Automatico

Costruzione Query: Sistema costruisce query basata configurazione
Applicazione Filtri: Filtri applicati per limitare risultati
Caricamento Relazioni: Dati correlati inclusi se selezionati
Mappatura Dati: Conversione dati per formato Excel
Generazione File: Creazione file .xlsx con formattazione professionale

Notifiche

Successo: Conferma generazione con numero record totali
Errore: Messaggio dettagliato problema riscontrato
Download Automatico: File scaricato direttamente browser

Caratteristiche Avanzate

Sistema Sorgenti Dati

8 Sorgenti Disponibili: Copertura completa dati scolastici
Descrizioni Dettagliate: Spiegazione contenuto ogni sorgente
Aggiornamento Dinamico: Colonne disponibili cambiano con sorgente selezionata

Filtri Sofisticati

Multi-Selezione: Possibilità scegliere più valori stesso filtro
Dipendenze: Alcuni filtri visibili solo per sorgenti specifiche
Validazione: Controlli automatici coerenza filtri

Gestione Relazioni

Caricamento Eager: Relazioni caricate efficientemente
Selezione Granulare: Scegli quali relazioni includere
Performance: Query ottimizzate per grandi dataset

Template System

Salvataggio Automatico: Configurazioni salvate database
Riutilizzo: Template caricabili da sezione dedicata
Versioning: Possibilità aggiornare template esistenti

Sicurezza e Validazioni

Controlli Automatici

Validazioni Form

Sorgente dati obbligatoria
Almeno una colonna selezionata
Nome esportazione obbligatorio
Nome template obbligatorio se salvataggio abilitato

Sicurezza Accesso

Solo amministratori possono accedere
Isolamento tenant per sicurezza multi-scuola
Logging generazione esportazioni

Gestione Errori

Query Fallite: Gestione eccezioni con messaggi user-friendly
File System: Controlli permessi scrittura file
Limiti Dati: Gestione dataset molto grandi

Considerazioni Tecniche

Performance

Query Ottimizzate: Utilizzo indici database
Chunking: Elaborazione dati in blocchi per grandi esportazioni
Caching: Risultati temporaneamente cachati per performance

Formato Excel

Libreria Maatwebsite: Generazione Excel professionale
Formattazione: Intestazioni, colori, bordi automatici
Colonne Dinamiche: Larghezza automatica basata contenuto

Limiti Sistema

Record Massimi: Nessun limite teorico, ma attenzione performance
Colonne: Nessun limite colonne esportabili
Relazioni: Supporto relazioni multiple nidificate

Best Practices

Configurazione Esportazioni

Selezione Colonne

Scegliere solo colonne necessarie per ridurre dimensione file
Considerare privacy dati quando si includono informazioni sensibili
Utilizzare descrizioni colonne per identificare campi corretti

Applicare Filtri

Utilizzare filtri data per limitare periodo esportazione
Filtrare per stato attivo per escludere record obsoleti
Combinare filtri per ottenere dataset precisi

Gestione Relazioni

Includere relazioni solo se necessarie
Considerare impatto performance su dataset grandi
Verificare dati correlati siano completi

Template Management

Naming Convention

Nomi descrittivi per identificare scopo template
Includere data creazione per versionamento
Descrizioni dettagliate per facilitare riutilizzo

Aggiornamento Template

Revisionare periodicamente template esistenti
Aggiornare filtri se struttura dati cambia
Eliminare template non più utilizzati

Sicurezza Dati

Privacy Consideration

Evitare esportazione dati sensibili non necessari
Utilizzare password per file Excel contenenti dati personali
Archiviare file esportati in posizioni sicure

Audit Trail

Registrare generazione esportazioni per compliance
Mantenere log accessi ai template
Documentare scopo ogni esportazione

Troubleshooting

Problemi Comuni

Esportazione Vuota

Verificare filtri non escludano tutti record
Controllare dati esistano per periodo selezionato
Verificare permessi accesso dati

Errore Generazione

Controllare connessione database
Verificare spazio disco sufficiente
Contattare supporto per errori sistema

File Corrotto

Riprovare generazione esportazione
Verificare versione browser aggiornata
Utilizzare Excel invece di altri software

Ottimizzazione Performance

Dataset Grandi

Utilizzare filtri più restrittivi
Esportare in periodi più brevi
Considerare esportazioni programmate

Relazioni Complesse

Limitare numero relazioni incluse
Utilizzare filtri per ridurre record base
Monitorare tempo generazione

Integrazione Sistema

Compatibilità

Browser Moderni: Supporto completo Chrome, Firefox, Safari, Edge
Excel Versions: Compatibile da Excel 2007 in poi
Mobile: Accessibile ma ottimizzato per desktop

API Integration

Servizi Backend: Utilizzo ExportBuilderService per logica
Data Mapping: CustomDataExport per formattazione
Template Storage: DataExportService per persistenza

Estensibilità

Nuove Sorgenti: Facilmente aggiungibili in DataExportService
Filtri Custom: Estendibili in wizard form
Formati Esportazione: Possibilità aggiungere PDF, CSV futuri