top of page
Aide en ligne SCAPIN

É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

GUI Param StopOnError.png

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

GUI Param Handle.png

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

GUI Param Pattern.png

Pattern d'expression régulière permettant d'identifier la portion de texte. Ce paramètre est obligatoire.

GUI Param Modifier.png

Les modificateurs de l'expression régulière

GUI Param Occurences.png

Variable de récupération du nombre d'occurrences renvoyé

GetText

Instruction d'action pour récupérer le libellé du bouton

Paramètres

GUI Param Text Bag.png

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

GUI Param Required ExpectedText.png

Libellé attendu du bouton ou une portion du libellé selon la valeur du 2ème paramètre.

GUI Param Exact.png

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

GUI Param Expected state.png

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

GUI Param Expected state.png

TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE

Button

É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

GUI Param Required State.png

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

GUI Param Required Expected State.png

É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

GUI Param Expected state.png

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

GUI Param Required set state.png

TRUE pour cocher, FALSE pour décocher.

Checkbox
GUI Combobox.png

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

GUI Param Count Options.png

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

GUI Param Has Count Options.png

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

GUI Param By.png

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>)

GUI Param ByData.png

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

GUI Param Expected state.png

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

GUI Param Expected state.png

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

GUI Param SelectByIndex.png

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

GUI Param SelectByName.png

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

GUI Param SelectByValue.png

Tout ou partie de la valeur interne de l'option. Peut être une expression régulière.

Combobox
GUI Input.png

É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

GUI Param InputText.png

Texte à saisir

GUI Param InputText Click before.png

Si TRUE exécute un clic dans la zone de saisie avant d'y mettre le texte. La valeur par défaut est TRUE

GUI Param InputText Erase before.png

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

GUI Param Expected state.png

TRUE si l'état attendu est l'état activé, FALSE dans le cas contraire. La valeur par défaut est TRUE

Input
GUI Link.png

Élément graphique lien hypertexte

Les instructions

Click

Instruction d'action d'un clic souris sur le lien hypertexte

Paramètres

GUI Param StopOnError.png

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

GUI Param Handle.png

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

GUI Param Expected state.png

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

GUI Param Expected state.png

TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE

Link
GUI StaticText.png

É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

GUI Param Pattern.png

Pattern d'expression régulière permettant d'identifier la portion de texte. Ce paramètre est obligatoire.

GUI Param Modifier.png

Les modificateurs de l'expression régulière

GUI Param Occurences.png

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

GUI Param Text Bag.png

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

GUI Param Required ExpectedText.png

Totalité ou portion du contenu textuel attendu selon la valeur du 2ème paramètre.

GUI Param Exact.png

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

GUI Param Expected state.png

TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE

StaticText
GUI Download.png

É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

GUI Param Download.png

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

GUI Param Expected state.png

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

GUI Param Expected state.png

TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE

Download
GUI Upload.png

É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

GUI Param Filename.png

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

GUI Param Expected state.png

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

GUI Param Expected state.png

TRUE si l'état attendu est l'état visible, FALSE dans le cas contraire. La valeur par défaut est TRUE

Upload

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.

Browser
ACC - Browser.png

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

ACC-B-GetTitle.png

Variable de réception du titre de la page web.

GoToUrl

Instruction d'action pour naviguer à l'url de destination

Paramètres

ACC-B-GoToUrl.png

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

ACC-B-HasTitle.png

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

ACC-B-Browser.png

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.

ACC-B-GoToUrl.png

URL de destination

GUI Param Handle.png

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

ACC-B-GoToUrl.png

URL de destination

GUI Param Handle.png

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

ACC-B-Switch.png

Identifiant de l'onglet de destination.

Caculator
ACC - Calculator.png

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

ACC-C-Expression.png

Expression mathématique à calculer.

ACC-C-Result.png

Variable de réception du résultat

Dataset
ACC - Dataset.png

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

ACC-D-Config.png

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

ACC-D-AddRow1.png

Valeur de la 1ère colonne

ACC-D-AddRow2.png

Valeur de la 2ème colonne

ACC-D-AddRow3.png

Valeur de la 3ème colonne

ACC-D-AddRow4.png

Valeur de la 4ème colonne

ACC-D-AddRow5.png

Valeur de la 5ème colonne

ACC-D-AddRow6.png

Valeur de la 6ème colonne

ACC-D-AddRow7.png

Valeur de la 7ème colonne

ACC-D-AddRow8.png

Valeur de la 8ème colonne

ACC-D-AddRow9.png

Valeur de la 9ème colonne

ACC-D-AddRow10.png

Valeur de la 10ème colonne

DeleteRow

Instruction d'action pour supprimer une ligne du tableau de données

Paramètres

ACC-B-Switch.png

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

ACC-B-Switch.png

Identifiant à contrôler

ACC-D-DeleteRow.png

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

ACC-B-Switch.png

Identifiant de la ligne

ACC-D-GetDataRowColonne.png

Nom de la colonne tel qu'il est donné par le paramètre configuration 

ACC-D-GetDataRowVariable.png

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

ACC-D-GetRowHandle.png

Variable de récupération de l'identifiant de la ligne trouvée

ACC-D-AddRow1.png

Filtre sur la 1ère colonne

ACC-D-AddRow2.png

Filtre sur la 2ème colonne

ACC-D-AddRow3.png

Filtre sur la 3ème colonne

ACC-D-AddRow4.png

Filtre sur la 4ème colonne

ACC-D-AddRow5.png

Filtre sur la 5ème colonne

ACC-D-AddRow6.png

Filtre sur la 6ème colonne

ACC-D-AddRow7.png

Filtre sur la 7ème colonne

ACC-D-AddRow8.png

Filtre sur la 8ème colonne

ACC-D-AddRow9.png

Filtre sur la 9ème colonne

ACC-D-AddRow10.png

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

ACC-B-Switch.png

Identifiant de la ligne

ACC-D-GetDataRowColonne.png

Nom de la colonne tel qu'il est donné par le paramètre configuration 

ACC-D-UpdateRow.png

Nouveau contenu de la cellule.

ACC - WaitService.png

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

ACC-W-Durée.png

Durée de suspension exprimée en millisecondes.

Wait Service
  • LinkedIn
bottom of page