<!-- 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>
&erik.kjaer.pedersen.role; 
</authorgroup>
</chapterinfo>
<title
>Gennemgang</title>

<para
>Denne gennemgang tjener som en kortfattet indledning til Kugar.</para>

<para
>Antag at du vil oprette en skabelon for en eksempelrapport med &kudesigner;, en eksempeldatafil, og til sidst oprette en fuldstændig rapport.</para>

<para
>Kildekoden for eksempelskabeloner og datafiler er i <filename
>sample1.ktf</filename
> og <filename
>sample1.kdf</filename
> som kommer med &kugar;.</para>


<sect1 id="tut-1">
<title
>Oprettelse af rapportskabelon med &kudesigner;</title>

<para
>Kør Kugar Designer ved at skrive <command
>kudesigner</command
> i en terminal. </para>

<para
>Efter du har startet designer, vælg <guimenu
>Fil</guimenu
> | <guilabel
>Ny</guilabel
> og indstil in sidestørrelsen til <guilabel
>Letter</guilabel
> og sideorienteringen til <guilabel
>Landskab</guilabel
>. Indstil in venstre og højre margin til 48, øvre og nedre margin til 40. Alle dimensioner i &kudesigner; (sidemarginer, størrelser, positioner, osv.) angives i millimeter. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_file_new.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Dialogen <interface
>Ny rapport</interface
></phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>En ny rapport er nu oprettet, og alle knapper i værktøjslinjerne <guilabel
>Objektværktøjslinje</guilabel
> og <guilabel
>Afsnitsværktøjslinje</guilabel
> er nu aktive (de tilsvarende menupunkter i menuerne <guilabel
>Objekt</guilabel
> og <guilabel
>Afsnit</guilabel
> er også aktive). <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_empty_report.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Tomt rapportvindue</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Nu er det tid at tilføje nogle afsnit i rapporten, og afgøre deres størrelser. Vi tilføjer <link linkend="report-header-and-footer"
>sidehoved og sidefod for rapport</link
>, <link linkend="page-header-and-footer"
>sidehoved og sidefod</link
> og et enkelt <link linkend="detail"
>detalje</link
>-afsnit. Sidehoved og sidefod for rapporten udskrives på første og sidste side af rapporten før og efter al anden rapportdata. En sidefod for rapporten er et godt sted at have <link linkend="calculated-field-element"
>beregnede felter</link
>. Sidehoved og sidefod udskrives ud længst oppe og længst nede på hver side. Vores rapport har et detaljeafsnit med niveau 0. Det betyder at alle datarækker har identiske strukturer (dvs. felter). Hvis datastrukturen er mere kompliceret, eller er organiseret i et  mester-detalje forhold, bør flere detaljeniveauer laves. Se <filename
>sample3.kut</filename
> og <filename
>sample3.kud</filename
>, for et eksempel på hvordan dette kan gøres. Kig i <link linkend="template-elements"
>beskrivelsen af skabelonelement</link
> for yderligere information. </para>

<para
>Afsnit tilføjes ved at bruge menuen <guilabel
>Afsnit</guilabel
> eller <guilabel
>Afsnitsværktøjslinjen</guilabel
>. Tilføj nu hovede for rapport, sidehoved, sidefod og derefter detaljeafsnittet. Når detaljeafsnittet tilføjes, sæt dets niveau til 0, som vist på skærmaftrykket nedenfor. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_set_level.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Angiv detaljeniveau</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Vor rapport bør nu se ud som den på skærmaftrykket. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look1.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Rapport med afsnit</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Alle vore afsnit har en prædefineret højde - 50 mm. Lad os ændre den. For at gøre dette, højreklikkes på afsnittets sidehoved for rapport, eller klik på knappen <guilabel
>Redigér egenskaber</guilabel
> og vælg derefter et afsnit. Egenskabsvinduet skulle så vises. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_edit_height.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Redigér højden af afsnit</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Ændr nu højden for rapportens sidehoved til 70. Lad os udføre samme procedure for alle andre afsnit. Ændr sidehovedets højde til 45, og detaljerne til 30. Rapportens og sidens sidefod skal være 32 mm høje. </para>

