Automation Engine Script-Leitfaden > Funktionelle Gliederung > Script-Aufbau und -Prozessierung > :INCLUDE

:INCLUDE

Script-Anweisung: Bindet ein Include-Objekt in ein Script ein.

Syntax

:INC[LUDE] Include Object [OldString = NewString], [NOFOUND=IGNORE], [EXT_REPORT=OFF]

Syntax	Beschreibung/Format
Include-Objekt	Name des einzubindenden Include-Objektes. Geben Sie den vollständigen Namen des Include-Objektes an. Script-Variablen sind nicht erlaubt!
StringAlt	Zeichenfolge aus dem Script des Include-Objektes, die durch StringNeu ersetzt werden soll. Format: Script-Literal
StringNeu	Zeichenfolge, die StringAlt aus dem Script des Include-Objektes ersetzt. Format: Script-Literal maximal 50 Zeichen
NOFOUND=IGNORE	Wird das angegebene Include-Objekt nicht gefunden, entsteht kein Fehler.
EXT_REPORT=OFF	Der Inhalt des Include-Objektes wird nicht in den erweiterten Reports protokolliert. Es wird stattdessen eine Hinweiszeile ausgegeben.

Kommentare

Viele Objekte verwenden in ihrem Script gleiche Verarbeitungsschritte. Um diese nicht in jedem einzelnen Script schreiben und pflegen zu müssen, gibt es die Include-Objekte. Diese enthalten in ihrem Script häufig wiederkehrende und oft verwendete Script-Teile.

Um ein Include-Objekt aus einem anderen Objekt heraus ansprechen zu können, wird die :INC-Anweisung verwendet. Bei der Aktivierung des Objektes wird das Script aus dem Include-Objekt hinzugeneriert.

StringAlt und StringNeu sind optional. Sie können dazu verwendet werden, um eine Zeichenfolge aus dem Include-Objekt durch eine neue zu ersetzen. Diese Zuweisung ist nur für die laufende Generierung gültig und ändert das Include-Objekt selbst nicht.

Beispiele

Das Beispiel zeigt die Einbindung eines Include-Objektes. Dabei wird anstatt der im Include-Objekt angegebenen Zeichenfolge "$MAWI." eine neue namens "$MAWITEST." zugewiesen.

:INC MM.FILEASSIGNMENTS "$MM." = "$MMTEST."

Im Beispiel wird ein Benutzer-Include aufgerufen. Ist dieses nicht vorhanden, entsteht kein Fehler.

:INCLUDE HEADER.WINDOWS.USER.HEAD ,NOFOUND=IGNORE

Im dritten Beispiel wird unterdrückt, dass der Inhalt des Include-Objektes in den erweiterten Reports protokolliert wird.

:INC MM.FILEASSIGNMENTS ,EXT_REPORT=OFF

Siehe auch:

Script-Sprachmittel	Beschreibung
:INC_SCRIPT	Bindet ein Script in ein anderes Script des gleichen Objektes ein.

Script-Sprachmittel - Script-Aufbau und Prozessierung

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