Alexander Dymo

cloudtemple@mksat.net

Phil Thompson

phil@river-bank.demon.co.uk

Hans-FriederHirsch

f.hirsch@t-online.de

Deutsche Übersetzung 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. 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 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> 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