DokumentationSmartBear-Projekte
Gerätekonfiguration
Allgemeine Gerätekonfiguration finden Sie unter EEM-Projekt mit EEM-Timer-Jobs
Beispiel für eine SmartBear-Gerätekonfiguration
Im folgenden Beispiel wurden die Parameter für ein Gerät für SmartBear-Tests gemäß der Beschreibung im Abschnitt „EEM-Projektinformationen“ festgelegt:
EEM-Projekt-Jobdetails
SmartBear-Projekteinstellungen:
EEM-Projektparameter
Parameter | Beschreibung |
|---|---|
Name der Suite | 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 eingegeben werden. Andernfalls geben Sie sowohl den Namen der Suite als auch den Namen des Projekts an. Sobald dieses Feld ausgefüllt ist, wird das Feld „Argumente” automatisch mit den Standard-Befehlszeilenargumenten ausgefüllt, die an den Befehl TestComplete oder TestExecute angehängt werden sollen. |
Projektname | Name des TestComplete-Projekts. Dieser muss nur ausgefüllt werden, wenn die Projektsuite mehr als ein Projekt enthält. |
VPN-Testmodus | Aktivieren Sie dieses Kontrollkästchen nur in dem Sonderfall, dass das auszuführende Projekt während der Projektlaufzeit selbst VPN-Verbindungen zu einem VPN-Gateway initiiert. Dies würde zu einem vorübergehenden Verbindungsverlust zwischen SKOOR Engine und dem Roboter-Host führen. Natürlich müsste das Projekt selbst das Schließen dieser VPN-Verbindungen wieder vorsehen, da SKOOR Engine sonst niemals Ergebnisse abrufen kann. Wenn dieses Kontrollkästchen aktiviert ist, wartet SKOOR Engine nicht auf den Exit-Status der Projektlaufzeit und versucht erst nach Ablauf der unter „Laufzeitlimit“ angegebenen Zeit, die Ergebnisse aus der Projektlaufzeit abzurufen. |
Laufzeitlimit | Geben Sie die Zeit an, die für die Ausführung des Projekts zur Verfügung steht. Diese 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 Testvorgang auf dem Roboter noch läuft, wird er beendet. In diesem Fall werden keine MHT-Protokolle erstellt und abgerufen (was zu einer Warning-Meldung führt). |
Roboter-Timeout | Optionaler interner Zeitüberschreitungs-Parameter (auf 0 s setzen, um ihn zu deaktivieren). Dieser Parameter ist nur sinnvoll, wenn der Wert kürzer ist als der Parameter „Laufzeitlimit“. |
Video aufnehmen | Wenn die Videoaufzeichnung aktiviert ist, kann der gesamte Testlauf im Falle eines fehlgeschlagenen Testlaufs auf der SKOOR Engine-Ergebnisseite angesehen werden. Dies kann sehr hilfreich sein, um Fehler im Projekt zu finden und zu korrigieren. Testläufe, die mit dem Status „OK“ beendet werden, werden nicht auf den Server übertragen, um unnötige Netzwerkbelastung und Speicherverbrauch zu vermeiden. |
Suite automatisch aktualisieren | Aktivieren Sie diese Option, wenn die aktuellsten Projektdateien aus dem SKOOR Engine-Projekt-Repository abgerufen werden sollen. |
Repository | Wählen Sie eines der beiden Projekt-Repositorys „Produktion” oder „Test” aus, aus dem die Projektdateien abgerufen werden sollen. Dieser Parameter ist nur sichtbar, wenn die EEM-Geräteeigenschaft „EEM-Ausführungsmodus” auf „TestExecute” gesetzt und „Suite automatisch aktualisieren” 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 mithilfe der Aufwärts- oder Abwärts-Schaltflächen im Abschnitt „Verknüpfte EEM-Timer-Jobs“ zu sortieren. |
Bitte beachten Sie, dass die Videoaufzeichnung eine hohe CPU-Auslastung 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, auf dem sich der EEM-Projektjob befindet, um redundante Einstellungen für jeden einzelnen Job zu vermeiden. Wenn ein Job jedoch andere Parametereinstellungen erfordert, können die Geräteparameter durch die für den Job konfigurierten Parameter überschrieben werden:
Parameter | Beschreibung |
|---|---|
Domäne | 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. |
Benutzername | Der Name des angemeldeten Benutzers. |
Passwort | Das Passwort des Benutzers |
Bildschirmauflösung | Bei bildbasierten Tests ist die Bildschirmauflösung wichtig. Es muss dieselbe Auflösung konfiguriert werden, die auch auf dem System verwendet wird, auf dem das Projekt entwickelt wurde. Die Standardauflösung beträgt 1920 x 1200. |
Optional | Weitere Parameter des rdesktop- oder FreeRDP-Dienstprogramms können hier bei Bedarf konfiguriert werden. |
Sitzung abmelden | Nach der Projektdurchführung aus der RDP-Sitzung abmelden. |
Bitte beachten Sie, dass die Videoaufzeichnung eine hohe CPU-Auslastung auf dem SKOOR Engine-System verursachen kann.
EEM-Projektwerte und Alarm Limits
Wert / Alarm Limit | Beschreibung |
|---|---|
Laufzeit | Die Laufzeit des gesamten EEM-Projekts |
Antwortcode | 0 = |
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.
Hinzufügen von Timer-Jobs
Die Timer-Jobs stellen die Messungen dar, die in der SKOOR Engine oder im SKOOR Dashboard angezeigt werden sollen. Ein Projekt kann mehrere Timer-Jobs haben, z. B. die Gesamtzeit aller Messungen, die Anmeldung bei einer 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-Projekt-Jobs auf „Timer-Jobs hinzufügen“:
Der folgende Bildschirm wird angezeigt und dokumentiert die gefundenen Timer und durchgeführten Aktionen:
Die Timer wurden unterhalb des EEM-Projekt-Jobs konfiguriert:
Mit den Aufwärts- und Abwärts-Tasten können sie nun nach Bedarf angeordnet 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-Projekt-Jobs, um unter den Projekt-Job zu gelangen, und fügen Sie den Timer über das Funktionsmenü oder das Zahnrad-Symbol hinzu:
Danach muss der Timer-Name 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 | Bei einem EEM-Timer-Job können nur der Jobname und der Timername konfiguriert werden. Der Name des Jobs kann sich vom Timernamen unterscheiden, aber der Timername muss mit dem Timernamen übereinstimmen, der in der Timerdatei angegeben ist. |
EEM-Timer-Werte und Alarm Limits
Wert / Alarm Limit | Beschreibung |
|---|---|
Laufzeit | Die Laufzeit dieses bestimmten EEM-Timers |
Ergebniscode | 0 = |
Bekannter Fehler | Das Alarm Limit für bekannte Fehler ist nur für EEM-Timer-Jobs verfügbar und überprüft, ob in der Timer-Datei eine Zeichenfolge zurückgegeben wurde, die sich von den üblichen Zeichenfolgen OK, FAILED oder NOTRUN unterscheidet. Ein Alarm wird ausgelöst, wenn eine Zeichenfolge erkannt wird, nicht aufgrund ihres Inhalts. |
Fehlercode | Generischer 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 im Projektverzeichnis geschrieben. Die Datei ist wie folgt strukturiert:
========== 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 Timer-Name, sein aktueller Status und die Zeit in Sekunden, die für die Ausführung des entsprechenden Timers während des letzten Laufs benötigt wurde, ausgegeben.
Es besteht auch die Möglichkeit, dass das Projekt eine bestimmte Fehlerzeichenfolge in die Timer-Datei schreibt, die dann als Zeichenfolgenwert analysiert wird. Dies ist sinnvoll, wenn ein Projekt auf Fehler stößt, 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 die Projektsequenz programmiert werden und eine bestimmte Fehlerzeichenfolge in die Timer-Datei für den jeweiligen Timer 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 Konfigurationen für 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 (der Name muss mit dem Projektnamen identisch sein), wird über WinAgent abgerufen und nach den Zuständen und Werten jedes Timers analysiert. Dies geschieht jedoch nur, wenn Timer mit den entsprechenden Namen konfiguriert sind.
EEM-Projektergebnisse
Nach einem Lauf des Projekts auf dem EEM-Roboter sieht der Werteabschnitt des EEM-Projekt-Jobs wie folgt aus (unterscheidet sich von SikuliX-Projekten):
oder im Falle eines Fehlers während der Projektdurchführung:
Durch Klicken auf den Link „Timer-Datei” kann die abgerufene Timer-Datei direkt angezeigt werden (siehe Beispieldatei oben).
Durch Klicken auf den Link neben „MHT-Protokolldatei“ kann das MHT-Zusammenfassungsprotokoll heruntergeladen oder direkt angezeigt werden. Die direkte Anzeige ist nur möglich, wenn der Link in einem Internet Explorer-Browser angeklickt wird. Nachfolgend finden Sie ein Beispiel für ein MHT-Protokoll:
Durch Klicken auf den Link „Result files“ im Abschnitt „Values“ wird das folgende neue Browserfenster oder die folgende neue Registerkarte geöffnet:
Diese Seite bietet einen Überblick über die Tests, die auf dem EEM-Roboter ausgeführt wurden. Für jeden Lauf, bei dem Protokolle von SKOOR Engine erfasst 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, auf das geklickt werden kann und das ein neues Browserfenster mit einem Screenshot des ersten während des Laufs aufgetretenen Fehlers öffnet. Dies gibt in der Regel einen guten Hinweis darauf, warum ein Testlauf fehlgeschlagen ist. Wenn der letzte Lauf fehlgeschlagen ist, wie in diesem Beispiel, wird der Screenshot auch groß im Abschnitt „Letztes Ergebnis“ dieser Übersicht angezeigt. Durch Klicken auf den Link „Screenshot“ im Abschnitt „Wert“ des Auftrags wird dieses Screenshot-Bild direkt geöffnet.
Beispiel für ein EEM-Projekt
Ausführen eines einfachen EEM-Projekts mit 3 EEM-Timern
Die folgende Konfiguration geht davon aus, dass der Remote-Host über eine TestComplete-Projektsuite namens „Calc“ mit einem darunter liegenden Projekt namens „Calc“ verfügt. Die Projektausgabe enthält 3 Timer und wird über den auf dem Remote-Host installierten WinAgent ausgeführt. WinAgent muss so konfiguriert sein, dass die Ausführung der Binärdatei „testexecute.exe“ möglich ist. Die Timer werden als einzelne EEM-Timer-Jobs unterhalb des EEM-Projekt-Jobs hinzugefügt.
Ausgabe
