| Funktion | Mit der CallVB-Anweisung können Sie aus einem GuiXT Script oder
InputScript .NET-Funktionen aufrufen – unabhängig davon, ob diese in C#, VB.NET oder einer anderen .NET-Sprache implementiert sind.
Die aufgerufene Funktion kann
Die .NET Klassenbibliothek (dll) kann lokal oder zentral, z.B. im SAP Mime Repository, zur Verfügung gestellt werden. Voraussetzungen:
|
| Beispiel | CallVB msg =
utilities.email.send Die .NET Klassenbibliothek "utilities.dll" wird aus dem im GuiXT Profile angegebenen Verzeichnis ".NET class libraries", guixt.ini-Parameter VBDirectory, geladen. Es wird pro SAP GUI -Modus ein Objekt der angegebenen Klasse "email" aus "utilities.dll" angelegt. Die Funktion "send" des Objekts wird aufgerufen und ihr Rückgabewert in V[msg] gespeichert. |
| Format 1 | CallVB
progname.classname.funcname
"par1" "par2 "par2" ... Die Funktion funcname eines pro SAP GUI Modus angelegten Objekts der Klasse classname (Klassenbibliothek progname.dll) wird aufgerufen. Die angegebenen Strings "par1", "par2",... werden an die Funktion als Parameter übergeben (Wertübergabe). Statt der Übergabe als Positionsparameter können Sie auch den in VB definierten Parameternamen angeben. Beispiel: CallVB utilities.email.send emailaddr:="&V[email]" cc:="&V[cclist]" subject:="&V[subject]" body:="&V[mytext]" |
| Format 2 | CallVB
varname
= progname.classname.funcname "par1" "par2 "par2" Die Funktion funcname eines pro SAP GUI Modus angelegten Objekts der Klasse classname (Klassenbibliothek progname.dll) wird aufgerufen. Die angegebenen Strings "par1", "par2",... werden an die Funktion als Parameter übergeben (Wertübergabe). Das Resultat der Funktion wird in einen String umgewandelt und in die Variable V[varname] gestellt. |
| Details zum Ablauf |
Bei der ersten Ausführung einer
CallVB-Anweisung
für eine Klassenbibliothek "progname.dll"
wird diese in die VB.NET Laufzeitumgebung geladen. Dazu wird sie, falls
das SAP MIME Repository im Profile als VBDirectory
angegeben ist, von dort zunächst in das lokale GuiXT-Cache-Verzeichnis
kopiert.
Falls Sie das SAP Web Repository oder SAP MIME Repository verwenden, bitte mit VersionNumber arbeiten. Ebenfalls kopiert wird, falls erforderlich, die Schnittstellenbibliothek guinet.dll. Als nächstes wird pro SAP GUI Modus genau ein Objekt der Klasse classname angelegt und die Funktion funcname des Objekts aufgerufen. Die Parameterübergabe an die Funktion erfolgt als Wertübergabe von Strings, ebenso wird der Rückgabewert als String in die angegebene GuiXT-Variable gestellt. Einzige Ausnahme: siehe den nachfolgenden Abschnitt über Objektreferenzen. In der VB-Funktion können Sie lesend und schreibend auf GuiXT Variablen und Langtextvariablen zugreifen, siehe Klasse "guixt" in VB. Damit können Sie eine Referenzübergabe einer Variablen dadurch realisieren, dass Sie statt eines Wertes den Namen der Variablen an die VB-Funktion übergeben und dort mit guixt.GetVariable() und guixt.SetVariable() arbeiten. |
| Konvertierung der Werte | Deklariert eine .NET-Funktion ihre Parameter als skalare Typen ungleich String (z. B. Integer, Decimal, Double oder Date), führt GuiXT beim Aufruf automatisch eine Konvertierung vom GuiXT-String in den Zieltyp durch. Technisch erfolgt dies innerhalb der .NET-Umgebung über die Methode CTypeDynamic.
Skalare Rückgabetypen wandelt GuiXT automatisch in einen String um. Dabei wird "Boolean" als "-1" für True, "0" für False zurückgegeben. Für Datumswerte und Dezimalzahlen wirken sich die Regionaleinstellungen des Benutzers aus. Empfehlungen zur Typisierung:
Beispiel mit automatischer Konvertierung:
Beispiel mit eigener Konvertierung (empfehlenswert):
GuiXT
Als Resultat wird "1.4142135623731" zurückgegeben. |
| Objektreferenzen |
Die Parameterübergabe von Objektreferenzen
an GuiXT Variablen ist in beide Richtungen möglich. GuiXT benutzt dazu eine
String-Darstellung der Objektreferenz und konvertiert automatisch zwischen
der Stringdarstellung und der Objektreferenz (technisch: eine "IDispatch"
Schnittstelle). Sie können also zum Beispiel in VB eine Klasse definieren,
in einer VB Funktion ein Objekt der Klasse mit New anlegen und die
Objektreferenz an GuiXT zurückgeben. An eine weitere VB-Funktion können
Sie dann aus GuiXT die Objektreferenz als Parameter übergeben und in der
Funktion auf Attribute und Methoden des Objekts zugreifen.
Beispiel: In der VB.NET-Funktion "newcustomer" legen Sie ein Objekt der von Ihnen definierten Klasse "customer" an, setzen ein Attribut ("name") und geben die Objektreferenz an GuiXT zurück:
In einer zweiten Funktion erwarten Sie als Parameter ein Objekt der Klasse "customer" und liefern den Namen zurück:
In GuiXT rufen Sie die erste Funktion auf und stellen das Ergebnis in eine Variable. Später können Sie dann die zweite Funktion aufrufen und den Inhalt der Variablen als Objektreferenz übergeben: GuiXT
|
| Behandlung von .NET Exceptions | Beim Aufruf der .NET Methode kann an verschiedenen Stellen eine Exception (Ausnahme mit Abbruch des CallVB) auftreten:
In allen Fällen setzt GuiXT als Rückgabewert auf "" und erzeugt eine Fehlermeldung im "Script" Fenster, dem InputScript Trace sowie im GuiXT Script Editor Pro, setzt aber die Verarbeitung des Scripts fort. SIe können nach CallVB mit if not Q[ok] abfragen, ob eine Exception aufgetreten ist; in der Systemvariablen V[_exception] steht dann der entsprechende Fehlertext. Hier sind einige Beispiele: GuiXT
Nachricht: "Method 'sqroot' not found in class 'calculations' of dll C:\GuiXT\VB\util.dll" GuiXT
Nachricht bei Parametertype "Double": "VB.NET Exception for parameter 'n': Die Eingabezeichenfolge hat das falsche Format. Conversion from string "abc" to type 'Double' is not valid." Nachricht bei bei Parametertyp "String" und eigener Konvertierung: "VB.NET Exception: Die Eingabezeichenfolge hat das falsche Format." Sie können in der .NET Methode auch eigene Prüfungen durchführen und dann durch "Throw" eine Exception mit einem selbstdefinierten Text auslösen:
GuiXT
Nachricht: "VB.NET Exception: Invalid value passed to method util.sqrt: abc" |
| Debugging | Sie können
mit einer "Stop" Anweisung in der VB.NET Funktion den Debugger
(Visual Studio) aktivieren. Alternativ können Sie auch in Visual Studio über "Debug -> Attach to process" dynamisch den Debugger für eine laufende SAP GUI Session aktivieren. Dabei als Prozess "saplogon.exe" angeben. |
| Beispiel 2 | Wir starten
Excel mit einigen Demowerten: GuiXT
In VB.NET nehmen wir in unserem Projekt am besten eine Referenz auf "Microsoft.Office.Interop.Excel" auf, damit wir typisiert (statt nur mit "Object") arbeiten können.
|
| .NET und Javascript | Im Tutorial Fortgeschritten: JS, .NET, WASM wird gezeigt, wie Sie .NET mit anderen Technologien (JavaScript und WASM) in GuiXT-Anwendungen integrieren können. |
| Tips & Tricks | |
| Komponente | GuiXT + Controls |