5.4.4

Weitere Merkmale

In der Tabelle 'Weitere Merkmale' werden unterschiedliche Informationen, die für die Wiedererkennung der Komponente nützlich sein können, abgespeichert. Unter 'Weitere Merkmale' finden Sie eine Aufstellung der standardmäßig erzeugten Einträge. Sie können aber auch eigene über einen ExtraFeatureResolver (siehe Abschnitt 52.1.11) hinzufügen.

Einige der weiteren Merkmale werden prophylaktisch aufgezeichnet und im Normalfall gar nicht für die Komponentenerkennung genutzt. Dies betrifft hauptsächlich Informationen zur Komponentenklasse, die QF-Test für die Ableitung der Generische Klassen nutzt. Sie erhalten standardmäßig den Status 'Ignorieren'. Dieser kann umgestellt werden, wenn in Spezialfällen der Originalwert von Interesse ist.

Für die Wiedererkennung ist die Beschriftung einer Komponente relevant, für die unterschiedliche qfs:label*-Varianten zur Verfügung stehen.

5.4.4.1

qfs:label*-Varianten

Beschriftungen sind nach dem Komponentenbezeichner, der von den Entwicklern vergeben und von QF-Test im Attribut Name gespeichert wird, das nächstbeste Kriterium für die Komponentenerkennung.

Beschriftungen können über unterschiedliche Arten dargestellt werden. Bei einem Button ist dies meist der eigene Text, bei einem Textfeld hingegen ein Text, der häufig links oder oberhalb des Eingabefeldes steht. Es gibt programmtechnisch zugeordnete Beschriftungen. Auch der Tooltip, der Name eines Images oder der Titel der Komponente können als Beschriftung genutzt werden.

QF-Test speichert Informationen zur Beschriftung in den weiteren Merkmalen ab. Bis QF-Test Version 6 wurde nach einem bestimmten Algorithmus die am besten passende Beschriftung ermittelt und im weiteren Merkmal qfs:label abgespeichert.

7.0+ Ab QF-Test Version 7.0 werden in Frage kommende Beschriftungen in weiteren Merkmalen abgespeichert, die mit qfs:label beginnen und einen spezifischen Zusatz für den Fundort der Beschriftung erhalten, zum Beispiel qfs:labelText für den Text des Buttons oder qfs:labelLeft für die Beschriftung links des Eingabefeldes. Der Vorteil einer spezifischen Beschriftung ist einerseits die Performanz bei der Wiedergabe, da direkt nach der entsprechenden Beschriftung gesucht werden kann, andererseits die Flexibilität.

Hinweis Wenn Sie in vorhandenen Komponentenknoten das weitere Merkmal qfs:label auf den neuen Algorithmus umstellen wollen, ändern Sie bitte den Namen des weiteren Merkmals auf qfs:labelBest. In diesem Fall wird, wie bisher, aus allen in Frage kommenden Beschriftungen die beste Beschriftung ermittelt. Weitere Informationen zur Umstellung finden Sie im Kapitel Das ExtraFeatureResolver Interface.

Für Beschriftungen, die über die Position gefunden werden, gibt die folgende Grafik Auskunft:

Nachfolgend finden Sie eine Auflistung aller zur Verfügung stehenden qfs:label*-Varianten, im Anschluss daran die Beschreibungen. Außerdem wird die Syntax für die direkte Adressierung in einer SmartID aufgelistet.

Die Angabe unter "Kategorie" entspricht den Begriffen, die bei der Beschreibung für Generische Klassen in der Rubrik "qfs:label*" verwendet werden.

qfs:labelTitle

Die Überschrift einer Komponente, zum Beispiel eines Fensters (Komponentenklasse "Window") oder einer Kachel mit Titel, also der Komponentenklasse "Panel:titledPanel".

qfs:labelFor

Text, der im Programmcode der Komponente als Beschriftung zugewiesen wird. Bei Web-Anwendungen zum Beispiel über das HTML-Attribut labelFor.

qfs:labelText

Der Text der Komponente selbst.

qfs:labelLeft

Der Text einer Komponente der Klasse 'Label' links der betrachteten Komponente.

qfs:labelTop

Der Text einer Komponente der Klasse 'Label' über der betrachteten Komponente.

qfs:labelRight

Der Text einer Komponente der Klasse 'Label' rechts der betrachteten Komponente.

qfs:labelBottom

Der Text einer Komponente der Klasse 'Label' unter der betrachteten Komponente.

qfs:labelTopleft

Der Text einer Komponente der Klasse 'Label' oben links der betrachteten Komponente.

qfs:labelInherited

Die Beschriftung einer anderen Komponente. Beispiel: "Straße: Hauptstraße 11", wobei der Straßenname und die Hausnummer in eigenen Eingabefeldern stehen. Das Eingabefelder für die Hausnummer erhält hier "qfs:labelInherited" mit dem Wert "Straße:".

qfs:labelTooltip

Der Tooltip der Komponente selbst.

qfs:labelImage

Der Name eines der Komponente zugeordneten Images.

qfs:labelPlaceholder

Nur bei Web-Anwendungen. Der Prompt, der für die Komponente angezeigt wird, wenn sie keine Eingabe des Benutzers enthält.

Der Einfluss auf die 'QF-Test ID der Komponente' der qfs:label*-Variante, die die Beste Beschriftung darstellt, ist in Generierung der 'QF-Test ID' der Komponente beschrieben.

Informationen zum Übergang vom alten auf den neuen Algorithmus finden Sie in Das ExtraFeatureResolver Interface.

5.4.4.2

Beste Beschriftung

Bei der Komponentenanalyse werden die in Frage kommenden Beschriftungen nach bestimmten Kriterien bewertet und als in den 'Weiteren Merkmalen' abgespeichert, wobei die Namen der Einträge qfs:label anfangen (siehe Tabelle 5.2). Die qfs:label*-Variante mit der besten Bewertung (beste Beschriftung) erhält den Status "Sollte übereinstimmen", die anderen "Ignorieren". Die Reihenfolge der Einträge in obiger Tabelle entspricht grob der Gewichtung. Sie ist aber auch von der Komponentenklasse abhängig. Dokumentiert ist dies in der Rubrik "qfs:label*" in den Eigenschaften der einzelnen Generische Klassen. Bei den qfs:label*-Varianten der Kategorie "Label in der Nähe" spielen auch die Entfernung des Labels und der Überlappungsgrad eine Rolle.

Die beste Beschriftung wird zusätzlich in dem weiteren Merkmal mit dem Namen qfs:labelBest abgespeichert. In einer SmartID kann dieses Merkmal über den Kennzeichner qlabel angesprochen werden. Siehe auch SmartID-Syntax für 'Weitere Merkmale'.

5.4.4.3

qfs:text

qfs:text enthält den Textinhalt der Komponente. Dies dient als Zusatzinformation für Textfelder oder PDF-Komponenten. Es wird nicht aufgenommen, kann aber seit QF-Test Version 5.3 ohne zusätzlichen Resolver für die Komponentenerkennung genutzt werden.

Letzte Änderung: 11.10.2023 Copyright © 1999-2023 Quality First Software GmbH