DocumentationProjet EEM avec emplois EEM Timer
Fonction | Ce plugin est un outil de vérification spécifique destiné aux 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, captures d'écran ou vidéos générés et les affiche sur une page de synthèse. |
|---|---|
Alertes | Durée d'exécution, code de réponse, code de résultat (EEM Timer), erreur connue (EEM Timer) |
Informations générales sur le projet EEM
Le plugin « Projet EEM » est conçu pour être utilisé sur un appareil de type PC (robot EEM). 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. Ce plugin a été développé pour simplifier la configuration et la gestion des exécutions de 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 s’exécuter en tant qu’application, et non en tant que service.
Le plugin EEM Project se compose de la configuration EEM Project elle-même et d’un nombre illimité de tâches EEM Timer associées pouvant être ajoutées en dessous.
Valeurs du projet EEM et seuils d’alarme
Valeur / Seuil d’alarme | Description |
|---|---|
Durée d’exécution | Durée d’exécution de l’ensemble du projet EEM |
Code de réponse | 0 = OK - |
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 d’un projet EEM est liée à un calendrier (qui définit les périodes d’activité et d’inactivité pour l’exécution de la tâche), le bouton « Vérifier maintenant » ne fonctionne pas pendant la période d’inactivité configurée dans le calendrier.
Périphérique EEM Robot
Avant de créer une tâche de projet EEM, 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 « Infos sur le projet EEM » sert de référence pour les valeurs par défaut configurées des propriétés utilisées pour exécuter un projet EEM. En dehors de cela, un périphérique de type PC (EEM Robot) est fonctionnellement identique aux autres types de périphériques. Vous pouvez remplacer ces propriétés en définissant manuellement une ou plusieurs d’entre elles dans la section « Propriétés ».
Propriétés du périphérique
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 au niveau des 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 (chiffrement 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 la valeur par défaut. Ce paramètre doit être défini en fonction de la propriété « Mode d'exécution EEM » et, bien sûr, des chemins d'accès aux composants logiciels |
Mode d'exécution EEM | Pour les périphériques d’exécution utilisés pour effectuer des mesures, choisissez « SikuliX » ou « TestExecute » Pour les périphériques utilisés pour développer des projets EEM, choisissez « SikuliX Development » ou « TestComplete » |
Récupération des journaux MHT EEM (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 de plusieurs Mo, en particulier 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 permettre le transfert de fichiers volumineux |
Répertoire racine des journaux EEM | Il s'agit du répertoire racine dans lequel les fichiers journaux SikuliX ou MHT sont stockés sur le robot EEM |
Répertoire racine des projets EEM | Il s’agit du répertoire racine dans lequel les projets SikuliX / TestComplete sont stockés sur le robot EEM |
Accès à distance à l’EEM | En général, l'exécution des projets s'effectue 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 outils 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 enjeu, les tests peuvent être configurés pour s’exécuter au sein d’une session de bureau à distance Windows (RDP). Cela permet de verrouiller l’écran de la console. Les utilisateurs seront déconnectés lorsque les tests seront lancés. Si une authentification au niveau du réseau est requise, le périphérique 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 « Infos sur le projet EEM » de l'objet de l'appareil pour plus de détails |
Déconnexion RDP | Afin de gagner du temps entre les mesures, les sessions RDP ne sont pas déconnectées après l'exécution d'une tâche du projet. Si une déconnexion est nécessaire pour une raison quelconque, cette propriété peut être définie en conséquence |
Tâches de projet EEM
Pour la configuration des tâches de projet EEM, veuillez consulter les sous-pages spécifiques à SKOOR Robot et SmartBear.
Résultats du projet EEM
Les résultats des mesures sont présentés dans les tâches de projet EEM et les tâches planifiées, ainsi que dans le navigateur de résultats EEM.
File d’attente des projets EEM
Le SKOOR Engine Collector planifie automatiquement les tâches du projet EEM en fonction de l’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 Scheduler veille à ce que cet intervalle soit respecté. S'il existe plusieurs tâches du projet EEM sur un périphérique EEM et que le Scheduler 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 disposer d’un collecteur par défaut défini dans sa configuration
Au moins une tâche de projet EEM doit exister sur le périphérique 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 des projets EEM
Le développement de projets de test nécessite l’installation du logiciel TestComplete ou SikuliX. Le développement s’effectue généralement sur des hôtes différents de ceux où les tests sont réellement exécutés. Sur les hôtes d’exécution des tests, 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 consistant à créer un fichier zip du répertoire du projet en cours sur l’hôte de développement, à le transférer vers 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 l’hôte de développement
Assurez-vous que, de leur côté, tous les hôtes des robots EEM ont cette propriété définie sur « TestExecute » ou « SikuliX »
Sur l’hôte de développement, créez un nouveau projet EEM ou modifiez-en un existant. Enregistrez le projet et fermez l’IDE correspondant.
Sous le périphérique de développement dans l’interface utilisateur de SKOOR Engine, sur le projet EEM qui doit être distribué aux périphériques hôtes des robots EEM, sélectionnez « Distribuer vers le référentiel de test » dans la liste déroulante « Exécuter/Distribuer » de la section « Exécution de la tâche » de la tâche :
Si vous choisissez « Exécuter le job de mesure », cela se contentera d’exécuter le projet EEM.
Cliquez sur « OK » pour enregistrer la tâche
Ouvrez la nouvelle tâche à l’aide de la loupe et cliquez sur « Distribuer »
La section « Valeurs » devrait désormais afficher « Suite distribuée avec succès » :
Le répertoire compressé de la suite de projets sera désormais placé dans le répertoire /opt/eranger/collector/eem_repository/from_development/test du collecteur SKOOR Collector sur lequel la tâche du projet EEM est configurée
L’archive sera synchronisée vers le répertoire /opt/eranger/collecteur/eem_repository/to_execute/test, ce qui la rendra disponible pour la mise à jour automatique.
Sur le robot EEM, accédez à la tâche EEM Project correspondante et cochez la case « Mise à jour automatique de la suite ». Sélectionnez ensuite le référentiel « Test » dans la liste qui s’affiche :
Lancez « Vérifier maintenant » sur la tâche du projet EEM. Cela permettra tout 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 c’est le cas, il les transférera vers le robot EEM, en remplaçant l’ancien répertoire de la suite de projets. Il exécutera ensuite le test et renverra ses résultats
S’il s’avère que le test s’exécute correctement sur l’hôte TestExecute associé au référentiel de test, vous pouvez commencer à distribuer le projet vers le 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 par SKOOR Engine 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 le SKOOR Engine, sur lequel les tâches du projet EEM sont configurées, dispose d’un accès authentifié par clé publique via SSH aux SKOOR Engine Collectors sur lesquels s’exécutent les tâches du projet EEM. SKOOR Engine récupère toutes les archives de projets compressées depuis tous les collecteurs SKOOR Engine, puis les distribue vers les répertoires de référentiels de tous les collecteurs.