PROCESS REPORTER ACTION
|
|||||||||||
|
|
|
||||||||||
INITIALIZE
|
|||||||||||
TERMINATE
|
|||||||||||
|
|
OPEN
|
|
|||||||||
CLOSE
|
|||||||||||
REPLACE-TABLE
|
|
operand1
|
|
||||||||
SET-PRINTER
|
WITH
|
||||||||||
SET-PRINT-OPTIONS
|
PARAMETERS-clause | ||||||||||
PRINT
|
|||||||||||
PREVIEW |
|||||||||||
EDIT
|
|
WITH
|
|
operand1
|
|
||||||
| PARAMETERS-clause | |||||||||||
[GIVING
operand2]
|
|||||||||||
Dieses Dokument behandelt folgende Themen:
Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.
Das PROCESS REPORTER-Statement dient der Kommunikation mit
dem Natural Reporter aus einem Progamm heraus. Es weist den Reporter an, eine
bestimmte Aktion auszuführen.
Eine Anleitung für die Benutzung des Reporters finden Sie in der Online-Hilfe, die mit Natural Reporter angeboten wird.
Anmerkung:
Bei Aktionen, die sich auf einen bestimmten Report beziehen, können
Sie das zweite Schlüsselwort auf REPORT verkürzen. Dies dient nur
der Lesbarkeit Ihrer Programme; Natural unterscheidet nicht zwischen der
ausgeschriebenen und abgekürzten Form des Schlüsselworts.
Operanden-Definitionstabelle:
| Operand | Mögliche Struktur | Mögliche Formate | Referenzierung erlaubt | Dynam. Definition | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operand1 | C | S | A | N | P | I | F | B | D | T | L | ja | nein | |||||||
| operand2 | S | N | P | I | ja | nein | ||||||||||||||
Syntax-Element-Beschreibung:
| ACTION |
Aktionen:
Sie können eine der folgenden Aktionen angeben, die vom Reporter ausgeführt werden sollen. |
|---|---|
| INITIALIZE | Diese Aktion initialisiert und lädt den Reporter. Dies muss immer die erste Aktion sein, die ausgeführt wird. |
| TERMINATE | Diese Aktion beendet und entlädt den Reporter. Dies muss immer die letzte Aktion sein, die ausgeführt wird. |
| OPEN | Diese Aktion öffnet einen angegebenen Report und gibt ein Handle zurück. Dieses Handle kann dazu benutzt werden, den Report bei nachfolgenden Aktionen zu identifizieren. |
| CLOSE | Diese Aktion schließt einen angegebenen Report. Danach kann das Report-Handle nicht mehr benutzt werden. |
| REPLACE-TABLE | Diese Aktion ersetzt den Pfadnamen einer Tabelle. |
| SET-PRINTER | Diese Aktion wählt einen Drucker aus, der zum Ausdrucken aller
nachfolgenden Reports benutzt werden soll. Die Druckmethode für den
ausgewählten Drucker muss in NATPARM auf
"TTY" gesetzt sein.
|
| SET-PRINT-OPTIONS | Diese Aktion setzt die Druckoptionen für einen angegebenen Report. |
| Diese Aktion druckt einen angegebenen Report direkt auf dem ausgewählten Drucker. | |
| PREVIEW | Diese Aktion bietet eine Vorschau des angegebenen Reports, basierend auf dem zur Zeit ausgewählten Drucker. |
| EDIT | Wenn kein Report angegeben ist, zeigt diese Aktion das Hauptfensters des Reporters. Wenn ein Report angegeben ist, zeigt diese Aktion das Hauptfenster des Reporters zusammen mit dem Editierfenster für den angegebenen Report. |
| WITH |
WITH-Klausel:
Als operand1 geben Sie die Parameter an, die an die Aktion übergeben werden sollen. |
| PARAMETERS-clause | Als Alternative zur WITH-Klausel können Sie die
unten beschriebene PARAMETERS-Klausel
benutzen.
|
| GIVING operand2 |
GIVING-Klausel:
Mit der Als operand2 geben Sie das Feld an, das den Response-Code empfangen soll. Der Response-Code wird im Format/Länge I4 ausgegeben. Response-Code "0" bedeutet, dass die Aktion erfolgreich war. Jeder andere Response-Code entspricht einer Natural-Systemfehlernummer (NATnnnn). |
PARAMETERS
{parameter-name=operand1}
|
END-PARAMETERS
|
Mit dieser Klausel können Sie die Parameter auch mit dem Namen übergeben (statt mit der Position):
Bei dieser Aktion geben Sie als ersten Parameter den Namen des zu öffnenden Reports an (ohne Erweiterung .rpt oder Pfadangabe). Als zweiten Parameter geben Sie das Feld an, das das Handle empfangen soll. Format/Länge des ersten Parameters muss mit A8 kompatibel sein. Format/Länge des zweiten Parameters muss mit I4 kompatibel sein.
Der Report wird zuerst im RES-Unterverzeichnis
der Logon-Library gesucht, dann im RES-Unterverzeichnis
jeder Steplib und dann im Verzeichnis, das mit der Umgebungsvariablen
NATGUI_BMP definiert ist.
Die Reportdaten werden zuerst in dem Pfad gesucht, der bei der Erstellung des Reports angegeben wurde (wenn er existiert), und dann im Verzeichnis, in dem der Report gefunden wurde.
Wenn Sie die PARAMETERS-Klausel benutzen, muss parameter-name Folgendes enthalten:
REPORT-NAME für den Reportnamen.
REPORT-ID für das Handle-Feld.
Siehe auch Beispiel 1 - Parameter für die OPEN-Aktion.
Bei dieser Aktion geben Sie als ersten Parameter das Handle an, das den Report identifiziert, auf den die Aktion angewandt werden soll. Als zweiten Parameter geben Sie die Arbeitsdateinummer an. Als dritten Parameter können Sie optional den Tabellennamen eingeben. Format/Länge der ersten beiden Parameter müssen mit I4 kompatibel sein. Format/Länge des dritten Parameters muss mit A8 kompatibel sein.
Wenn Sie die PARAMETERS-Klausel benutzen,
muss parameter-names Folgendes enthalten:
REPORT-ID, WORK-FILE beziehungsweise
TABLE-NAME.
Siehe auch Beispiel 2 - Parameter für die REPLACE-TABLE-Aktion.
Bei dieser Aktion geben Sie als operand1 den logischen Gerätenamen (LPT1 bis LPT31) des ausgewählten Druckers an. Format/Länge von operand1 muss mit A8 kompatibel sein.
Wenn Sie die PARAMETERS-Klausel benutzen,
muss parameter-name Folgendes enthalten:
DEVICE-NAME.
Siehe auch Beispiel 3 - Parameter für die SET-PRINTER-Aktion.
Bei dieser Aktion geben Sie als ersten Parameter (Nummer 1 in der Tabelle unten) das Handle an, das den Report identifiziert, auf den die Aktion angewandt werden soll. Danach folgenden die zu setzenden Druckeroptionen, die alle optional sind. Wenn ein Parameter weggelassen wird, wird die entsprechende Option nicht geändert.
| Sequenznummer | Parameter |
|---|---|
| 1 |
Dieser Parameter (der mit Format/Länge I4 kompatibel sein muss) ist das Handle, das den Report identifiziert, auf den die Aktion angewandt werden soll. parameter-name muss
|
| 2 |
Dieser Parameter (der mit Format/Länge I2 kompatibel sein muss) ist eine der Konstanten für die Papiergröße, die in der Local Data Area NGULKEY1 definiert ist. Die möglichen Werte sind:
PAPER-SIZE sein. * |
| 3 und 4 |
Diese Parameter (die mit Format/Länge I2 kompatibel sein müssen)
sind die Papierbreite und -höhe (in Twips; 1 Twip = 1/1440 Zoll). Diese
Parameter werden nur mit der Papiergröße Wenn Sie die PARAMETERS-Klausel
benutzen, muss parameter-names Folgendes enthalten:
|
| 5, 6, 7 und 8 |
Diese Parameter (die mit Format/Länge I2 kompatibel sein müssen) geben den linken, oberen, rechten und unteren Rand an (in Twips). parameter-names muss Folgendes
enthalten: |
| 9 |
Dieser Parameter (der im Format L sein muss) gibt die Papierausrichtung an:
Dieser Parameter wird nicht mit der Papiergröße
parameter-name muss
|
| 10 |
Dieser Parameter (der im Format L sein muss) entspricht der Druckoption für schnelles Drucken (nur Text):
FAST-PRINT sein. * |
| 11 |
Dieser Parameter (der im Format L sein muss) bestimmt ob Datensätze, die nur aus Leerzeichen bestehen, bei der Ausgabe unterdrückt werden sollen:
SUPPRESS- BLANK-LINES sein. * |
| 12 |
Dieser Parameter (der im Format L sein muss) bestimmt ob aufeinanderfolgende Datensätze mit identischen Daten ignoriert werden sollen:
IGNORE-DUPLICATES sein. * |
| 13 |
Dieser Parameter (der im Format L sein muss) bestimmt ob beim Drucken ein Dialog für die Druckerauswahl angezeigt werden soll:
SHOW-PRINT-DIALOG. * |
| 14 |
Dieser Parameter (der mit Format/Länge I2 kompatibel sein muss) ist einer der Konstanten für die Papierquelle, die in der Local Data Area NGULKEY1 definiert ist. Die möglichen Werte sind:
PAPER-SOURCE sein. * |
Anmerkung:
* Wenn Sie die
PARAMETERS-Klausel benutzen.
Siehe auch Beispiel 4 - Parameter für die SET-PRINT-OPTIONS-Aktion.
Bei diesen Aktionen geben Sie als operand1 das Handle an, das den Report identifiziert, auf den die Aktion angewandt werden soll. Format/Länge von operand1 muss mit I4 kompatibel sein.
Wenn Sie die PARAMETERS-Klausel benutzen,
muss REPORT-ID der parameter-name
ein.
Siehe auch Beispiel 5 - Parameter für die CLOSE-, PRINT-, PREVIEW-, EDIT-Aktionen.
PROCESS REPORT ACTION OPEN WITH 'MYREPORT' #HANDLE
PROCESS REPORT ACTION OPEN WITH
PARAMETERS
REPORT-NAME = 'MYREPORT'
REPORT-ID = #HANDLE
END-PARAMETERS
PROCESS REPORT ACTION REPLACE-TABLE WITH
PARAMETERS
REPORT-ID = #HANDLE
WORK-FILE = 5
END-PARAMETERS
PROCESS REPORTER ACTION SET-PRINTER WITH 'LPT1'
DEFINE DATA LOCAL USING 'NGLUKEY1' END-DEFINE ... PROCESS REPORT ACTION SET-PRINT-OPTIONS WITH #HANDLE A4 0 0 0 0 0 0 FALSE FALSE FALSE FALSE FALSE AUTOMATIC
DEFINE DATA LOCAL USING 'NGLUKEY1' END-DEFINE ... PROCESS REPORT ACTION SET-PRINT-OPTIONS WITH PARAMETERS REPORT-ID = #HANDLE PAPER-SIZE = A4 PAPER-WIDTH = 0 PAPER-HEIGHT = 0 LEFT-MARGIN = 0 TOP-MARGIN = 0 RIGHT-MARGIN = 0 BOTTOM-MARGIN = 0 LANDSCAPE = FALSE FAST-PRINT = FALSE SUPPRESS-BLANK-LINES = FALSE IGNORE-DUPLICATES = FALSE SHOW-PRINT-DIALOG = FALSE PAPER-SOURCE = AUTOMATIC END-PARAMETERS
PROCESS REPORT ACTION PRINT WITH #HANDLE PROCESS REPORT ACTION PREVIEW WITH #HANDLE PROCESS REPORT ACTION CLOSE WITH #HANDLE PROCESS REPORT ACTION EDIT WITH #HANDLE PROCESS REPORTER ACTION EDIT