You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
381 lines
13 KiB
381 lines
13 KiB
<!-- 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>
|