DocsSmartBear-Projekte
Gerätekonfiguration
Zur allgemeinen Gerätekonfiguration besuchen Sie das EEM-Projekt mit EEM-Timer-Jobs
Beispiel einer SmartBear-Gerätekonfiguration
Im folgenden Beispiel wurden die Parameter für ein Gerät für SmartBear-Tests eingestellt, wie im Abschnitt EEM-Projektinfos beschrieben:
Auftragsdetails des EEM-Projekts
SmartBear-Projekteinstellungen:
EEM-Projektparameter
Parameter | Beschreibung |
|---|---|
Suite-Name | Ein TestComplete-Projekt besteht aus mindestens einer Projektsuite und einem Projekt innerhalb dieser Suite. Wenn es nur ein Projekt gibt, muss nur der Name der Projektsuite ausgefüllt werden. Andernfalls geben Sie sowohl den Suite- als auch den Projektnamen an. Sobald dieses Feld ausgefüllt ist, wird das Feld „Argumente“ automatisch mit den standardmäßigen Befehlszeilenargumenten ausgefüllt, die an den Befehl „TestComplete“ oder „TestExecute“ angehängt werden. |
Projektname | Name des TestComplete-Projekts. Dies muss nur ausgefüllt werden, wenn die Projektsuite mehr als ein Projekt enthält. |
VPN-Testmodus | Aktivieren Sie dieses Kontrollkästchen nur in dem speziellen Fall, dass das auszuführende Projekt während des Projektlaufs selbst VPN-Verbindungen zu einem VPN-Gateway initiiert. Dies würde zu einem vorübergehenden Verbindungsverlust zwischen SKOOR Engine und dem Roboterhost führen. Natürlich müsste das Projekt selbst beinhalten, dass diese VPN-Verbindungen wieder geschlossen werden, sonst wird SKOOR Engine niemals Ergebnisse abrufen können. Wenn diese Option aktiviert ist, wartet SKOOR Engine nicht auf den Beendigungsstatus des Projektlaufs und versucht erst, die Ergebnisse des Projektlaufs abzurufen, nachdem sie die unter Laufzeitlimit angegebene Zeit gewartet hat. |
Laufzeitbegrenzung | Geben Sie die Zeitspanne an, die für die Ausführung des Projekts vorgesehen werden soll. Dies hängt davon ab, was das Projekt tut. Dieser Parameter ist optional, außer wenn auch der VPN-Testmodus aktiviert ist. Wenn diese Zeit abgelaufen ist und der Testprozess auf dem Roboter noch läuft, wird er beendet. In diesem Fall werden keine MHT-Protokolle generiert und abgerufen (was zu einer Warnung führt). |
Zeitüberschreitung des Roboters | Optionaler interner Timeout-Parameter (zum Deaktivieren auf 0 s setzen). Dieser Parameter ist nur sinnvoll, wenn der Wert kleiner als der Parameter Laufzeitbegrenzung ist |
Video aufnehmen | Wenn die Videoaufzeichnung aktiviert ist, kann bei fehlgeschlagenen Testläufen der gesamte Testlauf auf der Ergebnisseite der SKOOR Engine angesehen werden. Dies kann sehr hilfreich sein, um Fehler im Projekt zu finden und zu korrigieren. Testläufe, die mit einem OK Zustand enden, werden nicht an den Server übertragen, um unnötige Netzwerklast und Speicherverbrauch zu vermeiden |
Auto-Update-Suite | Aktivieren Sie dieses Steuerelement, wenn die aktuellsten Projektdateien aus dem Projekt-Repository der SKOOR Engine abgerufen werden sollen |
Repository | Wählen Sie eines der beiden Projekt-Repositorys Produktion oder Test aus, aus dem die Projektdateien gezogen werden sollen. Dieser Parameter ist nur sichtbar, wenn die EEM-Geräteeigenschaft EEM-Ausführungsmodus auf TestExecute gesetzt und Auto update suite aktiviert ist |
Timer-Jobs sortieren | Wählen Sie zwischen Nach Name , Nach Status , Nach Laufzeit oder Nach Startzeit, um Timer-Jobs automatisch zu sortieren, oder Manuell, um sie mit den Schaltflächen „ Nach oben “ oder „Nach unten“ im Abschnitt „Verknüpfte EEM-Timer-Jobs“ zu sortieren |
Bitte beachten Sie, dass die Videoaufnahme eine hohe CPU-Last auf dem SKOOR Engine System verursachen kann
Der Abschnitt Verknüpfte EEM-Timer-Jobs zeigt, welche EEM-Timer zu diesem EEM-Projekt-Job hinzugefügt wurden. In der obigen Abbildung wurden noch keine Timer-Jobs hinzugefügt.
Remote Desktop Protocol (RDP)-Einstellungen für Messungen
RDP sollte auf dem Gerät konfiguriert werden, das den EEM-Projektauftrag enthält, um redundante Einstellungen für jeden einzelnen Auftrag zu vermeiden. Wenn jedoch für einen Job andere Parametereinstellungen erforderlich sind, können die Geräteparameter durch im Job konfigurierte Parameter überschrieben werden:
Parameter | Beschreibung |
|---|---|
Domain | Domäne, zu der der Benutzer gehört. Wenn der Benutzer ein lokaler Windows-Benutzer ist, muss der Hostname des EEM-PCs als Domäne konfiguriert werden |
Nutzername | Der Name des Anmeldebenutzers |
Passwort | Das Passwort des Benutzers |
Bildschirmauflösung | Bei bildbasierten Tests ist die Bildschirmauflösung wichtig. Es muss dieselbe Auflösung konfiguriert werden, die auf dem System verwendet wird, auf dem das Projekt entwickelt wurde. Die Standardauflösung ist 1920 x 1200 |
Optional | Hier können bei Bedarf weitere Parameter des Dienstprogramms rdesktop oder FreeRDP konfiguriert werden |
Sitzung abmelden | Melden Sie sich nach der Projektausführung von der RDP-Sitzung ab |
Bitte beachten Sie, dass die Videoaufnahme eine hohe CPU-Last auf dem SKOOR Engine System verursachen kann
EEM-Projektwerte und Alarmgrenzen
Wert / Alarm Limit | Beschreibung |
|---|---|
Laufzeit | Die Laufzeit des gesamten EEM-Projekts |
Antwortcode | 0 = Okay |
Fehlercode | Allgemeiner 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.
Timer-Jobs hinzufügen
Die Timer-Jobs stellen die Messungen dar, die in der SKOOR Engine oder im Dashboard angezeigt werden sollen. Ein Projekt kann mehrere Timer-Jobs haben, z. B. die Gesamtzeit aller Messungen, das Einloggen in eine Anwendung und andere Anwendungsfälle. Die Timer müssen im Projekt konfiguriert / programmiert werden. Wenn das Testprojekt in einem der SKOOR Engine Repositorys oder auf dem EEM-Roboter im konfigurierten Skriptverzeichnis verfügbar ist, versucht die SKOOR Engine , die Timer aus dem Projekt zu extrahieren und automatisch zu konfigurieren.
Klicken Sie im Bearbeitungsfenster eines EEM-Projektjobs auf Zeitgeberjobs hinzufügen :
Der folgende Bildschirm erscheint und dokumentiert die gefundenen Timer und durchgeführten Aktionen:
Die Timer wurden unterhalb des EEM-Projektjobs konfiguriert:
Mit den Auf- und Ab -Tasten können sie jetzt nach Bedarf bestellt werden.
Timer-Jobs manuell hinzufügen
Wenn Timer-Jobs erstellt werden sollen, bevor das EEM-Projekt auf der SKOOR Engine und den Roboter-PCs verfügbar ist, können sie auch manuell hinzugefügt werden. Klicken Sie auf den Namen des EEM-Projektjobs, um unter den Projektjob zu gelangen, und fügen Sie den Timer über das Funktionsmenü oder das Zahnradsymbol hinzu:
Danach muss der Timername genau so konfiguriert werden, wie er im Projekt definiert ist. Der folgende Bildschirm zeigt einen Timer namens totalTime :
EEM-Timer-Parameter
Parameter | Beschreibung |
|---|---|
Timer-Name | Für einen EEM-Timer-Job können nur der Jobname und der Timername konfiguriert werden. Der Name des Jobs kann sich vom Timer-Namen unterscheiden, aber der Timer-Name muss dem Timer-Namen entsprechen, wie er in der Timer-Datei steht. |
EEM Timerwerte und Alarmgrenzen
Wert / Alarm Limit | Beschreibung |
|---|---|
Laufzeit | Die Laufzeit dieses bestimmten EEM-Zeitgebers |
Ergebniscode | 0 = Okay |
Bekannter Fehler | Die Alarm Limit für bekannte Fehler ist nur bei EEM-Timer-Jobs verfügbar und prüft, ob in der Timer-Datei ein String zurückgegeben wurde, der sich von den üblichen OK , FAILED- oder NOTRUN-Strings unterscheidet. Alarmierung ist möglich, wenn eine Zeichenfolge erkannt wird, nicht aufgrund ihres Inhalts. |
Fehlercode | Allgemeiner Job-Fehlercode (siehe Abschnitt Job-Fehlercodes ) |
EEM-Timer-Details
Timer werden innerhalb eines Projekts eingeführt, um das Ergebnis ( OK /Failed/NotRun) und die Zeit zu messen, die für einen bestimmten Abschnitt eines Testlaufs benötigt wurde. Während des Laufs werden die Timer in eine Textdatei innerhalb des Projektverzeichnisses geschrieben. Die Datei ist wie folgt aufgebaut:
========== 2017.11.30-12.43 ================= Name;Status;Time ---------------- Calc_Open;OK;6.26 Calc_Calculate;OK;1.69 Total;OK;8.47
Für jeden Timer werden der Name des SKOOR Engine EEM-Timer-Jobs, der tatsächliche Name des Timers, sein aktueller Status und die Zeit in Sekunden gedruckt, die zum Ausführen des entsprechenden Timers während des letzten Laufs benötigt wurde.
Es besteht auch die Möglichkeit, dass das Projekt einen bestimmten Fehler-String in die Timer-Datei schreibt, der dann als String-Wert geparst wird. Dies ist sinnvoll, wenn in einem Projekt Fehler auftreten, die häufig auftreten und bekannt sind, aber in der getesteten Anwendung oder Website nicht behoben werden können. In einem solchen Fall muss die Erkennung des Fehlers in den Projektablauf programmiert werden und sollte einen spezifischen Fehlerstring für den spezifischen Timer in die Timer-Datei schreiben. Ein Beispiel für eine solche Timer-Datei ist unten dargestellt:
========== 2017.11.30-12.43 ================= Name;Status;Time ---------------- Calc_Open;OK;6.26 Calc_Calculate;Known error encountered in Calculate sub-step;1.69 Total;OK;8.47
Die zweite Spalte der Zeile Calc_Calculate wird als bekannter Fehler auf EEM-Timer-Job-Ebene interpretiert.
Diese bekannten Fehler können dann in Alarm Limit verwendet werden. Ein Beispiel für einen aufgetretenen bekannten Fehler ist in der folgenden Abbildung dargestellt:
Und im Wertebereich des entsprechenden EEM-Timer-Jobs:
Die Timer-Datei, in diesem Fall calc.txt (ihr Name muss mit dem Projektnamen identisch sein), wird über WinAgent abgerufen und für die Zustände und Werte jedes Timers analysiert. Dies geschieht aber nur, wenn Timer mit den entsprechenden Namen konfiguriert sind.
Ergebnisse des EEM-Projekts
Nach einem Lauf des Projekts auf dem EEM-Roboter sieht der Wertebereich des EEM-Projektjobs so aus (unterscheidet sich von SikuliX-Projekten):
oder bei einem Fehler während des Projektlaufs:
Durch Klicken auf den Link Timer-Datei kann die abgerufene Timer-Datei direkt angesehen werden (siehe Beispieldatei oben).
Durch Klicken auf den Link neben MHT-Protokolldatei kann das zusammenfassende MHT-Protokoll heruntergeladen oder direkt angezeigt werden. Eine direkte Ansicht ist nur möglich, wenn der Link aus einem Internet Explorer-Browser heraus angeklickt wird. Das Folgende ist ein Beispiel für ein MHT-Protokoll:
Durch Klicken auf den Link „Ergebnisdateien“ im Abschnitt „Werte“ wird das folgende neue Browserfenster oder die folgende Registerkarte geöffnet:
Diese Seite bietet einen Überblick über die Tests, die auf dem EEM-Roboter gelaufen sind. Für jeden Lauf, bei dem Protokolle von SKOOR Engine gesammelt wurden, gibt es eine Zeile mit einem Zeitstempel und einem Link zur entsprechenden MHT-Datei. Wenn während eines Laufs Fehler aufgetreten sind, wird der Link in der Spalte Fehlgeschlagene Tests platziert, zusammen mit einem kleinen Symbol, das angeklickt werden kann und ein neues Browserfenster mit einem Screenshot des ersten Fehlers öffnet, der während des Laufs aufgetreten ist. Dies gibt meistens eine gute Vorstellung davon, warum ein Testlauf fehlgeschlagen ist. Wenn der letzte Lauf fehlgeschlagen ist, wie in diesem Beispiel, wird der Screenshot auch in dieser Übersicht im Abschnitt Letztes Ergebnis groß angezeigt. Durch Klicken auf den Screenshot- Link im Wertbereich des Jobs wird dieses Screenshot-Bild direkt geöffnet.
EEM-Projektbeispiel
Führen Sie ein einfaches EEM-Projekt mit 3 EEM-Timern aus
Bei der folgenden Konfiguration wird davon ausgegangen, dass der Remote-Host über eine TestComplete-Projektsuite namens Calc mit einem Projekt namens Calc darunter verfügt. Die Projektausgabe enthält 3 Timer und wird über den auf dem Remote-Host installierten WinAgent ausgeführt. WinAgent muss konfiguriert werden, um die Ausführung der Binärdatei testexecute.exe zuzulassen. Die Timer werden als einzelne EEM-Timer-Jobs unterhalb des EEM-Projektjobs hinzugefügt.
Ausgang
