Funktion Wenn Sie mit  CallJS eine JavaScript-Funktion aufrufen, ist bereits ein Objekt "guixt" vordefiniert (IE-Modus) oder kann über "let guixt = window.guixthost" abgerufen werden (Chromium Modus). Das guixt-Objekt gestattet den Zugriff auf GuiXT Scriptvariablen und bietet einige Sonderfunktionen z.B.  Aufruf von GuiXT Scripts aus JavaScript.

Das gleiche Objekt wird bei connectHTML an die HTML-Seite übergeben, indem eine Funktion guixt_initialize(obj) aufgerufen wird (falls vorhanden):

JavaScript

Falls die HTML-Seite mit WebView eingeblendet wurde, können Sie direkt das Objekt "guixthost" verwenden und auf die Funktion guixt_initialize() verzichten. Ein Aufruf von connectHTML íst trotzdem erforderlich.

Voraussetzung: Komponente "GuiXT Controls" ist aktiv.

Get() r = guixt.Get(var)

Wenn var den Inhalt "xxx" hat, wird die GuiXT Scriptvariable V[xxx] gelesen und der Inhalt nach r gestellt.

Beispiel:

menu_icon_path = guixt.Get("menu_icon_path");

Set() guixt.Set(var,value)

Wenn var den Inhalt "xxx" hat, wird die GuiXT Scriptvariable V[xxx] auf den Inhalt von value gesetzt.

Beispiel:

guixt.Set("menu_icon_path", "C:\guixt\menu\icons");

Tabellen- und Strukturvariablen
Ist V[xxx] eine mit CreateTable angelegte Tabellenvariable oder eine Strukturvariable, können Sie sie als Ganzes setzen, indem Sie einen String in JSON-Notation übergeben. Bei einer Tabelle ist das ein Array mit einem Objekt pro Zeile; die Eigenschaftsnamen sind die Spaltennamen. Es ist dieselbe Notation, die GuiXT für die String-Darstellung "&V[xxx]" verwendet. Sie können eine Tabelle also mit JSON.parse(guixt.Get("xxx")) lesen, in JavaScript ändern und mit guixt.Set("xxx", JSON.stringify(...)) zurückschreiben.

Beispiel:

// GuiXT Script: CreateTable V[customers] account name city
var rows = JSON.parse(guixt.Get("customers"));
rows.push({ account: "3000", name: "XYZ GmbH", city: "Berlin" });
guixt.Set("customers", JSON.stringify(rows));

Die mit CreateTable definierte Spaltenstruktur bleibt erhalten: Spalten, die in den JSON-Objekten fehlen, bleiben leer; zusätzliche Eigenschaften werden ignoriert.

Es gibt keine Größenbeschränkung. Die JSON-Umwandlung ist auch bei großen Tabellen schnell, ein Umweg über Langtextvariablen (SetText) ist nicht nötig.

Geänderte Variablen und der SAP-Bildschirm
Das Setzen einer Variablen ändert den SAP-Bildschirm nicht unmittelbar. Bildschirmelemente, die Variablen anzeigen (z.B. Eingabefelder mit V[...] oder ein Table Control auf Basis einer Tabellenvariablen), zeigen den neuen Inhalt beim nächsten Bildschirmaufbau.

  • Bei CallJS läuft die JavaScript-Funktion synchron während der GuiXT-Scriptverarbeitung. Der Bildschirm wird danach aufgebaut und zeigt die neuen Werte; eine Aktualisierung ist nicht nötig.
  • Bei CallJSAsync oder in einer Ereignisroutine einer HTML-Seite (connectHTML, WebView) ist der Bildschirm bereits aufgebaut. Zur Anzeige der neuen Werte ist ein Bildschirm-Roundtrip nötig. Empfehlenswert ist guixt.Input("OK:?"): Im Gegensatz zu "OK:/0" (Enter) löst der Funktionscode "?" keinerlei Aktionen in der SAP-Anwendung aus.
GetText() r = guixt.GetText(var)

Wenn var den Inhalt "xxx" hat, wird die GuiXT Langtextvariable text[xxx] gelesen und der Inhalt nach r gestellt.

SetText() guixt.SetText(var,value)

Wenn var den Inhalt "xxx" hat, wird die GuiXT Langtextvariable text[xxx] auf den Inhalt von value gesetzt.

Value() r = guixt.Value(var)

GuiXT ersetzt im angegebenen String alle &-Ausdrücke nach GuiXT-Logik durch die entsprechenden Werte und stellt das Resultat nach r.

Beispiel:

