DocumentationProjets SmartBear
Configuration de l'appareil
Pour la configuration générale des appareils, rendez-vous sur Projet EEM avec tâches EEM Timer
Exemple de configuration d'un appareil SmartBear
Dans l'exemple suivant, les paramètres d'un appareil ont été définis pour les tests SmartBear, comme décrit dans la section Informations sur le projet EEM :
Détails de la tâche du projet EEM
Paramètres du projet SmartBear :
Paramètres du projet EEM
Paramètre | Description |
|---|---|
Nom de la suite | Un projet TestComplete comprend au moins une suite de projets et un projet au sein de cette suite. S'il n'y a qu'un seul projet, seul le nom de la suite de projets doit être renseigné. Sinon, indiquez à la fois le nom de la suite et celui du projet. Une fois ce champ renseigné, le champ Arguments est automatiquement rempli avec les arguments de ligne de commande par défaut à joindre à la commande TestComplete ou TestExecute. |
Nom du projet | Nom du projet TestComplete. Ce champ ne doit être rempli que si la suite de projets contient plusieurs projets. |
Mode de test VPN | Cochez cette case uniquement dans le cas particulier où le projet à exécuter initie lui-même des connexions VPN à une passerelle VPN pendant l'exécution du projet. Cela entraînerait une perte temporaire de connexion entre SKOOR Engine et l'hôte du robot. Bien entendu, le projet lui-même devra inclure la fermeture de ces connexions VPN, sinon SKOOR Engine ne pourra jamais récupérer les résultats. Si cette case est cochée, SKOOR Engine n'attendra pas le statut de sortie de l'exécution du projet et n'essaiera de récupérer les résultats de l'exécution du projet qu'après avoir attendu le temps spécifié dans Limite de temps d'exécution. |
Limite de temps d'exécution | Spécifiez la durée autorisée pour l'exécution du projet. Cela dépend de ce que fait le projet. Ce paramètre est facultatif, sauf si le mode de test VPN est également 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 interrompu. Dans ce cas, aucun journal MHT ne sera généré ni récupéré (ce qui entraînera un Warning). |
Délai d'expiration du robot | Paramètre de délai d'expiration interne facultatif (défini sur 0 s pour le désactiver). Ce paramètre n'est utile que si la valeur est inférieure au paramètre Limite de temps d'exécution. |
Capturer la vidéo | Si la capture vidéo est activée, l'ensemble du test peut être visionné à partir de la page de résultats de l'SKOOR Engine en cas d'échec des tests. Cela peut être très utile pour trouver et corriger les erreurs dans le projet. Les tests qui se terminent avec un état OK ne sont pas transférés vers le server afin d'éviter une charge réseau et une consommation de stockage inutiles. |
Mise à jour automatique de la suite | Cochez cette case si vous souhaitez que les fichiers de projet les plus récents soient récupérés à partir du référentiel de projets SKOOR Engine. |
Référentiel | Sélectionnez l'un des deux référentiels de projet, Production ou Test, à partir duquel extraire les fichiers du projet. Ce paramètre n'est visible que si la propriété du périphérique EEM Mode d'exécution EEM est définie sur TestExecute et que la case Mise à jour automatique de la suite est cochée. |
Trier les tâches planifiées | Choisissez entre Par nom, Par état, Par durée d'exécution ou Par heure de début pour trier automatiquement les tâches planifiées, ou Manuel pour les trier à l'aide des boutons haut et bas dans la section Tâches planifiées EEM liées. |
Veuillez noter que la capture vidéo peut entraîner une charge CPU élevée sur le système SKOOR Engine.
La section Tâches de minuterie EEM liées indique quelles minuteries EEM ont été ajoutées à cette tâche de projet EEM. Aucune tâche de minuterie n'a encore été ajoutée dans la figure ci-dessus.
Paramètres du protocole RDP (Remote Desktop Protocol) pour les mesures
Le protocole RDP doit être configuré sur l'appareil qui contient la tâche du projet EEM afin d'éviter des paramètres redondants pour chaque tâche. Cependant, si une tâche nécessite des paramètres différents, les paramètres de l'appareil peuvent être remplacés par les paramètres configurés dans la tâche :
Paramètre | Description |
|---|---|
Domaine | Domaine auquel appartient l'utilisateur. Si l'utilisateur est un utilisateur Windows local, le nom d'hôte des PC EEM doit être configuré comme domaine. |
Nom d'utilisateur | Nom de l'utilisateur connecté. |
Mot | Mot de passe de l'utilisateur |
Résolution d'écran | Dans le cas de tests basés sur des images, la résolution d'écran est importante. La même résolution doit être configurée que celle utilisée sur le système où le projet a été développé. La résolution par défaut est 1920x1200 |
Facultatif | D'autres paramètres de l'utilitaire rdesktop ou FreeRDP peuvent être configurés ici si nécessaire |
Déconnexion de la session | Déconnectez-vous de la session RDP après l'exécution du projet. |
Veuillez noter que la capture vidéo peut entraîner une charge CPU élevée sur le système SKOOR Engine
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.
Ajout de tâches planifiées
Les tâches planifiées représentent les mesures à afficher dans le SKOOR Engine ou le SKOOR Dashboard. Un projet peut comporter plusieurs tâches planifiées, telles que la durée totale de toutes les mesures, la connexion à une application et d'autres cas d'utilisation. Les minuteries doivent être configurées/programmées dans le projet. Si le projet de test est disponible dans l'un des référentiels du SKOOR Engine ou sur le robot EEM dans le répertoire des scripts configurés, le SKOOR Engine tentera d'extraire les minuteries du projet et de les configurer automatiquement.
Dans la fenêtre d'édition d'une tâche de projet EEM, cliquez sur Ajouter des tâches de minuterie :
L'écran suivant apparaît et documente les minuteries trouvées et les actions effectuées :
Les minuteries ont été configurées sous la tâche du projet EEM :
À l'aide des touches haut et bas, elles peuvent désormais être classées selon les besoins.
Ajouter manuellement des tâches de minuterie
Si des tâches programmées doivent être créées avant que le projet EEM ne soit disponible sur le SKOOR Engine et les PC robots, elles peuvent également être ajoutées manuellement. Cliquez sur le nom des tâches du projet EEM pour accéder à la tâche du projet et ajoutez la minuterie à l'aide du menu de fonctions ou de l'icône en forme d'engrenage :
Ensuite, le nom du minuteur doit être configuré exactement comme défini dans le projet. L'écran suivant montre un minuteur appelé totalTime :
Paramètres de la minuterie EEM
Paramètre | Description |
|---|---|
Nom de la minuterie | Seuls le nom de la tâche et le nom du minuteur peuvent être configurés sur une tâche de minuteur EEM. Le nom de la tâche peut être différent du nom du minuteur, mais le nom du minuteur doit correspondre au nom du minuteur tel qu'il est écrit dans le fichier du minuteur. |
Valeurs du minuteur EEM et limites d'alarme
Valeur / Limite d'alarme | Description |
|---|---|
Durée d'exécution | Durée d'exécution de cette minuterie EEM particulière |
Code de résultat | 0 = |
Erreur connue | La limite d'alarme d'erreur connue n'est disponible que pour les tâches de minuterie EEM et vérifie si une chaîne différente des chaînes habituelles OK, FAILED ou NOTRUN a été renvoyée dans le fichier de minuterie. L'alarme est déclenchée lors de la détection d'une chaîne, et non en fonction de son contenu. |
Code d'erreur | Code d'erreur générique de tâche (voir la section Codes d'erreur de tâche) |
Détails du minuteur EEM
Les minuteries sont introduites dans un projet pour mesurer le résultat (OK/Failed/NotRun) et le temps nécessaire à l'exécution d'une section spécifique d'un test. Pendant l'exécution, les minuteries sont écrites dans un fichier texte dans le répertoire du projet. Le fichier est structuré de la manière suivante :
========== 2017.11.30-12.43 ================= Name;Status;Time ---------------- Calc_Open;OK;6.26 Calc_Calculate;OK;1.69 Total;OK;8.47
Pour chaque minuterie, le nom de la tâche SKOOR Engine EEM Timer, le nom réel de la minuterie, son état actuel et le temps en secondes nécessaire à l'exécution de la minuterie correspondante lors de la dernière exécution sont imprimés.
Il est également possible de demander au projet d'écrire une chaîne d'erreur spécifique dans le fichier du minuteur, qui sera ensuite analysée comme une valeur de chaîne. Cela est utile lorsqu'un projet rencontre des erreurs fréquentes et connues, mais qui ne peuvent être corrigées dans l'application ou le site web testé. Dans ce cas, la reconnaissance de l'erreur doit être programmée dans la séquence du projet et une chaîne d'erreur spécifique doit être écrite dans le fichier du minuteur pour le minuteur spécifique. Un exemple d'un tel fichier de minuteur est présenté ci-dessous :
========== 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
La deuxième colonne de la ligne Calc_Calculate est interprétée comme une erreur connue au niveau de la tâche de minuterie EEM.
Ces erreurs connues peuvent ensuite être utilisées dans les configurations de limites d'alarme. Un exemple d'erreur connue rencontrée est présenté dans la figure suivante :
Et dans la section des valeurs de la tâche de minuterie EEM correspondante :
Le fichier de minuterie, dans ce cas calc.txt (son nom doit être identique au nom du projet), est récupéré via WinAgent et analysé pour les états et les valeurs de chaque minuterie. Mais cela ne se produit que si des minuteries avec les noms correspondants sont configurées.
Résultats du projet EEM
Après l'exécution du projet sur le robot EEM, la section des valeurs de la tâche du projet EEM se présente comme suit (diffère des projets SikuliX) :
ou en cas d'erreur pendant l'exécution du projet :
En cliquant sur le lien Fichier de minuterie, le fichier de minuterie récupéré peut être consulté directement (voir l'exemple de fichier ci-dessus).
En cliquant sur le lien à côté du fichier journal MHT, le journal récapitulatif MHT peut être téléchargé ou consulté directement. La consultation directe n'est possible que si le lien est cliqué à partir d'un navigateur Internet Explorer. Voici un exemple de journal MHT :
En cliquant sur le lien Fichiers de résultats dans la section Valeurs, la nouvelle fenêtre ou l'onglet suivant s'affiche dans le navigateur :
Cette page fournit un aperçu des tests qui ont été exécutés sur le robot EEM. Pour chaque exécution pour laquelle des journaux ont été collectés par SKOOR Engine, il y a une ligne avec un horodatage et un lien vers le fichier MHT correspondant. Si des erreurs se sont produites pendant une exécution, le lien est placé dans la colonne Tests ayant échoué, accompagné d'une petite icône sur laquelle vous pouvez cliquer et qui ouvre une nouvelle fenêtre de navigateur avec une capture d'écran de la première erreur rencontrée pendant l'exécution. Cela donne généralement une bonne idée de la raison pour laquelle un test a échoué. Si le test le plus récent a échoué, comme dans cet exemple, la capture d'écran est également affichée en grand dans la section « Dernier résultat » de cet aperçu. En cliquant sur le lien « Capture d'écran » dans la section « Valeur » du travail, vous ouvrez directement cette capture d'écran.
Exemple de projet EEM
Exécutez un projet EEM simple avec 3 minuteries EEM
La configuration suivante suppose que l'hôte distant dispose d'une suite de projets TestComplete appelée Calc, avec un projet appelé Calc en dessous. La sortie du projet contient 3 minuteries et est exécutée via WinAgent installé sur l'hôte distant. WinAgent doit être configuré pour permettre l'exécution du binaire testexecute.exe. Les minuteries sont ajoutées en tant que tâches de minuterie EEM individuelles sous la tâche du projet EEM.
Résultat
