55.8 Platzhalter
55.8.1 Platzhalter für Knotenattribute (außer für Komponentenknoten)
Die folgende Tabelle beschreibt die Platzhalter, mit denen sich Informationen zu einem
aufgezeichneten Schritt abfragen lassen, die nicht die Komponente selbst betreffen.
Solche Platzhalter können, in spitze Klammern eingeschlossen (z.B. <text>),
unter anderem als Wert eines Attributs in der Rubrik
attributes, als Wert eines Parameters
in set procedure call parameters, als Wert eines Doctags in
doctags oder in einem Ausdruck der Rubrik
condition verwendet werden.
Der Name der Platzhalter für Attribute und Komponentenknoten entspricht dabei
dem Namen des zugehörigen YAML-Attributs
in der Rubrik attributes.
Dabei werden Leerzeichen, die in den Namen der YAML verwendet werden, in den
Platzhaltern weggelassen.
| Platzhalter | Beschreibung |
|---|---|
| client |
Der Client, unter dem das Ereignis aufgezeichnet wurde (Inhalt des Schritt-Attributs
client, meist eine Variable wie $(client)).
|
| client name | Der vollständige (absolute) Name des Clients, auf dem das Ereignis aufgezeichnet wurde. |
| checktype |
Der Name des Check-Typs des Knotens, zum Beispiel für Check Boolean Knoten
selected, checked,
visible oder enabled.
|
| <componentid> |
Der Wert des Platzhalters muss exakt mit dem Wert im Attribut QF-Test ID der Komponente
des zu konvertierenden Knotens übereinstimmen.
In einem DefinitionStep liegt der zugehörige Schlüssel
in der Rubrik attributes.
|
| detail |
Zusätzliche, ereignisspezifische Detailinformationen, z.B. die Angaben zu einer
aufgezeichneten Wischgeste (siehe startx, starty,
endx, endy und swipeduration weiter unten).
|
| file | Der Dateiname bzw. -pfad des aufgezeichneten Ereignisses. |
| height | Die Höhe des Fensters oder der Komponente. |
| width | Die Breite des Fensters oder der Komponente. |
| keychar | Das Zeichen eines aufgezeichneten Tastaturereignisses. |
| keycode | Der Tastencode eines aufgezeichneten Tastaturereignisses. |
| modifiers | Die beim Ereignis gedrückten Zusatztasten (z.B. Umschalt, Strg), kodiert als Zahlenwert. |
| clicks | Die Anzahl der Mausklicks des aufgezeichneten Mausevent. |
| hardclick | Ob es sich beim aufgezeichneten Mausevent um einen "harten" Mausklick handelte, der die normale Fokusbehandlung überspringt. |
| popup | Ob der aufgezeichnete Mausklick ein Kontextmenü (Popup) ausgelöst hat. |
| x | Die x-Koordinate des Ereignisses; bei Komponentenevent-Knoten der erste Parameter des Schritts. |
| y | Die y-Koordinate des Ereignisses; bei Komponentenevent-Knoten der zweite Parameter des Schritts. |
| startx, starty, endx, endy, swipeduration |
Start- und Endkoordinaten sowie Dauer einer aufgezeichneten Wischgeste. Diese
Platzhalter liefern nur dann einen Wert, wenn der Wert im Attribut detail
des umzuwandelnden Knotens mit swipe: .
|
| procedure | Name der Prozedur eines Prozeduraufrufs. |
| window | Der Name des Fensters, in dem das Ereignis aufgetreten ist. |
| singleevents | Ob die Texteingabe bei einem Texteingabe über einzelne Tastenereignisse erfolgte. |
| clear | Ob der vorhandene Text bei einem Texteingabe vor der Eingabe gelöscht wurde. |
| text, VALUE |
Der aufgezeichnete Text bzw. aktuelle Wert der Komponente zum Zeitpunkt des
Ereignisses. Bei Texteingabe- und Check Text-Knoten der eingegebene
bzw. erwartete Text. Bei anderen Ereignissen an Unterelementen, z.B. von Tabellen
oder Listen, der aufgezeichnete Wert des betroffenen Unterelements, andernfalls
der aktuelle Selektionszustand der Komponente. Auch nutzbar als Alias
currentvalue bzw. value.
|
| selectedstate, checkedstate, visiblestate, enabledstate, editablestate, state |
Der zum Zeitpunkt des Ereignisses aufgezeichnete Zustand der Komponente. Bei
Check Boolean-Knoten werden die Zustände stattdessen aus dem erwarteten
Zustand (
Bei CheckBoxen, RadioButtons, ToggleButtons und Menüeinträgen, die durch einen
Mausklick angeklickt wurden, geben |
| items |
Die Liste der Einträge eines Check Elemente-Knotens.
Standardmäßig werden die Listeneinträge durch ||| voneinander
getrennt. Über die Option "OPT_RECORDING_PROCESSOR_ITEMLIST_SEPARATOR"
können Sie in einem Server-Skript einen anderen Wert setzen.
|
| itemswithselection |
Die Liste der Einträge eines Check selektierbare Elemente-Knotens samt
Selektionszustand, getrennt wie beim Platzhalter items.
|
| event |
Der Name des Events, z.B. MOUSE_CLICK für das Event-Attribut
eines Mausevent oder für einen Tastaturevent KEY_STROKE.
|
| resultvariable | Der Name der Variable, in die der Index bei Index auslesen-Knoten geschrieben wird. |
| variable name |
Der Name der Variable, die den Rückgabewert eines Prozeduraufruf empfängt
(Variable für Rückgabewert). Auch nutzbar als Alias returnvariable
bzw. variablename.
|
| localvariable | Ob die Ergebnisvariable zum Beispiel eines Check-Knotens eine lokale Variable ist. |
55.8.2 Platzhalter für Komponentenknoten
| Platzhalter | Beschreibung |
|---|---|
| <id> | Die QF-Test ID eines Komponente-Knotens. |
| <name> | Der Name der Komponente |
| <feature> | Das Merkmal der Komponente |
| <class> | Die aufgezeichnete Klasse der Komponente |
| <COMPEF-name-des-weiteren-merkmals> | Der Wert des angegebenen weiteren Merkmals der Komponente |
| <ENGINE> | Der Name der Engine, entweder 'awt', 'swt', 'web' oder 'fx'. |
| <ENGINE2> | Der alternative Name der Engine, entweder 'swing', 'swt', 'web' oder 'fx'. |
55.8.3 Platzhalter für Zustände von Komponenten im SUT
Die Zustands-Platzhalter selectedstate,
checkedstate, visiblestate,
enabledstate und editablestate, stehen nur als
Platzhalter zur Verfügung und sind keine eigenen YAML-Attribute.
| Platzhalter | Beschreibung |
|---|---|
| <enabledstate> | Der Status zum Zeitpunkt der Aufnahme, ob die Komponente enabled ist. |
| <selectedstate> | Der Status zum Zeitpunkt der Aufnahme, ob die Komponente selektiert ist. Bei Mausklicks auf CheckBoxen, RadioButtons, ToggleButtons und selektierbaren Menüeinträgen der (alte) Zustand vor dem Klick. |
| <checkedstate> | Bei Mausklicks auf CheckBoxen, RadioButtons, ToggleButtons und selektierbaren Menüeinträgen der durch den Klick erwartete (neue) Zustand, ob die Komponente angehakt beziehungsweise aktiviert ist. Technisch handelt es sich um den negierten Wert des Zustands vor dem Klick. Für andere Knotentypen wird der "angehakt" beziehungsweise "aktiviert" Zustand der Komponente geliefert. |
| <editablestate> | Der Status zum Zeitpunkt der Aufnahme, ob die Komponente editierbar ist. |
| <visiblestate> | Der Status zum Zeitpunkt der Aufnahme, ob die Komponente sichtbar ist. |