Projets SKOOR Robot

Configuration de l'appareil

Pour la configuration générale de l'appareil, consultez EEM Project avec tâches EEM Timer

Exemple de configuration d'un appareil SikuliX

Dans l'exemple suivant, les paramètres d'un appareil ont été définis pour les tests SikuliX comme décrit dans la section d'informations sur le projet EEM :

Détails de la tâche EEM Project

Paramètres du projet SikuliX :

Paramètres EEM Project

Paramètre

Description

Project name

Nom du projet SikuliX. Il s'agit du nom du fichier Python ou du répertoire du projet sans extension

VPN test mode

Cochez cette case uniquement dans le cas particulier où le projet à exécuter établit lui-même des connexions VPN vers une passerelle VPN pendant son exécution. Cela entraînerait une perte de connexion temporaire entre SKOOR Engine et l'hôte robot. Bien entendu, le projet lui-même doit également prévoir la fermeture de ces connexions VPN, sans quoi SKOOR Engine ne pourra jamais récupérer les résultats. Si cette case est cochée, SKOOR Engine n'attendra pas le code de sortie de l'exécution du projet et n'essaiera de récupérer les résultats qu'après avoir attendu la durée spécifiée dans Run time limit

Run time limit

Spécifiez la durée maximale allouée à l'exécution du projet. Ce paramètre est facultatif, sauf si VPN test mode est coché. Si ce délai est écoulé et que le processus de test est toujours en cours d'exécution sur le robot, il sera arrêté

Verbose/Debug

Ajoutez des informations de débogage à la sortie du projet (journal) si nécessaire

Capture video

Si la capture vidéo est activée, l'intégralité de l'exécution du test peut être visionnée depuis la page de résultats de SKOOR Engine en cas d'échec du test. Cela peut être très utile pour identifier et corriger les erreurs dans le projet. Les exécutions de test qui se terminent avec un état OK ne sont pas transférées vers le server afin d'éviter toute charge réseau et consommation de stockage inutiles

Auto update suite

Cochez cette option si les fichiers de projet les plus récents doivent être récupérés depuis le référentiel de projets SKOOR Engine

Repository

Sélectionnez l'un des deux référentiels de projets Production ou Test depuis lequel récupérer les fichiers du projet. Ce paramètre n'est visible que si la propriété d'appareil EEM EEM execution mode est définie sur SikuliX et que Auto update suite est coché

Sort timer jobs

Choisissez entre By name, By state, By run time ou By start time pour trier automatiquement les tâches timer, ou Manually pour les trier à l'aide des boutons up ou down dans la section Linked EEM Timer Jobs

Veuillez noter que la capture vidéo peut entraîner une charge CPU élevée sur le système SKOOR Engine

La section Linked EEM Timer Jobs indique quels timers EEM ont été ajoutés à cette tâche EEM Project.

Paramètres RDP (Remote Desktop Protocol) pour les mesures

Le protocole RDP doit être configuré sur l'appareil qui héberge la tâche EEM Project afin d'éviter des paramètres redondants sur chaque tâche. Toutefois, si une tâche nécessite des paramètres différents, les paramètres de l'appareil peuvent être remplacés par ceux configurés sur la tâche :

Paramètre

Description

Domain

Domaine auquel appartient l'utilisateur. Si l'utilisateur est un utilisateur Windows local, le nom d'hôte du PC EEM doit être configuré comme domaine

Username

Le nom de l'utilisateur de connexion

Password

Le mot de passe de l'utilisateur

Screen resolution

Dans le cas de tests basés sur les images, la résolution d'écran est importante. La même résolution que celle utilisée sur le système sur lequel le projet a été développé doit être configurée. La résolution par défaut est 1920x1200

Optional

Des paramètres supplémentaires de l'utilitaire rdesktop ou FreeRDP peuvent être configurés ici si nécessaire

Logout session

Fermer la session RDP après l'exécution du projet

Paramètres de variables et de mots de passe

