SKOOR Robot Projekte

Gerätekonfiguration

Allgemeine Gerätekonfiguration finden Sie unter EEM-Projekt mit EEM-Timer-Jobs

Beispiel für eine SikuliX-Gerätekonfiguration

Im folgenden Beispiel wurden die Parameter für ein Gerät für SikuliX-Tests wie im Abschnitt „EEM-Projektinformationen” beschrieben festgelegt:

EEM-Projekt-Jobdetails

SikuliX-Projekteinstellungen:

EEM-Projektparameter

Parameter	Beschreibung
Projektname	Name des SikuliX-Projekts. Dies ist der Name der Python-Datei oder des Projektverzeichnisses ohne Erweiterung.
VPN-Testmodus	Aktivieren Sie dieses Kontrollkästchen nur in dem speziellen Fall, 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 der 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 Beendigungsstatus des Projektlaufs und versucht erst nach Ablauf der unter „Laufzeitlimit” angegebenen Zeit, die Ergebnisse aus dem Projektlauf abzurufen.
Laufzeitlimit	Geben Sie die Zeit an, die für die Ausführung des Projekts zur Verfügung steht. Dieser Parameter ist optional, außer wenn der VPN-Testmodus aktiviert ist. Wenn diese Zeit abgelaufen ist und der Testprozess noch auf dem Roboter läuft, wird er beendet.
Ausführlich/Debug	Fügen Sie bei Bedarf Debug-Informationen zur Projektausgabe (Protokoll) hinzu.
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 beheben. 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 „SikuliX” 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 Videoaufnahme eine hohe CPU-Auslastung auf dem SKOOR Engine-System verursachen kann.

Der Abschnitt „Verknüpfte EEM-Timer-Jobs“ zeigt an, welche EEM-Timer zu diesem EEM-Projekt-Job hinzugefügt wurden.

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.

Variablen- und Passwortparameter

Konfigurieren Sie Variablen und Passwörter in SikuliX-Projekt-Jobs, die als Skriptargumente auf den Roboter-Rechnern verwendet werden. Zu diesem Zweck stehen die Job-Parameter EEM: Password und EEM: Variable zur Verfügung. Eine Variable wird als durch Kommas getrennte Schlüssel/Wert-Paare definiert. Der Schlüssel wird später im SikuliX-Skript verwendet, um den Wert zu lesen. Passwörter müssen auf die gleiche Weise konfiguriert werden, zum Beispiel: passwd:mySecretPassword

Die Eigenschaften können im SikuliX-Skript wie im folgenden Beispiel verwendet werden:

username = SkoorUtils.variable("username")
password = SkoorUtils.variable("passwd")

Hinweis: Um Variablen während der Entwicklung zu testen, können SikuliX-Projekte auch über die Windows-Eingabeaufforderung ausgeführt werden. Beachten Sie, dass Variablen Base64-kodiert sein müssen.

Beispiel:

sikulix.exe -r scripts\test.sikuli -- dXNlcm5hbWU6dGVzdC1zaWt1bGl4

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 = OK-1 = Nicht ausgeführt-2 = Fehlgeschlagen-3 = Projektfehler 1 = Bekannter Fehler
Bekannter Fehler	Die 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 für SikuliX

In SikuliX-Projekten werden Timer anders verarbeitet. Daher ist es nicht möglich, den Inhalt der Timer-Datei zu ändern.

EEM-Projektbeispiel

Führen Sie ein einfaches EEM-Projekt mit 3 EEM-Timern aus

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

SikuliX-Skriptvorlage

Als Grundlage für die Entwicklung von SikuliX-Skripten wird in der SKOOR-Dokumentation eine Vorlage bereitgestellt.