<!-- 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 Datendateien finden Sie in den Dateien <filename
>Beispiel1.ktf</filename
> und <filename
>Beispiel1.kdf</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 Leeres Berichtfenster</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 <link linkend="report-header-and-footer"
>Berichtkopfzeile und Berichtfußzeile</link
>, <link linkend="page-header-and-footer"
>Seitenkopfzeile und Seitenfußzeile</link
> sowie einen einzigen <link linkend="detail"
>Detailabschnitt</link
>hinzufügen. Berichtkopfzeilen und Berichtfußzeilen werden auf der ersten und letzten Seite des Berichts vor bzw. nach den Berichtdaten gedruckt. Berichtfußzeilen eignen sich sehr gut zur Aufnahme von <link linkend="calculated-field-element"
>Berechnungsfeldern</link
>. Seitenkopfzeilen und Seitenfußzeilen werden am Anfang bzw. Ende jeder Seite gedruckt. Unser Bericht wird einen Detailabschnitt der Stufe 0 enthalten. Dies bedeutet, dass alle Datenzeilen eine identische Struktur (&dh; Felder) besitzen. Falls die Datenstruktur komplexer, oder entsprechend einer Ganzes-Detail-Beziehung angeordnet wird, sollten mehrere Detailabstufungen erstellt werden. Sehen Sie als Anwendungsbeispiel dazu auch die Dateien <filename
>Beispiel3.ktf</filename
> und <filename
>Beispiel3.kdf</filename
>. Weitere Informationen erhalten Sie in den<link linkend="template-elements"
>Vorlagen-Elementbeschreibungen</link
>. </para>

<para
>Abschnitte werden mit dem Menü <guilabel
>Abschnitte</guilabel
> oder der Werkzeugleiste <guilabel
>Abschnitte</guilabel
> hinzugefügt. Fügen Sie eine Berichtkopfzeile, eine Berichtfußzeile, eine Seitenkopfzeile, eine Seitenfußzeile und danach ein Detail hinzu. Achten Sie beim hinzufügen des Details darauf, dass die Stufe auf 0 gesetzt ist, wie im Bildschirmphoto unten gezeigt. <screenshot
> <mediaobject>
<imageobject>
<imagedata fileref="tut_set_level.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Die Detailstufe einstellen</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 von 50mm. Wir wollen diese jetzt ändern. Klicken Sie dazu mit der <mousebutton
>rechten</mousebutton
> Maustaste auf die Berichtkopfzeile. Sie können auch auf den Knopf <guilabel
>Attribute bearbeiten</guilabel
> auf der Werkzeugleiste <guilabel
>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 Berichtkopfzeile jetzt auf 70. Führen Sie diese Prozedur auch für alle anderen Abschnitte durch. Setzen Sie dabei die Höhe der Seitenkopfzeile auf 45 und die Höhe des Details auf 30. Setzen Sie die Höhen der Seitenfußzeile sowie der Berichtfuß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, wahlweise 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 Detailabschnitten platziert werden. Felder sind Datenfelder, deren Inhalte aus einer Datendatei bezogen werden während ein Bericht erstellt wird. Anzahl, Summen, Durchschnitte &etc; 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 auf den entsprechenden Element-Knopf auf der Werzeugleiste <guilabel
>Elemente</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 Dialog <guilabel
>Bericht-Element-Optionen</guilabel
> 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 Detailabschnitt 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 Seitenfußzeile ist ein geeigneter Platz um das aktuelle Datum und die Seitenzahl anzuzeigen. Platzieren Sie deshalb dort zwei Spezialfelder und setzen deren <guilabel
>Typ</guilabel
>-Eigenschaften auf 0 und 1. Spezialfelder mit dem Typ 0 zeigen das Datum, mit Typ 1 die Seitenzahl an. Beachten Sie, dass die <guilabel
>Text</guilabel
>-Eigenschaft von Spezialfeldern automatisch verändert wird. </para>

<para
>Das letzte Element das noch gesetzt werden muss, ist das <guilabel
> Berechnungsfeld</guilabel
> für das Feld <quote
>Kopien</quote
>. Um die Summe der Kopien zu erhalten, muss die <guilabel
>Feld</guilabel
>-Eigenschaft auf <quote
>Kopien</quote
> und der <guilabel
> Berechnungstyp</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.kdf</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.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
>Den Bericht erstellen</title>

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