<<

Inhaltsverzeichnis

Suchen

>>

 

Reporteigenschaften

 

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.

 

 

Ablauf eines Reports im Ebus-Programm

 

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.

 

NEXTLINE

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.

NEWLINE

Vor der aktuellen Zeile wird eine Leerzeile ausgedruckt. (entspricht REPLINE "")

NEXTREPFIELD

Das aktuelle Reportfeld wird nicht ausgedruckt; es wird zum nächsten Reportfeld gesprungen. In der Druckzeile erscheinen anstelle des Feldes Leerzeichen.

NEXTBLOCK

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.)

REPEATLINE

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.

 

 

Seitenvorschub im Report

 

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

 

 

Erfassung eines Reports

 

 

 

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.