:PUT_READ_BUFFER

Objekte aktivieren

ACTIVATE_UC_OBJECT

---

:READ

Script-Anweisung: Fragt Angabe vom Benutzer im Dialog ab.

Syntax

:REA[D] InVariable, [Input Check], [Message Text], [Default Value], [Input Handling]

Anmerkungen

Durch die :READ-Anweisung wird ein Dialogfeld ausgegeben, dessen Aussehen und Funktion von den verwendeten Parametern abhängt. Der Name des Objektes ist in der Titelzeile dargestellt. Über ein Eingabefeld wird die Benutzereingabe entgegengenommen und in eine Script-Variable eingelesen.

Beachten Sie, dass das Dialogfeld nur angezeigt wird, wenn das Script im Dialog-Modus läuft! Ist dies nicht der Fall, werden die Vorgabewerte verwendet.

Achten Sie bei der Verwendung dieses Scriptsprachmittels, dass der eingegebene Wert mit dem Datentyp der "InVariable" (Zielvariable) kompatibel ist.

Die Parameter Eingabeprüfung, Eingabeaufforderung, Vorgabewert und Eingabeformatierung sind optional. Sollen für Eingabeprüfung und Eingabeaufforderung keine Inhalte vorgegeben werden, sind in der :READ-Anweisung dennoch die Kommata zu setzen.

Sollen Komma und Bindestrich nicht als Trennkennzeichen interpretiert werden, können die Werte zusätzlich unter einfache Hochkomma gesetzt werden. Beispiel: Es kann entweder der Wert "1-5" oder der Wert "8,9" ausgewählt werden.

:READ &OPTION#,"'1-5','8,9'",'Please select','1-5'

Über die Eingabeprüfung ist es möglich nur Buchstaben, nur Zahlen oder auch ein Gemisch aus beidem zuzulassen. Bei letzterem erfolgt die Kontrolle über die Zeichen. Daher muss in solchen Fällen die Eingabeprüfung wie folgt formuliert werden. Das Beispiel lässt Eingaben von "A" bis "F" und "1" bis "999" zu:

:READ &INPUT#, "A-F,1-9,01-99,001-999","Please select"

Wenn der Benutzer keinen Wert einträgt oder auswählt, wird in der Script-Variablen ein Leerzeichen " " gespeichert!

Im Report wird automatisch mitprotokolliert welche Werte in den Dialogfeldern eingegeben wurden. Im Jobreport können Sie dies mit dem Parameter "I" deaktivieren. Beachten Sie, dass geschützte Eingaben (in der Regel Passwörter), die mit dem Parameter "D" definiert werden, im Report verschlüsselt dargestellt sind.

Mit der :READ-Anweisung ist es ebenfalls möglich Werte, die zuvor in den Zwischenspeicher gestellt wurden, auszulesen (siehe :PUT_READ_BUFFER).

Das Script-Sprachmittel bewirkt, dass die offenen Transaktionen des Scripts in die Datenbank geschrieben werden.

Bei der Verwendung von :PUT_VAR vor einer :READ-Anweisung gilt folgende Besonderheit.
Wird bei :READ die Generierung des Scripts manuell über die Schaltfläche "Abbrechen" oder aufgrund ungültiger Vorgabewerte (siehe "Zur Laufzeit generieren") abgebrochen, so besitzt das Variablen-Objekt trotzdem die mit :PUT_VAR gesetzten Werte.

Beispiele

Abfrage einer Überschrift vom Benutzer. Der eingelesene Wert wird keiner Prüfung unterzogen. Auch eine Leereingabe ist möglich. Die Zeichen werden schon bei der Eingabe auf Großbuchstaben umgesetzt.

:READ &HEADLINE#,"00","Please enter headline"

Abfrage einer Überschrift vom Benutzer. Es erfolgen keinerlei Vorgaben. Auch hier wird der eingegebene Wert nicht geprüft. Die Eingabe von Kleinbuchstaben ist jedoch möglich.

:READ &HEADLINE#,,,,"K"

Abfrage einer Zahl. Der Parameter "N" erzeugt in diesem Fall ein Zahlenfeld mit Pfeilen. Es können nur Zahlen im Bereich von 0 bis 5 eingetragen werden.

:READ &NUMBER#,"0-5","Please enter number",,"N"

Abfrage eines Datums vom Benutzer. Der eingelesene Wert muss im Format "JJMMTT" ein gültiges Datum sein. Es handelt sich um eine Muss-Eingabe.

:READ &DATE1#,"YYMMDD","Please specify a date (YYMMDD)",,"M"

Abfrage eines Kennzeichens vom Benutzer. Das Eingabefeld enthält als Vorgabewert "A". Der eingelesene Wert wird überprüft und darf nur "A", "X", "5", "6", "7", "8" oder "9" sein.

:READ &LKZ#,"A,X,5-9","Please enter List Signature","A"

Abfrage eines Passwortes vom Benutzer mit maximal 8 Zeichen. Die Eingabeformatierung legt fest, dass die Eingabe geschützt erfolgt, dass keine Umsetzung auf Großbuchstaben erfolgt und dass eine Eingabe vorgeschrieben ist.

:READ &PASS#,"08","Please enter password (max. 8 characters)",,"DMK"

Im Beispiel wird die E-Mail-Adresse abgefragt. Der Benutzer kann eine von drei auswählen. Eine der E-Mail-Adressen ist unter einfache Hochkommata gesetzt, damit der darin enthaltene Bindestrich nicht als Wertebereich interpretiert wird.

:READ &USER#,"brown@automic.us,johnson@automic.us,'smith@late-night.com'", "Please select user"

Im folgenden Beispiel kann der Benutzer nicht nur eine der drei E-Mail-Adressen auswählen, sondern auch selbst eine eingeben.

:READ &USER#,"brown@automic.us,johnson@automic.us,'smith@late-night.com'", "Please select user",,"O"

Siehe auch:

Script-Sprachmittel - Objekte aktivieren

Beispielsammlung:
Datenbankwartung mit Optionen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung