Port IMAGE - DEFAULT¶

Standard-Port für Interaktionen mit dem Browser

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Browser		‚Firefox‘	[‚Firefox‘, ‚Chrome‘, ‚Edge‘]	string	Auswahl des Browsers. Passend zur gewählten Einstellung müssen der Pfad zum Browser und der Pfad zum entsprechenden Webdriver gesetzt werden.
Browser-Pfad		‚<auto>‘		string	Absoluter Installationspfad zum Browser oder „<auto>“, um den Standardpfad zu verwenden.
Browser-Profilpfad				string	Optional: Absoluter Pfad zum verwendeten Browser-Profil
Browser-Erweiterungen				string	Optional: Kommaseparierte Pfade zu Browser-Erweiterungen. Pfade können absolut oder relativ zum Basispfad des Toolhosts angegeben werden.
Browser-Breite		800		int	Breite des Browser-Fensters in Pixel.
Browser-Höhe		600		int	Höhe des Browser-Fensters in Pixel.
WebDriver-Pfad		‚<auto>‘		string	Installationspfad zum Webdriver. Pfad kann absolut oder relativ zum Basispfad des Toolhosts angegeben werden. Die Option „<auto>“ versucht, den Treiber automatisch über den Webdriver-Manager von Selenium zu finden und herunterzuladen (Internetzugang erforderlich).
Implizites Timeout		10		float	Timeout in Sekunden, welches für alle Schritte gilt, sofern nicht im Schritt anders spezifiziert.
Headless Modus		☐		bool	Startet den Browser im Headless Mode (ohne sichtbare Anzeige).
Zusätzliche Argumente				string	Zusätzliche Kommandozeilenargumente, die beim Start an den konfigurierten Webdriver übergeben werden, z. B. „–proxy-server=http://proxy.local:8338“. Mögliche Argumente finden Sie in der Selenium Webdriver Dokumentation.
Live-Vorschau		☐		bool	Streamt eine Live-Vorschau auf dem eingestellten Netzwerkport. Der Livestream ist unter der IP-Adresse des Toolhosts und dem eingestellten Port erreichbar, z.B. für eine lokale Toolanbindung: http://127.0.0.1:<port>
Vorschaufenster öffnen	Live-Vorschau	☑		bool	Öffnet ein Vorschaufenster beim Ausführen des StartBrowser-Jobs. Dieses Fenster zeigt das aktuelle Bild als Livestream an und bleibt so lange geöffnet bis der StopBrowser-Job ausgeführt wird.
Port	Live-Vorschau	‚<auto>‘		string	Der Port über welchen das Bild gestreamt werden soll. Falls die Live-Vorschau für mehrere Bildquellen aktiviert ist, muss jeder Livestream einen anderen Port verwenden. Wenn <auto> eingetragen ist, wird automatisch ein freier Port zugewiesen.
Text-Overlay in Aufzeichungen einblenden		☐		bool	Fügt bei Aktivierung ein Text-Overlay im Format „Timestamp Packagename“ in die untere linke Ecke von Videoaufnahmen ein.

Jobs 🛈¶

ClickElement¶

Klickt auf das gewünschte Element.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
searchMethod	‚id‘	[‚id‘, ‚xpath‘, ‚link text‘, ‚partial link text‘, ‚name‘, ‚tag name‘, ‚class name‘, ‚css selector‘]	string	Die Methode, mit der das Element identifiziert wird.
searchValue			string	Der Wert zur Identifikation des Elements auf das geklickt werden soll, passend zur Such-Methode.
timeout	-1.0		float	Timeout zum Warten auf das Element; -1 für Standardwert aus Testbenchkonfiguration.

ClickPosition¶

Klickt auf die angegebene Position.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
positionX		0		int	Die X-Koordinate der Position.
positionY		0		int	Die Y-Koordinate der Position.

CloseWindow¶

Schließt das angegebene Fenster.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
windowHandle				string	Der Identifier für das zu wechselnde Fenster.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
success			[False, True]	bool	Gibt zurück, ob das Schließen des Fensters erfolgreich war.

DragAndDropByOffset¶

Führt ein Drag and Drop auf einem Element in die angegebene Richtung durch.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
offsetX	0		int	Anzahl der Pixel in horizontaler Richtung.
offsetY	0		int	Anzahl der Pixel in vertikaler Richtung.
searchMethod	‚id‘	[‚id‘, ‚xpath‘, ‚link text‘, ‚partial link text‘, ‚name‘, ‚tag name‘, ‚class name‘, ‚css selector‘]	string	Die Methode, mit der das Element identifiziert wird.
searchValue			string	Der Wert zur Identifikation des Elements auf das geklickt werden soll, passend zur Such-Methode.
timeout	-1.0		float	Timeout zum Warten auf das Element; -1 für Standardwert aus Testbenchkonfiguration.

