:READ

Verwenden Sie die Script-Anweisung :READ, wenn Sie Daten aus dem Read-Buffer abrufen möchten. Der Read-Buffer speichert Variablen, um die Werte für die weitere Verarbeitung zur Verfügung zu stellen. Die Funktion der :READ-Anweisung hängt vom Kontext ab, in dem Sie diese Script-Anweisung verwenden.

Wichtig! Verwenden Sie keine Textwerte mit Zeilenumbrüchen im Lesepuffer. :READ ignoriert die Zeichen nach dem ersten Zeilenumbruch.

Variablen im Read-Buffer auslesen

Verwenden Sie die :READ-Anweisung, um die folgenden Daten aus dem Read-Buffer abzurufen:

So lesen Sie Daten aus, die im Read-Buffer gespeichert sind

Speichern Sie eine Script-Variable im Read-Buffer mit einer :PUT_READ_BUFFER-Anweisung. Aktivieren Sie ein Objekt mit der Funktion ACTIVATE_UC_OBJECT. Rufen Sie den Wert der Variablen, die Sie im Read-Buffer gespeichert haben, mit einer :READ-Anweisung ab. Jede Script-Variable im Buffer kann nur einmal ausgelesen werden. Die Variable wird nach dem Auslesen aus dem Buffer gelöscht.

Beispiel

Im folgenden Beispiel wird der Name des Agenten eines Jobs im Read-Buffer gespeichert und es wird ein Benachrichtigungsobjekt aktiviert.

:SET &att_host# = GET_ATT(HOST)
:PUT_READ_BUFFER host# = '&att_host#'

:SET &ret# = ACTIVATE_UC_OBJECT('CALLOP')

Im Benachrichtigungsobjekt ruft das folgende Script den Agentennamen ab, der vom vorherigen Script gespeichert wurde:

:READ &host#,,

:PRINT "Agent: &host#"

Das folgende Beispiel ist ein Script in einem Benachrichtigungsobjekt. Das Script liest UC_CAUSE*-Variablen aus, um die Details der Aufgabe abzurufen, die die Benachrichtigung aktiviert hat. Das Script gibt die Details der Aufgabe im Aktivierungsreport aus:

:READ &UC_CAUSE_NAME,,
:READ &UC_CAUSE_NR,,
:READ &UC_CAUSE_STATE,,
:READ &UC_CAUSE_RETCODE,,

:PRINT "Diese Benachrichtigung wurde von der folgenden Aufgabe ausgelöst:"
:PRINT "Name: &UC_CAUSE_NAME"
:PRINT "RunID: &UC_CAUSE_NR"
:PRINT "Status: &UC_CAUSE_STATE"
:PRINT "Rückgabewert: &UC_CAUSE_RETCODE"

:READ-Benutzerdialoge

Schreiben Sie die :READ-Anweisung zwischen eine :BEGINREAD- und eine :ENDREAD-Anweisung, um eine Anfrage auszulösen und sie in der Ansicht Anforderungen für Benutzereingaben anzuzeigen. Die vom Benutzer eingegebenen Daten werden in Variablen gespeichert und können für die weitere Verarbeitung verwendet werden. Weitere Informationen finden Sie unter Anfragen.

:READ-Anweisungen lösen nur eine Anforderung aus, wenn Folgendes zutrifft:

:READ-Anweisungen lösen in den folgenden Situationen keine Anfrage aus, sondern verwenden die Standardwerte:

Tipp:: Verwenden Sie die Script-Funktion GET-ATT mit dem Attribut DCMODUS, um zu bestimmen, ob ein Script in einem Modus ausgeführt wird, der die Anzeige der Anfragen ermöglicht. Weitere Informationen finden Sie unter GET_ATT.

Der Report protokolliert automatisch Werte, die in die Anfrage eingegeben werden. Sie können dieses Verhalten für Job-Reports in den Parametern der Script-Anweisung deaktivieren.

So lesen Sie Benutzereingaben aus dem Read-Buffer aus

Schreiben Sie die :READ-Anweisung in einen umschließenden :BEGINREAD....:ENDREAD-Block, um den Benutzer abzufragen und die Werte im Read-Buffer zu speichern.

Syntax

:REA[D] InVariable, [Eingabeprüfung], [Meldungstext] [, Standardwert] [, Eingabeverarbeitung]

Parameter

Wichtig!

Hinweise:

Die Anforderung zeigt den Objektnamen in der Symbolleiste an. Verwenden Sie die Parameter der Script-Anweisung, um das Aussehen und den Inhalt des Anfrage zu definieren.

Beispiele

Das Script im folgenden Beispiel erstellt einen Anfrage, die den Benutzer nach einer Überschrift fragt. Die Eingabe, die der Benutzer vornimmt, wird nicht überprüft, und der Benutzer kann das Feld auch leer lassen. Die Zeichen werden sofort in Großbuchstaben umgewandelt.

:READ &HEADLINE#,"00","Bitte Überschrift eingeben"

Das folgende Beispiel fragt den Benutzer auch nach einer Überschrift. Die Anforderung schlägt keinen Standardwert vor und validiert die Eingabe nicht. Die Eingabe von Kleinbuchstaben ist möglich.

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

Das folgende Beispiel fragt den Benutzer nach einer Zahl. Die Option Eingabeformatierung ist auf N gesetzt, sodass die Anfrage ein Zahlenfeld enthält. Es werden nur Zahlen von 0 bis 5 akzeptiert.

:READ &NUMBER#,"0-5","Bitte eine Zahl eingeben",,"N"

Das folgende Beispiel fragt den Benutzer nach einem Datum. Die Eingabe muss ein gültiges Datum im Format YYMMDD sein und darf nicht leer sein.

:READ &DATE1#,"YYMMDD","Bitte ein Datum eingeben (YYMMDD)",,"M"

Das folgende Beispiel fragt den Benutzer nach einer Signatur. Der Standardwert im Eingabefeld ist A. Der im Feld eingegebene Wert wird validiert, um zu prüfen, ob er mit den zulässigen Werten von A, X und Zahlen zwischen 5 und 9 übereinstimmt.

:READ &LKZ#,"A,X,5-9","Bitte Listensignatur eingeben","A"

Das folgende Beispiel fordert den Benutzer auf, ein Passwort mit maximal 8 Zeichen einzugeben. Die Optionen D, M und K der Eingabeformatierung legen fest, dass das Feld gesichert ist, Buchstaben nicht in Großbuchstaben umgewandelt werden und das Feld nicht leer gelassen werden darf.

:READ &PASS#,"08","Bitte das Passwort eingeben (max. 8 Zeichen)",,"DMK"

Das folgende Beispiel fragt den Benutzer nach einer E-Mail-Adresse. Der Benutzer hat die Auswahl zwischen drei E-Mail-Adressen. Um zu vermeiden, dass der Bindestrich als Wertebereich interpretiert wird, wird die letzte Adresse in einfache Anführungszeichen gesetzt.

:READ &USER#,"brown@automic.us,johnson@automic.us,'smith@late-night.com'", "Bitte Benutzer auswählen"

Das folgende Beispiel fordert den Benutzer auf, eine Adresse auszuwählen oder eine neue einzugeben.

:READ &USER#,"brown@automic.us,johnson@automic.us,'smith@late-night.com'", "Bitte Benutzer auswählen",,"O"

Siehe auch:

Related Script Elements

:BEGINREAD... :ENDREAD

seealso

Benachrichtigung (CALL)

PromptSets (PRPT)

:PUT_READ_BUFFER