<<

Inhaltsverzeichnis

Suchen

>>

 

EXTREPORT

 

 

Funktion

 

 

Syntax:

EXTREPORT(<Report-Datei>,<Indexdatei>,<Indexdateischlüssel>,<Variable für Fehlertext>)

 

<Report-Datei>

= <STRING-AUSDRUCK>

<Indexdatei>

= <STRING-AUSDRUCK>

<Indexdateischlüssel>

= <NUM-AUSDRUCK>

<Variable für Fehlertext>

= <STRING-VARIABLE>

 

 

Bedeutung:

Die Funktion EXTREPORT erzeugt einen Report aus einer externen Reportdatei. Die Datensätze der <Indexdatei> werden aufsteigend verarbeitet.

 

Im Reporteditor kann das Reportlayout mit <ALT/X> in eine Datei geschrieben werden. Die so erzeugten Dateien können mit dem Programm Ebusreport.jar bearbeitet werden. Dies kann dazu verwendet werden, Formularanpassungen beim Kunden durchzuführen ohne die Programmierung ändern zu müssen.

 

Im Programm wird dann nicht die Anweisung REPORT sondern die Funktion EXTREPORT aufgerufen.

 

In der Datei <Report-Datei> muss sich ein gültiges Reportlayout befinden.

 

<Indexdatei> legt die Indexdatei und <Indexdateischlüssel> den Schlüssel fest, mit dem die Indexdatei gelesen wird. Die Datensätze werden aufsteigend verarbeitet.

 

EXTREPORT liefert als Ergebnis 0, falls kein Fehler auftrat, andernfalls eine der folgenden Fehlernummern. Im Fehlerfall enthält die Variable <Variable für Fehlertext> den genauen Fehlertext.

 

Fehlernummer

Bedeutung

1
2
3
4
5
6
7
8
9
10
11

Fehler beim Öffnen der Datei <Report-Datei>
Die Reportdatei ist unvollständig
Fehler beim Lesen der Reportdatei
1. Zeile ist unvollständig in Reportdatei
Makro nicht vorhanden
Feldattribut ist fehlerhaft
Indexdatei nicht vorhanden
Indexdateifeld nicht vorhanden
Hilfsvariable nicht vorhanden
Indexdateischlüssel nicht vorhanden
Dimensionierung ist fehlerhaft

 

Die externe Reportdatei enthält genauso wie die internen Reports Variablen und Makros. Da externe Reports mit Ebureport.jar geändert werden können, ohne dass das zugehörige Programm neu generiert werden muss, sind folgende Regeln zu beachten:

 

Alle im externen Report vorkommenden Makros und Indexdateien müssen auch im generierten Programm vorkommen. Deshalb sollte der 'Urprungsreport', aus dem die Reportdatei erzeugt wurde, im Programm enthalten sein.

 

Bei der Anpassung eines Reports können Reportfelder geändert, gelöscht oder hinzugefügt werden. Wenn eine Indexdatei im Programm verwendet wird, sind dem Programm alle Indexdateifelder bekannt. Anders sieht es bei Hilfsvariablen aus. Es sind dem Programm nur die Variablen bekannt, die im Programm verwendet werden. Wird in einem externen Report eine neue Hilfsvariable eingefügt, die im Programm nicht vorkommt, so liefert EXTREPORT den Fehler 9. Um derartige Fehler zu vermeiden, empfiehlt es sich, in das Programm eine Art 'Maximalreport' einzubauen, aus dem alle benötigen externen Reports ohne Hinzufügung von neuen Hilfsvariablen erzeugt werden können.

 

Externe Reports dürfen nur eindimensionierte Hilfsvariable enthalten, mehrdimensionale Hilfsvariablen sind nicht zulässig.

 

Parameter:

Report-Datei

Name der Reportdatei

Indexdatei

Name der Indexdatei

Indexdateischlüssel

Nummer des Schlüssels

Variable für Fehlertext

Variable, in die der Fehlertext geschrieben wird.

 

Beispiel:

/* Kunden ab Nr. 10000 aufsteigend drucken

KUNDEN.NR = 10000

H% = EXTREPORT("rep7.dat",KUNDEN,1,FEHLER$)

IF H% <> 0

THEN ERRORMES = "Folgender Fehler ist aufgetreten: " + FEHLER$

ENDIF

 

Siehe auch:

EXTREPORT_D

REPORT

REPORT_D