Funktion Mit der Include-Anweisung können Sie auf eine weitere Scriptdatei verweisen.
Beispiele

Weitere Beispiele 		Include "radiobuttons_bukrs.txt"

Die Datei "radiobuttons_bukrs.txt" wird im laufenden Scriptverzeichnis gesucht. Sie wird in der gleichen Weise interpretiert, als wäre sie unmittelbar in der aktuellen Scriptdatei enthalten.
Format Include "includename"

Die Datei "includename" wird im laufenden Scriptverzeichnis gesucht. Falls sie nicht gefunden wird, erscheint eine Syntaxfehlermeldung im GuiXT Scriptfenster, und es geht im HauptScript weiter. Wird sie gefunden, dann werden zunächst die Zeilen der Include-Datei interpretiert, anschließend das ursprüngliche Script fortgesetzt.

Die Datei kann auch mit einem gesamten Pfad angegeben werden, z.B.

Include "\\server12\guixt\includes\r105.txt"

Ebenfalls möglich ist der direkte Bezug auf Dateien im SAP Web Repository oder auf http/ftp Servern, z.B.

Include "SAPWR:ZGUIXT.r105.txt"

Include "http://www.synactive.com/includes/r105.txt"

Ein geschachtelter Aufruf ist möglich bis zur Stufe 10.  Dabei bitte beachten, dass immer in dem aktiven Scriptverzeichnis gesucht wird, nicht relativ in dem Verzeichnis, in dem die übergeordnete include-Datei liegt.
Verwendung von Variablen in Include-Dateinamen Wenn Sie Variablen in Include-Anweisungen verwenden, etwa in:

   Include "inc.&V[company].txt"

ist es wichtig, den Kontext des Skripts zu beachten:

  • In GuiXT-Scripten (also außerhalb von InputScripts oder per process aufgerufenen Funktionen) wird der Variablenwert zur Laufzeit ausgewertet – genau in dem Moment, in dem die Include-Anweisung verarbeitet wird.
  • In InputScripts und process-Funktionen hingegen erfolgt das Einlesen der Include-Dateien bereits beim Laden des Skripts. Das bedeutet: Der Variablenwert wird nicht dynamisch, sondern statisch zum Ladezeitpunkt verwendet.

 Empfehlung: Verwenden Sie Variablen in Include-Dateinamen ausschließlich in GuiXT-Skripten. In InputScripts oder process-Funktionen kann dies zu unerwartetem Verhalten führen – GuiXT gibt in solchen Fällen eine Warnung im Trace aus.

Bedingte Includes Auch die bedingte Einbindung von Include-Dateien funktioniert in GuiXT-Skripten zuverlässig. Ein typisches Beispiel:

   if Q[Transaction=IW33]
       Include "IW33mainscript.txt"
    endif
  • In GuiXT-Scripten wird die Bedingung zur Laufzeit geprüft, und die Include-Datei wird nur bei erfüllter Bedingung geladen.
  • In InputScripts und process-Funktionen wird die if-Bedingung zwar ebenfalls zur Laufzeit ausgewertet, die zugehörige Include-Datei wird jedoch unabhängig davon bereits beim Laden des Skripts eingelesen.

Empfehlung: Nutzen Sie bedingte Includes bevorzugt in GuiXT-Skripten, um unerwünschtes Vorladen in InputScripts und process-Funktionen zu vermeiden.

Komponente GuiXT