Handbuch

Das Akronym AJAX für "Asynchronous JavaScript and XML" wird allgemein mit modernen Webanwendungen assoziiert, die sich interaktiver anfühlen als die klassischen <FORM>-basierten Anwendungen und vom Look&Feel her schon fast an Desktop-Applikationen herankommen. Hinter diesem gemeinsamen Akronym steckt allerdings ein ganzer Zoo von Toolkits, auf denen solche Anwendungen basieren. Jedes davon setzt eigene Schwerpunkte und kommt mit einem eigenen Satz von Widgets. Solche Toolkits stellen für QF-Test und jedes andere automatisierte Testwerkzeug aus folgenden Gründen ein Problem dar:

• Die Komponentenhierarchie wird automatisch aus abstrakten Widgets wie Button oder List generiert. Ein Widget wird dabei oft mittels diverser <DIV> Knoten implementiert. Dies führt zu einer sehr tief verschachtelten Hierarchie mit geringer Struktur.
• IDs werden entweder gar nicht zugewiesen oder automatisch generiert, was noch schlechter ist.
• Die asynchrone Kommunikation mit dem Webserver und die dynamische Erstellung von DOM Knoten kann Probleme beim Timing verursachen.

Es gibt kein Allheilmittel, mit dem sich diese Probleme generisch lösen lassen. In vielen Fällen kann QF-Test trotzdem ohne weiteres Zutun mit AJAX Anwendungen interagieren. Dabei sind Wiedererkennung und Performanz allerdings nicht ideal. Optimale Testbarkeit kann nur mit Hilfe von Spezialfunktionen erreicht werden, die genau auf ein Toolkit zugeschnitten sind und sich dessen Eigenheiten zu Nutze machen.

Für die folgende Liste von Toolkits bietet QF-Test Resolver für eine optimierte Behandlung:

QF-Test ist sogar in der Lage, automatisch festzustellen, ob Ihre Webanwendung eines dieser Toolkits benutzt und einen passenden Resolver, wie unten beschrieben, einzuhängen.

Ein AJAX Resolver besteht aus verschiedenen Resolvern und anderen Funktionen, die speziell für ein bestimmtes AJAX Toolkit entwickelt werden. Vor allem versucht QF-Test, den DOM Knoten Klassen zuzuweisen, die den zugehörigen abstrakten Widgets entsprechen und Knoten auf Zwischenebenen, die nur ein Detail der Toolkit-Implementierung sind, aus der Hierarchie herauszufiltern. Die Attribute 'Name', 'Merkmal' und 'Weiteres Merkmal' werden passend zum Toolkit ermittelt und Events werden so auf den korrekten DOM Knoten wiedergegeben, dass dies möglichst exakt einer Aktion von einem echten Anwender entspricht. Diese Maßnahmen reduzieren die Hierarchie der Komponenten drastisch und erhöhen Performanz und Zuverlässigkeit der Wiedererkennung und Wiedergabe gleichermaßen. Zudem werden Timing und Synchronisation besonders unterstützt.

Zwangsläufig unterscheiden sich Komponenten und Events für eine Webanwendung mit und ohne aktiviertem AJAX Resolver signifikant und sind nicht zueinander kompatibel. Daher sollte die Entscheidung, ob ein AJAX Resolver verwendet wird, so früh wie möglich getroffen werden. Andernfalls müssen entweder bestehende Tests neu implementiert werden, nachdem der Resolver aktiviert wird, oder Tests mit und ohne Resolver müssen sauber voneinander getrennt werden. Wenn ein Resolver für Ihre Anwendung verfügbar ist, sollten Sie ihn praktisch immer auch einsetzen, außer Ihre Tests sind bereits zu umfangreich, weitgehend vollständig und stabil.

Die Implementierung eines AJAX Resolvers ist ein fortlaufender Prozess. Da Änderungen an einem Resolver Auswirkungen darauf haben können, wie Komponenten aufgenommen und erkannt werden, muss sichergestellt sein, dass Sie Ihre QF-Test Version aktualisieren können, ohne die Kompatibilität bestehender Tests zu gefährden. Hierzu werden AJAX Resolver mit einer eigenen dreistelligen Version versehen, beginnend mit Version 1.0.0, mit folgender Bedeutung:

• Bei einer Änderung der Minor Version, z.B. 1.0.1, ist die Kompatibilität nicht berührt.
• Eine Änderung der Medium Version, z.B. 1.1.0, bedeutet, dass mit niedrigerer Medium Version aufgenommene Tests immer noch wiedergegeben werden können, bei Aufnahme neuer Sequenzen aber Komponenten anders aufgenommen werden können. Dies ist nicht kritisch, es kann aber besser sein, solche Neuaufnahmen zu vermeiden, wenn die Vorteile der neuen Version nicht überwiegen.
• Bei einer Änderung der Major Version, z.B. 2.0.0, kann auch die Kompatibilität der Wiedergabe verloren gehen, was dann eine Neuaufnahme oder manuelle Anpassung der betreffenden Komponenten erforderlich macht.

AJAX Resolver werden über die 'Prozedur' qfs.web.ajax.installCustomWebResolver in der Standardbibliothek qfs.qft aktiviert, bei der Sie die zu verwendende Version angeben müssen. Sie können wahlweise nur die Major Version angeben, in welchem Fall QF-Test die höchste verfügbare Medium.Minor Version für diese Major Version verwendet. Dies ist üblicherweise die beste Option und wird in der mit Hilfe des Schnellstart-Assistenten erstellten Startsequenz verwendet (vgl. Kapitel 3). Alternativ können Sie die Major.Medium Version festlegen, oder sogar die exakte Major.Medium.Minor Version und so Ihre Tests mit der Version des Resolvers ausführen, mit der sie erstellt wurden.

Leider steigt die Zahl der verfügbaren AJAX Toolkits rasant und deren Popularität ändert sich sehr schnell. Daher müssen wir sehr genau abwägen, welche Toolkits wir zu welchem Grad unterstützen. Die Zusammenarbeit mit QF-Test Anwendern spielt hierbei auch eine große Rolle. Die Entwicklung eines Resolvers kann - bis auf die Beseitigung kritischer Bugs - auch eingefroren werden, wenn ein Toolkit an Bedeutung verliert.

Dieser Abschnitt führt die unterstützen AJAX Toolkits und deren Version zusammen mit den verfügbaren Versionen der Resolver auf. Neuere Versionen eines Toolkits benötigen nicht immer ein Update des Resolvers. Sollte Ihre Anwendung mit einer neueren Version des Toolkits arbeiten, verwenden Sie bitte den aktuellsten verfügbaren AJAX Resolver für dieses Toolkit und informieren Sie uns über Ihre Ergebnisse.

4.1+ Mit QF-Test Version 4.1 wurde die Integration der meisten Toolkits grundlegend überarbeitet und auf das Konzept der generischen Klassen umgestellt. Sie sollten daher diese Toolkits nur mehr mit der Prozedur qfs.web.ajax.installCustomWebResolver installieren. Falls Sie ältere Integrationen verwenden, können Sie diese weiterhin benutzen. Eine Liste dieser älteren Versionen finden Sie unter Abschnitt 44.3.4.

Dieser Resolver wurde mit Angular Version 4 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet angular.

Dieser Resolver wurde zunächst mit Ext JS Version 2 entwickelt, unterstützt mittlerweile aber auch Ext JS Version 6.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet extjs.

Es gibt keinen eigenen Ext GWT Resolver. Ext GWT ist faktisch eine Kombination aus Ext JS und GWT und wird von QF-Test durch Aktivierung der beiden entsprechenden Resolver unterstützt. Zur Zeit keine Aktivitäten. Für ältere Versionen siehe Abschnitt 44.3.4.2.

Das Google Widget Toolkit wird seit GWT Version 1.5 unterstützt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet gwt.

Dieser Resolver wurde mit ICEfaces Version 3.3 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet icefaces.

Dieser Resolver wurde mit jQuery UI Version 1.10.3 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet jqueryui.

Dieser Resolver wurde mit jQuery EasyUI Version 1.4.1 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet jeasyui.

Dieser Resolver wurde mit Kendo UI Version Q1 2016 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet kendoui.

Dieser Resolver wurde mit PrimeFaces Version 3.5 entwickelt, unterstützt mittlerweile aber auch PrimeFaces Version 5.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet primefaces.

Dieser Resolver wurde mit qooxdoo Version 5.0.2 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet qooxdoo.

Dieser Resolver wurde mit RAP Version 1 entwickelt, die Unterstützung für RAP Versionen 2 und höher ist gegeben.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet rap.

Dieser Resolver wurde mit den RichFaces Versionen 3, 4 und 5 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet richfaces.

Dieser Resolver wurde mit Smart GWT Version 6.1 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet smartgwt.

Vaadin ist ein Toolkit, das zwar auf GWT aufsetzt, aber zusätzliche Features und seine eigenen Widgets mitbringt und somit für das Testen ganz andere Anforderungen stellt als GWT.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet vaadin.

Dieser Resolver wurde mit den Versionen 6.5 und 7 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installCustomWebResolver lautet zk.

Jedes AJAX Toolkit hat seine eigene Methoden, um eindeutige IDs zu vergeben. In diesem Abschnitt finden Sie die entsprechenden Methoden für die unterstützten Toolkits von QF-Test:

Die einfachste Variante ist es, das 'ID' Attribut <div id="myId"/> für alle notwendigen Komponenten zu setzen.

IDs können mittels folgendem Code gesetzt werden:
var container = Ext.create('Ext.container.Container', {
id: 'MyContainerId',
... });.

Als Alternative können Sie auch container.getEl().set({ 'qfs-id': 'myId' }); aufrufen. In diesem Fall müssen Sie allerdings einen NameResolver implementieren, der 'qfs-id' als Namen für QF-Test setzt.

Die einfachste Variante ist die Methode widget.getElement().setId("myId"); für die erzeugten Elemente aufzurufen.

Alternativ können Sie auch widget.ensureDebugId("myId") aufrufen. Allerdings müssen Sie in diesem Fall die Datei xxx.gwt.xml anpassen, damit diese IDs auch wirklich gesetzt werden. Hierfür müssen Sie <inherits name="com.google.gwt.user.Debug"/> eintragen.

Es ist auch möglich ein eigenes Attribut 'qfs-id' für die Identifikation zu setzen. Hierfür rufen Sie die Methode setAttribute("qfs-id", "myId") auf. Dieses Attribut kann nun mittels NameResolver für QF-Test verwendet werden.

Die einfachste Variante ist es, das 'ID' Attribut <p:inputText id="myId"/> für alle notwendigen Komponenten in der xhtml Definition zu setzen.

Die einfachste Variante ist es, das 'ID' Attribut <p:inputText id="myId"/> für alle notwendigen Komponenten zu setzen. Zusätzlich einem existierenden Element wie folgt: $(element).attr("id","myId");

Die einfachste Variante ist es, das 'ID' Attribut <p:inputText id="myId"/> für alle notwendigen Komponenten zu setzen.

Sie müssen das 'ID' Attribut im Sourcecode oder über den grafischen Editor setzen.

Die einfachste Variante ist es, das 'ID' Attribut <p:inputText id="myId"/> für alle notwendigen Komponenten in der xhtml Definition zu setzen.

Es gibt keinen Standardweg. Sie können entweder ein eigenes Attribut in der Generierung des DOMs an die Knoten oder eine Eigenschaft an die setData Methode des Qooxdoo Widgets hängen. Diese Eigenschaft können Sie dann per Resolver auswerten.

