:PUT_READ_BUFFER und :PUT_PROMPT_BUFFER speichern Werte für ein Objekt, das durch 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_OBJECTaktivieren, 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 die :PUT_READ_BUFFER/:PUT_PROMPT_BUFFERScript-Anweisung ohne führendes kaufmännisches Und (&). 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] Variable Name = Content
:PUT_PROMPT_BUF[FER] Variable Name = Content
Parameter
- :PUT_READ_BUFFER bzw. :PUT_PROMPT_BUFFER
Schreibt die Variable in den Eingangspuffer - Variable name
Name der Script-Variable ohne ein führendes &-Zeichen
Hinweis: Für :PUT_PROMPT_BUFFER muss der Variablenname dem Variablennamen der PromptSet-Variablen entsprechen.
Format: AE Name - Content
Wert der Script-Variable
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: