Report Skripte

Unter dem Menüpunkt Skripte des Datenbank -Menüs listet ein Popup-Menü die drei Skripttypen auf, die SuperReport Pro bei der Erzeugung eines Reports ausführen kann:

Startskript

Das Startskript wird vor der Generierung des Reports abgearbeitet. Es dient in der Regel dazu, eine Selektion von Datensätzen zu laden und vor dem Ausdruck zu sortieren.

Start ExtOP

Hinweis für fortgeschrittene Benutzer:

Business OPEN ermöglicht sogenannte Start ExtOPs. Hierbei handelt es sich um vom Anwender definierte externe Operationen, die dem eigentlichen Formulardruck vorgelagert abgearbeitet werden.

Lesen Sie Genaueres über Start ExtOP s im noch folgenden gleichnamigen Abschnitt dieses Handbuch-Kapitels.

Datenskript

Das Datenskript wird während der Verarbeitung jedes einzelnen Datensatzes Ihrer Auswahl ausgeführt. Es dient dazu, Datensätze aus abhängigen Dateien (im Fall von Vorgangspositionen z.B. Artikel oder Lagermengen) zu laden oder um Selektionen in anderen Dateien durchzuführen.

Endskript

Das Endskript wird nach Beendigung des Report-Drucks abgearbeitet. Es kann beispielsweise dazu dienen, benutzte Variablen zu leeren oder die Eingangs-Selektion von Datensätzen wiederherzustellen.

Möchten Sie für einen Report ein Start-, Daten- oder Endskript definieren, rufen Sie den Skript-Editor auf, indem Sie aus dem Menü Datenbank die Option Skripte wählen und in den gewünschten Bereich verzweigen. Liegt für einen Bereich bereits ein Skript vor, zeigt ein Häkchen dies an.

Skript-Editor

Haben Sie den Skript-Editor aufgerufen, erscheint ein Texteingabebereich, in dem Sie ein- oder mehrzeilige 4D-Befehle definieren können:

Bei der Zusammenstellung einer Anweisung können die drei eingebundenen Layouts in der unteren Hälfte des Skript-Editors behilflich sein.

Tabelle oder Feld wählen

Das linke der drei Layouts listet in alphabetischer Reihenfolge alle Dateien im System auf. Doppelklicken auf eine Datei fügt den Dateinamen in eckigen Klammern in Ihr SuperReport Pro-Skript ein, z.B. [LagerMengen] im Skript unten:

Feldliste öffnen

Durch Doppelklicken auf einen Dateinamen oder durch einfaches Klicken auf das jedem Dateinamen vorangestellte Dreieck öffnen Sie die alphabetisch sortierte Feldliste der jeweiligen Datei.

Doppelklicken auf einen Feldnamen fügt die Feldbezeichnung inklusive vorangestelltem Dateinamen in eckigen Klammern in Ihr SuperReport Pro-Skript ein:

Variable wählen

Das mittlere eingebundene Layout dient der Auswahl vordefinierter Variablen:

1. Super Report Pro-eigenen Standardvariablen

2. BO Systemvariablen

3. Mandantenwerten aus BO

Durch Doppelklicken auf eine Variablengruppe oder durch einfaches Klicken auf das vorangestellte Dreieck öffnen Sie die Liste verfügbarer vordefinierter Variablen.

Durch Doppelklicken auf einen Variableninhalt fügen Sie den zugehörigen Variablennamen in Ihr Skript ein, im Beispiel unten die SuperReport Pro-Variable SRDate für das aktuelle Tagesdatum:

Befehl wählen

Das rechte der eingebundenen Layouts listet nach Gruppen geordnet 4D Befehle auf. Aus dieser Liste kann der kundige Anwender 4D Anweisungen in sein Skript integrieren oder auch einfache Befehle wie z.B. QUERY oder ORDER BY auswählen, anstatt diese manuell einzutippen:

OK	Speichern Sie Ihr Skript durch Bestätigen des OK -Buttons.
Abbrechen	Abbrechen verwirft Ihre Anweisungen.
Sichern	Mit Sichern können Sie ein Skript auf die Festplatte speichern, um es
Laden	z.B. via Laden in den Skript-Editor eines anderen SuperReport Pro-Formulars zu laden.

Hinweis:

Test

Wird der Skript-Dialog aus der grafischen Eigenschaften-Palette von SRP 4.1 (in BO v20) aufgerufen, ist am unteren Rand ein weiterer Button Test sichtbar:

Durch einen Klick auf Test können Sie einen Testdurchlauf Ihres Skripts veranlassen.