ElementScreenshot¶

Gibt das Bild des ersten gesuchten Elements zurück.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
searchMethod	‚id‘	[‚id‘, ‚xpath‘, ‚link text‘, ‚partial link text‘, ‚name‘, ‚tag name‘, ‚class name‘, ‚css selector‘]	string	Die Methode, mit der das Element identifiziert wird.
searchValue			string	Der Wert zur Identifikation des Elements auf das geklickt werden soll, passend zur Such-Methode.
timeout	-1.0		float	Timeout zum Warten auf das Element; -1 für Standardwert aus Testbenchkonfiguration.

FindElements¶

Gibt die IDs der gesuchten Elemente zurück

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
searchMethod	‚id‘	[‚id‘, ‚xpath‘, ‚link text‘, ‚partial link text‘, ‚name‘, ‚tag name‘, ‚class name‘, ‚css selector‘]	string	Die Methode, mit der das Element identifiziert wird.
searchValue			string	Der Wert zur Identifikation des Elements auf das geklickt werden soll, passend zur Such-Methode.
timeout	-1.0		float	Timeout zum Warten auf das Element; -1 für Standardwert aus Testbenchkonfiguration.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Response				object	Liste mit IDs.

GetCurrentUrl¶

Gibt die URL der aktuell geöffneten Seite zurück.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Response				string	Aktuelle URL.

GetElementProperty¶

Gibt die gewünschte Eigenschaft des Elements zurück.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
propertyName			string	Der Wert der Eigenschaft, die zurückgegeben werden soll.
searchMethod	‚id‘	[‚id‘, ‚xpath‘, ‚link text‘, ‚partial link text‘, ‚name‘, ‚tag name‘, ‚class name‘, ‚css selector‘]	string	Die Methode, mit der das Element identifiziert wird.
searchValue			string	Der Wert zur Identifikation des Elements auf das geklickt werden soll, passend zur Such-Methode.
timeout	-1.0		float	Timeout zum Warten auf das Element; -1 für Standardwert aus Testbenchkonfiguration.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Response				string	Eigenschaftswert.

GetOpenWindows¶

Gibt alle geöffneten Fenster zurück. Leere Liste, falls keine offen sind.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
windows				object	Liste aller geöffneter Fenster.

GetPageSource¶

Gibt den HTML Quelltext der Seite zurück.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
html				string	HTML Quelltext der Seite.

GetWebDriver¶

Gibt den internen Selenium Webdriver zurück, der direkten Zugriff auf die Selenium-API ermöglicht.

GoBack¶

Zeigt die vorherige Seite wieder an.

MoveMouseOverElement¶

Bewegt die Maus zum ersten gefundenen Element.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
searchMethod	‚id‘	[‚id‘, ‚xpath‘, ‚link text‘, ‚partial link text‘, ‚name‘, ‚tag name‘, ‚class name‘, ‚css selector‘]	string	Die Methode, mit der das Element identifiziert wird.
searchValue			string	Der Wert zur Identifikation des Elements auf das geklickt werden soll, passend zur Such-Methode.
timeout	-1.0		float	Timeout zum Warten auf das Element; -1 für Standardwert aus Testbenchkonfiguration.

OpenUrl¶

Öffnet die angegebene Webseite (URL).

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
url			string	Die komplette Web-Adresse.
windowName			string	Der Name des Fensters in dem die URL geöffnet werden soll.
windowType	‚Aktuelles Fenster‘	[‚Aktuelles Fenster‘, ‚Ausgewähltes Fenster‘, ‚Neues Fenster‘, ‚Neuer Tab‘]	string	Art des Fensters in dem die URL geöffnet werden soll.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
windowHandle				string	Der Identifier des Fensters.

ScrollElement¶

Scrollt im angegebenen Element um die angegebene Distanz - bei negativer Distanz nach oben, sonst nach unten.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
searchMethod	‚id‘	[‚id‘, ‚xpath‘, ‚link text‘, ‚partial link text‘, ‚name‘, ‚tag name‘, ‚class name‘, ‚css selector‘]	string	Die Methode, mit der das Element identifiziert wird.
searchValue			string	Der Wert zur Identifikation des Elements auf das geklickt werden soll, passend zur Such-Methode.
xDistance	0		int	Die zu scollende Anzahl von Pixeln.
yDistance	0		int	Die zu scollende Anzahl von Pixeln.

ScrollPage¶

