diff options
Diffstat (limited to 'koffice-i18n-it/docs/koffice/kugar/tutorial.docbook')
| -rw-r--r-- | koffice-i18n-it/docs/koffice/kugar/tutorial.docbook | 380 |
1 files changed, 380 insertions, 0 deletions
diff --git a/koffice-i18n-it/docs/koffice/kugar/tutorial.docbook b/koffice-i18n-it/docs/koffice/kugar/tutorial.docbook new file mode 100644 index 00000000..a992d823 --- /dev/null +++ b/koffice-i18n-it/docs/koffice/kugar/tutorial.docbook @@ -0,0 +1,380 @@ +<!-- 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 +>[email protected]</email +></address> +</affiliation> +</author> +<author +><firstname +>Phil</firstname +> <surname +>Thompson</surname +> <affiliation +> <address +><email +>[email protected]</email +></address> +</affiliation> +</author> +<othercredit role="translator" +><firstname +>Federico</firstname +><surname +>Zenith</surname +><affiliation +><address +><email +>[email protected]</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> |