<!-- 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
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@comhem.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Handledning</title>

<para
>Den här handledningen tjänar som en kortfattad inledning till Kugar.</para>

<para
>Antag att du vill skapa en exempelrapportmall med &kudesigner;, en exempeldatafil, och till sist skapa en fullständig rapport.</para>

<para
>Källkoden för exempelmallar och datafiler finns i <filename
>sample1.ktf</filename
> och <filename
>sample1.kdf</filename
> som levereras med &kugar;.</para>


<sect1 id="tut-1">
<title
>Att skapa rapportmallen med &kudesigner;</title>

<para
>Kör Kugar Designer genom att skriva <command
>kudesigner</command
> i en terminal. </para>

<para
>Efter du startat designer, välj <guimenu
>Arkiv</guimenu
> | <guilabel
>Ny</guilabel
> och ställ in sidstorleken till <guilabel
>Letter</guilabel
> och sidorienteringen till <guilabel
>Liggande</guilabel
>. Ställ in vänster och höger marginal till 48, övre och nedre marginal till 40. Alla dimensioner i &kudesigner; (sidmarginaler, storlekar, positioner, etc.) anges i millimeter. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_file_new.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Dialogrutan <interface
>Ny rapport</interface
></phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>En ny rapport har nu skapats, och alla knappar i verktygsraderna <guilabel
>Objektverktygsrad</guilabel
> och <guilabel
>Sektionsverktygsrad</guilabel
> är nu aktiva (motsvarande menyalternativ i menyerna <guilabel
>Objekt</guilabel
> och <guilabel
>Sektioner</guilabel
> är också aktiva). <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_empty_report.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Tomt rapportfönster</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Nu är det dags att lägga till några sektioner i rapporten, och avgöra deras storlekar. Vi lägger till <link linkend="report-header-and-footer"
>sidhuvud och sidfot för rapport</link
>, <link linkend="page-header-and-footer"
>sidhuvud och sidfot</link
> och en enda <link linkend="detail"
>detalj</link
>sektion. Sidhuvud och sidfot för rapporten skrivs ut på första och sista sidan av rapporten före och efter all annan rapportdata. En sidfot för rapporten är ett bra ställe att ha <link linkend="calculated-field-element"
>beräknade fält</link
>. Sidhuvud och sidfot skrivs ut längst upp och längst ner på varje sida. Vår rapport har en detaljsektion med nivå 0. Det betyder att alla datarader har identisk struktur (dvs. fält). Om datastrukturen är mer komplicerad, eller är organiserad i med förhållandet huvud-detalj, bör fler detaljnivåer skapas. Se <filename
>sample3.ktf</filename
> och <filename
>sample3.kdf</filename
>, för ett exempel på hur detta kan göras. Titta i <link linkend="template-elements"
>beskrivningen av mallelement</link
> för ytterligare information. </para>

<para
>Sektioner läggs till genom att använda menyn <guilabel
>Sektioner</guilabel
> eller <guilabel
>Sektionsverktygsraden</guilabel
>. Lägg nu till sidhuvud och sidfot för rapport, sidhuvud, sidfot och därefter detaljsektionen. När detaljsektionen läggs till, ange nivån till 0, som visas på skärmbilden nedan. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_set_level.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ange detaljnivå</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Vår rapport bör nu se ut som den på skärmbilden. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look1.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Rapport med sektioner</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Alla våra sektioner har en förinställd höjd - 50 mm. Låt oss ändra den. För att göra det, högerklicka på sektionen sidhuvud för rapport, eller klicka på knappen <guilabel
>Redigera egenskaper</guilabel
> i redigeringsverktygsraden och välj sedan en sektion. Egenskapsfönstret ska visas. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_edit_height.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Redigera höjden på sektionerna</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Ändra nu höjden för rapportens sidhuvud till 70. Låt oss utföra samma procedur för alla andra sektioner. Ändra sidhuvudets höjd till 45, och detaljsektionens till 30. Rapportens och sidans sidfot ska vara 32 mm höga. </para>

<para
>En rapportmall med sektioner som har riktigt storlek är klar att fylla i med rapportobjekt. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Rapport med sektioner som har rätt storlek</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Nu kan man lägga till objekt till sektionerna i rapporten. Fem olika sorters objekt kan läggas till i rapporten. <link linkend="label-element"
>Etikett</link
> är ett rektagulärt område som kan ha kanter, och kan fyllas med vilken textdata som helst. Text- och bakgrundsfärger samt teckensnitt kan ändras. Typ av kantlinje och linjefärger kan också anpassas. <link linkend="field-element"
>Fält</link
> kan placeras i en detaljsektion. Fält representerar datafält, deras värden hämtas från en datafil när en rapport skapas. Antal, summor, medelvärden, etc. för fältvärden kan skrivas ut i rapporten med hjälp av <link linkend="calculated-field-element"
>beräknade fält</link
>. <link linkend="special-element"
>Specialfält</link
> är etiketter med fördefinerad text, som dagens datum eller sidnummer. Allmänt rapportutseende kan förfinas med <link linkend="line-element"
>Linjer</link
>. </para>

<para
>För att lägga till ett rapportobjekt, klicka på motsvarande objektknapp på <guilabel
>Objektverktygsraden</guilabel
> och placera (klicka) det på sektionen. Det valda objektet kommer att placeras på den markerade sektionen med övre vänstra hörnet på de angivna koordinaterna. Andra egenskaper sätts till normalvärden, och kan ändras i dialogrutan <guilabel
>Rapportobjektalternativ</guilabel
> (på samma sätt som vi ändrade höjd för sektionerna). </para>

<para
>Låt oss alltså lägga till etiketter till rapportens sidhuvud, och sidhuvudet som visas på skärmbilden nedan. Observera att etiketten <quote
>Mutiny Bay Software</quote
> har sin <guilabel
>kantstil</guilabel
> och <guilabel
>kantbredd</guilabel
> inställda till 0 mm, och <quote
> Inventarierapport för programvara</quote
> till 1 mm. Alla färger anges som en kombination av tre värden (RGB, röd, grön, blå) avgränsade med kommatecken. </para>

<para
>Lägg också till fältobjekt i detaljsektionen. Antag att vi bara har fyra fält: titel, version, plattform och antal kopior. Alltså ska fyra <guilabel
>Fält</guilabel
>-objekt placeras, och deras egenskap <guilabel
>Fält</guilabel
> anges. Observera att egenskapen <guilabel
>Text</guilabel
> är automatiskt satt till <quote
>[<userinput
>fält_namn</userinput
>]</quote
>. </para>

<para
>Vår sidfot är ett bra ställe att visa dagens datum och sidnummer, så lägg till två specialfält och ange deras egenskap <guilabel
>Typ</guilabel
> till 0 och 1. Ett specialfält med typ = 0 representerar datum, och ett men typ = 1 sidnummer. Observera att specialfältens egenskap <guilabel
>Text</guilabel
> ändras automatiskt. </para>

<para
>Det sista objektet som ska placeras är ett <guilabel
>Beräknat fält</guilabel
> för <quote
>antal kopior</quote
>. För att hämta en summa(antal kopior), ändra det beräknade fältets egenskap <guilabel
>Fält</guilabel
> till <quote
>antal kopior</quote
>, och <guilabel
>Beräkningstyp</guilabel
> till 1 (summeringsfunktion). </para>

<para
>Till sist bör vår rapportmall se ut så här: <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_complete.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Fullständig rapport</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>



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

<para
>I allmänhet kan datafiler skapas på flera sätt. Någon kanske använder xsl-transformeringstabeller för att skapa riktig &XML; från ett annat &XML;-dokument (som ett &kspread; kalkylblad), någon annan använder ett eget program för att hämta data i en databas och fylla i datafilen. I den här handledningen skapar vi den helt enkelt för hand. Källkoden för exemplet finns i filen <filename
>sample1.kdf</filename
>, eller kan kopieras från exemplet nedan. </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
>Skapa rapporten</title>

<para
>Vid detta tillfälle har vi en rapportmall (<filename
>sample1.ktf</filename
>) och en rapportdatafil (<filename
>sample1.kdf</filename
>). </para>
<para
>För att skapa rapporten, skriv följande kommandon i en terminal: <command
>kugar <option
>-r <replaceable
>sample1.ktf</replaceable
></option
> <option
>-d <replaceable
>sample1.kdf</replaceable
></option
></command
> </para>

<para
>Då visas ett &kugar;-skalfönster med den skapade rapporten. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_generated.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Skapad rapport</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>

</chapter>
