Port IMAGE - DEFAULT

Standard-Port für die Interaktion mit einer AUT

Stimulation

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Besonderheiten

Die unterstützten Toucheingaben Tap, Hold und Multi-Tap werden als Mausaktionen ausgeführt. Tap entspricht dabei einem Linksklick, Hold einem langen Linksklick und Multi-Tap einem mehrfach wiederholten Linksklick mit der angegebenen Wartezeit dazwischen. Damit kann bspw. ein Doppelklick erzeugt werden.

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Name der AUT

string

Name der Application Under Test, die gestartet werden soll

Screenshot Modus

Desktop

[Desktop, Object]

string

Legt den Bereich fest, von dem beim Bild-Lesen-Testschritt ein Screenshot erstellt wird.

Object für Medienzugriff

Screenshot Modus: ‚Object‘

string

Name des Objects welches beim Medienzugriff verwendet wird. Der Bild-Lesen-Testschritt wird einen Screenshot von dem hier konfigurierten Object machen. Dies muss der Name eines Member der Objectmap (names.py) sein.

Delay für Object-Screenshots ❲ms❳

1000

int

Verzögerung für Bild-Lesen-Schritte im Screenshot Modus „Object“ und für Job „Screenshot“. Per Default 1000 ms, damit die Aut zuvor eventuelle Eingaben verarbeiten und einen stabilen Zustand erreichen kann.

Toolkit Wrapper der AUT

Windows

[Qt, Windows, Web (Chromium-based Application)]

string

Name des Toolkit Wrappers, der für die AUT zum Einsatz kommen soll. Falls nicht bekannt, kann dieser Wert den Einstellungen der Test Suite entnommen werden.

Remote-Debugging-Port

Toolkit Wrapper der AUT: ‚Web (Chromium-based Application)‘

int

Portnummer des Remote-Debugging-Ports der AUT für den Aufbau einer Verbindung von Squish zum Chromium-Webinhalt der AUT.

AUT starten und stoppen

☑

bool

Wenn aktiviert, wird die Application Under Test beim Starten der Konfiguration automatisch gestartet und beim Stoppen der Konfiguration wieder beendet.

CheckIfObjectExists

Prüft ob Object existiert.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ItemName

string

Falls Object ein Container (z.B. Liste, Tabelle, Baum) ist, kann hiermit optional ein Unterelement angegeben werden. Bei Tabellen erfolgt die Vorgabe als „Zeile/Spalte“ (z.B. „5/3“), bei Bäumen als Pfad mit „.“ als Trennzeichen. Für die Toolkits Windows, Java und Qt wird dieses Element ausgewertet, sonst das Object.

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

return

[False, True]

bool

True wenn das Object existiert, sonst False.

GetObjectProperty

Fragt den Wert einer Eigenschaft vom Object mit dem gegebenen Namen ab.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ItemName

string

Falls Object ein Container (z.B. Liste, Tabelle, Baum) ist, kann hiermit optional ein Unterelement angegeben werden. Bei Tabellen erfolgt die Vorgabe als „Zeile/Spalte“ (z.B. „5/3“), bei Bäumen als Pfad mit „.“ als Trennzeichen. Für die Toolkits Windows, Java und Qt wird dieses Element ausgewertet, sonst das Object.

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

PropertyName

string

Name der abzufragenden Eigenschaft.

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

return

string

Textrepräsentation des Wertes der Eigenschaft.

GetTableCell

Liest die Daten einer Tabellenzelle aus. Erlaubt dabei die Angabe einer beliebigen QT Rolle wie Qt.DisplayRole oder Qt.UserRole. Dieser Job ist nur in Verbindung mit dem Toolkit „Qt“ ausführbar. Bei anderen Toolkits kommt es zu einem Fehler.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

Position

(0, 0)

object

Koordinaten der Zelle, die gelesen werden soll.

RoleContext

‚Qt.DisplayRole‘

[‚Qt.DisplayRole‘, ‚Qt.UserRole‘]

string

Art der zu erfassenden Information. Bei Angabe einer Qt-Rolle die wird der Inhalt der gewählten Zelle in der entsprechenden Darstellung ausgegeben. Beispielsweise entspricht „Qt.DisplayRole“ den wesentlichen Inhalten der Zelle in Textform.

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

return

object

Repräsentation des Wertes der Zelle.

GetTableSize

Liefert die Größe einer Tabelle. Dieser Job ist nur in Verbindung mit dem Toolkit „Qt“ ausführbar. Bei anderen Toolkits kommt es zu einem Fehler.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

return

object

Die Größe der Tabelle als (Zeilenanzahl, Spaltenanzahl).

MouseClickObject

Löst einen Mausklick auf dem Element aus, welches über den Object Name identifiziert wird.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ItemName

string

Falls Object ein Container (z.B. Liste, Tabelle, Baum) ist, kann hiermit optional ein Unterelement angegeben werden. Bei Tabellen erfolgt die Vorgabe als „Zeile/Spalte“ (z.B. „5/3“), bei Bäumen als Pfad mit „.“ als Trennzeichen. Für die Toolkits Windows, Java und Qt wird dieses Element ausgewertet, sonst das Object.

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

MouseClickPosition

Löst einen Mausklick an einer bestimmten Position aus.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Position

(0, 0)

object

Position, an die geklickt werden soll. Muss ein Tupel der Form (x, y) sein.

MouseDragObject

Drückt die linke Maustaste auf einem Element und verschiebt es.

Dieser Tooljob ist nur in Verbindung mit dem Toolkit „Qt“ ausführbar. Bei anderen Toolkits kommt es zu einem Fehler.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Delta

(0, 0)

object

