EEM-Projekt mit EEM-Timer-Aufträgen
Funktion | Dieses Plugin dient der spezifischen Überprüfung von End-to-End-Tests (E2E) auf Basis von SikuliX und SmartBear TestComplete. Es führt ein Projekt auf einem entfernten Windows-Host über dessen WinAgent aus, wartet auf den Abschluss der Ausführung, ruft anschließend die generierten Protokolldateien, Screenshots oder Videos ab und zeigt diese 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 den Einsatz auf einem Gerät vom Typ PC (EEM-Roboter) konzipiert. EEM-Geräte (Enduser Experience Monitoring) sind Roboter-Geräte, die End-to-End-Tests von Software und Diensten mithilfe von 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 über einen SKOOR Engine-Server 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 der SKOOR Engine erfolgt über die SKOOR Engine WinAgent-Anwendung. Der WinAgent muss so konfiguriert werden, dass die Ausführung von SikuliX- oder TestComplete-/TestExecute-Binärdateien sowie das Abrufen der generierten Ausgabedateien möglich ist. Außerdem muss der 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 zugehörigen 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 = |
Fehlercode | Allgemeiner Job-Fehlercode (siehe Abschnitt Job-Fehlercodes) |
Wenn ein EEM-Projekt-Job 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-Robot-Gerät
Stellen Sie vor dem Erstellen eines EEM-Projekt-Jobs sicher, dass das Gerät, zu dem der Job gehört, als Gerät vom Typ PC (EEM-Roboter) konfiguriert ist. Beim Erstellen eines solchen Geräts wird der folgende Bildschirm mit den Konfigurationsoptionen angezeigt:
Der Abschnitt EEM-Projekt-Infos dient als Referenz für die konfigurierten Standardwerte der Eigenschaften, die zur Ausführung eines EEM-Projekts verwendet werden. Abgesehen davon ist ein PC-Gerät (EEM-Robot) funktional identisch mit anderen Gerätetypen. Überschreiben Sie die Eigenschaften, indem Sie eine oder mehrere 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 in den WinAgent-Einstellungen auf dem EEM-Host ein Benutzername und ein Passwort 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 festgelegt werden, wenn er vom Standardwert abweicht. Dies muss entsprechend der Eigenschaft EEM-Ausführungsmodus und natürlich den Pfaden zu den Softwarekomponenten erfolgen |
EEM-Ausführungsmodus | Für Laufzeitgeräte, 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 (Standardeinstellung), versucht die SKOOR Engine, die auf dem EEM-Roboter erstellten Zusammenfassungsprotokolle der Projektdurchläufe zu übertragen. Diese werden für jeden Durchlauf im MHT-Format (MHTML) erstellt und können ausschließlich mit dem Internet Explorer angezeigt werden. MHT-Protokolldateien können sehr groß sein, manchmal mehrere MB, insbesondere wenn der Projektdurchlauf viele Fehler erzeugt hat. Deaktivieren Sie diese Option, wenn auf der SKOOR Engine zu wenig Speicherplatz für die Protokollspeicherung vorhanden ist oder wenn die Netzwerkbandbreite zwischen der SKOOR Engine und dem EEM-Roboter für die Übertragung großer Dateien zu gering ist |
Stammverzeichnis für EEM-Protokolle | 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 Projektläufe auf der Konsole des EEM-Roboters ausgeführt (der 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. Dabei bleibt der Konsolenbildschirm des Roboters jedoch 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. Die Verbindung der Benutzer wird unterbrochen, wenn Tests ausgeführt werden. Wenn eine Authentifizierung auf Netzwerkebene erforderlich ist, muss das Gerät mit FreeRDP konfiguriert werden |
RDP-Domäne | Für die RDP-Anmeldung verwendete Active-Directory-Domäne |
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. Einzelheiten finden Sie im Abschnitt EEM-Projektinformationen des Geräteobjekts |
RDP-Abmeldung | Um zwischen den Messungen Zeit zu sparen, wird die RDP-Sitzung nach Ausführung eines Projektjobs nicht beendet. Sollte aus irgendeinem Grund eine Abmeldung erforderlich sein, kann diese Eigenschaft entsprechend eingestellt werden |
EEM-Projekt-Jobs
Informationen zur Konfiguration von EEM-Projekt-Jobs finden Sie auf den jeweiligen Unterseiten für SKOOR Robot und SmartBear.
EEM-Projektergebnisse
Die Messergebnisse werden im EEM-Projekt und in den Timer-Jobs sowie im EEM-Ergebnisbrowser angezeigt.
EEM-Projektwarteschlange
Der SKOOR Engine Collector plant die EEM-Projekt-Jobs automatisch entsprechend ihres festgelegten Ausführungsintervalls. Das bedeutet, dass jeder EEM-Projekt-Job sein eigenes Ausführungsintervall haben kann und der Scheduler sicherstellt, 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 gerade bereits einer der anderen EEM-Projekt-Jobs ausgeführt wird. Um diese Warteschlange anzuzeigen, müssen die folgenden Voraussetzungen erfüllt sein:
Auf dem EEM-Gerät muss in der Konfiguration ein Standard-Kollektor definiert sein
Auf dem EEM-Gerät muss mindestens ein EEM-Projekt-Job vorhanden sein
Sind die oben genannten Kriterien erfüllt, können die Warteschlange und der Status des aktuell laufenden Projekts angezeigt werden, indem Sie auf dem EEM-Gerät Details anzeigen auswählen:
Verteilung von EEM-Projekten
Die Entwicklung von Testprojekten erfordert die Installation der Software „TestComplete“ oder „SikuliX“. Die Entwicklung erfolgt in der Regel auf anderen Hosts als denen, auf denen die Tests tatsächlich ausgeführt werden. Auf den Hosts, auf denen die Tests ausgeführt werden, muss lediglich die TestExecute-Laufzeitsoftware installiert sein (nur SmartBear). Zur Verteilung der entwickelten Tests bietet die SKOOR Engine einen Mechanismus, bei dem eine ZIP-Datei des aktuellen Projektverzeichnisses auf dem Entwicklungshost erstellt, in die SKOOR Engine geladen und anschließend an die EEM-Roboter verteilt wird. Die SikuliX-Ausführungsdatei wird auf dieselbe Weise übertragen. Befolgen Sie dazu die folgenden Anweisungen:
Setzen Sie die Eigenschaft EEM-Ausführungsmodus auf dem Entwicklungshost auf SikuliX Development oder TestComplete
Stellen Sie sicher, dass diese Eigenschaft auf allen EEM-Roboter-Hostgeräten hingegen auf TestExecute oder SikuliX gesetzt ist
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 Benutzeroberfläche der SKOOR Engine für das EEM-Projekt, das an die EEM-Roboter-Hosts verteilt werden soll, im Abschnitt Jobausführung des Jobs aus der Dropdown-Liste Ausführen/Verteilen die Option An Test-Repository verteilen aus:
Die Auswahl von Execute measurement job würde lediglich das EEM-Projekt ausführen.
Klicken Sie auf OK, um den Job zu speichern
Öffnen Sie den neuen Job über die Lupe und klicken Sie auf Verteilen
Im Abschnitt „Werte“ sollte nun Suite erfolgreich verteilt angezeigt werden:
Das komprimierte Verzeichnis der Projektsuite wird nun in das Verzeichnis `/opt/eranger/collector/eem_repository/from_development/test` des SKOOR Collectors kopiert, 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 die automatische Aktualisierung zur Verfügung.
Wechseln Sie auf dem EEM-Roboter-Gerät zum entsprechenden EEM-Projekt-Job und aktivieren Sie die Option Suite automatisch aktualisieren. Wählen Sie anschließend aus der angezeigten Liste das Test-Repository aus:
Führen Sie im EEM-Projekt-Job die Option Jetzt prüfen aus. Dadurch wird zunächst überprüft, ob im SKOOR Engine-Repository (unterhalb des Verzeichnisses /opt/eranger/collector/eem_repository/to_execute/test) aktualisierte Projektdateien vorhanden sind. Ist dies der Fall, werden diese auf den EEM-Roboter übertragen und ersetzen das alte Projekt-Suite-Verzeichnis. Anschließend wird der Test ausgeführt und die Ergebnisse werden zurückgegeben
Sollte sich herausstellen, dass der Test auf dem für das Test-Repository aktivierten TestExecute-Host einwandfrei läuft, kann mit der Verteilung des Projekts an das Produktions-Repository begonnen werden. Es hat sich bewährt, einen dedizierten Test-Roboter zu verwenden, auf dem alle entwickelten Tests zunächst ausgeführt werden, bevor sie an die Produktions-Roboter verteilt werden
Es kann bis zu 4 Minuten dauern, bis die SKOOR Engine neu hochgeladene (verteilte) Projekte auf alle SKOOR Engine-Agenten kopiert hat; daher stehen sie möglicherweise nicht sofort für die automatische Aktualisierung zur Verfügung
Wenn Projekte nicht verteilt werden, prüfen Sie, ob die SKOOR Engine, auf der die EEM-Projekt-Jobs konfiguriert sind, über SSH einen durch einen öffentlichen Schlüssel authentifizierten Zugriff auf jene SKOOR Engine Collectors hat, auf denen die EEM-Projekt-Jobs ausgeführt werden. Die SKOOR Engine ruft alle komprimierten Projektarchive von allen SKOOR Engine Collectern ab und verteilt sie anschließend in die Repository-Verzeichnisse aller Collectors.




