# 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 Datendatei finden Sie in den Dateien `Beispiel1.kut` und `Beispiel1.kud`, 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 leerer Berichtdialog

Es ist jetzt an der Zeit, einige Abschnitte zum Bericht hinzuzufügen und deren Größen zu bestimmen. Wir werden eine Bericht-Kopfzeile und Bericht-Fußzeile, eine Seiten-Kopfzeile und Seiten-Fußzeile sowie einen einzigen Detail-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 Berechnungsfeldern. 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 `Beispiel3.kut` und `Beispiel3.kud`. Für weitere Informationen sehen Sie bitte auch die Vorlagen-Elementbeschreibungen.

Abschnitte werden unter Verwendung des Menüs Abschnitte oder der Werkzeugleiste Abschnitte 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. Die Detail-Abstufung festlegen

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

Alle Abschnitte besitzen eine vorgegebene Höhe - 50mm. Wir wollen diese jetzt ändern. Klicken Sie dazu mit der rechten Maustaste auf die Bericht-Kopfzeile. 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 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.

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, 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 Feld 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 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 einfach auf den entsprechenden Element-Knopf auf der Element-Werkzeugleiste 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 Bericht-Element Optionen Dialog 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 Detail-Abschnitt 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 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 Typ-Eigenschaften auf 0 und 1. Spezial-Felder mit dem Typ = 0 zeigen das Datum, mit Typ = 1 die Seitenzahl an. Beachten Sie, dass die Text-Eigenschaft von Spezial-Feldern automatisch verändert wird.

Das letzte Element das noch gesetzt werden muss ist das Berechnungsfeld für dasKopien Feld. Um die Summe der Kopien zu erhalten muss die Feld -Eigenschaft auf Kopien und der Berechnungstyp-Typ 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.kud` 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.kut">
        <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>

## Einen Bericht erstellen

Zu diesem Zeitpunkt gibt es eine Berichtvorlage (`Beispiel1.kut`) und die Berichtdaten (`Beispiel1.kud`).

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

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