Was ist ein Report?
Ein
Report beschreibt eine Liste (oder ein Formular), die (das) vom Ebus-Programm
ausgedruckt werden soll. Die Definition eines Reports im Ebus-J ist so
allgemein gehalten, dass jede beliebige Liste (bzw. jedes Formular) damit
erstellt werden kann.
Jeder
Report besteht aus maximal fünf Arten von Blöcken. Lediglich der Datenblock muss vorhanden sein, alle anderen
Blöcke können fehlen. Ein Block gilt als 'vorhanden', wenn für ihn wenigstens
eine Zeile definiert wurde.
|
a)
Kopfblock |
Der
Kopfblock wird am Beginn einer jeden Seite immer an der gleichen Stelle
ausgedruckt. |
|
b)
Fußblock |
Ebenso
wird der Fußblock am Ende einer jeden Seite immer an der gleichen Stelle ausgedruckt.
|
|
c)
Datenblock |
Der
Datenblock ist der sich wiederholende Teil des Reports. Im Normalfall wird
für jeden Datensatz einmal der Datenblock gedruckt. In der Programmiersprache
stehen jedoch Befehle zur Verfügung, mit denen diese Regel beliebig
durchbrochen werden kann. |
|
d)
Gruppenwechselblock |
Der
Gruppenwechselblock wird jedesmal dann vor einem Datenblock gedruckt, wenn
bei einem Reportfeld des Datenblockes die Checkbox Gruppenwechsel gesetzt
wurde und ein Gruppenwechsel auftrat (d.h. wenn sich der Wert des
Reportfeldes im Vergleich zum vorhergehenden Datenblock geändert hat). Der
Gruppenwechselblock kann z.B. dazu verwendet werden, Zwischensummen oder
Hinweise zu drucken. |
|
e)
Reportendeblock |
Der
Reportendeblock wird am Ende des Reports hinter einem eventuellen
Gruppenwechselblock gedruckt. Der Reportendeblock kann z.B. dazu benutzt
werden, Endsummen auf der Liste auszudrucken. |
Zuerst
wird, falls vorhanden, der Reportkopf gedruckt.
Wenn
für den Report eine Indexdatei angegeben wurde, so erfolgt intern ein START bzw. STARTS
(entsprechend dem angegebenen Schlüssel), und der Datenblock wird gedruckt.
Anschließend wird mit READ-NEXT bzw. READS-NEXT solange in der Indexdatei weiter
gelesen, bis das Dateiende erreicht ist oder in einem Makro des Reports der
Befehl ENDREP ausgeführt wird. Für jeden gelesenen Datensatz wird einmal der
Datenblock gedruckt.
Wenn
für den Report keine Indexdatei angegeben wurde, so wird in endloser
Wiederholung der Datenblock gedruckt. In diesem Fall muss über die Makros des Reports gesteuert werden, ob und welche
Datensätze gelesen werden sollen. Ferner muss
der Report über die Anweisung ENDREP in einem
Makro beendet werden, sonst läuft er endlos.
Jeder
Block besteht aus einer bestimmten Anzahl von Zeilen. Die Zeilen werden einzeln
aufgebaut und gedruckt. Beim Aufbau der Zeile wird von links nach rechts für jedes
Reportfeld der Zeile der Wert der zugehörigen Variablen an der Stelle des
Reportfeldes eingefügt. Bevor jedoch der Wert eingefügt wird, wird der zu dem
Reportfeld gehörende Makro vorher ausgeführt (falls vorhanden). In den
Makros können dadurch die Werte der aktuellen Reportvariablen noch beliebig
verändert werden.
Wenn
zu Beginn eines Datenblocks die Bedingung für einen Gruppenwechsel erfüllt ist,
so wird vor dem Datenblock der Gruppenwechselblock gedruckt. Dabei ist zu
beachten, dass erst am Ende des Datenblocks, also nach der Ausführung aller zum
Datenblock gehörenden Makros, festgestellt werden kann, ob ein Gruppenwechsel
vorliegt. Der Datenblock ist also schon vollständig gedruckt. Programmintern
werden die Druckzeilen deshalb zwischengespeichert. Wenn ein Gruppenwechsel
auftrat, werden zuerst die durch den bereits abgearbeiteten Datenblock
veränderten Summenwerte zurückgesetzt, dann wird der Gruppenwechselblock
gedruckt. Anschließend werden die zwischengespeicherten Zeilen des Datenblocks
ausgegeben und die Summenfelder werden wieder aktualisiert.
Am
Ende des Reports wird als letzter Block, falls vorhanden, der Reportendeblock
gedruckt. Abschließend wird nur noch, wie auf jeder Seite, der Fußblock
gedruckt (falls vorhanden).
Bevor
jeweils einer der Blöcke Datenblock, Gruppenwechselblock oder Endeblock
gedruckt wird, wird intern geprüft, ob die für diesen Block vorgesehene Anzahl
von Zeilen auf der aktuellen Seite noch Platz hat. Falls nicht, so wird zuerst
der Fußblock gedruckt, dann wird der Seitenzähler um 1 erhöht, anschließend
wird der Kopfblock der nächsten Seite gedruckt, und erst dann wird der
entsprechende Block gedruckt. Mit den Anweisungen REPORT_DATABLOCKLENGTH, REPORT_GROUPBLOCKLENGTH und REPORT_ENDBLOCKLENGTH kann die in der
Report-Verwaltung festgelegte Anzahl von Zeilen des entsprechenden Blocks
geändert und damit ein anderes Seitenvorschubverhalten erreicht werden.
Befehle zur Report-Steuerung
In
der Programmiersprache des Ebus-J stehen eine Reihe spezieller Befehle für die
individuelle Steuerung des Reportausdrucks zur Verfügung.
|
Die
aktuelle Reportzeile wird nicht gedruckt; es wird mit der nächsten Zeile des
aktuellen Blocks fortgefahren. War die aktuelle Reportzeile die letzte Zeile
des aktuellen Blocks, so wird mit dem nächsten Block fortgefahren. |
|
|
REPLINE <STRING-AUSDRUCK> |
Vor
der aktuellen Zeile wird eine Zeile mit dem Inhalt von
<STRING-AUSDRUCK> ausgedruckt. |
|
Vor
der aktuellen Zeile wird eine Leerzeile ausgedruckt. (entspricht REPLINE "") |
|
|
Das
aktuelle Reportfeld wird nicht ausgedruckt; es wird zum nächsten Reportfeld
gesprungen. In der Druckzeile erscheinen anstelle des Feldes Leerzeichen. |
|
|
Der
aktuelle Block wird abgebrochen. Fortgesetzt wird mit der ersten Zeile des
nächsten Blocks. Im Fußblock werden dabei noch so viele Leerzeilen gedruckt,
bis die Anzahl der Zeilen des Blockes erreicht ist. (Dadurch wird
sichergestellt, dass sich der Seitenanfang der nächsten Seite nicht
verschiebt.) |
|
|
Dieser
Befehl ist nur im Datenblock wirksam. Nach dem Drucken der aktuellen Zeile
wird nicht mit der nächsten Zeile fortgefahren, sondern die aktuelle Zeile
wird erneut gedruckt. Dies wiederholt sich solange, wie in einem Makro der
aktuellen Zeile der Befehl REPEATLINE ausgeführt wird. |
Über
den Schalter ENABLE / DISABLE
LPGDI wird gesteuert, ob graphisch oder nicht-graphisch (Zeichenmodus) gedruckt
wird.
Beim
graphischen Druck (ENABLE LPGDI) müssen keine
Steuerzeichen für den Seitenvorschub ausgegeben werden.
Beim
nicht-graphischen Druck (DISABLE LPGDI) werden pro Seite so viele Zeilen gedruckt,
wie in der Report-Beschreibung bei Reportlänge angegeben wurden. Es
wird aber kein CHR$(12)
(Steuerzeichen für Seitenvorschub) an den Drucker geschickt. Stimmt die Reportlänge nicht
mit der Anzahl von Zeilen überein, die der Drucker auf einer Seite drucken
kann, so ist der Reportausdruck ab der 2. Seite verschoben. Soll der
Seitenvorschub über CHR$(12) gesteuert werden, so ist folgendermaßen
vorzugehen:
In
der ersten Zeile des Kopfblockes wird ein Makro angegeben mit folgendem Inhalt:
IF
PAGE > 1
THEN LPRINT CHR$(12);
ENDIF
Ab
der 2. Seite wird damit der Seitenvorschub für die vorhergehende Seite erzeugt.
Der Seitenvorschub für die letzte Seite wird nach dem Reportaufruf erzeugt.
REPORT #100
LPRINT CHR$(12);
Beim
graphischen Druck werden diese Anweisungen LPRINT CHR$(12); ignoriert. Das Ebus-Programm
erkennt, dass intern bereits ein Seitenvorschub erzeugt wurde.

