Alexander Dymo

    cloudtemple@mksat.net

Phil Thompson

    phil@river-bank.demon.co.uk

Federico Zenith

    zenith@chemeng.ntnu.no

Traduzione della documentazione in italiano

# Esercitazione

Questa esercitazione cercherà di essere una breve introduzione a Kugar.

Creerai un modello di rapporto campione con &kudesigner;, un file dati campione e infine genererai un rapporto completo.

Il codice sorgente per i modelli e i file dati campione può essere trovato in `sample1.ktf` e `sample1.kdf`, che sono distribuiti con &kugar;.

## Creare il modello di rapporto con &kudesigner;

Avvia Kugar Designer digitando `kudesigner` nella shell.

Dopo aver avviato il Designer, scegli File|Nuovo e imposta la dimensione della pagina a A4 e l'orientamento della carta a Orizzontale. 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.

Finestra di dialogo Nuovo rapporto

Viene ora creato un nuovo rapporto e tutti i pulsanti sulla Barra degli strumenti degli elementi e Barra degli strumenti delle sezioni sono ora abilitati (sono abilitati anche gli elementi dei corrispondenti menu Elementi e Sezioni).

Finestra di dialogo Rapporto vuoto

Adesso è ora di aggiungere delle sezioni al rapporto e determinarne le dimensioni. Aggiungeremo un'intestazione e un piè di pagina di rapporto, un'intestazione e un piè di pagina per le pagine e una sola sezione dettagli. 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 campi calcolati. 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 `sample3.ktf` e `sample3.kdf` per un esempio di come si possa fare. Riferisciti alla descrizione dei elementi dei modelli per maggiori informazioni.

Le sezioni sono aggiunte usando il menu Sezioni o un elemento della Barra degli strumenti delle sezioni. 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.

Impostare il livello di dettaglio

Il nostro rapporto dovrebbe ora assomigliare a questo nella schermata.

Rapporto con sezioni

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 Modifica proprietà nella Barra degli strumenti degli elementi e scegli una sezione. Dovrebbe apparire la finestra delle proprietà.

Modifica dell'altezza della sezione

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.

Un modello di rapporto con sezioni appropriatamente dimensionate è pronto a essere riempito di elementi del rapporto.

Rapporto con sezioni dimensionate

Adesso puoi aggiungere elementi alle sezioni nel rapporto. Al rapporto possono essere aggiunti cinque tipi diversi di elementi. L'Etichetta è 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 Campi 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 Campi calcolati. Gli Speciali sono etichette con testo predefinito, come la data corrente o il numero di pagina. L'aspetto generale del rapporto può essere ridefinito con le Linee.

Per aggiungere un elemento del rapporto fai clic sull'elemento corrispondente sulla Barra degli strumenti degli elementi 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 Opzioni degli elementi del rapporto (nello stesso modo in cui abbiamo cambiato l'altezza della sezione).

Aggiungiamo ora le etichette alle intestazioni del rapporto e delle pagine come mostrato nella schermata sotto. Nota che l'etichetta Mutiny Bay Software ha i suoi Stile del bordo e Larghezza del bordo impostati a 0 e Rapporto dell'inventario del software a 1 mm. Tutti i colori sono impostati come combinazione di tre valori (RGB; rosso, verde, blu) separati da virgole.

Aggiungeremo anche elementi di campo alla sezione dettaglio. Supponi che abbiamo quattro campi: titolo, versione, piattaforma e copie. Quindi, dovrebbero essere posizionati quattro elementi Campo e impostate le loro proprietà di Campo. Nota che la proprietà Testo è impostata automaticamente a [`nome_campo`].

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à Tipo 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à Testo dello speciale è cambiata automaticamente.

L'ultimo elemento da posizionare è un Campo calcolato per il campo copie. Per acquisire una somma di copie, imposta la proprietà Campo del campo calcolato a copie e Tipo di calcolo a 1 (funzione di somma).

Finalmente, il nostro modello di rapporto dovrebbe apparire così:

Rapporto completo

## Creare il file dati del rapporto

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 `sample1.kdf` o copiato dall'esempio sotto.

    <?xml version=1.0 encoding=UTF-8?>

    <!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>

## Generazione del rapporto

Al momento abbiamo un modello di rapporto (`sample1.ktf`) e un file dati di rapporto (`sample1.kdf`).

Per generare un rapporto, digita il seguente comando nella shell: `kugar`-r sample1.ktf` `-d sample1.kdf``

Ciò farà apparire una finestra di shell di &kugar; con il rapporto generato.

Rapporto generato