mat = guixt.Value("&F[Material]"); 

Input() guixt.Input(s)

Der angegebene String s wird exakt so interpretiert wie für die input= Option der Image-Anweisung beschrieben.

Beispiel:

guixt.input("U[VBELN]:" + ListView.selectedItem);
guixt.input("OK:/nVA03,process=va03_enter.txt");

Enter auslösen
Eine eigene Funktion guixt.Enter() gibt es nicht. Mit guixt.Input() lösen Sie Enter genauso aus, als hätte der Benutzer es ausgelöst; GuiXT und InputAssistant verarbeiten es in gleicher Weise:

guixt.Input("OK:/0"); // Enter
guixt.Input("OK:?");  // Enter ohne Aktion in der SAP-Anwendung

"OK:?" entspricht Enter "?" in einem InputScript (siehe Enter). Verwenden Sie es, wenn Sie nur einen neuen Bildschirm-Roundtrip benötigen, z.B. um per JavaScript geänderte Variablen anzuzeigen.

Process() guixt.Process(funcname, par1, par2, ...))

Entspricht der GuiXT Anweisung Process.

Aus dem ersten Parameter funcname wird der Scriptname "process_[funcname].txt" gebildet. Dieses Script wird durchgeführt, wobei die Parameter des Scripts durch die Werte von par1, par2,... besetzt werden. Der bei "Return" im Script gesetzte String wird zurückgegeben.

address = guixt.process("customeraddress", "K1032");

Beispiel:

JavaScript
FilePath() guixt.FilePath(s, [cache=True])

Der angegebene String s wird als Dateiname relativ zum GuiXT Scriptverzeichnis interpretiert.

  • Der gesamte Dateiname, mit aktuellem Scriptverzeichnis, wird zurückgegeben.
  • Ein absoluter Dateiname wie C:\guixt\scripts\..." bleibt unverändert.
  • Bei Angabe einer Datei aus dem SAP MIME Repository "SAPMR:..." wird im GuiXT Cache eine lokale Kopie erstellt und der Cache-Dateiname zurückgegeben
  • Ein Angabe einer http oder ftp Datei wie "http://..." oder "ftp://" wird im GuiXT Cache eine lokale Kopie erstellt und der Cache-Dateiname zurückgegeben.

Bei cache=True werden externe Dateien zunächst im GuiXT Cache gesucht.

Beispiele:

imgpath = guixt.FilePath("images\home.gif");
imgpath ist jetzt z.B. "C:\guixt\scripts1\images\home.gif"

imgpath = guixt.FilePath("http://www.synactive.com/images/s10logo_blue.gif");
imgpath ist jetzt z.B. "C:\Users\ADMINI~1\AppData\Local\Temp\guixt\GuiXT Cache\http\www.synactive.com\images\s10logo_blue.gif"

SetEventHandler() guixt.SetEventHandler(obj1,obj2)

Angabe zweier Objekte. Für jedes Event z.B. "Click" von Objekt obj1 wird die Funktion "OnClick" von Objekt2 aufgerufen. Die Parameterübergabe erfolgt gemäss der Event-Schnittstelle, d.h. Sie müssen die Funktionen zur Eventbehandlung mit den entsprechenden Parametern anlegen. Meist ist obj1 ein Control, z.B. ein Tree View oder ein List View, und obj2 ist ein Objekt zur Behandlung der Events.

Die ausgelösten Events und aktuellen Parameter können Sie mit der Trace-Funktion im GuiXT-Window anzeigen.

DoEvents() guixt.DoEvents()

Die Funktion wartet einige Millisekunden und verarbeitet dann alle Windows-Nachrichten, die sich in der Warteschlange befinden.

Sie benötigen die Funktion bei einigen Controls, die asynchrone Verarbeitungen durchführen. Zum Beispiel werden im Internet Explorer eine Seite und die einzelnen Objekte asynchron geladen, und Sie müssen die eigene Verarbeitung durch DoEvents() unterbrechen, bis die Seite geladen ist, ehe Sie mit der Verarbeitung der geladenen Seite beginnen können.

CreateObject() guixt.CreateObject(progid)

Erstellt und gibt einen Verweis auf ein ActiveX-Objekt zurück.

Beispiel:

let XXL = guixt.CreateObject("Excel.Application");

GetObject() guixt.GetObject(progid)

Gibt einen Verweis auf ein bereits existierendes registriertes Objekt zurück, das von einer ActiveX-Komponente bereitgestellt wird.

Beispiel:

let XXL = guixt.GetObject("Excel.Application");

Komponente GuiXT + Controls