# Einführung

Dies ist eine kurze Einführung in &kugar;.

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

Den Quellcode für Beispielvorlagen und Datendateien finden Sie in den Dateien `Beispiel1.ktf` und `Beispiel1.kdf`, die mit &kugar; geliefert werden.

## Eine Berichtvorlage mit &kudesigner; erstellen

Starten Sie den Kugar-Designer, indem Sie `kudesigner` in einer Shell eingeben.

Wählen Sie nach dem Starten des Designers Datei Neu. Setzen Sie dann das Seitenformat auf Letter und die Seitenausrichtung auf Querformat. 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. Der Dialog Neuer Bericht

Der neue Bericht wurde jetzt erstellt. Alle Knöpfe der Werkzeugleiste Elemente und der Werkzeugleiste Abschnitte sind jetzt aktiviert (ebenso wie die dazugehörigen Einträge in den Menüs Elemente und Abschnitte). Ein Leeres Berichtfenster

Es ist jetzt an der Zeit, einige Abschnitte zum Bericht hinzuzufügen und deren Größen zu bestimmen. Wir werden Berichtkopfzeile und Berichtfußzeile, Seitenkopfzeile und Seitenfußzeile sowie einen einzigen Detailabschnitthinzufü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 Berechnungsfeldern. 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 `Beispiel3.ktf` und `Beispiel3.kdf`. Weitere Informationen erhalten Sie in denVorlagen-Elementbeschreibungen.

Abschnitte werden mit dem Menü Abschnitte oder der Werkzeugleiste Abschnitte 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. Die Detailstufe einstellen

Unser Bericht sollte jetzt wie auf diesem Bildschirmphoto aussehen. Ein Bericht mit Abschnitten

Alle Abschnitte besitzen eine vorgegebene Höhe von 50mm. Wir wollen diese jetzt ändern. Klicken Sie dazu mit der rechten Maustaste auf die Berichtkopfzeile. Sie können auch auf den Knopf Attribute bearbeiten auf der Werkzeugleiste Bearbeiten klicken und anschließend den gewünschten Abschnitt auswählen. Das Fenster "Eigenschaften" sollte sich daraufhin öffnen. Höhe von Abschnitten bearbeiten

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.

Der Bericht mit den angepassten Abschnitten kann jetzt mit Bericht-Elementen gefüllt werden. Bericht mit angepassten Abschnittshöhen

Sie können jetzt den Abschnitten des Berichts Elemente hinzufügen. Fünf unterschiedliche Typen von Elementen stehen dazu zur Verfügung.Beschriftung 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 Feld 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 vonBerechnungsfeldern dargestellt. Spezialfelder sind Felder mit vorgegebenem Inhalt, beispielsweise Datum oder Seitenzahl. Das allgemeine Aussehen des Berichts kann mit Linien verfeinert werden.

Um einem Bericht ein Element hinzuzufügen, klicken Sie auf den entsprechenden Element-Knopf auf der Werzeugleiste Elemente 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 Bericht-Element-Optionen verändert werden (auf gleiche Weise wie Sie es bei der Änderung der Höhe des Abschnittes gemacht haben).

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 derRand-Stil und die Rand-Breite der Beschriftung Mutiny Bay Softwareauf 0 und vonSoftware Inventory Report auf 1mm gesetzt ist. Alle Farben werden in Form einer Kombination von drei (RGB - rot,grün,blau), durch Kommata getrennten Werten festgelegt.

Fügen Sie dem Detailabschnitt auch Feldelemente hinzu. Wie Sie sehen, gibt es vier Felder - Titel, Version, Plattform und Kopien. Deshalb müssen vierFeld-Elemente gesetzt und ihre Feld-Eigenschaften festgelegt werden. Beachten Sie, dass dieText-Eigenschaft automatisch auf [`field_name`] festgelegt ist.

Die Seitenfußzeile ist ein geeigneter Platz um das aktuelle Datum und die Seitenzahl anzuzeigen. Platzieren Sie deshalb dort zwei Spezialfelder und setzen deren Typ-Eigenschaften auf 0 und 1. Spezialfelder mit dem Typ 0 zeigen das Datum, mit Typ 1 die Seitenzahl an. Beachten Sie, dass die Text-Eigenschaft von Spezialfeldern automatisch verändert wird.

Das letzte Element das noch gesetzt werden muss, ist das Berechnungsfeld für das Feld Kopien. Um die Summe der Kopien zu erhalten, muss die Feld-Eigenschaft auf Kopien und der Berechnungstyp auf 1 (Summenfunktion) gesetzt werden.

Schließlich sollte die Berichtvorlage etwa so aussehen: Vollständiger Bericht

## Die Berichtsdaten-Datei erstellen

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 `sample1.kdf` zu finden oder kann vom Beispiel weiter unten kopiert werden.

    <?xml version=1.0 encoding=UTF-8?>

    <!DOCTYPE KugarData [
        <!ELEMENT KugarData (Row* )>
        <!ATTLIST KugarData
            Template CDATA #REQUIRED>

        <!ELEMENT Row EMPTY>
        <!ATTLIST Row
            level CDATA #REQUIRED
            title CDATA #REQUIRED
            version CDATA #REQUIRED
            platform CDATA #REQUIRED
            copies CDATA #REQUIRED>
    ]>

    <KugarData Template="beispiel1.ktf">
        <Row level="0" title="  BRU" version="15.0" platform="x86" copies="1"/>
        <Row level="0" title="  Caldera Open Linux" version="2.2" platform="x86" copies="3"/>
        <Row level="0" title="  K Desktop" version="1.1.1" platform="x86" copies="1"/>
        <Row level="0" title="  Netscape Communicator" version="4.6" platform="x86" copies="10"/>
        <Row level="0" title="  Redhat Linux" version="5.0" platform="x86" copies="11"/>
        <Row level="0" title="  Redhat Linux" version="5.1" platform="x86" copies="12"/>
        <Row level="0" title="  Redhat Linux" version="5.2" platform="x86" copies="14"/>
        <Row level="0" title="  Redhat Linux" version="6.0" platform="x86" copies="15"/>
        <Row level="0" title="  Star Office" version="5.0" platform="x86" copies="1"/>
        <Row level="0" title="  Star Office" version="5.1" platform="x86" copies="3"/>
        <Row level="0" title="  Microsoft Windows NT" version="3.1" platform="x86" copies="1"/>
        <Row level="0" title="  Microsoft Windows NT" version="3.51" platform="x86" copies="1"/>
        <Row level="0" title="  Microsoft Windows NT" version="4.0" platform="x86" copies="1"/>
        <Row level="0" title="  Microsoft Windows NT" version="5.0" platform="x86" copies="1"/>
        <Row level="0" title="  Sun Solaris" version="2.5" platform="Sparc" copies="1"/>
    </KugarData>

## Den Bericht erstellen

Zu diesem Zeitpunkt gibt es eine Berichtvorlage (`Beispiel1.ktf`) und die Berichtdaten (`Beispiel1.kdf`).

Um einen Bericht zu erstellen, geben Sie folgendes Kommando in der Shell ein: `kugar `-r `Beispiel1.ktf`` `-d `Beispiel1.kdf```

Dies wird ein &kugar;-Fenster mit dem erstellten Bericht anzeigen. Erstellter Bericht