Ab RAP Version 2.2 wird ein Name, der mit widget.setData("name", "myId") vergeben wird, genau wie bei SWT direkt von QF-Test ausgewertet. Das Feld kann nur benutzt werden wenn es zuvor über WidgetUtil.registerDataKeys("name"); registriert wurde.

Für RAP Versionen älter als 3.0.0 funktioniert auch die folgende Technik, die aber nicht empfohlen wird, da sie vom SWT Standard abweicht und zuätzlich erfordert, den Webserver mit einer besonderen Option zu starten.:

Rufen Sie die Methode widget.setData(WidgetUtil.CUSTOM_WIDGET_ID, "myId"); für jedes notwendige Element auf.

Nun müssen Sie noch Ihre Webserver Umgebung mit folgendem zusätzlichen Parameter starten -Dorg.eclipse.rap.rwt.enableUITests=true.

Bitte beachten: Der VM Parameter wurde ab RAP 2.0 umbenannt, für RAP Versionen vor 2.0 lautet er -Dorg.eclipse.rwt.enableUITests=true.

Sie müssen das 'ID' Attribut im Sourcecode oder über den grafischen Editor setzen.

Die einfachste Variante ist es, die Methode widget.setID("id") für alle notwendigen Komponenten aufzurufen.

Die einfachste Variante ist es, die Methode widget.setId("id") (widget.setDebugId("id") für Vaadin Version < 7) für alle notwendigen Komponenten aufzurufen.

Sie können auch eine eigene Stylesheet Klasse mittels widget.setStyleName("qfs-id=myId") hinzufügen. Diese muss dann in einem NameResolver für QF-Test ausgewertet werden.

QF-Test verwendet die Widget-ID, welche auch in den zul Dateien verwendet wird. Daher sollten die meisten IDs nutzbar sein.

Das ZK Framework bietet auch einen eigenen IDGenerator an, um IDs zu vergeben. Dies kann allerdings ziemlich aufwendig sein, hier ist es besser sich auf die Standardalgorithmen von QF-Test zu verlassen.

Mit QF-Test Version 4.1 wurde die Integration der AJAX Toolkits grundlegend überarbeitet und an das Konzept der generischen Klassen angepasst. In bestehenden Projekten können Sie allerdings nach wie vor ältere Versionen der AJAX Toolkit Resolver verwenden. Diese älteren Versionen können Sie über die 'Prozedur' qfs.web.ajax.installToolkitResolver in der Standardbibliothek qfs.qft aktivieren.

Dieser Resolver wurde zunächst mit Ext JS Version 2 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet extjs.

Es gibt keinen eigenen Ext GWT Resolver. Ext GWT ist faktisch eine Kombination aus Ext JS und GWT und wird von QF-Test durch Aktivierung der beiden entsprechenden Resolver unterstützt.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet extgwt.

Das Google Widget Toolkit wird seit GWT Version 1.5 unterstützt.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet gwt.

Dieser Resolver wurde mit ICEfaces Version 3.3 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet icefaces.

Dieser Resolver wurde mit jQuery UI Version 1.10.3 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet jqueryui.

Dieser Resolver wurde mit PrimeFaces Version 3.5 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet primefaces.

Dieser Resolver wurde mit qooxdoo Version 0.7.2 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet qooxdoo.

Dieser Resolver wurde mit RAP Version 1 und 2 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet rap.

Dieser Resolver wurde mit den RichFaces Versionen 3 und 4 entwickelt.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet richfaces.

Vaadin ist ein Toolkit, das zwar auf GWT aufsetzt, aber zusätzliche Features und seine eigenen Widgets mitbringt und somit für das Testen ganz andere Anforderungen stellt als GWT.

Der Kurzname für Aufrufe von qfs.web.ajax.installToolkitResolver lautet vaadin.

Letzte Änderung: 11.09.2018 Copyright © 1999-2018 Quality First Software GmbH