<!-- If you want to validate or edit this document separately, uncomment this prolog <?xml version="1.0" ?> <!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> --> <chapter id="tutorial"> <chapterinfo> <authorgroup> <author ><firstname >Alexander</firstname > <surname >Dymo</surname > <affiliation > <address ><email >cloudtemple@mksat.net</email ></address> </affiliation> </author> <author ><firstname >Phil</firstname > <surname >Thompson</surname > <affiliation > <address ><email >phil@river-bank.demon.co.uk</email ></address> </affiliation> </author> <othercredit role="translator" ><firstname >Federico</firstname ><surname >Zenith</surname ><affiliation ><address ><email >zenith@chemeng.ntnu.no</email ></address ></affiliation ><contrib >Traduzione della documentazione in italiano</contrib ></othercredit > </authorgroup> </chapterinfo> <title >Esercitazione</title> <para >Questa esercitazione cercherà di essere una breve introduzione a Kugar.</para> <para >Creerai un modello di rapporto campione con &kudesigner;, un file dati campione e infine genererai un rapporto completo.</para> <para >Il codice sorgente per i modelli e i file dati campione può essere trovato in <filename >sample1.ktf</filename > e <filename >sample1.kdf</filename >, che sono distribuiti con &kugar;.</para> <sect1 id="tut-1"> <title >Creare il modello di rapporto con &kudesigner;</title> <para >Avvia Kugar Designer digitando <command >kudesigner</command > nella shell. </para> <para >Dopo aver avviato il Designer, scegli <guimenu >File</guimenu >|<guilabel >Nuovo</guilabel > e imposta la dimensione della pagina a <guilabel >A4</guilabel > e l'orientamento della carta a <guilabel >Orizzontale</guilabel >. Imposta i margini destro e sinistro a 48, i margini superiore e inferiore a 40. Tutte le dimensioni in &kudesigner; (margini di pagina, dimensioni, posizioni, &etc;) sono misurate in millimetri. <screenshot > <mediaobject> <imageobject> <imagedata fileref="tut_file_new.png" format="PNG"/> </imageobject> <textobject> <phrase >Finestra di dialogo <interface >Nuovo rapporto</interface ></phrase> </textobject> </mediaobject> </screenshot> </para> <para >Viene ora creato un nuovo rapporto e tutti i pulsanti sulla <guilabel >Barra degli strumenti degli elementi</guilabel > e <guilabel >Barra degli strumenti delle sezioni</guilabel > sono ora abilitati (sono abilitati anche gli elementi dei corrispondenti menu <guilabel >Elementi</guilabel > e <guilabel >Sezioni</guilabel >). <screenshot > <mediaobject> <imageobject> <imagedata fileref="tut_empty_report.png" format="PNG"/> </imageobject> <textobject> <phrase >Finestra di dialogo Rapporto vuoto</phrase> </textobject> </mediaobject> </screenshot> </para> <para >Adesso è ora di aggiungere delle sezioni al rapporto e determinarne le dimensioni. Aggiungeremo <link linkend="report-header-and-footer" >un'intestazione e un piè di pagina di rapporto</link >, <link linkend="page-header-and-footer" >un'intestazione e un piè di pagina per le pagine</link > e una sola sezione <link linkend="detail" >dettagli</link >. Le intestazioni e i piè di pagina di rapporto sono stampati sulla prima e ultima pagina del rapporto, rispettivamente prima e dopo ogni altro dato del rapporto. I piè di pagina del rapporto sono un buon posto per i <link linkend="calculated-field-element" >campi calcolati</link >. Le intestazioni e i piè di pagina delle pagine sono stampati in cima e in fondo a ogni pagina. Il nostro rapporto avrà una sezione dettagli di livello 0. Ciò significa che tutte le nostre righe di dati hanno la stessa struttura (&ie; campi). Se una struttura di dati è più complessa, o è organizzata secondo una relazione tra elementi principali e dettagli, dovrebbero essere creati più livelli. Vedi <filename >sample3.ktf</filename > e <filename >sample3.kdf</filename > per un esempio di come si possa fare. Riferisciti alla <link linkend="template-elements" >descrizione dei elementi dei modelli</link > per maggiori informazioni. </para> <para >Le sezioni sono aggiunte usando il menu <guilabel >Sezioni</guilabel > o un elemento della <guilabel >Barra degli strumenti delle sezioni</guilabel >. Adesso aggiungi un'intestazione e il piè di pagina del rapporto, un'intestazione, un piè di pagina delle pagine e un dettaglio. Quando aggiungi una sezione dettaglio, imposta il suo livello a 0, come mostrato nella schermata sotto. <screenshot > <mediaobject> <imageobject> <imagedata fileref="tut_set_level.png" format="PNG"/> </imageobject> <textobject> <phrase >Impostare il livello di dettaglio</phrase> </textobject> </mediaobject> </screenshot> </para> <para >Il nostro rapporto dovrebbe ora assomigliare a questo nella schermata. <screenshot > <mediaobject> <imageobject> <imagedata fileref="tut_rep_look1.png" format="PNG"/> </imageobject> <textobject> <phrase >Rapporto con sezioni</phrase> </textobject> </mediaobject> </screenshot> </para> <para >Tutte le nostre sezioni hanno un'altezza predefinita, 50 mm. Cambiamola. Per farlo, premi il &RMB; sulla sezione Intestazione del rapporto, o fai clic sul pulsante <guilabel >Modifica proprietà</guilabel > nella <guilabel >Barra degli strumenti degli elementi</guilabel > e scegli una sezione. Dovrebbe apparire la finestra delle proprietà. <screenshot > <mediaobject> <imageobject> <imagedata fileref="tut_edit_height.png" format="PNG"/> </imageobject> <textobject> <phrase >Modifica dell'altezza della sezione</phrase> </textobject> </mediaobject> </screenshot> </para> <para >Adesso imposta l'altezza dell'intestazione del rapporto a 70. Facciamo questa procedura per tutte le altre sezioni. Imposta l'altezza dell'intestazione a 45 per le pagine e 30 per il dettaglio. I piè di pagina del rapporto e delle pagine dovrebbero essere alti 32 mm. </para> <para >Un modello di rapporto con sezioni appropriatamente dimensionate è pronto a essere riempito di elementi del rapporto. <screenshot > <mediaobject> <imageobject> <imagedata fileref="tut_rep_look2.png" format="PNG"/> </imageobject> <textobject> <phrase >Rapporto con sezioni dimensionate</phrase> </textobject> </mediaobject> </screenshot> </para> <para >Adesso puoi aggiungere elementi alle sezioni nel rapporto. Al rapporto possono essere aggiunti cinque tipi diversi di elementi. L'<link linkend="label-element" >Etichetta</link > è un'area rettangolare che può avere bordi e può essere riempita con qualsiasi tipo di dati testuali. I colori di primo piano e di sfondo dell'etichetta, così come i caratteri, possono essere cambiati. Anche i tipi di linee del bordo e i colori delle linee sono personalizzabili. I <link linkend="field-element" >Campi</link > possono essere posizionati su una sezione dettagli. I Campi rappresentano campi di dati; i loro valori saranno raccolti da un file dati nella generazione di un rapporto. Le conte, somme, medie, &etc; per i valori dei campi possono essere stampate sul rapporto attraverso i <link linkend="calculated-field-element" >Campi calcolati</link >. Gli <link linkend="special-element" >Speciali</link > sono etichette con testo predefinito, come la data corrente o il numero di pagina. L'aspetto generale del rapporto può essere ridefinito con le <link linkend="line-element" >Linee</link >. </para> <para >Per aggiungere un elemento del rapporto fai clic sull'elemento corrispondente sulla <guilabel >Barra degli strumenti degli elementi</guilabel > e posizionalo (con un clic) sulla sezione. L'elemento scelto sarà posizionato sulla sezione selezionata con l'angolo in alto a sinistra alle coordinate date. le altre proprietà sono impostate ai valori predefiniti, e possono essere cambiate con la finestra di dialogo <guilabel >Opzioni degli elementi del rapporto</guilabel > (nello stesso modo in cui abbiamo cambiato l'altezza della sezione). </para> <para >Aggiungiamo ora le etichette alle intestazioni del rapporto e delle pagine come mostrato nella schermata sotto. Nota che l'etichetta <quote >Mutiny Bay Software</quote > ha i suoi <guilabel >Stile del bordo</guilabel > e <guilabel >Larghezza del bordo</guilabel > impostati a 0 e <quote >Rapporto dell'inventario del software</quote > a 1 mm. Tutti i colori sono impostati come combinazione di tre valori (RGB; rosso, verde, blu) separati da virgole. </para> <para >Aggiungeremo anche elementi di campo alla sezione dettaglio. Supponi che abbiamo quattro campi: titolo, versione, piattaforma e copie. Quindi, dovrebbero essere posizionati quattro elementi <guilabel >Campo</guilabel > e impostate le loro proprietà di <guilabel >Campo</guilabel >. Nota che la proprietà <guilabel >Testo</guilabel > è impostata automaticamente a <quote >[<userinput >nome_campo</userinput >]</quote >. </para> <para >Il nostro piè di pagina è un buon posto dove mettere la data corrente e il numero di pagina, quindi aggiungi due campi speciali e imposta le loro proprietà <guilabel >Tipo</guilabel > a 0 e 1. Uno speciale di tipo 0 rappresenta una data, e uno di tipo 1 un numero di pagina. Nota che la proprietà <guilabel >Testo</guilabel > dello speciale è cambiata automaticamente. </para> <para >L'ultimo elemento da posizionare è un <guilabel >Campo calcolato</guilabel > per il campo <quote >copie</quote >. Per acquisire una somma di copie, imposta la proprietà <guilabel >Campo</guilabel > del campo calcolato a <quote >copie</quote > e <guilabel >Tipo di calcolo</guilabel > a 1 (funzione di somma). </para> <para >Finalmente, il nostro modello di rapporto dovrebbe apparire così: <screenshot > <mediaobject> <imageobject> <imagedata fileref="tut_rep_complete.png" format="PNG"/> </imageobject> <textobject> <phrase >Rapporto completo</phrase> </textobject> </mediaobject> </screenshot> </para> </sect1> <sect1 id="tut-2"> <title >Creare il file dati del rapporto</title> <para >In generale, i file dati possono essere creati in diversi modi. Alcuni useranno le tabelle di trasformazione xsl per generare dell'&XML; corretto da un altro documento &XML; (come un foglio di calcolo &kspread;); altri useranno il loro programma per scaricare i dati da una banca dati e riempire il file dati. In questa esercitazione lo creeremo semplicemente a mano. Il codice sorgente per l'esempio può essere trovato nel file <filename >sample1.kdf</filename > o copiato dall'esempio sotto. </para> <programlisting ><?xml version=<quote >1.0</quote > encoding=<quote >UTF-8</quote >?> <!DOCTYPE KugarData [ <!ELEMENT KugarData (Row* )> <!ATTLIST KugarData Template CDATA #REQUIRED> <!ELEMENT Row EMPTY> <!ATTLIST Row level CDATA #REQUIRED title CDATA #REQUIRED version CDATA #REQUIRED platform CDATA #REQUIRED copies CDATA #REQUIRED> ]> <KugarData Template="sample1.ktf"> <Row level="0" title=" BRU" version="15.0" platform="x86" copies="1"/> <Row level="0" title=" Caldera Open Linux" version="2.2" platform="x86" copies="3"/> <Row level="0" title=" K Desktop" version="1.1.1" platform="x86" copies="1"/> <Row level="0" title=" Netscape Communicator" version="4.6" platform="x86" copies="10"/> <Row level="0" title=" Redhat Linux" version="5.0" platform="x86" copies="11"/> <Row level="0" title=" Redhat Linux" version="5.1" platform="x86" copies="12"/> <Row level="0" title=" Redhat Linux" version="5.2" platform="x86" copies="14"/> <Row level="0" title=" Redhat Linux" version="6.0" platform="x86" copies="15"/> <Row level="0" title=" Star Office" version="5.0" platform="x86" copies="1"/> <Row level="0" title=" Star Office" version="5.1" platform="x86" copies="3"/> <Row level="0" title=" Microsoft Windows NT" version="3.1" platform="x86" copies="1"/> <Row level="0" title=" Microsoft Windows NT" version="3.51" platform="x86" copies="1"/> <Row level="0" title=" Microsoft Windows NT" version="4.0" platform="x86" copies="1"/> <Row level="0" title=" Microsoft Windows NT" version="5.0" platform="x86" copies="1"/> <Row level="0" title=" Sun Solaris" version="2.5" platform="Sparc" copies="1"/> </KugarData> </programlisting> </sect1> <sect1 id="tut-3"> <title >Generazione del rapporto</title> <para >Al momento abbiamo un modello di rapporto (<filename >sample1.ktf</filename >) e un file dati di rapporto (<filename >sample1.kdf</filename >). </para> <para >Per generare un rapporto, digita il seguente comando nella shell: <command >kugar<option > -r <replaceable >sample1.ktf</replaceable ></option > <option >-d <replaceable >sample1.kdf</replaceable ></option ></command > </para> <para >Ciò farà apparire una finestra di shell di &kugar; con il rapporto generato. <screenshot > <mediaobject> <imageobject> <imagedata fileref="tut_rep_generated.png" format="PNG"/> </imageobject> <textobject> <phrase >Rapporto generato</phrase> </textobject> </mediaobject> </screenshot> </para> </sect1> </chapter>