:PRINT

Objekte aktivieren

:READ

---

:PUT_READ_BUFFER, :PUT_PROMPT_BUFFER

Script-Anweisung: Stellt Namen und Inhalt einer Script-Variablen in den Zwischenspeicher.

Syntax

:PUT_READ_BUF[FER] Variable Name = Content
:PUT_PROMPT_BUF[FER] Variable Name = Content

Anmerkungen

Die Script-Anweisung ist in Verbindung mit der Funktion ACTIVATE_UC_OBJECT wie folgt zu verwenden:

:PUT_READ_BUFFER legt die Script-Variable in einem eigenen Speicherbereich ab und vergibt für diesen eine interne ID. Rufen Sie für jeden Wert, den Sie speichern wollen, diese Anweisung auf. Er wird in demselben Speicherbereich abgelegt. 

Der Parameter Variablenname wird ohne das bei Script-Variablen übliche Zeichen "&" angegeben.

Gesamte Script-Arrays können nicht in den Zwischenspeicher geschrieben werden!

Sobald nun ACTIVATE_UC_OBJECT im Script aufgerufen wird, gilt der Speicherbereich als abgeschlossen. Das aktivierte Objekt kann auf dessen Script-Variablen, wie zuvor erwähnt, zugreifen.

Die :PUT_READ_BUFFER-Anweisung, die nach der Funktion ACTIVATE_UC_OBJECT steht, benutzt einen anderen Speicherbereich und vergibt ihm auch eine neue ID.

Beim Auslesen der Script-Variablen aus dem Zwischenspeicher gilt Folgendes:

• Mit der Anweisung :READ werden die Script-Variablen einzeln ausgelesen. Dabei müssen Sie jedoch das Zeichen "&" vor den Variablennamen stellen.
• Jede Script-Variable kann nur einmal ausgelesen werden, da sie beim Lesevorgang im Zwischenspeicher gelöscht wird.

Das Sprachmittel dient ebenfalls dazu, die PromptSet-Werte für das mit ACTIVATE_UC_OBJECT aktivierte Objekt zu setzen. Der Name der ReadBuffer-Variable muss dabei dem Namen einer PromptSet-Variable des gestarteten Objekts entsprechen.

Mehrfache Verwendung von Variablennamen

Es ist auch möglich :PUT_READ_BUFFER mehrmals mit demselben Variablennamen aufzurufen. Der Wert wird dabei nicht überschrieben, da die Anweisung für jeden einzelnen Aufruf einen eigenen Eintrag im Speicherbereich anlegt. Beim Auslesen einer Script-Variablen beginnt :READ immer am Anfang des Speicherbereiches zu suchen. Der Wert des ersten Vorkommens der Variablen wird zurückgeliefert. Anschließend erfolgt die Löschung des Eintrages. Deshalb wird beim nächsten Auslesen der Script-Variablen deren nächstes Vorkommen zurückgeliefert. Dies bietet einen immensen Vorteil, da Sie die Werte in einer Schleife setzen und auslesen können.

Beispiele

Das Beispiel versorgt die Script-Variable "DATUM1" mit einem Wert und stellt den Eintrag in den Zwischenspeicher. Danach wird der Job "AUSWERTUNG" aktiviert.

:PUT_READ_BUFFER DATE1# = "01.01.2006"
:SET &ACTJOB# = ACTIVATE_UC_OBJECT(JOBS, EVALUATION) 

Der Job "AUSWERTUNG" verwendet diesen Eintrag im Zwischenspeicher.

:READ &DATE1#,,
:SET &RET# = VALID_DATE("DD.MM.YYYY:&DATE1#")

Im zweiten Beispiel wird ein bestimmter Wert eines Script-Arrays in den Zwischenspeicher geschrieben. Beachten Sie, dass es nicht möglich ist, ein komplettes Array nicht in den Zwischenspeicher zu stellen.

:DEFINE &ARRAY#,string,5
:SET &ARRAY#[1] = "test1"
:PUT_READ_BUFFER TEST# = &ARRAY#[1]
:SET &AKTJOB# = ACTIVATE_UC_OBJECT(PRINT)

Das aktivierte Objekt "PRINT" liest den Wert aus dem Zwischenspeicher und schreibt diesen in das Aktivierungsprotokoll.

:READ &TEST#,,
:PRINT "&TEST#"

Im dritten Beispiel werden mehrere Werte in den Prompt-Buffer geschrieben, bei einem Prompt mit aktivem Feld „Mehrfachauswahl“. "VARA#" ist in diesem Fall der Name der Variable, die als Datenreferenz für das PromptSet-Element gewählt wurde.

:PUT_PROMPT_BUFFER "VARA#[]"="VALUE1"
:PUT_PROMPT_BUFFER "VARA#[]"="VALUE2"

Siehe auch:

Script-Sprachmittel - Objekte aktivieren

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