<!-- 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
>Hans-Frieder</firstname
><surname
>Hirsch</surname
><affiliation
><address
><email
>f.hirsch@t-online.de</email
></address
></affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Einführung</title>

<para
>Dies ist eine kurze Einführung in &kugar;</para>

<para
>Sie werden als Beispiel eine einfache Berichtvorlage mit &kudesigner; erstellen, außerdem eine Datendatei und schließlich einen vollständigen Bericht.</para>

<para
>Den Quellcode für Beispielvorlagen und Datendatei finden Sie in den Dateien <filename
>Beispiel1.kut</filename
> und <filename
>Beispiel1.kud</filename
>, die mit &kugar; geliefert werden.</para>


<sect1 id="tut-1">
<title
>Eine Berichtvorlage mit &kudesigner; erstellen</title>

<para
>Starten Sie den Kugar-Designer, indem Sie <command
>kudesigner</command
> in einer Shell eingeben. </para>

<para
>Wählen Sie nach dem Starten des Designers <guimenu
>Datei</guimenu
> <guilabel
>Neu</guilabel
>. Setzen Sie dann das Seitenformat auf <guilabel
>Letter</guilabel
> und die Seitenausrichtung auf <guilabel
>Querformat</guilabel
>. Setzen Sie anschließend den linken und rechten Rand auf 48 sowie den oberen und unteren Rand auf 40. Alle Dimensionen (&dh; Seitenränder, Größen, Positionen, &etc;) werden in &kudesigner; in Millimeter angegeben. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_file_new.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Der Dialog <interface
>Neuer Bericht</interface
></phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Der neue Bericht wurde jetzt erstellt. Alle Knöpfe der <guilabel
>Werkzeugleiste Elemente</guilabel
> und der <guilabel
>Werkzeugleiste Abschnitte</guilabel
> sind jetzt aktiviert (ebenso wie die dazugehörigen Einträge in den Menüs <guilabel
>Elemente</guilabel
> und <guilabel
>Abschnitte</guilabel
>). <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_empty_report.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ein leerer Berichtdialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Es ist jetzt an der Zeit, einige Abschnitte zum Bericht hinzuzufügen und deren Größen zu bestimmen. Wir werden eine <link linkend="report-header-and-footer"
>Bericht-Kopfzeile und Bericht-Fußzeile</link
>, eine <link linkend="page-header-and-footer"
>Seiten-Kopfzeile und Seiten-Fußzeile</link
> sowie einen einzigen <link linkend="detail"
>Detail</link
>-Abschnitt hinzufügen. Bericht-Kopfzeilen und Bericht-Fußzeilen werden auf der ersten und letzten Seite des Berichts vor und nach den Berichtdaten gedruckt. Bericht-Fußzeilen eignen sich sehr gut zur Aufnahme von <link linkend="calculated-field-element"
>Berechnungsfeldern</link
>. Seiten-Kopfzeilen und Seiten-Fußzeilen werden am Anfang und Ende jeder Seite gedruckt. Unser Bericht wird einen Detail-Abschnitt der Abstufung 0 enthalten. Dies bedeutet, dass alle Datenzeilen eine identische Struktur (&dh; Felder) besitzen. Falls die Datenstruktur komplexer wird oder entsprechend einer Ganzes-Detail-Beziehung angeordnet wird, dann sollten mehrere Detail-Abstufungen erstellt werden. Sehen Sie als Anwendungsbeispiel dazu auch die Dateien <filename
>Beispiel3.kut</filename
> und <filename
>Beispiel3.kud</filename
>. Für weitere Informationen sehen Sie bitte auch die <link linkend="template-elements"
>Vorlagen-Elementbeschreibungen</link
>. </para>

<para
>Abschnitte werden unter Verwendung des Menüs <guilabel
>Abschnitte</guilabel
> oder der <guilabel
>Werkzeugleiste Abschnitte</guilabel
> hinzugefügt. Fügen Sie jetzt eine Bericht-Kopfzeile, eine Bericht-Fußzeile, eine Seiten-Kopfzeile, eine Seiten-Fußzeile und danach ein Detail hinzu. Wenn Sie das Detail hinzufügen, achten Sie darauf, dass die Abstufung auf 0 gesetzt ist, wie im Bildschirmphoto unten gezeigt. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_set_level.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Die Detail-Abstufung festlegen</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Unser Bericht sollte jetzt wie auf diesem Bildschirmphoto aussehen. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look1.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ein Bericht mit Abschnitten</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Alle Abschnitte besitzen eine vorgegebene Höhe - 50mm. Wir wollen diese jetzt ändern. Klicken Sie dazu mit der <mousebutton
>rechten</mousebutton
> Maustaste auf die Bericht-Kopfzeile. Sie können auch auf den Knopf <guilabel
>Attribute bearbeiten</guilabel
> auf der <guilabel
>Werkzeugleiste Bearbeiten</guilabel
> klicken und anschließend den gewünschten Abschnitt auswählen. Das Fenster "Eigenschaften" sollte sich daraufhin öffnen. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_edit_height.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Höhe von Abschnitten bearbeiten</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Setzen Sie die Höhe der Bericht-Kopfzeile jetzt auf 70. Führen Sie diese Prozedur auch für alle anderen Abschnitte durch. Setzen Sie dabei die Höhe der Seiten-Kopfzeile auf 45 und die Höhe des Details auf 30. Setzen Sie die Höhen der Seiten-Fußzeile sowie der Bericht-Fußzeile jeweils auf 32 mm. </para>

<para
>Der Bericht mit den angepassten Abschnitten kann jetzt mit Bericht-Elementen gefüllt werden. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_look2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Bericht mit angepassten Abschnittshöhen</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

<para
>Sie können jetzt den Abschnitten des Berichts Elemente hinzufügen. Fünf unterschiedliche Typen von Elementen stehen dazu zur Verfügung.<link linkend="label-element"
>Beschriftung</link
> ist ein rechteckiges, möglicherweise umrandetes Feld, in das beliebiger Text eingegeben werden kann.Text- und Hintergrundfarben sowie die Schriftarten der Beschriftung können verändert werden. Der Stil und die Farbe der Randlinien sind ebenfalls einstellbar. Ein <link linkend="field-element"
>Feld</link
> kann auf Detail-Abschnitten platziert werden. Felder sind Datenfelder, deren Inhalte aus einer Datendatei bezogen werden während ein Bericht erstellt wird. Anzahl, Summen, Durchschnitte usw. werden in einem Bericht mit Hilfe von<link linkend="calculated-field-element"
>Berechnungsfeldern</link
> dargestellt. <link linkend="special-element"
>Spezialfelder</link
> sind Felder mit vorgegebenem Inhalt, beispielsweise Datum oder Seitenzahl. Das allgemeine Aussehen des Berichts kann mit<link linkend="line-element"
> Linien</link
> verfeinert werden. </para>

<para
>Um einem Bericht ein Element hinzuzufügen klicken Sie einfach auf den entsprechenden Element-Knopf auf der <guilabel
>Element-Werkzeugleiste </guilabel
> und platzieren es auf dem Abschnitt. Das ausgewählte Element wird mit der oberen linken Ecke an den gewählten Koordinaten platziert. Andere Eigenschaften sind auf Standardwerte gesetzt. Diese können mit dem <guilabel
>Bericht-Element Optionen</guilabel
> Dialog verändert werden (auf gleiche Weise wie Sie es bei der Änderung der Höhe des Abschnittes gemacht haben). </para>

<para
>Jetzt können Sie den Kopfzeilen der Seite und des Berichts Beschriftungen hinzufügen, so wie es auf dem Bildschirmphoto unten zu sehen ist. Beachten Sie, dass der<guilabel
>Rand-Stil</guilabel
> und die <guilabel
>Rand-Breite</guilabel
> der Beschriftung<quote
> Mutiny Bay Software</quote
>auf 0 und von<quote
>Software Inventory Report</quote
> auf 1mm gesetzt ist. Alle Farben werden in Form einer Kombination von drei (RGB - rot,grün,blau), durch Kommata getrennten Werten festgelegt. </para>

<para
>Fügen Sie dem Detail-Abschnitt auch Feldelemente hinzu. Wie Sie sehen gibt es vier Felder - Titel, Version, Plattform und Kopien. Deshalb müssen vier<guilabel
>Feld</guilabel
> Elemente gesetzt und ihre <guilabel
>Feld</guilabel
> -Eigenschaften festgelegt werden. Beachten Sie, dass die<guilabel
>Text</guilabel
> Eigenschaft automatisch auf <quote
>[<userinput
>field_name</userinput
>]</quote
> festgelegt ist. </para>

<para
>Die Seiten-Fußzeile ist ein geeigneter Platz um das aktuelle Datum und die Seitenzahl anzuzeigen. Platzieren Sie deshalb dort zwei Spezial-Felder und setzen deren <guilabel
>Typ</guilabel
>-Eigenschaften auf 0 und 1. Spezial-Felder mit dem Typ = 0 zeigen das Datum, mit Typ = 1 die Seitenzahl an. Beachten Sie, dass die <guilabel
>Text</guilabel
>-Eigenschaft von Spezial-Feldern automatisch verändert wird. </para>

<para
>Das letzte Element das noch gesetzt werden muss ist das <guilabel
> Berechnungsfeld</guilabel
> für das<quote
>Kopien</quote
> Feld. Um die Summe der Kopien zu erhalten muss die <guilabel
>Feld</guilabel
> -Eigenschaft auf <quote
>Kopien</quote
> und der <guilabel
> Berechnungstyp-Typ </guilabel
> auf 1 (Summenfunktion) gesetzt werden. </para>

<para
>Schließlich sollte die Berichtvorlage etwa so aussehen: <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_complete.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Vollständiger Bericht</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>



<sect1 id="tut-2">
<title
>Die Berichtsdaten Datei erstellen</title>

<para
>Ganz allgemein gesagt können Datendateien auf unterschiedlichen Wegen erstellt werden. Man kann xsl Transformationstabellen verwenden um ein eigenes  &XML; Dokument aus einem anderen  &XML; Dokument zu erstellen (wie eine &kspread; Tabelle). Sie können auch ein eigenes Programm verwenden um Daten aus einer Datenbank in die Datendatei einzufügen. In dieser Einführung wird die Datendatei einfach von Hand erstellt. Der Quellcode für das Beispiel ist in der Datei <filename
>sample1.kud</filename
> zu finden oder kann vom Beispiel weiter unten kopiert werden. </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="beispiel1.kut"&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
>Einen Bericht erstellen</title>

<para
>Zu diesem Zeitpunkt gibt es eine Berichtvorlage (<filename
>Beispiel1.kut</filename
>) und die Berichtdaten (<filename
>Beispiel1.kud</filename
>). </para>
<para
>Um einen Bericht zu erstellen, geben Sie folgendes Kommando in der Shell ein: <command
>kugar <option
>-r <replaceable
>Beispiel1.kut</replaceable
></option
> <option
>-d <replaceable
>Beispiel1.kud</replaceable
></option
></command
> </para>

<para
>Dies wird ein &kugar;-Fenster mit dem erstellten Bericht anzeigen. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_rep_generated.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Erstellter Bericht</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>

</sect1>

</chapter>
