www.vallemediatime.com

FastReport è un potente componente per Delphi specializzato nella reportistica. Da questa edizione di EC4 lo abbiamo adottato e incluso in EC4 sostituendo il DocumentEditor che avevamo usato nelle precedenti versioni di EC.

Potete trovare tutta la documentazione ufficiale di FastReport sul sito:
http://www.fast-report.com/en/download/fast-report-4-download.html
(si veda nella parte più in basso, relativa alla documentazione, i diversi tipi di file pdf scaricabili)

Considerato che la documentazione è di oltre 600 pagine tutte in inglese e che è rivolta soprattutto agli sviluppatori vi forniamo qui un tutorial per la creazione di un semplice report. Terminata la creazione del report sarete in grado di comprendere meglio come sono stati organizzati tutti gli altri reports da noi creati. Vi consigliamo quindi di aprirli in modalità di editing e di modificarli facendone prima una copia di sicurezza.
Prima di procedere con il tutorial vi consigliamo anche di scaricare e stampare il file EC4_InfoReport.pdf presente nella cartella EC4_docs scaricabile dalla pagina di Download di EC4.

Creazione di un nuovo report
N.B. La modalità 'Modifica report...' è disponibile solo sui PC con licenza registrata.
Per creare un nuovo report è prima necessario aprire un report già creato da noi in modalità 'Modifica report...':
- portatevi alla sezione Report di EC4 mediante il pulsante 'Report' della barra principale degli strumenti
- fate click sulla cartella dell'albero dei dati in cui si trova il report (vedi numero 1);
- selezionate un report mediante un click (nell'esempio abbiamo selezionato il file 'A4(1P) SCHEDA 22d.fr3' (vedi numero 2);
- infine fate click sul pulsante 'Modifica report...' (vedi numero 3 più in alto).



Si aprirà così FastReport (l'editor dei reports incluso in questa nuova edizione di EC4) che vi mostrerà tutta la struttura di cui è composto il report selezionato. Tramite FastReport potrete sia intervenire sul report modificandolo in parte o del tutto sia creare da zero un nuovo report.
Ecco come appare il report selezionato in modalità di editing (chiamata anche designer).



Descrizione della struttura di un report
Un report è strutturato da vari livelli di descrizione del documento stesso più gli oggetti contenuti in esso (come per i documenti di videoscrittura).
Tra i principali livelli di descrizione possiamo indicare:
- il formato della carta: dimensioni in altezza e larghezza
- il numero di pagine: una o due (nel nostro caso)
- l'orientamento della pagina: verticale / orizzontale
- i margini della pagina: alto, basso, sinistra, destra.

Tra i principali oggetti inseribli nei reports possiamo utilizzare il MasterData e vari elementi testuali o grafici (linee, cornici, immagini, tabelle...).
Il MasterData, (che esiste solo in FastReport), lo si riconosce sia dal nome, sia dal colore arancio scuro del suo bordo superiore. Il MasterData serve come contenitore principale di tutti quei campi che prendono i dati dal database in modo tale che lo stesso campo possa poi ricrearsi automaticamente nelle pagine seguenti con i dati relativi agli alunni successivi.
Ad esempio se inseriamo un solo campo per il cognome dell'alunno nel MasterData avremo poi un'anteprima di stampa con tutti i cognomi degli alunni della classe per ciascuna pagina.

Vi illustriamo ora in dettaglio come creare un report simile a quello riportato nell'immagine soprastante.
1. Dopo aver aperto il file in modalità editing (come spiegato più sopra) andate al menu File (di FastReport) e selezionate il comando 'Nuovo report' (vedi Fig.1), si aprirà così un nuovo report senza titolo chiamato infatti 'Untitled.fr3' (vedi Fig.2)



2. Eliminate il ReportTitle e il PageFooter selezionandoli e premendo il tasto canc e quindi fate doppioc clik sul MasterData per scegliere l'origine dei dati, selezionate REP come nella figura e premete il pulsante OK



3. Nel report dovreste vedere che sull'angolo destro in alto del MasterData compare la sigla REP (vedi cerchio rosso nell'immagine più sotto). Verificate quindi le impostazioni di pagina mediante il menu File > Impostazioni della pagina... di FastReport



e adattate l'area del MasterData alle dimensioni della pagina trascinando il suo lato inferiore (vedi direzione della freccia).
Salvate il vostro primo nuovo report con un nome a VS piacere, nei prossimi esempi lo chiameremo 'Nuovo report'.
A questo punto possiamo iniziare a inserire i principali oggetti che comporranno il nostro primo report.
3. Inserimento del logo del ministero.
- Fate click sul pulsante Immagine (vedi Fig. 1), quindi fate click sulla parte alta del MasterData (Fig. 2): si formera una cornice tratteggiata di forma rettangolare e si aprirà la finestra 'Immagine' da dove poter caricare l'immagine (in questo caso il logo del ministero) mediante il pulsante 'Carica' (visibile sempre in Fig. 2).



Il file con il logo del ministero si trova nella cartella EC4_Allegati posta all'interno della directory principale di EC4:



Dopo aver selezionato uno dei due file bmp fate click sul pulsante 'Apri' in basso a destra, a questo punto vedrete in anteprima l'immagine, fate click sul pulsante evidenziato dalla cornice rossa nella figura sottostante e finalmente avrete importato il logo nel report.



Nella figura sottostante potete vedere che mediante un click con il tasto destro del mouse sull'immagine comparirà un comodo menu che vi permette di autodimensionare l'immagine, centrarla, ecc.


4. Inserimento dell'intestazione 'Ministero della pubblica istruzione'
- Fate click sul pulsante (1 vedi figura sottostante) e quindi di nuovo click all'interno del report: apparirà una cornice tratteggiata (2) e la finestra 'Editor di testo'. Inserite l'intestazione come in figura (3) e al termine fate click sul pulsante in basso 'OK'.
-


Ora trascinate il lato destro della cornice contenente l'intestazione per visualizzrne l'intero contenuto e



procedete alla sua formattazione: nella figura sottostante abbiamo usato il font 'English-111-Adagio-B-T.ttf' (disponibile nella cartella EC4_Allegati o nella pagina di download del nostro sito) a dimensione 26 con stile grassetto.



5. Inserimento dell'intestazione dell'istituto e di altri dati dinamici collegati al database.
Per inserire i dati collegati al database (campi dinamici) ed eventuale testo fisso (label, non dinamiche) si utilizza sempre lo strumento Testo (lo si seleziona mediante un click dal pulsante evidenziato in rosso nella seguente figura):



Dopo aver fatto click sul pulsante 'Testo' e un click su un punto del report appare la finestra 'Editor di testo' in cui è possibile inserire sia campi dinamici (cioè campi i cui dati vengono caricati dal database) sia label (testi fissi).
Nella seguente figura abbiamo inserito una serie di campi dinamici (delimitati dalle parentesi quadrate in apertura e chiusura) e una label formattata in grassetto mediante comuni tag HTML: <B>Istituzione scolastica</B>.



I testi dinamici vanno sempre inseriti nella forma: [REP."nome del campo dinamico"].
Per conoscere il 'nome del campo dinamico' da utilizzare potete stampare il documento in pdf che trovate sulla pagina di download di EC4 chiamato 'Riferimenti per i reports di stampa', oppure fare click sul campo di cui volete conoscere il nome e osservare il suo rifermento che compare nella barra di stato in basso a sinistra. Nella seguente figura vedete che il campo evidenziato si chiama ISTNOME e che appartiene alla tabella IST: il nome del campo viene dato dai caratteri che seguono il punto, il nome della tabella è dato dai caratteri che precedono il punto. Per la creazione dei reports è necessario conoscere solo il nome del campo.



N.B. FastReport può utilizzare solo una parte dei tag dell'HTML. Affinché il campo li possa utilizzare correttamente è necessario impostare la proprietà 'AllowHTMLTags' dell'oggetto Testo al valore True.



Per aprire la finestra proprietà dell'oggetto selezionate l'oggetto e premete il tasto F11.

6. Anteprima immediato dei campi dinamici.
FastReport vi dà la possibilità di visualizzare immediatamente i dati che saranno contenuti nel report definitivo mediante un semplice clik sul pulsante 'Anteprima':