Scrollt die gesamte Seite um die angegebene Distanz - bei negativer Distanz nach oben bzw. nach links, sonst nach unten bzw. nach rechts.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
xDistance		0		int	Die zu scollende Anzahl von Pixeln.
yDistance		0		int	Die zu scollende Anzahl von Pixeln.

ScrollToElement¶

Scrollt zum angegebenen Element.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
searchMethod		‚id‘	[‚id‘, ‚xpath‘, ‚link text‘, ‚partial link text‘, ‚name‘, ‚tag name‘, ‚class name‘, ‚css selector‘]	string	Die Methode, mit der das Element identifiziert wird.
searchValue				string	Der Wert zur Identifikation des Elements auf das geklickt werden soll, passend zur Such-Methode.

SendKey¶

Drückt eine Sondertaste.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
key		‚ADD‘	[‚ADD‘, ‚ALT‘, ‚ARROW_DOWN‘, ‚ARROW_LEFT‘, ‚ARROW_RIGHT‘, ‚ARROW_UP‘, ‚BACKSPACE‘, ‚BACK_SPACE‘, ‚CANCEL‘, ‚CLEAR‘, ‚COMMAND‘, ‚CONTROL‘, ‚DECIMAL‘, ‚DELETE‘, ‚DIVIDE‘, ‚DOWN‘, ‚END‘, ‚ENTER‘, ‚EQUALS‘, ‚ESCAPE‘, ‚F1‘, ‚F10‘, ‚F11‘, ‚F12‘, ‚F2‘, ‚F3‘, ‚F4‘, ‚F5‘, ‚F6‘, ‚F7‘, ‚F8‘, ‚F9‘, ‚HELP‘, ‚HOME‘, ‚INSERT‘, ‚LEFT‘, ‚LEFT_ALT‘, ‚LEFT_COMMAND‘, ‚LEFT_CONTROL‘, ‚LEFT_META‘, ‚LEFT_OPTION‘, ‚LEFT_SHIFT‘, ‚META‘, ‚MULTIPLY‘, ‚NULL‘, ‚NUMPAD0‘, ‚NUMPAD1‘, ‚NUMPAD2‘, ‚NUMPAD3‘, ‚NUMPAD4‘, ‚NUMPAD5‘, ‚NUMPAD6‘, ‚NUMPAD7‘, ‚NUMPAD8‘, ‚NUMPAD9‘, ‚PAGE_DOWN‘, ‚PAGE_UP‘, ‚PAUSE‘, ‚RETURN‘, ‚RIGHT‘, ‚RIGHT_ALT‘, ‚RIGHT_CONTROL‘, ‚RIGHT_META‘, ‚RIGHT_OPTION‘, ‚RIGHT_SHIFT‘, ‚SEMICOLON‘, ‚SEPARATOR‘, ‚SHIFT‘, ‚SPACE‘, ‚SUBTRACT‘, ‚TAB‘, ‚UP‘, ‚ZENKAKU_HANKAKU‘]	string	Die Taste, die gedrückt werden soll.

SetWindowSize¶

Ändert die Größe des Browserfensters.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
mode	‚Aus Testbenchkonfiguration‘	[‚Aus Testbenchkonfiguration‘, ‚Maximiert‘, ‚Minimiert‘, ‚Benutzerdefiniert‘]	string	Benutzerdefinierter Wert, „maximiert“, „minimiert“ oder Standardwert aus Testbenchkonfiguration
windowHeight	0		int	Fensterhöhe in Pixel für Modus „Benutzerdefiniert“.
windowWidth	0		int	Fensterbreite in Pixel für Modus „Benutzerdefiniert“.

StartBrowser¶

Startet die Browser-Instanz.

StopBrowser¶

Stoppt die Browser-Instanz.

SwitchToDefaultContent¶

Setzt den Fokus zurück auf den Standardinhalt nachdem ein iframe ausgewählt wurde.

SwitchToFrame¶

Setzt den Fokus auf einen iframe, um Elemente darin zu lokalisieren.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
identifier				string	Index, Name oder ID des iframe-Containers.

SwitchToWindow¶

Wechselt zum angegebenen Fenster.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
windowHandle				string	Der Identifier für das zu wechselnde Fenster.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
success			[False, True]	bool	Gibt zurück, ob der Wechsel zum Fenster erfolgreich war.

WebsiteScreenshot¶

Gibt ein Bild der kompletten Webseite zurück, inklusive des nicht sichtbaren Bereichs.

WriteText¶

Schreibt den übergegebenen Text an die aktuelle Cursor-Position.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
pressEnter		☐		bool	Falls True, wird nach der Texteingabe Enter gedrückt.
text				string	Der einzugebende Text.