:PUT_READ_BUFFER, :PUT_PROMPT_BUFFER
:PUT_READ_BUFFER und :PUT_PROMPT_BUFFER speichern Werte für ein Objekt, das über die Script-Funktion ACTIVATE_UC_OBJECT aktiviert wurde. Verwenden Sie die Script-Anweisung :PUT_READ_BUFFER, um eine Script-Variable in den Lesepuffer zu schreiben. Verwenden Sie die Script-Anweisung :PUT_PROMPT_BUFFER, um eine PromptSet-Variable in den Puffer zu schreiben.
Mehr Informationen:
Beide Anweisungen speichern die Variable in einem Speicherbereich mit einer internen ID auf der Datenbank. Wenn Sie ein Objekt mit ACTIVATE_UC_OBJECT aktivieren, kann das aktivierte Objekt auf die Werte im Puffer zugreifen.
Rufen Sie die Script-Anweisung für jeden Wert auf, den Sie speichern möchten. Die interne ID des Speicherbereichs ermöglicht es der Anweisung, alle Werte im gleichen Bereich zu speichern. Wenn Sie die Script-Anweisung mehrfach mit dem gleichen Variablennamen aufrufen, erzeugt jede Anweisung einen individuellen Eintrag. Die Einträge werden bei nachfolgenden Aufrufen nicht überschrieben.
Verwenden Sie :READ-Anweisungen, um die Werte der Variablen abzurufen. :READ beginnt die Suche am Anfang des Speicherbereichs, wenn Sie eine Script-Variable lesen. Die Anweisung ruft den ersten verfügbaren Wert der Variablen ab und löscht den Eintrag. Die nächste :READ-Anweisung ruft den Wert des nächsten Ereignisses ab. Weitere Informationen finden Sie unter :READ.
Hinweise:
- Schreiben Sie den Variablennamen in der Script-Anweisung :PUT_READ_BUFFER/:PUT_PROMPT_BUFFER ohne ein führendes kaufmännisches Und-Zeichen (&). Sie müssen ein führendes kaufmännisches Und vor dem Variablennamen in die :READ-Anweisung aufnehmen.
- Jeder Wert im Puffer kann nur einmal gelesen werden. Der Wert wird nach dem Lesen aus dem Puffer gelöscht.
- Wenn Sie eine :PUT_READ_BUFFER/:PUT_PROMPT_BUFFER-Anweisung nach einer ACTIVATE_UC_OBJECT-Funktion in einem Script schreiben, verwendet die Script-Anweisung einen neuen Speicherbereich mit einer anderen ID.
- Nachfolgende Leerzeichen werden beim Ausführen dieser Script-Anweisungen entfernt.
Wichtig!
- Sie können keine kompletten Script-Arrays in den Puffer schreiben. Sie können einzelne Werte aus einem Script-Array im Puffer speichern und abrufen.
- Verwenden Sie keine Textwerte mit Zeilenumbrüchen im Lesepuffer. :READ ignoriert die Zeichen nach dem ersten Zeilenumbruch.
Syntax
: PUT_READ_BUF[FER] Variablenname = Inhalt
:PUT_PROMPT_BUF[FER] Variablenname = Inhalt
Parameter
-
:PUT_READ_BUFFER oder :PUT_PROMPT_BUFFER
Schreibt die Variable in den Eingabepuffer -
Variablenname
Name der Script-Variablen ohne führendes &
Hinweis: Für :PUT_PROMPT_BUFFER muss der Variablenname dem Variablennamen der PromptSet-Variablen entsprechen.
Format: AE Name -
Inhalt
Wert der Script-Variablen
Format:Script-Literal oder Script-Variable
Beispiele
Das folgende Beispiel setzt einen Wert für eine Script-Variable mit dem Namen DATE1 und schreibt den Wert in den Puffer. Das Script aktiviert einen Job namens EVALUATION.
: PUT_READ_BUFFER DATE1# = "01.01.2006"
: SET &ACTJOB# = ACTIVATE_UC_OBJECT (JOBS, EVALUATION)
Der aktivierte Job (EVALUATION) enthält ein Script, das den Eintrag (&DATE1) verwendet, der im Puffer gespeichert ist:
: READ &DATE1# ,,
: SET &RET# = VALID_DATE ( "DD.MM.YYYY:&DATE1#" )
Das folgende Beispiel definiert ein Script-Array und schreibt einen bestimmten Wert aus dem Array in den Eingabepuffer. Das Script aktiviert einen Job mit dem Namen PRINT.
: DEFINE &ARRAY#,string,5
:SET &ARRAY#[1] = "test1"
:PUT_READ_BUFFER TEST# = &ARRAY# [1]
: SET &ACTJOB# = ACTIVATE_UC_OBJECT (PRINT)
Der aktivierte Job (PRINT) liest den Wert aus dem Array und schreibt den Wert in den Aktivierungsreport.
:READ &TEST#,,
:PRINT "&TEST#"
Das folgende Beispiel schreibt mehrere Werte aus einem PromptSet in den Puffer. Das PromptSet ist so konfiguriert, dass es eine Mehrfachauswahl zulässt. VARA# ist der Name der Variablen, die als Datenreferenz für das PromptSet-Element ausgewählt wurde.
:PUT_PROMPT_BUFFER "VARA#[]"="VALUE1"
:PUT_PROMPT_BUFFER "VARA#[]"="VALUE2"
Das folgende Beispiel speichert den Namen des Agenten eines Jobs im Puffer und ruft ein Benachrichtigungsobjekt auf.
: SET &att_host# = GET_ATT (HOST)
: PUT_READ_BUFFER host# = '&att_host#'
: SET &ret# = ACTIVATE_UC_OBJECT ( 'CALLOP' )
Das Benachrichtigungsobjekt enthält eine :READ-Anweisung, die den Agentennamen der Aufgabe abruft, die die Benachrichtigung aktiviert:
: READ &host# ,,
: PRINT "Agent: &host#"
Siehe auch: