Funktion	Dieses Plugin ist eine spezielle Überprüfung für End-to-End-Tests (E2E) auf Basis von SikuliX und SmartBear TestComplete. Es führt ein Projekt auf einem Remote-Windows-Host über dessen WinAgent aus, wartet auf das Ende der Ausführung, ruft dann die generierten Protokolldateien, Screenshots oder Videos ab und zeigt sie auf einer Übersichtsseite an.
Alarmierung	Laufzeit, Antwortcode, Ergebniscode (EEM-Timer), bekannter Fehler (EEM-Timer)

Allgemeine Informationen zum EEM-Projekt

Das EEM-Projekt-Plugin ist für die Verwendung auf einem Gerät vom Typ PC (EEM-Roboter) konzipiert. EEM-Geräte (Enduser Experience Monitoring) sind Robotergeräte, die End-to-End-Software- und Servicetests mit SKOOR Robot, einem auf dem Open-Source-Projekt SikuliX basierenden Produkt, oder den Testtools TestComplete / TestExecute von SmartBear durchführen. Das Plugin wurde entwickelt, um die Konfiguration und Verwaltung von End-to-End-Testläufen von einem SKOOR Engine-Server aus zu optimieren. Die Tests können so programmiert werden, dass sie funktionale End-to-End-Tests von Websites, Webdiensten, UI-Anwendungen oder mobilen Apps durchführen.

Die Kommunikation zwischen dem EEM-Roboter und SKOOR Engine erfolgt über die SKOOR Engine WinAgent-Anwendung. WinAgent muss so konfiguriert werden, dass die Ausführung von SikuliX- oder TestComplete/TestExecute-Binärdateien und das Abrufen der generierten Ausgabedateien möglich ist. Darüber hinaus muss WinAgent als Anwendung und nicht als Dienst ausgeführt werden.

Das EEM-Projekt-Plugin besteht aus der EEM-Projektkonfiguration selbst und einer beliebigen Anzahl von angehängten EEM-Timer-Jobs, die darunter hinzugefügt werden können.

EEM-Projektwerte und Alarm Limits

Wert / Alarm Limit	Beschreibung
Laufzeit	Die Laufzeit des gesamten EEM-Projekts
Antwortcode	0 = OK-1 = Allgemeiner Fehler 1 = Testergebnisse enthalten Warnungen 2 = Testergebnisse enthalten Fehler 3 = Der Test kann nicht ausgeführt werden 18 = TestComplete/TestExecute kann nicht gestartet werdenTestExecute 11 = Parameter fehlt 12 = Falscher Parameter 13 = Projekt nicht gefunden 14 = Ausführbare Datei nicht gefunden 15 = Keine Berechtigung 16 = Zeitüberschreitung bei der Ausführung 20 = Ausführung wurde abgebrochen 17 = Test fehlgeschlagen 19 = Unbekannte Antwort
Fehlercode	Generischer Job-Fehlercode (siehe Abschnitt „Job-Fehlercodes”)

Wenn ein EEM-Projektjob mit einem Zeitplan verknüpft ist (der aktive und inaktive Zeiten für die Jobausführung definiert), funktioniert die Schaltfläche „Jetzt prüfen“ während der im Zeitplan konfigurierten inaktiven Zeit nicht.

EEM-Robotergerät

Bevor Sie einen EEM-Projekt-Job erstellen, stellen Sie sicher, dass Sie das Gerät, zu dem der Job gehört, als Gerät vom Typ PC (EEM-Roboter) konfigurieren. Beim Erstellen eines solchen Geräts wird der folgende Konfigurationsoptionsbildschirm angezeigt:

Der Abschnitt „EEM-Projekt-Infos“ dient als Referenz für die konfigurierten Standardeinstellungen der Eigenschaften, die zum Ausführen eines EEM-Projekts verwendet werden. Abgesehen davon ist ein PC-Gerät (EEM-Roboter) funktional identisch mit anderen Gerätetypen. Überschreiben Sie Eigenschaften, indem Sie eine oder mehrere der Eigenschaften im Abschnitt „Eigenschaften“ manuell festlegen.

Geräteeigenschaften

Auf Geräteebene konfigurierte Eigenschaften wirken sich auf alle EEM-Projekt-Jobs dieses Geräts aus. Bei Bedarf können einige davon in den Mess-Jobs überschrieben werden.

Eigenschaftsname	Beschreibung
Agent-Benutzername	Muss festgelegt werden, wenn in den WinAgent-Einstellungen auf dem EEM-Host ein Benutzername und ein Passwort konfiguriert wurden.
Agent-Passwort	Muss festgelegt werden, wenn ein Benutzername und ein Passwort in den WinAgent-Einstellungen auf dem EEM-Host konfiguriert wurden
Sichere Verbindung des Agenten	Muss festgelegt werden, wenn die entsprechende Einstellung (SSL-Verschlüsselung für die Verbindung) in den WinAgent-Einstellungen auf dem EEM-Host konfiguriert wurde
EEM-Binärpfad	Muss gesetzt werden, wenn er vom Standardwert abweicht. Dies muss entsprechend der Eigenschaft „EEM-Ausführungsmodus” und natürlich den Pfaden zu den Softwarekomponenten festgelegt werden.
EEM-Ausführungsmodus	Für Laufzeiteinrichtungen, die zur Durchführung von Messungen verwendet werden, wählen Sie SikuliX oder TestExecute Für Geräte, die zur Entwicklung von EEM-Projekten verwendet werden, wählen Sie SikuliX Development oder TestComplete
EEM-MHT-Protokolle abrufen (nur TestExecute)	Wenn diese Option aktiviert ist (Standard), versucht die SKOOR Engine, die auf dem EEM-Roboter generierten Zusammenfassungsprotokolle des Projektlaufs zu übertragen. Diese werden für jeden Lauf im MHT-Format (MHTML) generiert und können nur mit Internet Explorer angezeigt werden. MHT-Protokoll-Dateien können sehr groß sein, manchmal mehrere MB, insbesondere wenn der Projektlauf viele Fehler generiert hat. Deaktivieren Sie diese Option, wenn auf der SKOOR Engine zu wenig Speicherplatz für die Protokolle vorhanden ist oder wenn die Netzwerkbandbreite zwischen der SKOOR Engine und dem EEM-Roboter für die Übertragung großer Dateien zu gering ist.
EEM-Protokoll-Stammverzeichnis	Dies ist das Stammverzeichnis, in dem die SikuliX- oder MHT-Protokolle auf dem EEM-Roboter gespeichert werden.
EEM-Projekt-Stammverzeichnis	Dies ist das Stammverzeichnis, in dem die SikuliX-/TestComplete-Projekte auf dem EEM-Roboter gespeichert werden.
EEM-Fernzugriff	Normalerweise werden die Projekte auf der Konsole des EEM-Roboters ausgeführt (dem Bildschirm, den man sehen würde, wenn ein physischer Monitor angeschlossen wäre). In diesem Fall werden VNC oder andere Mittel wie Teamviewer als Fernzugriffsmethode verwendet. Dadurch bleibt jedoch der Konsolenbildschirm des Roboters während der Ausführung der Tests sichtbar. Wenn Sicherheit ein Thema ist, können die Tests so konfiguriert werden, dass sie innerhalb einer Windows-Remotedesktop-Sitzung (RDP) ausgeführt werden. Dadurch kann der Konsolenbildschirm gesperrt werden. Benutzer werden getrennt, wenn Tests ausgeführt werden. Wenn eine Authentifizierung auf Netzwerkebene erforderlich ist, muss das Gerät mit FreeRDP konfiguriert werden.
RDP-Domäne	Active Directory-Domäne für die RDP-Anmeldung
RDP-Benutzername/Passwort	Active Directory-Benutzername und -Passwort für die RDP-Anmeldung
RDP-Auflösung	Bildschirmauflösung, die für EEM-Messungen verwendet wird. Dies ist besonders wichtig für bildbasierte Messungen (SKOOR Robot).
RDP-Optionen	Für die RDP-Sitzung können einige Optionen konfiguriert werden. Weitere Informationen finden Sie im Abschnitt „EEM-Projektinformationen” zum Geräteobjekt
RDP-Abmeldung	Um zwischen den Messungen Zeit zu sparen, werden RDP-Sitzungen nach der Ausführung eines Projektjobs nicht abgemeldet. Wenn aus irgendeinem Grund eine Abmeldung erforderlich ist, kann diese Eigenschaft entsprechend eingestellt werden.

EEM-Projektjobs

Informationen zur Konfiguration von EEM-Projekt-Jobs finden Sie auf den entsprechenden Unterseiten für SKOOR Robot und SmartBear.

EEM-Projektergebnisse

Die Messergebnisse werden in den EEM-Projekt- und Timer-Jobs sowie im EEM-Ergebnisbrowser angezeigt.

EEM-Projektwarteschlange

Der SKOOR Engine Collector plant die EEM-Projekt-Jobs automatisch entsprechend ihrem festgelegten Ausführungsintervall. Das bedeutet, dass jeder EEM-Projekt-Job sein individuelles Ausführungsintervall haben kann und der Scheduler dafür sorgt, dass dieses Intervall eingehalten wird. Befinden sich mehrere EEM-Projekt-Jobs auf einem EEM-Gerät und entscheidet der Scheduler, dass es Zeit für die Ausführung eines EEM-Projekt-Jobs ist, wird dieser in die Warteschlange gestellt, wenn derzeit bereits einer der anderen EEM-Projekt-Jobs ausgeführt wird. Um diese Warteschlange anzuzeigen, müssen die folgenden Voraussetzungen erfüllt sein:

Das EEM-Gerät muss in seiner Konfiguration über einen Standard-Kollektor verfügen.
Auf dem EEM-Gerät muss mindestens ein EEM-Projektjob vorhanden sein.

