VBScript/en: Unterschied zwischen den Versionen

Aus expecco Wiki (Version 2.x)
Zur Navigation springen Zur Suche springen
Zeile 18: Zeile 18:


==Connecting==
==Connecting==
Bevor a script can be imported or executed, expecco needs to be connected to a ScriptClient. The "''connect''"-option is found in the menu.
Bevor ein Skript importiert oder ausgeführt werden kann, muss expecco mit dem ScriptClient verbunden werden. Die Option zum Verbinden findet sich im Menü.
Der Client kann entweder lokal oder auf einem entfernten Rechner laufen.


The ScriptClient can run either on the local or on a remote machine. Because it is a proprietary Windows program, it must run on either a Windows machine, a virtual machine running Windows or in an emulator, such as Wine. The connection is done via a .NET-bridge; therefore, expecco itself can run on any system (incl. Linux or OSX).
Bei lokalen Verbindungen wird der ScriptClient beim Verbindungsaufbau automatisch von expecco gestartet.


In case of a local connection, the ScriptClient will be automatically started by expecco. gestartet.


For a remote connection, the ScriptClient must be already running and started either manually, or via a script or autoexec.bat. Command-line arguments for the startup are described in the following table:
Für Remote-Verbindungen muss der Client hingegen manuell auf dem entfernten Host gestartet werden (dies kann natürlich auch über ein Script oder autoexec.bat des Testrechners geschehen). Befehlszeilenargumente für die Konfiguration des manuellen Starts sind in der folgenden Tabelle dargestellt.


{| class="wikitable"
{| class="wikitable"
|-
|-
! Argument !! Beschreibung
! Argument !! Description
|-
|-
| -port <int> || Der TCP-Port auf dem die Verbindung laufen soll.
| -port <int> || The TCP-port to be used for the connection.
|-
|-
| -mode <server/client>|| Gibt an ob die .Net-Bridge als TCP-Server oder TCP-Client läuft.
| -mode <server/client>|| Run the .NET-bridge either as TCP-server or TCP-client.
|-
|-
| -keepAlive <true/false>|| '''true''' wenn der ScriptClient nach Verbindungsabbruch weiter bestehen soll.
| -keepAlive <true/false>|| '''true''' if the ScriptClient should continue to run after a connection breakdown.
|}
|}



Version vom 8. Dezember 2016, 08:10 Uhr

Introduction[Bearbeiten]

VBScript-Code in expecco

This plugin allows for Visual Basic Script (VBScript) actions to be created, imported and executed in expecco. For import and execution, the plugin uses the Windows "ScriptClient", which is addressed via the .NET-Bridge.

Settings[Bearbeiten]

In den Einstellungen des Plugins ist der Pfad des ScriptClients hinterlegt. Per Default ist der Pfad:

  plugin\vbScript\ScriptClient\ScriptClient.exe


Außerdem kann in den Einstellungen ein Scope gesetzt werden. Der Scope dient dazu, das Importieren von Skripten zu vereinfachen. Ist er gesetzt wird im Importfenster nur der Teil des Dateisystems angezeigt, welcher im angegebenen Pfad liegt.

Die Checkbox "Delete External Files" gibt an, ob Skripte über den Importdialog gelöscht werden können, nachdem sie importiert wurden.

Arbeiten mit VBScript[Bearbeiten]

Im folgenden wird die Interaktion mit dem Plugin anhand üblicher Arbeitsabläufe näher beschrieben. Das Menü des Plugins ist unter "Erweiterungen" -> "VBScript" zu finden.

Connecting[Bearbeiten]

Bevor a script can be imported or executed, expecco needs to be connected to a ScriptClient. The "connect"-option is found in the menu.

The ScriptClient can run either on the local or on a remote machine. Because it is a proprietary Windows program, it must run on either a Windows machine, a virtual machine running Windows or in an emulator, such as Wine. The connection is done via a .NET-bridge; therefore, expecco itself can run on any system (incl. Linux or OSX).

In case of a local connection, the ScriptClient will be automatically started by expecco. gestartet.

For a remote connection, the ScriptClient must be already running and started either manually, or via a script or autoexec.bat. Command-line arguments for the startup are described in the following table:

Argument Description
-port <int> The TCP-port to be used for the connection.
-mode <server/client> Run the .NET-bridge either as TCP-server or TCP-client.
-keepAlive <true/false> true if the ScriptClient should continue to run after a connection breakdown.

Importing[Bearbeiten]

Import-Dialog

Über das Menü des Plugins kann der Importdialog geöffnet werden. Angezeigt werden Ordner und VBS-Dateien (*.vbs) des Rechners auf dem der verbundene ScriptClient läuft.

Der Sourcecode angewählter Skripte wird im Vorschaufenster angezeigt und kann über das Kontextmenü des Baums (Rechtsklick auf ein Scriptfile) oder die Buttons im Vorschaufenster importiert und ausgeführt werden.

Editing[Bearbeiten]

Wurde ein Skript importiert oder neu angelegt, wird es in der aktiven Testsuite abgelegt. Zuweisungen im Skript werden als Eingänge im entstandenen Block angelegt. Die durch das Skript abgebildete Aktion kann somit parametrisiert werden ohne in das Skript selbt eingreifen zu müssen.

Des weiteren verfügt der Block über einen Ausgang der den Wert zurück liefert, welchen das Skript an die Konsole zurückliefern würde.


Über den Tab "Quellcode" kann das Skript nachbearbeitet werden. Eingangspins werden im Skript wie Umgebundvariablen behandelt, der Name muss also im Script in %-Zeichen gesetzt werden.

Executing[Bearbeiten]

Beim Abspielen verhält sich ein VBScript-Block wie jeder andere Block in expecco. Es muss natürlich ein ScriptClient vorhanden sein, bzw. im Remote-Fall bereits gestartet sein. Selbstverständlich ist, daß der ScripClient auf einem Windows Rechner laufen muß (bzw. in einer virtuellen Windows Gastmaschine).



Copyright © 2014-2024 eXept Software AG