<para
>En rapportskabelon med afsnit som har rigtigt størrelse er klar at blive udfyldt med rapportpunkter. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Rapport med afsnit som har rigtig størrelse</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Nu kan man tilføje punkter til afsnittene i rapporten. Fem forskellige slags punkter kan tilføjes i rapporten. <link linkend="label-element"
>Etiket</link
> er et rektangulært område som kan have kanter, og kan fyldes med hvilke som helst tekstdata. Etikettekst- og baggrundsfarver samt skrifttype kan ændres. Typen af kantlinjen og linjefarver kan også indstilles. <link linkend="field-element"
>Felt</link
> kan placeres i et detaljeafsnit. Felt representerer datafelter, deres værdier hentes fra en datafil når en rapport laves. Antal, summer, middelværdier, osv. for feltværdier kan udskrives i rapporten med hjælp af et<link linkend="calculated-field-element"
>beregningsfelt</link
>. <link linkend="special-element"
>Specialfelter</link
> er etiketter med fordefineret tekst, som dagens dato eller sidenummer. Generelt rapportudseende kan forfines med <link linkend="line-element"
>Linjer</link
>. </para>

<para
>For at tilføje et rapportpunkt, klikkes på tilsvarende punktknap på <guilabel
>Punktværktøjslinjen</guilabel
> og placér (klik) det i afsnittene. Det valgte punkt vil blive placeret i det markerede afsnit med øvre venstre hjørne på de angivne koordinater. Andre egenskaber sættes til normalværdier, og kan ændres i dialogen <guilabel
>Rapportpunktvalg</guilabel
> (på samme måde som vi ændrede højde for afsnittene). </para>

<para
>Lad os altså tilføje etiketter til rapportens sidehoved, og sidehovedet som vises på skærmaftrykkene nedenfor. Bemærk at etiketten <quote
>Mutiny Bay Software</quote
> har sin <guilabel
>kantstil</guilabel
> og <guilabel
>kantbredde</guilabel
> angivet til 0 mm, og <quote
> Inventarrapporten for programmel</quote
> til 1 mm. Alle farver angives som en kombination af tre værdier (RGB, rød, grøn, blå) afgrænsede med kommategn. </para>

<para
>Vi vil også tilføje feltpunkter i detaljeafsnittene. Antag at vi kun har fire felter: titel, version, platform og antal kopier. Altså skal fire <guilabel
>Felt</guilabel
>-punkter  placeres, og deres egenskab <guilabel
>Felt</guilabel
> angives. Bemærk at egenskaben <guilabel
>Tekst</guilabel
> automatisk er sat til <quote
>[<userinput
>felt_navn</userinput
>]</quote
>. </para>

<para
>Vor sidefod er et godt sted at vise dagens dato og sidenummer, så tilføj to specialfelter og angive deres egenskab <guilabel
>Type</guilabel
> til 0 og 1. Et specialfelt med type = 0 repræsenterer dato, og et med type = 1 sidenummer. Bemærk at specialfeltets egenskab <guilabel
>Tekst</guilabel
> ændres automatisk. </para>

<para
>Det sidste objekt som skal placeres er et <guilabel
>Beregnet felt</guilabel
> for <quote
>antal kopier</quote
>. For at hente en sum(antal kopier), ændres det beregnede felts egenskab <guilabel
>Felt</guilabel
> til <quote
>antal kopier</quote
>, og <guilabel
>Beregningstype</guilabel
> til 1 (sumfunktion). </para>

<para
>Endelig bør vor rapportskabelon se sådan her ud: <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_complete.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Fuldstændig rapport</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>



<sect1 id="tut-2">
<title
>Opret rapportdatafilen</title>

<para
>I almindelighed kan datafiler laves på flere måder. Nogen bruger måske xsl-transformeringstabeller for at oprette en rigtig xml fra et andet xml-dokument (såsom et Kspread beregningsblad), nogle andre bruger et eget program for at hente data i en database og udfylde i datafilen. I denne vejledning laver vi den simpelthen i hånden. Kildekoden for eksemplet er i filen <filename
>sample1.kdf</filename
>, eller kan kopieres fra eksemplet nedenfor. </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
>Opret rapporten</title>

<para
>På dette tidspunkt har vi en rapportskabelon (<filename
>sample1.ktf</filename
>) og en rapportdatafil (<filename
>sample1.kdf</filename
>). </para>
<para
>For at oprette rapporten, skrives følgende kommando i en terminal: <command
>kugar <option
>-r <replaceable
>sample1.kut</replaceable
></option
> <option
>-d <replaceable
>sample1.kdf</replaceable
></option
></command
> </para>

<para
>Dette får et &kugar;-skalvindue fre, med den oprettede rapport. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_generated.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Oprettet rapport</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>

</chapter>
