Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte aktivieren > :PRINT

:PRINT

Script-Anweisung: Dient zur Ausgabe von Text in einem Dialogfeld für Benutzerabfragen oder im Aktivierungsprotokoll eines Objektes.

Syntax

:P[RINT] Text
:P[RINT] Text1, Text2

Syntax	Beschreibung/Format
Text, Text1, Text2	Text, der im Dialogfeld oder im Aktivierungsprotokoll ausgegeben werden soll, maximal 1024 Zeichen für Text oder Text1 + Text2. Format: Script-Literal oder Script-Variable

Kommentare

Für die Script-Anweisung gibt es zwei Einsatzmöglichkeiten:

Anzeige im Aktivierungsprotokoll

:PRINT gibt den angegebenen Text im Aktivierungsprotokoll aus. Dies kann dazu genutzt werden, um Verarbeitungsergebnisse anzuzeigen. Auch ist es damit möglich, die korrekte Ersetzung von Script-Variablen zu überprüfen. Das Aktivierungsprotokoll ist Teil des Reports.

Syntax	Beschreibung
:PRINT Text	Der Text wird in einer eigenen Zeile angezeigt.
:PRINT Text1, Text2	Für Text1 und Text2 wird jeweils eine eigene Zeile angelegt.

Ein Zeilenumbruch wird nur dann eingefügt, wenn Text1 mit einfachen oder doppelten Hochkommata angegeben wird. Für Text2 spielt dies keine Rolle.

Anzeige im Dialogfeld

:PRINT gibt den angegebenen Text in Dialogfelder für Benutzerabfragen (:BEGINREAD... :ENDREAD) aus. Nutzen Sie dies, um die Eingabemaske übersichtlicher zu gestalten und Erklärungen hinzuzufügen.

Syntax	Beschreibung
:PRINT Text	Der Text wird in einer eigenen Zeile angezeigt.
:PRINT Text1, Text2	Folgt nach der Anweisung ein:READ so wird Text1 über der Eingabeaufforderung und Text2 über dem Textfeld positioniert. Ansonsten wird Text2 an Text1 angehängt.

Für beide Einsatzmöglichkeiten gilt, dass die in den Texten enthaltenen Script-Variablen durch ihre Werte ersetzt werden.

Der Administrator kann mit der Einstellung SERVER_OPTIONS in der Variablen UC_SYSTEM_SETTINGS bestimmen, ob die Ausgabe der Script-Anweisung zusätzlich zum Aktivierungsprotokoll auch in die Log-Datei / Report des Automation Engine geschrieben werden soll.

Beachten Sie, dass :PRINT die Leerzeichen am Ende des auszugebenden Textes abschneidet!

Beispiele

Dieses Beispiel zeigt die Ausgabe eines Textes im Aktivierungsprotokoll, in dem gleichzeitig das aktuelle Tagesdatum in einer Script-Variablen verwendet wird.

:SET &DATE# = SYS_DATE(DD.MM.YY)
:PRINT "The daily evaluation of &DATE# is activated."

Im Beispiel wird der Text "Hier eintragen:" im Dialogfeld für Benutzerabfragen über dem Eingabefeld ausgegeben.

:BEGINREAD
:PRINT "", "Enter here:"
:READ &ANR#,,"Account number"
:ENDREAD

Siehe auch:

Script-Sprachmittel	Beschreibung
:BEGINREAD... :ENDREAD	Beginn und Ende eines Dialogfeldes für Benutzerabfragen.
:READ	Fragt Angabe vom Benutzer im Dialog ab.

Script-Sprachmittel - Objekte aktivieren

Beispielsammlung:
Datenbankwartung mit Optionen
Endestatus aufgrund des Reportinhaltes setzen
Ermittlung der Fehlermeldung und -nummer
Reaktion auf externe Ereignisse

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

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support