1 - Introduction
2 - Liste des commandes de saisie de texte
Commande Exemple Description setTextByText Colle le texte donné dans l'élément qui contient le texte sélectionné. COMPATIBILITE : UNIVERSELLE setTextByDesc Colle le texte donné dans l'élément qui contient la description sélectionnée. COMPATIBILITE : UNIVERSELLE setTextByTextExact Colle le texte donné dans l'élément qui contient le texte sélectionné exact. COMPATIBILITE : UNIVERSELLE setTextById Colle le texte donné dans l'élément qui contient l’identifiant sélectionné. COMPATIBILITE : UNIVERSELLE enterText Saisit le texte donné dans le champ sélectionné en cliquant sur les touches du clavier pour chaque caractère. Le texte est saisi caractère par caractère à la fréquence donnée. FREQUENCE OPTIONNELLE COMPATIBILITE : UNIVERSELLE setTextLastElementFound Colle le texte donné dans le dernier élément trouvé. COMPATIBILITE : UNIVERSELLE enterTextFast Saisit le texte spécifié dans le paramètre. Saisir tout le texte en une seule fois. COMPATIBILITE : UNIVERSELLE Saisie de texte
setTextByText,[TEXTE],[TEXTE-SELECTEUR]setTextByDesc,[TEXTE],[DESC-SELECTEUR]setTextByText,[TEXTE],[TEXTE-EXACT-SELECTEUR]setTextById,[TEXTE],[ID-SELECTEUR]enterText,[TEXTE]enterText,[TEXTE],[FREQUENCE]setTextLastElementFound,[TEXTE]enterTextFast,[TEXTE]
3 - Cas d’usage
Cas d’usage 1 : Remplir un formulaire
Le formulaire de connexion de l'application Kwit contient un champ "Email" auquel on peut accéder avec son text et sa classe Android.
Attention, le texte au-dessus de "Sign in with your Email" contient également le texte "Email".
Pour sélectionner le champ du formulaire, il faut utiliser la commande clickByTextExact ou y accéder avec sa classe Android : android.widget.EditText.
Il est donc possible d'utiliser la fonction formClickOnEditText avec comme paramètre la position du champ de texte. Si aucun paramètre n'est fourni, le premier champ est sélectionné par défaut.
Il existe également la fonction formClickOnFirstEmptyEditText qui permet de sélectionner le premier champ de texte vide. Cette fonction n'est pas utile dans notre cas, car le champ "Email" est déjà pré-rempli.
Voici ce que vous obtenez après avoir saisi votre adresse électronique :
Puis pressTab pour accéder au champ suivant.
Exemple :
### Préparation rapide de l'appareil
applicationStart,fr.kwit.android
waitUntilText,Déjà un compte
# Clic sur l'élément "Déjà un compte"
clickByText,Déjà un compte
waitUntilText,Se connecter
# Clic sur l'élément "Autres méthodes de connexion"
clickByPercent,50,85
waitUntilText,Autres méthodes de connexion
# Clic sur l'élément "Email"
clickByPercent,50,92
waitUntilText,Se connecter avec votre Email
### Remplissage du formulaire
measureStart,ACTION_loginPage_remplissageForm
formClickOnEditText
enterText,test@gmail.com
pressTab
enterText,12345678
pause,${PAUSEAFTERLOAD}
measureStop
Cas d’usage 2 : Les champs ne sont pas accessibles via leur texte, leur identifiant ou leur description
Le site web https://www.sante.fr contient des champs qui ne sont pas accessibles par leur texte, leur description ou leur identifiant.
Cependant, les deux champs ont la classe Android suivante : android.widget.EditText.
Vous pouvez utiliser la fonction GDSL formClickOnFirstEmptyEditText qui clique sur le premier champ de texte vide.
Exemple :
### Préparation rapide de l'appareil
setBrowser,chrome
launchBrowser
browserClearCache
browserCloseAllTabs
browserNewTab
browserGoToUrl,https://www.sante.fr
pressEnter
# Acceptation des cookies
waitUntilText,Tout accepter
clickByText,Tout accepter
waitUntilText,L'information fiable
### Remplissage du formulaire
measureStart,ACTION_homePage_fillForm
formClickOnFirstEmptyEditText
enterText,pediatre
pressTab
enterText,Hauts-de-Seine
pause,${PAUSEAFTERLOAD}
measureStop
Après la fonction enterText, n'écrivez pas de caractères spéciaux ou accentués, car ils ne sont pas pris en compte.