EXTREPORT
|
Syntax: |
EXTREPORT(<Report-Datei>,<Indexdatei>,<Indexdateischlüssel>,<Variable
für Fehlertext>)
|
||||||||
|
|
|
||||||||
|
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.
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: |
|
||||||||
|
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: |