<!-- 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
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@starman.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Algõpe</title>

<para
>Käesolev algõppekursus püüab lühidalt ja kokkuvõtlikult tutvustada Kugari põhiomadusi.</para>

<para
>Me näitame, kuidas luua aruande mall &kudesigner;iga, andmefail ning lõpuks genereerime terve aruande.</para>

<para
>Näidismallide ja -andmefailide lähtekoodi võib uurida &kugar;ile kaasa pandud failides <filename
>sample1.ktf</filename
> ja <filename
>sample1.kdf</filename
>.</para>


<sect1 id="tut-1">
<title
>Aruande malli loomine &kudesigner;i abil</title>

<para
>Käivita Kugar Disainer, andes käsu <command
>kudesigner</command
>. </para>

<para
>Pärast käivitamist vali käsk <guimenu
>Fail</guimenu
>|<guilabel
>Uus</guilabel
> ning määra paberi suuruseks <guilabel
>Letter</guilabel
> ja suunaks <guilabel
>Rõhtpaigutus</guilabel
>. Vasakule ja paremale äärele anna väärtuseks 48, ülemisele ja alumisele 40. Kõik mõõtmed &kudesigner;is (lehekülje ääred, asukohad &etc;) on millimeetrites. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_file_new.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Dialoog <interface
>Uus aruanne</interface
></phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Nüüd luuakse uus aruanne ning kõik <guilabel
>elemendiriba</guilabel
> ja <guilabel
>sektsiooniriba</guilabel
> nupud muutuvad aktiivseks (samuti analoogsed menüüelemendid menüüdes <guilabel
>Elemendid</guilabel
> ja <guilabel
>Sektsioonid</guilabel
>). <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_empty_report.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Tühja aruande aken</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Nüüd on aeg lisada aruandele mõned sektsioonid ja määrata kindlaks nende suurus. Me lisame <link linkend="report-header-and-footer"
>aruande päise ja jaluse</link
>, <link linkend="page-header-and-footer"
>lehekülje päise ja jaluse</link
> ning ühe <link linkend="detail"
>detailisektsiooni</link
>. Aruande päised ja jalused on näha aruande esimesel ja viimasel leheküljel vastavalt enne ja pärast kõiki aruande andmeid. Aruande jalused on näiteks hea koht <link linkend="calculated-field-element"
>arvutuslike väljade</link
> jaks. Lehekülje päised ja jalused on iga lehekülje üla- ja alaosas. Meie aruandes on üks detailisektsioon tasemel 0. See tähendab, et kõigil andmeridadel on ühesugune struktuur (&ie; väljad). Kui andmestruktuur on keerukam või organiseeritud allumispõhimõttel, tuleks luua rohkem detailitasandeid. Vaata failidest <filename
>sample3.ktf</filename
> ja <filename
>sample3.kdf</filename
>, kuidas seda teha. Lisainfot leiab <link linkend="template-elements"
>mallielemente kirjeldavast</link
> osast. </para>

<para
>Sektsioone saab lisada menüüst <guilabel
>Sektsioonid</guilabel
> või <guilabel
>sektsiooniriba</guilabel
> nuppudega. Lisame nüüd aruande päise ja jaluse, lehekülje päise ja jaluse ning detaili. Detaili lisades seame selle tasemeks 0, nagu näidatud alltoodud pildil. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_set_level.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Detaili taseme määramine</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Meie aruanne peaks nüüd välja nägema selline. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look1.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Sektsioonidega aruanne</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Kõigil sektsioonidel on eelnevalt määratud kõrgus 50 mm. Muudame seda. Selleks klõpsa &HPN;ga aruande päise sektsioonil või klõpsa <guilabel
>redigeerimisribal</guilabel
> nupul <guilabel
>Muuda omadusi</guilabel
> ning vali siis sektsioon. Nüüd ilmub omaduste aken. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_edit_height.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Sektsiooni kõrguse muutmine</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Määrame aruande päise kõrguseks 70. Teeme seda ka kõigi ülejäänud nelja sektsiooniga, määrates lehekülje päise kõrguseks 45 ning detaili kõrguseks 30. Lehekülje ja aruande jalused peaksid mõlemad olema 32 mm kõrgused. </para>

