# Tutorial

Aquest tutorial pretén ser una breu introducció al Kugar.

Podeu crear una plantilla d'informe de prova amb el &kudesigner;, un fitxer de dades de prova i, finalment, generar un informe complet.

El codi font per a les plantilles de prova i els fitxers de dades es poden trobar a `sample1.ktf` i `sample1.kdf`, que es distribueixen amb el &kugar;.

## Creant la plantilla d'informe amb el &kudesigner;

Executeu el Kugar Designer teclejant `kudesigner` al terminal.

Després d'iniciar el dissenyador, escolliu Fitxer|Nou i arrangeu la mida de la pàgina Carta i orientació del paper a Apaïsat. Arrangeu els marges esquerre i dret a 48, els marges dalt i baix a 40. Totes les dimensions en el &kudesigner; (marges de pàgina, mides, posicions, &etc;) es mesuren en mil·límeters. Diàleg Nou informe

Ara s'ha creat un nou informe i estan disponibles tots els botons de la Barra d'eines Ítems i la Barra d'eines Seccions Toolbar (els corresponents ítems de menú d'Ítems i Seccions també estan disponibles). Finestra d'informe buida

Ara és hora d'afegir algunes seccions a l'informe i determina les seves mides. Afegirem un capçalera i peu d'informe, capçalera i peu de pàgina i una única secció detall. Les capçaleres i peus d'informe s'imprimeixen a la primera i última pàgina de l'informe abans i després de qualsevol altra dada d'informe. Els peus d'informe són bons llocs per a camps calculats. Les capçaleres i peus de pàgina s'imprimeixen a la part superior i inferior de cada pàgina. El nostre informe tindrà una secció de detall amb nivell 0. Això vol dir que totes les nostres files de dades tenen idèntica estructura (és a dir, camps). Si l'estructura de dades és més complexa o està organitzada d'acord amb una relació master-detall, s'hauran de crear més nivells de detall. Mireu `sample3.ktf` i `sample3.kdf` per a un exemple de com es pot fer això. Referiu-vos a les descripcions d'elements de plantilla per a informacions addicionals.

Les seccions s'afegeixen usant el menú Seccions o una Barra d'eines Seccions. Ara afegiu una capçalera i peu d'informe, una capçalera i peu de pàgina i llavors una secció detall. Quan afegiu una secció detall, arrangeu el seu nivell a 0 com es mostra a la captura de pantalla de sota. Arranjant el nivell de detall

El nostre informe ha de semblar-se a aquest a la captura de pantalla. Informe amb seccions

Totes les nostres seccions tenen una alçada predefinida - 50mm. Canviem-la. Per a fer-ho, dretcliqueu a la secció Capçalera d'informe o cliqueu el botó Edita les propietats a la Barra d'eines Edita i llavors escolliu una secció. S'hauria de mostrar la finestra de Propietats. Editant l'alçada de la secció

Ara arrangeu l'alçada de la capçalera d'informe a 70. Fem el mateix peer a totes les altres seccions. Arrangeu l'alçada de capçalera de pàgina a 45 i la de detalls a 30. Els peus de pàgina i d'informe han de ser de 32 mm d'alçada.

Una plantilla d'informe amb les seccions correctament amidades està llesta per a omplir-se amb ítems d'informe. Informe amb les seccions amidades

Ara podeu afegir-hi ítems a les seccions de l'informe. Es poden afegir cinc tipus diferents d'ítems a l'informe. Etiqueta és una àrea rectangular que poden tenir vores i es poden omplir amb qualsevol tipus de dades textuals. Els colors de primer pla i de fons de l'etiqueta, així com fonts, es poden afegir. Els tipus de línia de les vores i els colors de línia també són personalitzables. Els Camps es poden emplaçar en una secció detall. Els Camps representen camps de dades; els seus valors es recolliran des d'un fitxer de dades mentre es genera un informe. Els comptes, sumatoris, mitjanes, &etc; per als valors de camp es poden imprimir a l'informe mitjançant Camps calculats. Especials són etiquetes amb text predefinit, com a dada actual o número de pàgina. L'aparença d'informe general es pot refinar amb Línies.

Per a afegir un ítem d'informe, cliqueu el botó de l'ítem corresponent de la Barra d'eines d'ítems i emplaceu-lo (clic) a la secció. L'ítem escollit s'emplaçarà a la secció seleccionada amb la cantonada superior esquerra a les coordenades donades. Altres propietats s'arrangen als valors per omissió i es poden canviar amb el diàleg Opcions d'ítem d'informe (la mateixa manera que vam fer servir per a canviar l'alçada de la secció).

Bé, anem a afegir etiquetes a les capçaleres d'informe i de pàgina com es mostra a la captura de pantalla de sota. Noteu que l'etiqueta Mutiny Bay Software té les seves BorderStyle i BorderWidth arranjades a 0 i Software Inventory Report a 1mm. Qualsevol color està arranjat a una combinació de tres valors (RGB - red,green,blue) separats per comes.

També volem afegir elements a la secció detall. Just assumiu que tenim quatre camps - títol, versió, plataforma i còpies. Per tant, s'emplaçaran quatre elements de Camp i els seus conjunts de propietats de Camp. Noteu que la propietat Text s'arranja automàticament a [`field_name`].

El nostre peu de pàgina és un bon lloc per a mostrar la data actual i el número de pàgina, així que hi afegim dos camps especials i arranjats les seves propietats de Tipus a 0 i 1. Un especial amb Type=0 representarà la data i una amb Type=1 el número de pàgina. Noteu que la propietat especial de Text es canvia automàticament.

L'últim element per a emplaçar és un Camp calculat per al camo còpies. Per a adquirir un sumatori (còpies) arrangeu la propietat del camp calculat Camp a còpies i CalculationType a 1 (funció sum).

Finalment, la nostra plantilla d'informe hauria de semblar-se a això: Informe complet

## Crea el fitxer de dades d'informe

Generalment, els fitxers de dades es poden crear de moltes maneres. Algunes usaran taules de transformació xsl per a generar &XML; correcte des d'un altre document &XML; (com el full de càlcul &kspread;); altres usaran el seu propi programa per a agafar les dades des d'una base de dades i omplir el fitxer de dades. En aquest tutorial, el crearem simplement a mà. El codi font per a l'exemple es pot trobar al fitxer `sample1.kdf` o es pot copiar des de l'exemple de sota.

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

## Generant l'informe

En aquest moment, tenim una plantilla d'informe (`sample1.ktf`) i un fitxer de dades d'informe (`sample1.kdf`).

Per a generar un informe, teclegeu la següent comanda al terminal: `kugar `-r `sample1.ktf`` `-d `sample1.kdf```

Això presentarà una finestra d'espai de treball del &kugar; amb l'informe generat. Informe generat