Nelle sue distribuzioni standard, Delphi fornisce dei componenti per creare,
organizzare e stampare i resoconti delle eleborazioni su database effettuate dalle nostre
applicazioni. Questo insieme di componenti costituiscono la suite QuickReport che permette
di creare visualmente lo schema da utilizzare per stampare i dati. Questa suite permette
di realizzare a design-time il report, di effettuarne l'anteprima sia in fase di design
che di run-time, effettuare calcoli l''interno del report stesso, inserire grafici
recuperare automaticamente i dati dai campi dei records, la realizzazione di report a più
livelli o collegati, effettuare un export del risultato dell'elaborazione in formato
testuale, CSV o HTML.
Su internet ed in particolare sui news group che trattano di Delphi molti non trovano
bene con questi componenti, che in effetti, almeno nelle versioni precedenti a quella
presente con Delphi 5, avevano qualche difetto. Esistono altre soluzioni per la creazione
di reports, sia commerciali che freeware, più o meno complesse e complete. Una delle
suite che ritengo meriti di essere mensionata è FuzzyReport (precedentemente Fastreport)
creata da Fabio Dell'Aria che mette a disposizione un editor di reports a run-time
permettedo quindi all'utente finale di personalizzare i reports dell'applicazione. Tutto
questo free, e anche con prestazioni migliori rispetto a quelle di QuickReport.
Comunque in questo corso tratteremo in maniera molto breve gli strumenti standard forniti
con Delphi.
Il componente fondamentale di QuickReport è il componente QuickRep, il cuore del
sistema di generazione dei reports. Esso si presenta come un foglio bianco da posizionare
in una form nel quale andranno posizionati gli altri componenti di QuickReport che
andranno a definire l'aspetto grafico e funzionale del report stesso. QuickReport è uno
di quegli strumenti per la costruzione di reports definiti a "bande". Infatti
per definire la struttura del report si utilizzano delle bande, ogniuna con uno specifico
compito. Esistono bande titolo, intestazione, piè di pagina, header, dettaglio,
sottodettaglio e così via. All'interno di ciascuna banda andranno inseriti altri
componenti visuali, che serviranno a rappresentare i dati del report: possiamo avere delle
etichette sia statiche che collegate a campi di database, come il componente Label
standard, delle immagini, sia statiche che ricavate da campi blob di database, campi per
inserire formule, componenti per le forme, per grafici statistici o per ricavare
informazioni strettamente riguardanti il report come il numero di pagine totali o il
numero di pagina corrente, la data di stampa etc.
La costruzione di un report può avvenire in due modi, attraverso i wizards attraverso
il menu File->New oppure "a manina" partendo da una normalissima form. Per
prima cosa si posiziona un componente QuickRep nella form che assumerà l'aspetto di un
foglio bianco con una griglia quadrettata e l'indicazione dell'area stampabile nella
stampante predefinita.
A questo punto è già possibile definire alcune delle
caratteristiche del report; attraverso la proprietà Bands del componente QuickRep, è
possibile definire quali bande sono necessarie alla realizzazione del report: Title,
PageHeader, PageFooter, etc. La proprietà Dataset serve a legare il report ad un dataset
per il recupero dei dati.
La proprietà Description serve a definire una descrizione per
il report; questa proprietà potrebbe tornare utile quando si da la possibilità
all'utente di scegliere un report, poiché attraverso questa proprietà si può fornire
una descrizione del report.
Attraverso la proprietà Frame è possibile specificare se il
report verrà riquadrato segnando l'area stampabile dalla stampante. Accedendo alla
proprietà Page è possibile definire le proprietà della pagina di stampa, larghezza,
altezza, margini e se si vuole, la visualizzazione dei righelli che ovviamente saranno
visibili solamente in fase di disegno del report.
PrinterSettings permette di impostare le
opzioni per la stampante, il numero di copie, il binario della carta, etc.
PrinterIfEmpty
indica a QuickReport se stampare o no il report se il dataset a cui è collegato è vuoto.
ReportTitle serve ad impostare il titolo del report e può essere utilizzato nel report
stesso attraverso il componente QRSysData e la stessa proprietà viene utilizzata
nell'elenco dei job di stampa nel "Print Manager" di windows.
Vi sono ancora
altre proprietà interessanti in questo componente come ShowProgress che serve a
visualizzare o no l'avanzamento dello stato di costruzione del report, Unit che indica
l'unità utilizzata nella rappresentazione della griglia e dei righelli ed infine lo Zoom,
che permette di regolare la visualizzazione del report in fase di disegno.
Completata la
costruzione del report, per permetterne la visualizzazione è necessario eseguire
all'interno del codice del programma il metodo Preview del componente QuickRep, per
visualizzare l'anteprima del report, o il metodo Print per effettuarne la stampa.
QuickReport permette di personalizzare l'aspetto della form di anteprima, mettendo a
disposizione il componente QRPreview.
Per maggiori informazioni a riguardo consultare la
guida in linea. Un'altra possibilità messa a disposizione da QuickReport è quella di
esportare il risultato dell'eleborazione del report in formato testuale formattato o in
HTML attraverso i componenti QRTextFilter, QRCVSFilter, QRHTMLFilter.
L'esportazione è
molto semplice: basta collocare un componente di quelli precedentemente mensionati in una
form ed automaticamente, attraverso l'opzione salva nella finestra di anteprima del
report, verrà visualizzata l'opzione di esportazione scelta. Si può efettuare la stessa
operazione da codice attraverso il metodo ExportToFilter del componente QuickRep.