Delta, um das die Maustaste das Object verschieben soll. Muss ein Tupel der Form (x, y) sein.

ItemName

string

Falls Object ein Container (z.B. Liste, Tabelle, Baum) ist, kann hiermit optional ein Unterelement angegeben werden. Bei Tabellen erfolgt die Vorgabe als „Zeile/Spalte“ (z.B. „5/3“), bei Bäumen als Pfad mit „.“ als Trennzeichen. Für die Toolkits Windows, Java und Qt wird dieses Element ausgewertet, sonst das Object.

Modifier1

[ONLINE]

string

Sondertaste, welche gedrückt sein soll.

Modifier2

[ONLINE]

string

Sondertaste, welche gedrückt sein soll.

MouseButton

[ONLINE]

string

Maustaste, welche für das Drücken verwendet werden soll.

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

Position

(0, 0)

object

Position, an welcher die Maustaste innerhalb des Objects gedrückt werden soll. Muss ein Tupel der Form (x, y) sein.

MousePressAndHoldObject

Drückt die linke Maustaste auf einem Element und hält sie für eine bestimmte Zeit gedrückt. Das Ziel wird über einen Namen aus der Objectmap (names.py) identifiziert.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Duration

1.0

float

Wie lang die Maustaste auf dem Ziel gedrückt gehalten werden soll (in Sekunden).

ItemName

string

Falls Object ein Container (z.B. Liste, Tabelle, Baum) ist, kann hiermit optional ein Unterelement angegeben werden. Bei Tabellen erfolgt die Vorgabe als „Zeile/Spalte“ (z.B. „5/3“), bei Bäumen als Pfad mit „.“ als Trennzeichen. Für die Toolkits Windows, Java und Qt wird dieses Element ausgewertet, sonst das Object.

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

MousePressAndHoldPosition

Drückt die linke Maustaste an einer bestimmten Position und hält sie für eine bestimmte Zeit gedrückt.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Duration

1.0

float

Wie lange die Maustaste gedrückt gehalten werden soll (in Sekunden).

Position

(0, 0)

object

Position, an welcher die Maustaste gedrückt werden soll. Muss ein Tupel der Form (x, y) sein.

ReattachAut

Dieser Job stellt eine Verbindung zur zugewiesenen AUT her. Sollte die AUT bereits verbunden sein, wird die bestehende Verbindung beendet und eine neue Verbindung aufgebaut. Eine erstmalige Verbindung ist mit diesem Job ebenfalls möglich.

Sollte die AUT nicht verbunden werden können, wird der Name zurückgegeben.

Dieser Job kann nicht verwendet werden, wenn die AUT automatisch mit dem Port gestartet und gestoppt wird.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

errorAut

string

Name der AUT, falls sie nicht verbunden werden konnte.

Screenshot

Macht einen Screenshot von einem Element, welches über den Object Name identifiziert wird. Das Object muss dabei nicht sichtbar sein.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ItemName

string

Falls Object ein Container (z.B. Liste, Tabelle, Baum) ist, kann hiermit optional ein Unterelement angegeben werden. Bei Tabellen erfolgt die Vorgabe als „Zeile/Spalte“ (z.B. „5/3“), bei Bäumen als Pfad mit „.“ als Trennzeichen. Für die Toolkits Windows, Java und Qt wird dieses Element ausgewertet, sonst das Object.

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

SendEvent

Sendet ein Event an das gegebene Object.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

EventArgs

()

object

Argumente des Events als Tupel.

EventName

string

Name des Event.

ItemName

string

Falls Object ein Container (z.B. Liste, Tabelle, Baum) ist, kann hiermit optional ein Unterelement angegeben werden. Bei Tabellen erfolgt die Vorgabe als „Zeile/Spalte“ (z.B. „5/3“), bei Bäumen als Pfad mit „.“ als Trennzeichen. Für die Toolkits Windows, Java und Qt wird dieses Element ausgewertet, sonst das Object.

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

SetObjectProperty

Setzt den Wert einer Object-Eigenschaft mit dem gegebenen Namen.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ItemName

string

Falls Object ein Container (z.B. Liste, Tabelle, Baum) ist, kann hiermit optional ein Unterelement angegeben werden. Bei Tabellen erfolgt die Vorgabe als „Zeile/Spalte“ (z.B. „5/3“), bei Bäumen als Pfad mit „.“ als Trennzeichen. Für die Toolkits Windows, Java und Qt wird dieses Element ausgewertet, sonst das Object.

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

PropertyName

string

Name der zu setzenden Eigenschaft.

Value

()

object

Wert der zu setzenden Eigenschaft. Sowohl einzugebender Datentyp als auch die Schreibberechtigung sind vom Object und dem Toolkit abhängig.

TypeText

Befüllt ein Eingabefeld, als würde man die Tastatur verwenden. Angaben in <> werden als Tastendruck interpretiert, beilspielsweise <Ctrl+c>.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ItemName

string

Falls Object ein Container (z.B. Liste, Tabelle, Baum) ist, kann hiermit optional ein Unterelement angegeben werden. Bei Tabellen erfolgt die Vorgabe als „Zeile/Spalte“ (z.B. „5/3“), bei Bäumen als Pfad mit „.“ als Trennzeichen. Für die Toolkits Windows, Java und Qt wird dieses Element ausgewertet, sonst das Object.

ObjectName

[ONLINE]

string

Name des referenzierten Objects. Dies muss der Name eines Members der Objectmap (names.py) sein.

Value

string

Einzugebender Text. Sowohl zulässige Tastenkombinationen, beispielsweise „<Ctrl+Return>“, als auch die Schreibberechtigung sind vom Object und dem Toolkit abhängig.