<!-- 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
>Natalie</firstname
> <surname
>Koning</surname
><affiliation
><address
> <email
>nat@switch.demon.nl</email
></address
></affiliation
> <contrib
>Vertaler</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Snelcursus</title>

<para
>Deze snelcursus is een korte inleiding in het gebruik van Kugar.</para>

<para
>U leert hoe u een rapportsjabloon maakt met &kudesigner;, een gegevensbestand maakt en een compleet rapport genereert.</para>

<para
>De broncode voor sjablonen en gegevensbestanden kunt u vinden in de bestanden <filename
>sample1.ktf</filename
> en <filename
>sample1.kdf</filename
> die met &kugar; meegeleverd worden.</para>


<sect1 id="tut-1">
<title
>De rapportsjabloon creëren met &kudesigner;</title>

<para
>Start Kugar Designer door het commando <command
>kudesigner</command
> in een terminal te typen. </para>

<para
>Als de designer gestart is, kiest u <guimenu
>Bestand</guimenu
>|<guilabel
>Nieuw</guilabel
>. Stel de paginagrootte in op <guilabel
>Letter</guilabel
> en de oriëntatie op <guilabel
>Landschap</guilabel
>. Stel de linker- en rechtermarge in op 48, de boven- en ondermarge op 40. Alle afmetingen in &kudesigner; (paginamarges, grootten, posities, &etc;) worden opgegeven in millimeters. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_file_new.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Het dialoogvenster <interface
>Nieuw Rapport</interface
></phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Er is nu een nieuw rapport gecreëerd. Alle knoppen op de <guilabel
>Werkbalk Items</guilabel
> en <guilabel
>Werkbalk SectiesToolbar</guilabel
> zijn beschikbaar (de overeenkomstige items in de menu's <guilabel
>Items</guilabel
> en <guilabel
>Secties</guilabel
> zijn eveneens beschikbaar). <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_empty_report.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Venster met leeg rapport</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Nu wordt het tijd om enkele secties aan het rapport toe te voegen en hun afmetingen in te stellen. We gaan een <link linkend="report-header-and-footer"
>rapportkoptekst en -voettekst</link
>, een <link linkend="page-header-and-footer"
>paginakoptekst en -voettekst</link
> en één <link linkend="detail"
>detail</link
> toevoegen. Rapportkopteksten en -voetteksten worden op de eerste en op de laatste pagina van het rapport afgedrukt, voor en na alle andere rapportgegevens. Rapportvoetteksten zijn geschikte plaatsen om <link linkend="calculated-field-element"
>berekende velden</link
> in te voegen. Paginakopteksten en -voetteksten worden bovenaan en onderaan elke pagina afgedrukt. Ons rapport krijgt één detailsectie met niveau 0. Dit betekent dat al onze gegevensrijen een identieke structuur (&ie; velden) hebben. Als de structuur van de gegevens complexer is of als deze volgens een hiërarchie ingedeeld is, moeten er meer niveaus gecreëerd worden. In <filename
>sample3.ktf</filename
> en <filename
>sample3.kdf</filename
> kunt u hier een voorbeeld van vinden. U kunt aanvullende informatie vinden in <link linkend="template-elements"
>Beschrijving van sjabloonelementen</link
>. </para>

<para
>Secties kunnen worden toegevoegd via het menu <guilabel
>Secties</guilabel
> of door de <guilabel
>Werkbalk Secties</guilabel
> te gebruiken. Voeg nu een rapportkoptekst en -voettekst, een paginakoptekst en -voettekst en een detail toe. Stel het niveau van het detail in op 0, zoals op de schermafdruk hieronder te zien is. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_set_level.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Het detailniveau instellen</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Het rapport moet er nu uitzien zoals in de schermafdruk. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look1.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Rapport met secties</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Alle secties hebben een voorgedefinieerde hoogte van 50mm. We gaan dit wijzigen. Klik met de &RMB; op de sectie "Rapportkoptekst" of klik op de knop <guilabel
>Eigenschappen bewerken</guilabel
> op de <guilabel
>Werkbalk Bewerken</guilabel
> en kies een sectie. Het venster "Eigenschappen" wordt nu geopend. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_edit_height.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>De hoogte van de sectie wijzigen</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Stel de hoogte van de rapportkoptekst in op 70. We zullen alle andere secties ook meteen wijzigen. Stel de hoogte van de paginakoptekst in op 45, de hoogte van het detail op 30, de hoogte van de pagina- en rapportvoetteksten op 32 mm. </para>