<para
>Nüüd on meil sobilikus suuruses sektsioonidega aruande mall, mis ainult ootab, et teda täitma hakataks. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Erinevas suuruses sektsioonidega aruanne</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Aruandele saab nüüd lisada elemente. Neid on olemas viis erinevat tüüpi. <link linkend="label-element"
>Pealdis</link
> on ristkülikuline piirkond, mille piiride vahele võib sisestada suvalisi tekstiandmeid. Pealdise teksti ja tausta värvi, samuti fonte on võimalik muuta. Muuta võib ka piirde tüüpi ja värvi. <link linkend="field-element"
>Välja</link
> võib lisada detailisektsiooni. Väljad tähistavad andmevälju, nende andmed hangitakse aruande loomisel andmefailist. Summad, keskmised &etc; väärtused saab aruandes esitada <link linkend="calculated-field-element"
>arvutatud väljal</link
>. <link linkend="special-element"
>Eriomadustega väljad</link
> kujutavad endast eelnevalt määratud tekstiga pealdisi, kus tekstiks on näiteks käesolev kuupäev või leheküljenumber. Aruande üldist välimust saab viimistleda <link linkend="line-element"
>joontega</link
>. </para>

<para
>Elemendi lisamiseks aruandele klõpsa vastavalt elemendil <guilabel
>elemendiriba</guilabel
>l ja uue klõpsuga aseta see vajalikku sektsiooni. Valitud element asetatakse sektsiooni nii, et tema ülemine vasak nurk asuks määratud asukohas. Muud omadused vastavad vaikeväärtustele ning neid saab muuta dialoogis <guilabel
>Aruandeelemendi valikud</guilabel
> (see sarnaneb sektsiooni kõrguse muutmisega). </para>

<para
>Lisame nüüd aruande ja lehekülje päisele pealdised, nagu näidatud allpool oleval pildil. Pane tähele, et pealdise <quote
>Mutiny Bay Software</quote
> <guilabel
>piirde stiil</guilabel
> ja <guilabel
>piirde laius</guilabel
> on väärtusega 0 ning pealdisel <quote
>Software Inventory Report</quote
> on need -1mm. Kõik värvid on antud kolme värvi (RGB ehk punane, roheline ja sinine) kombinatsioonina, väärtuste eraldajaks komad. </para>

<para
>Lisame ka väljaelemendi detailisektsiooni. Oletame, et meil läheb vaja nelja välja (tiitel, versioon, platvorm ja eksemplaride arv). Seega tuleb asetada paika neli <guilabel
>välja</guilabel
> ning kõigi <guilabel
>väljade</guilabel
> omadused paika määrata. Pane tähele, et omadus <guilabel
>Tekst</guilabel
> on automaatselt <quote
>[<userinput
>field_name</userinput
>]</quote
> </para>

<para
>Lehekülje jalus on just sobilik koht käesoleva kuupäeva ja leheküljenumbri esitamiseks, seega lisame siia kaks eriomadustega välja ning määrame nende omaduse <guilabel
>Tüüp</guilabel
> väärtuseks vastavalt 0 ja 1, kus Tüüp=0 tähistab kuupäeva ja Tüüp=1 leheküljenumbrit. Pane tähele, et eriomadustega välja omadus <guilabel
>Tekst</guilabel
> muutub seepeale automaatselt. </para>

<para
>Viimasena lisame <guilabel
>arvutusliku välja</guilabel
> meie <quote
>eksemplaride</quote
> väljale. Et seal ikka arvutataks välja summa (ehk siis eksemplaride arv), määra omadusele <guilabel
>Väli</guilabel
> väärtuseks <quote
>eksemplarid</quote
> ning omadusele <guilabel
>Arvutuse tüüp</guilabel
> 1 ehk summa. </para>

<para
>Lõpuks peaks meie aruande mall välja nägema selline: <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_complete.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Valmis aruanne</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>



<sect1 id="tut-2">
<title
>Aruande andmefaili loomine</title>

<para
>Üldiselt saab andmefaile luua mitmel moel. Võib näiteks kasutada XSL teisendustabelit mingist &XML;-dokumendist (näiteks &kspread;i arvutustabel) sobiva &XML;-i genereerimiseks. Võib kasutada ka mingit oma rakendust andmete hankimiseks andmebaasist ja nende andmefaili seadmiseks. Siinses algõppekursuses lahendame asjad vajalikku faili käsitsi luues. Meie näidise lähtekoodi leiab failis <filename
>sample1.kdf</filename
>, selle võib ka lihtsalt kopeerida allpool toodud näitest. </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
>Aruande genereerimine</title>

<para
>Nüüd on meil olemas aruande mall (<filename
>sample1.ktf</filename
>) ja aruande andmed (<filename
>sample1.kdf</filename
>). </para>
<para
>Aruande genereerimiseks anna käsureal korraldus: <command
>kugar <option
>-r <replaceable
>sample1.ktf</replaceable
></option
> <option
>-d <replaceable
>sample1.kdf</replaceable
></option
></command
> </para>

<para
>See peaks nüüd avama &kugar;i põhiakna, kus loodud aruanne on ilusasti näha. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_generated.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Genereeritud aruanne</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>

</chapter>