Configurez dans les tâches de projet SikuliX les variables et les mots de passe utilisés comme arguments de script sur les machines robots. Les paramètres de tâche EEM: Password et EEM: Variable sont disponibles à cet effet. Une variable est définie sous forme de paire clé/valeur séparée par deux-points. La clé est ensuite utilisée dans le script SikuliX pour lire la valeur. Les mots de passe doivent être configurés de la même manière, par exemple : passwd:mySecretPassword

Les propriétés peuvent être utilisées dans le script SikuliX comme dans l'exemple suivant :

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

Astuce : pour tester les variables pendant le développement, les projets SikuliX peuvent également être exécutés depuis l'invite de commandes Windows (CMD). Notez que les variables doivent être encodées en Base64.

Exemple :

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

Ajout de tâches timer

Les tâches timer représentent les mesures à afficher dans SKOOR Engine ou le tableau de bord. Un projet peut comporter plusieurs tâches timer, telles que la durée totale de toutes les mesures, la connexion à une application et d'autres cas d'utilisation. Les timers doivent être configurés / programmés dans le projet. Si le projet de test est disponible dans l'un des référentiels SKOOR Engine ou sur le robot EEM dans le répertoire de scripts configuré, SKOOR Engine tentera d'extraire les timers du projet et de les configurer automatiquement.

Dans la fenêtre d'édition d'une tâche EEM Project, cliquez sur Add timer jobs :

L'écran suivant s'affiche et répertorie les timers trouvés ainsi que les actions effectuées :

Les timers ont été configurés sous la tâche EEM Project :

À l'aide des boutons up et down, ils peuvent maintenant être réorganisés selon les besoins.

Ajout manuel de tâches timer

Si des tâches timer doivent être créées avant que le projet EEM ne soit disponible sur SKOOR Engine et les PC robots, elles peuvent également être ajoutées manuellement. Cliquez sur le nom de la tâche EEM Project pour accéder au niveau inférieur à la tâche de projet et ajoutez le timer à l'aide du menu de fonctions ou de l'icône d'engrenage :

Ensuite, le nom du timer doit être configuré exactement tel qu'il est défini dans le projet. L'écran suivant montre un timer appelé totalTime :

Paramètres EEM Timer

Paramètre

Description

Timer name

Seuls le nom de la tâche et le nom du timer peuvent être configurés sur une tâche EEM Timer. Le champ Name de la tâche peut être différent du Timer name, mais le Timer name doit correspondre au nom du timer tel qu'il est écrit dans le fichier timer.

Valeurs et seuils d'alarme EEM Timer

Valeur / Seuil d'alarme

Description

Run time

La durée d'exécution de ce timer EEM particulier

Result code

 0 = Ok
-1 = Notrun
-2 = Failed
-3 = Project error
 1 = Known error

Known Error

Le seuil d'alarme Known error est uniquement disponible sur les tâches EEM Timer et vérifie si une chaîne différente des chaînes habituelles OK, FAILED ou NOTRUN a été renvoyée dans le fichier timer. Le déclenchement d'une alarme est possible lors de la détection d'une chaîne, et non sur son contenu.

Error code

Code d'erreur générique de tâche (voir la section Codes d'erreur des tâches)

Détails EEM Timer pour SikuliX

Dans les projets SikuliX, les timers sont traités d'une manière différente. Par conséquent, il n'est pas possible de modifier le contenu du fichier timer. 

Exemple de projet EEM

Exécuter un projet EEM simple avec 3 timers EEM

La configuration suivante suppose que l'hôte distant dispose d'une suite de projets TestComplete appelée Calc contenant un projet appelé Calc. La sortie du projet contient 3 timers et est exécutée via WinAgent installé sur l'hôte distant. WinAgent doit être configuré pour autoriser l'exécution du binaire testexecute.exe. Les timers sont ajoutés en tant que tâches EEM Timer individuelles sous la tâche EEM Project.

Sortie

Modèle de script SikuliX

Un modèle est fourni dans la documentation SKOOR comme base pour le développement de scripts SikuliX.