<para
>De rapportsjabloon heeft nu secties waarvan de afmetingen aangepast zijn. Nu kunnen de rapportitems toegevoegd worden. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Rapport met secties waarvan de afmetingen aangepast zijn</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>U kunt nu items aan de secties in het rapport toevoegen. Er kunnen vijf verschillende typen items aan het rapport toegevoegd worden. <link linkend="label-element"
>Label</link
> is een rechthoekig gebied dat randen kan hebben en waar elke soort tekst in geplaatst kan worden. De voorgrond- en achtergrondkleur, evenals het lettertype in het label kan gewijzigd worden. De lijnstijl en de kleur van de rand kunnen ook aangepast worden. Een <link linkend="field-element"
>Veld</link
> kan in een detailsectie geplaatst worden. Velden representeren gegevensvelden; de waarden worden uit een gegevensbestand gehaald tijdens het genereren van het rapport. Aantallen, totalen, gemiddelden, &etc; kunnen in het rapport afgedrukt worden met behulp van <link linkend="calculated-field-element"
>Berekende velden</link
>. <link linkend="special-element"
>Speciale velden</link
> zijn labels met een voorgedefinieerde tekst, zoals de huidige datum of een paginanummer. Het uiterlijk van het rapport kan nog verder aangepast worden door het gebruik van <link linkend="line-element"
>Lijnen</link
>. </para>

<para
>Om een rapportitem toe te voegen klikt u op de overeenkomstige knop op de <guilabel
>Werkbalk Items</guilabel
> en klikt u op de gewenste plaats in de sectie. Het gekozen item wordt in de geselecteerde sectie geplaatst met de linkerbovenhoek op de opgegeven coördinaten. Andere eigenschappen zijn ingesteld op de standaardwaarden en kunnen in het dialoogvenster <guilabel
>Rapport-item-opties</guilabel
> gewijzigd worden (op dezelfde manier waarop we de hoogte van de secties gewijzigd hebben). </para>

<para
>We gaan nu labels aan de rapport- en paginakoptekst toevoegen zoals op de schermafdruk hieronder. Het label <quote
>Mutiny Bay Software</quote
> heeft een <guilabel
>Randstijl</guilabel
> en <guilabel
>Randdikte</guilabel
> die ingesteld zijn op 0, voor het label <quote
>Software Inventaris Rapport</quote
> zijn deze ingesteld op 1mm. Alle kleuren worden ingesteld als een combinatie van drie waarden (RGB - red,green,blue), gescheiden door komma's. </para>

<para
>We gaan nu veldelementen aan de detailsectie toevoegen. We nemen aan dat we vier velden hebben - titel, versie, platform en aantal. We voegen dus vier <guilabel
>Veld</guilabel
>elementen toe en stellen hun eigenschappen in. De eigenschap <guilabel
>Tekst</guilabel
> wordt automatisch ingesteld op <quote
>[<userinput
>field_name</userinput
>]</quote
>. </para>

<para
>De paginavoettekst is een geschikte plaats voor de huidige datum en het paginanummer. We voegen twee speciale velden toe en stellen de eigenschappen van het <guilabel
>Type</guilabel
> in op 0 en 1. Een speciaal veld met Type=0 representeert de datum, met Type=1 het paginanummer. De eigenschap <guilabel
>Tekst</guilabel
> van een speciaal veld wordt automatisch gewijzigd. </para>

<para
>Het laatste element dat we toevoegen is een <guilabel
>Berekend veld</guilabel
> voor het veld <quote
>aantal</quote
>. Om het aantal te berekenen stelt u de eigenschap <guilabel
>Veld</guilabel
> in op <quote
>aantal</quote
>  en het <guilabel
>Berekenigstype</guilabel
> op 1 (somfunctie). </para>

<para
>Uiteindelijk moet de rapportsjabloon er zo uitzien: <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_complete.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Het complete rapport</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>



<sect1 id="tut-2">
<title
>Het gegevensbestand voor het rapport creëren</title>

<para
>In het algemeen kunnen gegevensbestanden op verscheidene manieren gecreëerd worden. U kunt xsl-transformatietabellen gebruiken om correcte &XML; van een ander &XML;-document te genereren (zoals een &kspread;-spreadsheet); een andere mogelijkheid is om een eigen programma te gebruiken dat de gegevens uit een database haalt en in het gegevensbestand zet. In deze snelcursus creëren we het gegevensbestand handmatig. U kunt de broncode voor het voorbeeld in het bestand <filename
>sample1.kdf</filename
> vinden of van het onderstaande voorbeeld kopiëren. </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
>Het rapport genereren</title>

<para
>We hebben nu een rapportsjabloon (<filename
>sample1.ktf</filename
>) en een rapportgegevensbestand (<filename
>sample1.kdf</filename
>). </para>
<para
>Om een rapport te genereren typt u het volgende commando in de shell: <command
>kugar <option
>-r <replaceable
>sample1.ktf</replaceable
></option
> <option
>-d <replaceable
>sample1.kdf</replaceable
></option
></command
> </para>

<para
>Het venster van de &kugar;-shell wordt geopend met het gegenereerde rapport. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_generated.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Gegenereerd rapport</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>

</chapter>
