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 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 MIME Repository oder auf http/ftp Servern, z.B.

Include "SAPMR:SAP/BC/BSP/SAP/GUIXT/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.
Suche der Include-Datei Eine Include-Datei kann mit einem absoluten Pfad angegeben werden; in diesem Fall wird sie nur an dem angegebenen Ort gesucht. Wird kein absoluter Pfad verwendet, sucht GuiXT die Datei im gleichen Verzeichnis, in dem sich das Hauptskript befindet.

Ist im GuiXT-Profil die Option CheckAllDirectories aktiviert, erfolgt die Suche in allen aktiven Skriptverzeichnissen, entsprechend der gleichen Reihenfolge wie beim Hauptskript: von Directory4 bis Directory1.

Dieselbe Suchreihenfolge gilt auch bei verschachtelten Includes. Das bedeutet: Ein Include, das innerhalb eines anderen Include-Skripts eingebunden wird, wird ebenfalls im Verzeichnis des Hauptskripts gesucht – nicht im Verzeichnis des übergeordneten Include-Skripts. Bei aktiviertem  CheckAllDirectories erfolgt die Suche entsprechend wieder in der Reihenfolge Directory4 … Directory1.
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.

Tipps & Tricks
Komponente GuiXT