Wenn die oben genannten Kriterien erfüllt sind, können die Warteschlange und der Status des aktuell ausgeführten Projekts durch Auswahl von „Details anzeigen“ auf dem EEM-Gerät angezeigt werden:

EEM-Projektverteilung

Für die Entwicklung von Testprojekten muss die Software TestComplete oder SikuliX installiert sein. Die Entwicklung erfolgt in der Regel auf anderen Hosts als denen, auf denen die Tests tatsächlich ausgeführt werden. Dort, wo die Tests ausgeführt werden, muss nur die TestExecute-Laufzeitsoftware installiert sein (nur SmartBear). Um entwickelte Tests zu verteilen, bietet die SKOOR Engine einen Mechanismus, bei dem eine ZIP-Datei des aktuellen Projektverzeichnisses auf dem Entwicklungshost erstellt, an die SKOOR Engine übertragen und dann an die EEM-Roboter verteilt wird. Die ausführbare SikuliX-Datei wird auf die gleiche Weise übertragen. Befolgen Sie dazu die folgenden Anweisungen:

Setzen Sie die Eigenschaft „EEM-Ausführungsmodus” auf dem Entwicklungshostgerät auf „SikuliX Development” oder „TestComplete”.
Stellen Sie sicher, dass alle EEM-Roboter-Hostgeräte diese Eigenschaft auf „TestExecute” oder „SikuliX” gesetzt haben.
Entwickeln Sie auf dem Entwicklungshost ein neues EEM-Projekt oder bearbeiten Sie ein bestehendes. Speichern Sie das Projekt und schließen Sie die entsprechende IDE.
Wählen Sie unterhalb des Entwicklungsgeräts in der SKOOR Engine-Benutzeroberfläche für das EEM-Projekt, das an EEM-Roboter-Hosts verteilt werden soll, in der Dropdown-Liste „Ausführen/Verteilen“ im Abschnitt „Auftragsausführung“ des Auftrags die Option „An Test-Repository verteilen“ aus:
Wenn Sie „Messjob ausführen“ wählen, wird lediglich das EEM-Projekt ausgeführt.

Klicken Sie auf „OK“, um den Job zu speichern.
Öffnen Sie den neuen Job mit der Lupe und klicken Sie auf „Verteilen“.
Im Abschnitt „Werte“ sollte nun „Suite erfolgreich verteilt“ angezeigt werden:
Das komprimierte Projekt-Suite-Verzeichnis wird nun im Verzeichnis „/opt/eranger/collector/eem_repository/from_development/test“ des SKOOR Collectors abgelegt, auf dem der EEM-Projekt-Job konfiguriert ist.
Das Archiv wird mit dem Verzeichnis „/opt/eranger/Kollektor/eem_repository/to_execute/test“ synchronisiert und steht somit für automatische Updates zur Verfügung.
Gehen Sie auf dem EEM-Robotergerät zum entsprechenden EEM-Projektjob und aktivieren Sie die Option „Auto update suite control“ (Suite automatisch aktualisieren). Wählen Sie dann das Test-Repository aus der angezeigten Liste aus:

Führen Sie „Check now“ (Jetzt prüfen) für den EEM-Projektjob aus. Dadurch wird zunächst geprüft, ob im SKOOR Engine-Repository (unterhalb des Verzeichnisses /opt/eranger/collector/eem_repository/to_execute/test) aktualisierte Projektdateien vorhanden sind. Wenn ja, werden diese auf den EEM-Roboter übertragen und ersetzen das alte Projekt-Suite-Verzeichnis. Anschließend wird der Test ausgeführt und die Ergebnisse zurückgegeben.
Wenn sich herausstellt, dass der Test auf dem TestExecute-Host, der für das Test-Repository aktiviert ist, einwandfrei läuft, kann man mit der Verteilung des Projekts an das Produktions-Repository beginnen. Es empfiehlt sich, einen dedizierten Test-Roboter zu verwenden, auf dem alle entwickelten Tests zuerst ausgeführt werden, bevor sie an die Produktions-Roboter verteilt werden.
Es kann bis zu 4 Minuten dauern, bis SKOOR Engine neu hochgeladene (verteilte) Projekte auf alle SKOOR Engine-Agenten kopiert, sodass sie möglicherweise nicht sofort für die automatische Aktualisierung verfügbar sind.
Wenn Projekte nicht verteilt werden, überprüfen Sie, ob die SKOOR Engine, auf der die EEM-Projekt-Jobs konfiguriert sind, über ssh einen mit einem öffentlichen Schlüssel authentifizierten Zugriff auf die SKOOR Engine-Kollektoren hat, auf denen die EEM-Projekt-Jobs ausgeführt werden. Die SKOOR Engine ruft alle komprimierten Projektarchive von allen SKOOR Engine-Kollektoren ab und verteilt sie dann an die Repository-Verzeichnisse aller Kollektoren.

Dokumentation

EEM-Projekt mit EEM-Timer-Aufträgen