Éléments graphiques et Accessoires
Dans SCAPIN, le déroulé d'un test est une suite d'étapes de test, lesquelles sont des interactions avec des éléments graphiques présents sur des écrans ou des interactions avec des accessoires. Que sont précisément ces éléments graphiques et ces accessoires ? Comment sont-ils constitués ? Sur quels principes reposent-ils ? Quels mécanismes sont mis en œuvre pour l'exécution automatique des tests ? C'est à ces questions que répond cette documentation
Théorie des Éléments graphiques et des Accessoires
Lorsque, dans le magasin des écrans vous procédez à l'identification des éléments d'interaction présents sur un écran, vous précisez pour chacun d'eux de quel type d'élément il s'agit. Par exemple vous affectez le type bouton à l'élément Login tandis que pour l'élément Username vous indiquez qu'il s'agit d'une zone de saisie. Préciser le type d'un élément n'est pas anodin. En l’occurrence cela signifie que l'élément Login dispose d'un jeu d'instructions qui est différent de celui de Username.
En effet, parce que c'est un élément de type Button, l'instruction Clic existe pour Login alors qu'elle n'existe pas pour Username. De même, parce que c'est un élément de type Input, l'instruction InputText existe pour Username alors qu'elle n'existe pas pour Login.
La même logique interne s'applique aux accessoires. Lorsque, dans le magasin des accessoires, vous créez un nouvel accessoire, vous choisissez dans une liste déroulante le type d'accessoire que vous créez. Vous allez par exemple créer l'accessoire "Mon navigateur" et sélectionner le type d'accessoire Browser
En associant l'accessoire que vous venez de créer au type d'accessoire Browser votre accessoire dispose d'un jeu complet d'instructions pour interagir avec un navigateur web tel que Chrome ou Firefox. Ces instructions vont vous permettre de créer des étapes de test au cours desquelles vous allez lancer le navigateur, aller sur une page, ouvrir une page dans un nouvel onglet, aller d'un onglet à l'autre, revenir en arrière, etc. et bien sûr fermer le navigateur à la fin de votre test.
Liste des types standards d'éléments graphiques
SCAPIN dispose en standard d'une collection de types d'éléments graphiques. KOGEET travaille à enrichir et améliorer cette collection en réponse aux suggestions qui lui sont remontées.
Notez que cette collection peut être complétée d'éléments graphiques créés par vous pour répondre aux besoins spécifiques de votre entreprise. Sur ce sujet consultez l'aide en ligne Scapin Forge
Élément graphique ayant un aspect et la fonction d'un bouton sur lequel l'utilisateur peut cliquer.
Les instructions
Click
Instruction d'action d'un clic souris sur le bouton.
Paramètres
TRUE : Interrompt le test en cas d'erreur. La valeur par défaut est FALSE
ClickAndOpen
Instruction d'action à utiliser quand le clic souris ouvre un nouvel onglet du navigateur et que l'on veux naviguer dans ce nouvel onglet. Le paramètre Handle sert à y accéder dans une étape suivante.
Paramètres
Identifiant de l'onglet qui vient d'être crée. Pour basculer sur cet onglet une étape supplémentaire est nécessaire qui met en œuvre l'instruction SwitchTo de l'accessoire Browser.
FindText
Instruction de vérification de la présence d'une portion de texte dans le libellé du bouton. Cette instruction nécessite de connaitre les expressions régulières et leur usage.
L'étape de test est Pass si l'expression régulière matche au moins une occurrence et Fail dans le cas contraire.
Paramètres
Pattern d'expression régulière permettant d'identifier la portion de texte. Ce paramètre est obligatoire.
Les modificateurs de l'expression régulière
Variable de récupération du nombre d'occurrences renvoyé
GetText
Instruction d'action pour récupérer le libellé du bouton
Paramètres
Variable de récupération du libellé du bouton
HasText
Instruction de vérification du libellé du bouton. Cette instruction est une version simplifiée de FindText puisqu'elle n'utilise pas les expressions régulières.
L'étape de test est Pass si le libellé du bouton est celui attendu, Fail dans le cas contraire
Paramètres
Libellé attendu du bouton ou une portion du libellé selon la valeur du 2ème paramètre.
TRUE si le libellé du bouton est le texte attendu, FALSE si le texte attendu est une portion du libellé. La valeur par défaut est TRUE.
IsEnabled
Instruction de vérification de l'état activé ou déactivé du bouton.
L'étape de test est Pass si l'état du bouton est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état activé, FALSE dans le cas contraire. La valeur par défaut est TRUE
IsVisible
Instruction de vérification de l'état visible ou non du bouton. Dans le cas ou le bouton existe mais n'est pas visible, la réponse est immédiate. Ce n'est pas le cas si le bouton n'existe pas à cause d'un timeout.
L'étape de test est Pass si l'état du bouton est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE
Élément graphique ayant un aspect et la fonction d'une case à cocher.
Les instructions
GetState
Instruction d'action pour récupérer l'état coché ou non de la case
Paramètres
Variable de récupération de l'état de la cas à cocher
HasState
Instruction de vérification de l'état de la case à cocher
L'étape de test est Pass si la case à cocher est dans l'état attendu, Fail dans le cas contraire.
Paramètres
État attendu de la cas à cocher. TRUE si elle est cochée, FALSE dans le cas contraire
IsEnabled
Instruction de vérification de l'état activé ou déactivé de la case à cocher.
L'étape de test est Pass si l'état activé de la case à cocher est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état activé, FALSE dans le cas contraire. La valeur par défaut est TRUE
SetState
Instruction d'action pour cocher ou décocher une case
Paramètres
TRUE pour cocher, FALSE pour décocher.
Liste déroulante construite avec la balises HTML <SELECT> et <OPTION>. Les options sont les choix proposés par la liste déroulante.
Les instructions
CountOptions
Instruction d'action pour récupérer le nombre d'options de la liste déroulante
Paramètres
Variable de récupération du nombre d'options
HasCountOptions
Instruction de vérification du nombre d'options.
L'étape de test est Pass si la liste déroulante a le nombre d'option attendu, Fail dans le cas contraire.
Paramètres
Nombre d'options attendus
HasOption
Instruction de vérification de la présence d'une option dans la liste déroulante
L'étape de test est Pass si l'option attendue est présente, Fail dans le cas contraire.
Paramètres
Mode de localisation de l'option. Ce paramètre admet les 2 valeurs suivantes qui déterminent la valeur du 2ème paramètre :
-
name : l'option est localisée par son texte tel qu'il apparait à l'utilisateur
-
value : l'option est localisée par sa valeur interne non visible de l'utilisateur (celle de l'attribut value de la balise <option>)
Valeur attendue selon le mode du 1er paramètre
IsEnabled
Instruction de vérification de l'état activé ou déactivé de la liste déroulante.
L'étape de test est Pass si l'état de la liste déroulante est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état activé, FALSE dans le cas contraire. La valeur par défaut est TRUE
IsVisible
Instruction de vérification de l'état visible ou non de la liste déroulante. Dans le cas ou la liste existe mais n'est pas visible, la réponse est immédiate. Ce n'est pas le cas si la liste n'existe pas à cause d'un timeout.
L'étape de test est Pass si l'état de la liste déroulante est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE
SelectByIndex
Instruction d'action pour sélectionner l'option par son rang dans la liste déroulante.
Paramètres
Position dans liste déroulante. 0 pour le 1er choix, 1 pour le 2ème, etc.
SelectByName
Instruction d'action pour sélectionner l'option par son nom tel qu'il est affiché et visible par l'utilisateur.
Paramètres
Tout ou partie du libellé de l'option affichée. Peut être une expression régulière.
SelectByValue
Instruction d'action pour sélectionner l'option par sa valeur interne, c'est-à-dire par la valeur de l'attribut value de la balise <option>
Paramètres
Tout ou partie de la valeur interne de l'option. Peut être une expression régulière.
Élément graphique zone de saisie de texte
Les instructions
InputText
Instruction d'action pour la saisie d'un texte dans la zone de saisie
Paramètres
Texte à saisir
Si TRUE exécute un clic dans la zone de saisie avant d'y mettre le texte. La valeur par défaut est TRUE
Si TRUE supprime le texte présent dans la zone de saisie avant d'y mettre le nouveau texte. La valeur par défaut est FALSE
IsEnabled
Instruction de vérification de l'état activé ou déactivé de la zone de saisie.
L'étape de test est Pass si l'état de la zone de saisie est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état activé, FALSE dans le cas contraire. La valeur par défaut est TRUE
Élément graphique lien hypertexte
Les instructions
Click
Instruction d'action d'un clic souris sur le lien hypertexte
Paramètres
TRUE : Interrompt le test en cas d'erreur. La valeur par défaut est FALSE
ClickAndOpen
Instruction d'action à utiliser quand le clic souris ouvre un nouvel onglet du navigateur et que l'on veux naviguer dans ce nouvel onglet. Le paramètre Handle sert à y accéder dans une étape suivante.
Paramètres
Identifiant de l'onglet qui vient d'être crée. Pour basculer sur cet onglet une étape supplémentaire est nécessaire qui met en œuvre l'instruction SwitchTo de l'accessoire Browser.
IsEnabled
Instruction de vérification de l'état activé ou déactivé du lien hypertexte.
L'étape de test est Pass si l'état du lien hypertexte est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état activé, FALSE dans le cas contraire. La valeur par défaut est TRUE
IsVisible
Instruction de vérification de l'état visible ou non du lien hypertexte. Dans le cas ou le lien existe mais n'est pas visible, la réponse est immédiate. Ce n'est pas le cas si le lien n'existe pas à cause d'un timeout.
L'étape de test est Pass si l'état du lien hypertexte est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE
Élément graphique textuel.
Les instructions
FindText
Instruction de vérification de la présence d'une portion de texte de l'élément graphique textuel. Cette instruction nécessite de connaitre les expressions régulières et leur usage.
L'étape de test est Pass si l'expression régulière matche au moins une occurrence et Fail dans le cas contraire.
Paramètres
Pattern d'expression régulière permettant d'identifier la portion de texte. Ce paramètre est obligatoire.
Les modificateurs de l'expression régulière
Variable de récupération du nombre d'occurrences renvoyé
GetText
Instruction d'action pour récupérer le contenu textuel de l'élément graphique.
Paramètres
Variable de récupération du texte
HasText
Instruction de vérification contenu textuel de l'élément graphique. Cette instruction est une version simplifiée de FindText puisqu'elle n'utilise pas les expressions régulières.
L'étape de test est Pass si le libellé du bouton est celui attendu, Fail dans le cas contraire
Paramètres
Totalité ou portion du contenu textuel attendu selon la valeur du 2ème paramètre.
TRUE si le texte attendu et la totalité du contenu textuel, FALSE si le texte attendu n'est qu'une portion de ce contenu. La valeur par défaut est TRUE.
IsVisible
Instruction de vérification de l'état visible ou non de l'élément textuel. Dans le cas ou cet élément existe mais n'est pas visible, la réponse est immédiate. Ce n'est pas le cas si l'élément n'existe pas à cause d'un timeout.
L'étape de test est Pass si l'état de l'élément textuel est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE
Élément graphique ayant la fonction de télécharger un document.
Les instructions
DownloadFile
Instruction d'action pour télécharger un document
Paramètres
Chemin du répertoire dans lequel le document est téléchargé. A défaut le document est téléchargé dans le dossier de téléchargement système.
IsEnabled
Instruction de vérification de l'état activé ou déactivé de l'élément graphique.
L'étape de test est Pass si l'état de l'élément est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état activé, FALSE dans le cas contraire. La valeur par défaut est TRUE
IsVisible
Instruction de vérification de l'état visible ou non de l'élément graphique. Dans le cas ou l'élément existe mais n'est pas visible, la réponse est immédiate. Ce n'est pas le cas si l'élément n'existe pas à cause d'un timeout.
L'étape de test est Pass si l'état du lien hypertexte est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE
Élément graphique ayant la fonction de téléverser un document.
Les instructions
UploadFile
Instruction d'action pour télécharger un document
Paramètres
Nom du document à téléverser
IsEnabled
Instruction de vérification de l'état activé ou déactivé de l'élément graphique.
L'étape de test est Pass si l'état de l'élément est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état activé, FALSE dans le cas contraire. La valeur par défaut est TRUE
IsVisible
Instruction de vérification de l'état visible ou non de l'élément graphique. Dans le cas ou l'élément existe mais n'est pas visible, la réponse est immédiate. Ce n'est pas le cas si l'élément n'existe pas à cause d'un timeout.
L'étape de test est Pass si l'état du lien hypertexte est celui attendu, Fail dans le cas contraire.
Paramètres
TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE
Liste des types standards d'accessoires
SCAPIN dispose en standard d'une collection de types d'accessoires. KOGEET travaille à enrichir et améliorer cette collection en réponse aux suggestions qui lui sont remontées.
Notez que cette collection peut être complétée par des accessoires créés par vous pour répondre aux besoins spécifiques de votre entreprise. Sur ce sujet consultez l'aide en ligne Scapin Forge
Certains accessoires sont configurables pour leur permettre de s'adapter à des contextes d'utilisation différents.
Accessoire d'interaction avec un navigateur web
Configuration
Cet accessoire n'a pas de paramètres de configuration
Les instructions
Back
Instruction d'action qui actionne la commande de recul d'une page
Cette instruction n'a pas de paramètres
Forward
Instruction d'action qui actionne la commande d'avance d'une page
Cette instruction n'a pas de paramètres
GetTitle
Instruction d'action pour récupérer le titre de la page de l'onglet courant
Paramètres
Variable de réception du titre de la page web.
GoToUrl
Instruction d'action pour naviguer à l'url de destination
Paramètres
URL de destination
HasTitle
Instruction de vérification du titre de la page web
L'étape de test est Pass si le titre est celui attendu, Fail dans le cas contraire.
Paramètres
Texte complet et strictement identique au titre de la page web
LaunchToUrl
Instruction d'action pour démarrer le navigateur et naviguer à l'url de destination
Paramètres
Navigateur à utiliser. A choisir parmi les noms proposés : chrome pour lancer le navigateur Google Chrome, firefox pour le navigateur de Mozilla, msedge pour celui de Microsoft.
URL de destination
Variable de récupération de l'identifiant de l'onglet courant
OpenTabToUrl
Instruction d'action pour ouvrir un nouvel onglet et naviguer à une URL de destination
Paramètres
URL de destination
Variable de récupération de l'identifiant de l'onglet courant
Quit
Instruction d'action pour fermer le navigateur.
Cette instruction n'a pas de paramètres
Refresh
Instruction d'action qui actionne la commande de rechargement de la page
Cette instruction n'a pas de paramètres
SwitchTo
Instruction d'action pour basculer d'un onglet à un autre
Paramètres
Identifiant de l'onglet de destination.
Accessoire pour effectuer les opérations mathématiques supportées par le paramètre de type Number Expression En savoir plus sur le type Number
Configuration
Cet accessoire n'a pas de paramètres de configuration
Les instructions
Calculator
Instruction d'action pour exécuter un calcul mathématique
Paramètres
Expression mathématique à calculer.
Variable de réception du résultat
Accessoire pour interagir avec un tableau de données de test. Les interactions possibles sont l'ajout de données, leur récupération, leur modification et leur suppression. Pour en savoir plus sur la création, l'utilisation et la gestion des données de test dans Scapin consultez la documentation Datasets
Configuration
Noms des colonnes du tableau de données. Ces noms de colonnes doivent être séparés par le caractère barre verticale (|). Ce caractère peut être précédé et suivi d'un espace pour améliorer la lisibilité.
Les instructions
AddRow
Instruction d'action pour ajouter une ligne à la fin du tableau de données
Paramètres
Valeur de la 1ère colonne
Valeur de la 2ème colonne
Valeur de la 3ème colonne
Valeur de la 4ème colonne
Valeur de la 5ème colonne
Valeur de la 6ème colonne
Valeur de la 7ème colonne
Valeur de la 8ème colonne
Valeur de la 9ème colonne
Valeur de la 10ème colonne
DeleteRow
Instruction d'action pour supprimer une ligne du tableau de données
Paramètres
Identifiant de la ligne à supprimer
ExistRow
Instruction de contrôle de la validité de l'identifiant d'une ligne du tableau de données.
L'étape de test est Pass selon l'état attendu de l'identifiant , Fail dans le cas contraire.
Paramètres
Identifiant à contrôler
TRUE si l'état attendu est que l'identifiant existe et est valide, FALSE si l'état attendu est que l'identifiant n'existe pas. La valeur par défaut est TRUE
GetRowData
Instruction d'action pour récupérer le contenu de la cellule du tableau de données à l'intersection de la ligne visée par le 1er paramètre et de la colonne visée par le 2ème paramètre.
Paramètres
Identifiant de la ligne
Nom de la colonne tel qu'il est donné par le paramètre configuration
Variable de réception du contenu de la cellule du tableau
GetRowHandle
Instruction d'action pour récupérer l'identifiant d'une ligne du tableau de données. L'identifiant récupéré est celui de la 1ère ligne du tableau filtré par les paramètres Data1 à Data10. Si aucun filtre n'est donné, c'est l'identifiant de la 1ère ligne du tableau qui est récupéré.
Paramètres
Variable de récupération de l'identifiant de la ligne trouvée
Filtre sur la 1ère colonne
Filtre sur la 2ème colonne
Filtre sur la 3ème colonne
Filtre sur la 4ème colonne
Filtre sur la 5ème colonne
Filtre sur la 6ème colonne
Filtre sur la 7ème colonne
Filtre sur la 8ème colonne
Filtre sur la 9ème colonne
Filtre sur la 10ème colonne
UpdateRow
Instruction d'action pour modifier le contenu de la cellule du tableau de données à l'intersection de la ligne visée par le 1er paramètre et de la colonne visée par le 2ème paramètre. Si le paramètre data est omis, le contenu de la cellule est effacé.
Paramètres
Identifiant de la ligne
Nom de la colonne tel qu'il est donné par le paramètre configuration
Nouveau contenu de la cellule.
Accessoire pour suspendre temporairement l'exécution du test
Configuration
Durée par défaut exprimée en millisecondes
Les instructions
Sleep
Instruction d'action pour suspendre l'exécution du test pour une durée donné par le paramètre
Paramètres
Durée de suspension exprimée en millisecondes.
