2.1 Parameter als Eingabevariablen

Die Anweisung PARAMETERS (immer im Plural!) bietet Benutzern eine einfache Möglichkeit, Eingaben für einen Report vorzunehmen, die in einer Variablen gespeichert werden.

Geben Sie den Namen des Parameters an, den Typ und ggf. einen Vorschlagswert:

PARAMETERS pa_name type c length 12 DEFAULT 'HUGO'. 

(In diesem Beispiel verwenden wir den naheliegenden Typ c für Character (Zeichen).

Wenn Sie den Report starten, zeigt das System ein einfaches Eingabefeld mit dem vorgegebenen Vorschlagswert an, den Sie überschreiben können, siehe Abbildung 2.1.

Abbildung 2.1: Ein Parameter als Eingabevariable

Der Parameter dient als Eingabefeld und als Variable.

Nun verwenden wir die Eingabevariable, um unseren Willkommensgruß etwas persönlicher zu gestalten. Dafür nutzen wir CHAIN-Anweisungen:

WRITE: 'Hello', pa_name. 

Haben Sie versucht, Ihren Namen mit Kleinbuchstaben einzugeben und festgestellt, dass er in Großbuchstaben angezeigt wurde? Sie können für das Schlüsselwort PARAMETERS den Schlüsselwortzusatz LOWER CASE einsetzen, damit Kleinbuchstaben verwendet werden. Beachten Sie, dass dies keine Konvertierung in Kleinbuchstaben ist, sondern die Erlaubnis zur Verwendung von Kleinbuchstaben (also eine Konvertierung in Großbuchstaben zu unterlassen).

Die Benutzeroberfläche (Engl.: User Interface, kurz UI) in Abbildung 2.1 weist weiterhin nur den Namen der Eingabevariablen aus, was für den Benutzer nicht immer verständlich ist. Wenn Sie bedenken, dass die Länge einer Parameterbezeichnung auf 8 Zeichen begrenzt ist, können Sie bei Bedarf auch einen aussagekräftigeren Text eingeben.

Sie können für diese Variable zusätzliche Informationen erfassen, indem Sie im Menü zu Springen • Textelemente • Selektionstexte navigieren. Geben Sie als Selektionstext für PA_NAME »Dein Name« ein, wie in Abbildung 2.2 dargestellt.

Abbildung 2.2: Bearbeiten des Textes für eine Parametervariable

Beachten Sie, dass Sie den Selektionstext in dieser Ansicht aktivieren müssen, bevor Sie zum Quelltext Ihres Reports zurückkehren (mithilfe der Funktionstaste F3).

Falls sich bei der Aktivierung mehrere Ihrer Objekte in einem inaktiven Zustand befinden, zeigt das System diese in Form einer Liste an. So können Sie entweder nur einige oder auch alle Objekte zur Aktivierung auswählen. Im folgenden Beispiel ist der Report inaktiv. Wenn Sie den Selektionstext aktivieren, sind die beiden folgenden Objekte in der angezeigten Liste enthalten: das Objekt REPS (S für Source [Quelle]) und das Objekt REPT (T für Text), siehe Abbildung 2.3.

Abbildung 2.3: Liste inaktiver Objekte

Selektionstexte bieten den Vorteil, dass sie in weitere Sprachen übersetzt werden können. Wenn Sie bei der Anmeldung eine andere Sprache auswählen, zeigt Ihr Report den Parametertext in dieser Sprache an (vorausgesetzt, der Text wurde in diese Sprache übersetzt).

Um die wichtigsten Punkte noch einmal zusammenzufassen:

• Eine PARAMETERS-Anweisung deklariert eine lokale Variable.
• Zu Beginn eines Reports zeigt das Selektionsbild ein Eingabefeld, damit der Benutzer den Wert der Variablen festlegen kann.
• Das Eingabefeld auf dem Selektionsbild verfügt über einen Textbezeichner, der übersetzt werden kann.