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.

Eigenschaften 🛈¶

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‘, ‚XView‘, ‚Tk‘, ‚Web‘, ‚Java‘, ‚Mac‘, ‚Windows‘, ‚Android‘, ‚iOS‘, ‚Flex‘]	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.
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

Jobs 🛈¶

CheckIfObjectExists¶

Prüft ob Object existiert.

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.

Parameter

Name	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.

Parameter

Name	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.

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.

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.

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.

Parameter

Name	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.

Parameter

Name	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.

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.

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.

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.

Parameter

Name	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.

Parameter

Name	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>.

Parameter

Name	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.