Reportnummer: Durch die Reportnummer wird
jeder Report eindeutig identifiziert. Die Reportnummer kann nur bei der
Neuanlage eines Reports vergeben werden, sie kann danach nicht mehr geändert
werden.
Kurzbeschreibung: Die Kurzbeschreibung hat
nur informatorischen Charakter.
Indexdateiname: Wird ein Indexdateiname
angegeben, so wird beim Start des Reports in der Indexdatei an der durch die
Schlüsselfelder festgelegten Stelle gestartet. Für jeden gelesenen Datensatz
wird einmal der Datenblock gedruckt. Dies wiederholt sich solange bis entweder das Dateiende erreicht
ist oder in einem Makro die Anweisung ENDREP ausgeführt wird.
Schlüssel: Legt den Schlüssel fest,
mit dem die Indexdatei gelesen wird.
Reportlänge
(Zeilen):
Anzahl der Druckzeilen pro Seite.
Reportbreite
(Spalten):
Anzahl der Druckspalten pro Zeile.
Anzahl
Kopfzeilen: Größe des Kopfblockes. Der Kopfblock wird am Beginn einer jeden Seite
immer an der gleichen Stelle gedruckt.
Anzahl
Fußzeilen:
Größe des Fußblockes. Der Fußblock wird am Ende einer jeden Seite immer an der
gleichen Stelle gedruckt.
Anzahl
Zeilen für Datenblock: Größe des Datenblockes. Der Datenblock ist der sich wiederholende Teil
eines Reports, der z.B. für jeden gelesenen Indexdateidatensatz einmal gedruckt
wird.
Anzahl
Zeilen für Gruppenwechsel: Größe des Gruppenwechselblockes. Findet ein
Gruppenwechsel statt, so wird der Gruppenwechselblock gedruckt.
Anzahl
Zeilen für Endeblock: Größe des Endeblocks. Der Endeblock wird am Ende des Reports nach
einem eventuellen letzten Gruppenwechselblock gedruckt. Dieser Block kann dazu
benutzt werden, Endsummen oder Schlusstexte zu drucken.
Button
'OK':
Die Reportparameter werden gespeichert und der Reporteditor wird gestartet.
Button
'Abbrechen': Die Verarbeitung wird abgebrochen, Änderungen werden nicht
gespeichert.