<!-- 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
>&lt;?xml version=<quote
>1.0</quote
> encoding=<quote
>UTF-8</quote
>?&gt;

&lt;!DOCTYPE KugarData [
    &lt;!ELEMENT KugarData (Row* )&gt;
    &lt;!ATTLIST KugarData
        Template CDATA #REQUIRED&gt;

    &lt;!ELEMENT Row EMPTY&gt;
    &lt;!ATTLIST Row
        level CDATA #REQUIRED
        title CDATA #REQUIRED
        version CDATA #REQUIRED
        platform CDATA #REQUIRED
        copies CDATA #REQUIRED&gt;
]&gt;

&lt;KugarData Template="sample1.ktf"&gt;
    &lt;Row level="0" title="  BRU" version="15.0" platform="x86" copies="1"/&gt;
    &lt;Row level="0" title="  Caldera Open Linux" version="2.2" platform="x86" copies="3"/&gt;
    &lt;Row level="0" title="  K Desktop" version="1.1.1" platform="x86" copies="1"/&gt;
    &lt;Row level="0" title="  Netscape Communicator" version="4.6" platform="x86" copies="10"/&gt;
    &lt;Row level="0" title="  Redhat Linux" version="5.0" platform="x86" copies="11"/&gt;
    &lt;Row level="0" title="  Redhat Linux" version="5.1" platform="x86" copies="12"/&gt;
    &lt;Row level="0" title="  Redhat Linux" version="5.2" platform="x86" copies="14"/&gt;
    &lt;Row level="0" title="  Redhat Linux" version="6.0" platform="x86" copies="15"/&gt;
    &lt;Row level="0" title="  Star Office" version="5.0" platform="x86" copies="1"/&gt;
    &lt;Row level="0" title="  Star Office" version="5.1" platform="x86" copies="3"/&gt;
    &lt;Row level="0" title="  Microsoft Windows NT" version="3.1" platform="x86" copies="1"/&gt;
    &lt;Row level="0" title="  Microsoft Windows NT" version="3.51" platform="x86" copies="1"/&gt;
    &lt;Row level="0" title="  Microsoft Windows NT" version="4.0" platform="x86" copies="1"/&gt;
    &lt;Row level="0" title="  Microsoft Windows NT" version="5.0" platform="x86" copies="1"/&gt;
    &lt;Row level="0" title="  Sun Solaris" version="2.5" platform="Sparc" copies="1"/&gt;
&lt;/KugarData&gt;
</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>
