DocumentationProjet EEM avec emplois EEM Timer
Fonction | Ce plugin est un contrôle spécifique pour les tests de bout en bout (E2E) basés sur SikuliX et SmartBear TestComplete. Il exécute un projet sur un hôte Windows distant via son WinAgent, attend la fin de l'exécution, puis récupère les fichiers journaux, les captures d'écran ou les vidéos générés et les affiche dans une page de présentation. |
|---|---|
Alarme | Durée d'exécution, code de réponse, code de résultat (minuterie EEM), erreur connue (minuterie EEM) |
Informations générales sur le projet EEM
Le plugin EEM Project est conçu pour être utilisé sur un appareil de type PC (EEM Robot). Les appareils EEM (Enduser Experience Monitoring) sont des robots qui effectuent des tests de bout en bout de logiciels et de services à l'aide de SKOOR Robot, un produit basé sur le projet open source SikuliX, ou des outils de test TestComplete / TestExecute de SmartBear. Le plugin a été développé pour rationaliser la configuration et la gestion des tests de bout en bout à partir d'un serveur SKOOR Engine. Les tests peuvent être programmés pour effectuer des tests fonctionnels de bout en bout sur des sites web, des services web, des applications UI ou des applications mobiles.
La communication entre le robot EEM et SKOOR Engine s'effectue via l'application SKOOR Engine WinAgent. WinAgent doit être configuré pour permettre l'exécution des binaires SikuliX ou TestComplete / TestExecute et la récupération des fichiers de sortie générés. De plus, WinAgent doit être exécuté en tant qu'application, et non en tant que service.
Le plugin EEM Project comprend la configuration EEM Project elle-même et un nombre illimité de tâches EEM Timer qui peuvent être ajoutées en dessous.
Valeurs du projet EEM et limites d'alarme
Valeur / Limite d'alarme | Description |
|---|---|
Durée d'exécution | Durée d'exécution de l'ensemble du projet EEM |
Code de réponse | 0 = |
Code d'erreur | Code d'erreur générique de tâche (voir la section Codes d'erreur de tâche) |
Si une tâche du projet EEM est liée à un calendrier (qui définit les périodes actives et inactives pour l'exécution de la tâche), le bouton Vérifier maintenant ne fonctionne pas pendant la période inactive configurée dans le calendrier.
Périphérique EEM Robot
Avant de créer une tâche EEM Project, veillez à configurer le périphérique auquel appartient la tâche en tant que périphérique de type PC (EEM Robot). Lors de la création d'un tel périphérique, l'écran d'options de configuration suivant s'affiche :
La section Informations sur le projet EEM fournit des informations sur les valeurs par défaut configurées des propriétés utilisées pour exécuter un projet EEM. À part cela, un périphérique PC (EEM Robot) est fonctionnellement identique aux autres types de périphériques. Remplacez les propriétés en définissant manuellement une ou plusieurs propriétés dans la section Propriétés.
Propriétés de l'appareil
Les propriétés configurées au niveau du périphérique s'appliquent à toutes les tâches du projet EEM de ce périphérique. Si nécessaire, certaines d'entre elles peuvent être remplacées dans les tâches de mesure.
Nom de la propriété | Description |
|---|---|
Nom d'utilisateur de l'agent | Doit être défini si un nom d'utilisateur et un mot de passe ont été configurés dans les paramètres WinAgent sur l'hôte EEM |
Mot de passe de l'agent | Doit être défini si un nom d'utilisateur et un mot de passe ont été configurés dans les paramètres WinAgent sur l'hôte EEM |
Connexion sécurisée de l'agent | Doit être défini si le paramètre correspondant (cryptage SSL pour la connexion) a été configuré dans les paramètres WinAgent sur l'hôte EEM |
Chemin d'accès au fichier binaire EEM | Doit être défini s'il diffère de sa valeur par défaut. Il doit être défini en fonction de la propriété du mode d'exécution EEM et, bien sûr, des chemins d'accès aux composants logiciels |
Mode d'exécution EEM | Pour les appareils d'exécution, utilisés pour effectuer des mesures, choisissez SikuliX ou TestExecute Pour les appareils utilisés pour développer des projets EEM, choisissez SikuliX Development ou TestComplete |
EEM récupérer les journaux MHT (TestExecute uniquement) | Si cette option est activée (par défaut), le SKOOR Engine tentera de transférer les journaux récapitulatifs d'exécution du projet générés sur le robot EEM. Ceux-ci sont générés pour chaque exécution au format MHT (MHTML) et ne peuvent être consultés qu'avec Internet Explorer. Les fichiers journaux MHT peuvent être assez volumineux, parfois plusieurs Mo, surtout si l'exécution du projet a généré de nombreuses erreurs. Désactivez cette option si l'espace disponible sur le SKOOR Engine est insuffisant pour stocker les journaux ou si la bande passante réseau entre le SKOOR Engine et le robot EEM est trop faible pour le transfert de fichiers volumineux. |
Répertoire racine des journaux EEM | Il s'agit du répertoire racine où les journaux SikuliX ou MHT sont stockés sur le robot EEM. |
Répertoire racine du projet EEM | Il s'agit du répertoire racine où les projets SikuliX / TestComplete sont stockés sur le robot EEM. |
Accès à distance EEM | En général, les projets sont exécutés sur la console du robot EEM (l'écran que l'on verrait si un moniteur physique était connecté). Dans ce cas, VNC ou d'autres moyens tels que Teamviewer sont utilisés comme méthode d'accès à distance. Cependant, cela laisse l'écran de la console du robot visible pendant l'exécution des tests. Si la sécurité est un problème, les tests peuvent être configurés pour s'exécuter dans une session Windows Remote Desktop (RDP). Cela permet de verrouiller l'écran de la console. Les utilisateurs seront déconnectés lorsque les tests seront exécutés. Si une authentification au niveau du réseau est requise, l'appareil doit être configuré avec FreeRDP |
Domaine RDP | Domaine Active Directory utilisé pour la connexion RDP |
Nom d'utilisateur/mot de passe RDP | Nom d'utilisateur et mot de passe Active Directory pour la connexion RDP |
Résolution RDP | Résolution d'écran utilisée pour les mesures EEM. Ceci est particulièrement important pour les mesures basées sur l'image (SKOOR Robot) |
Options RDP | Certaines options peuvent être configurées pour la session RDP. Veuillez consulter la section Informations sur le projet EEM de l'objet appareil pour plus de détails |
Déconnexion RDP | Pour gagner du temps entre les mesures, les sessions RDP ne sont pas déconnectées après l'exécution d'une tâche de projet. Si une déconnexion est nécessaire pour une raison quelconque, cette propriété peut être définie en conséquence |
Tâches du projet EEM
Pour la configuration des tâches du projet EEM, veuillez consulter les sous-pages spécifiques pour SKOOR Robot et SmartBear.
Résultats du projet EEM
Les résultats des mesures sont présentés dans les tâches EEM Project et Timer, ainsi que dans le navigateur de résultats EEM.
File d'attente du projet EEM
Le SKOOR Engine Collector planifie automatiquement les tâches du projet EEM en fonction de leur intervalle d'exécution spécifié. Cela signifie que chaque tâche du projet EEM peut avoir son propre intervalle d'exécution et que le planificateur veille à ce que cet intervalle soit respecté. S'il y a plusieurs tâches du projet EEM sur un appareil EEM et que le planificateur décide qu'il est temps d'exécuter une tâche du projet EEM, celle-ci est mise en file d'attente si l'une des autres tâches du projet EEM est déjà en cours d'exécution. Pour afficher cette file d'attente, les conditions préalables suivantes doivent être remplies :
Le périphérique EEM doit avoir un collecteur par défaut défini dans sa configuration.
Au moins une tâche EEM Project doit exister sur le dispositif EEM
Si les critères ci-dessus sont remplis, la file d'attente et l'état du projet en cours d'exécution peuvent être consultés en sélectionnant Afficher les détails sur le périphérique EEM :
Distribution du projet EEM
Le développement de projets de test nécessite l'installation du logiciel TestComplete ou SikuliX. Le développement est généralement effectué sur des hôtes différents de ceux sur lesquels les tests sont réellement exécutés. Là où les tests sont exécutés, seul le logiciel d'exécution TestExecute doit être installé (SmartBear uniquement). Pour distribuer les tests développés, SKOOR Engine propose un mécanisme qui consiste à créer un fichier zip du répertoire du projet en cours sur l'hôte de développement, à le récupérer dans SKOOR Engine, puis à le distribuer aux robots EEM. L'exécutable SikuliX est transféré de la même manière. Pour ce faire, suivez les instructions ci-dessous :
Définissez la propriété du mode d'exécution EEM sur SikuliX Development ou TestComplete sur le périphérique hôte de développement.
Assurez-vous que tous les appareils hôtes des robots EEM ont cette propriété définie sur TestExecute ou SikuliX
Sur l'hôte de développement, développez un nouveau projet EEM ou modifiez un projet existant. Enregistrez le projet et fermez l'IDE correspondant.
Sous le périphérique de développement dans l'interface utilisateur SKOOR Engine, dans le projet EEM qui doit être distribué aux hôtes robots EEM, sélectionnez Distribute to test repository (Distribuer vers le référentiel de test) dans la liste déroulante Execute/Distribute (Exécuter/Distribuer) de la section Job execution (Exécution de la tâche) :
Choisir Exécuter le travail de mesure lancerait simplement le projet EEM.
Cliquez sur OK pour enregistrer la tâche.
Ouvrez le nouveau travail à l'aide de la loupe et cliquez sur Distribuer
La section Valeurs devrait maintenant afficher Suite distribuée avec succès :
Le répertoire zippé de la suite de projets sera désormais placé dans le répertoire /opt/eranger/collector/eem_repository/from_development/test du SKOOR Collector sur lequel le travail du projet EEM est configuré
L'archive sera synchronisée avec le répertoire /opt/eranger/collecteur/eem_repository/to_execute/test, la rendant ainsi disponible pour la mise à jour automatique.
Sur le dispositif robot EEM, accédez à la tâche EEM Project correspondante et cochez la case Auto update suite control (Contrôle de la mise à jour automatique de la suite). Sélectionnez ensuite le référentiel Test dans la liste qui s'affiche :
Exécutez Vérifier maintenant sur la tâche du projet EEM. Cela permettra d'abord de vérifier s'il existe des fichiers de projet mis à jour dans le référentiel SKOOR Engine (sous le répertoire /opt/eranger/collector/eem_repository/to_execute/test). Si oui, ils seront transférés vers le robot EEM, remplaçant l'ancien répertoire de la suite de projets. Ensuite, le test sera exécuté et ses résultats seront renvoyés.
Si le test s'exécute correctement sur l'hôte TestExecute activé pour le référentiel de test, vous pouvez commencer à distribuer le projet au référentiel de production. Il est recommandé de disposer d'un robot de test dédié, sur lequel tous les tests développés sont d'abord exécutés avant d'être distribués aux robots de production.
La copie des projets nouvellement téléchargés (distribués) vers tous les SKOOR Engine Agents peut prendre jusqu'à 4 minutes, ils ne seront donc peut-être pas immédiatement disponibles pour la mise à jour automatique.
Si les projets ne sont pas distribués, vérifiez si SKOOR Engine, où les tâches du projet EEM sont configurées, dispose d'un accès authentifié par clé publique via ssh aux collecteurs SKOOR Engine sur lesquels les tâches du projet EEM s'exécutent. SKOOR Engine récupère toutes les archives de projet compressées de tous les collecteurs SKOOR Engine, puis les distribue à tous les répertoires de référentiels des collecteurs.