Utiliser l’automatisation mobile pour les applications de banque mobile

Dans ce tutoriel, nous vous expliquons comment utiliser le package Automatisation mobile afin d’automatiser les tâches dans une application de banque mobile. Le tutoriel utilise le simulateur de opérations de banque mobile fourni par Bank of America, ainsi qu’un émulateur Google pixels de Sauce Labs. Nous nous concentrerons spécifiquement sur l’automatisation et le test des actions suivantes :

1. Se connecter à l’application.
2. Mettre en place un verrouillage de la carte de crédit.
3. Consulter une réclamation et effectuer une capture d’écran.

Le tutoriel fournit des instructions pour utiliser des activités et des API afin d’automatiser ces scénarios.

Prérequis

Afin d’utiliser l’appareil mobile et l’application souhaités, nous devons d’abord les créer comme suit dans le gestionnaire d’appareils mobiles :

1. Ajoutez un appareil Sauce Labs dans le gestionnaire d’appareils mobiles.

   Pour plus d’informations sur l’ajout d’appareils, consultez Ajouter un appareil Sauce Labs.

2. Ajoutez le simulateur des opérations de banque mobile de la Bank of America dans le gestionnaire d’appareils mobiles.

   Pour plus d’informations sur l’ajout d’applications, consultez la section Ajout d’applications.

Exemple de projet

Pour suivre les étapes et essayer vous-même le tutoriel, consultez l’exemple de projet suivant : Simulateur d’opérations de banque mobile.

Utiliser des activités

Dans cet exemple, nous utilisons les éléments du référentiel d’objets comme éléments d’IU d’entrée pour ces activités. Afin de créer des éléments d’IU pour appareils mobiles, établissez une connexion entre l’appareil cible et l’application dans le gestionnaire d’appareils mobiles. Ensuite, directement dans le panneau Référentiel d’objets, créez chaque élément et utilisez l’option Indiquer l’élément pour indiquer l’élément d’IU spécifique sur le périphérique du gestionnaire d’appareils mobiles.

Pour suivre le tutoriel sans difficulté, consultez la liste suivante relative à la structure Référentiel d’objets :

• Application BankOfAmerica, menu ÉcranMobile
  • backFromClaimDetails
  • backFromClaimStatus
  • BackToMenu
  • firstClaimSeeDetails
  • Lock
  • LockCard
  • Login
  • ManageDebitCredit
  • Menu
  • Mot de passe (Password)
  • swipeMenu
  • UserId
  • viewmyclaims

Astuce : vous pouvez également créer un workflow similaire en utilisant des actions enregistrées. Ce processus implique de créer une connexion entre votre appareil et l’application via le gestionnaire d’appareils mobiles, à exécuter une série d’actions sur cette connexion, puis à importer ces étapes dans une séquence. Pour plus d’informations, consultez la section Créer un workflow à l’aide d’actions enregistrées.

Étapes

1. Établissez une connexion entre l’appareil et l’application :
   1. Ajoutez une activité Connexion d’appareil mobile (Mobile Device Connection).
   2. Cliquez sur Sélectionner les détails de la connexion pour connecter l’appareil mobile et l’application précédemment créés.
2. Connectez-vous à l’application mobile :
   1. Ajoutez une activité Appui (Tap) pour sélectionner le champ ID utilisateur et pouvoir ensuite saisir un nom d’utilisateur.
   2. Ajoutez une activité Définir le texte (Set Text) pour saisir le nom d’utilisateur dans le champ ID utilisateur.
   3. Ajoutez une activité Appui (Tap) pour sélectionner le champ Mot de passe et pouvoir ensuite saisir le mot de passe.
   4. Ajoutez une activité Définir le texte (Set Text) pour saisir le mot de passe correspondant.
   5. Utilisez une activité Appui (Tap) pour sélectionner le bouton Connexion.
   Image 1. Les premières activités dans le cadre de la connexion à l’application
   

   

   
   
3. Verrouiller une carte de débit ou de crédit :
   1. Ajoutez une activité Appui (Tap) pour accéder au menu de l’application bancaire mobile.
   2. Ajoutez une activité Balayer (Swipe) pour glisser vers le bas dans le menu.

      Le but est de glisser jusqu’à ce que vous trouviez la section Gérer la carte de crédit/débit.

   3. Ajoutez une activité Appui (Tap) pour sélectionner la section Gérer la carte de crédit/débit.
   4. Ajoutez une activité Appui (Tap) pour sélectionner l’icône de verrouillage de la première carte affichée.
   5. Ajoutez une activité Balayer (Swipe) pour glisser vers le bas dans le message de verrouillage de la carte.

      Cette action vous permet de confirmer l’action en sélectionnant Verrouiller la carte.

   6. Ajoutez une activité Appui (Tap) pour sélectionner Verrouiller la carte.
   Image 2. Activités utilisées pour verrouiller la carte de crédit
   

   

   
   
4. Prenez la capture d’écran d’une réclamation :
   1. Ajoutez une activité Appui (Tap) pour sélectionner le bouton Précédent et revenez au menu principal.
   2. Ajoutez une activité Balayer (Swipe) pour glisser vers le bas dans le menu principal, jusqu’à ce que la section Afficher mes réclamations s’affiche.
   3. Utilisez une activité Appui (Tap) pour sélectionner la section Afficher mes réclamations.
   4. Ajoutez une activité Appui (Tap) pour sélectionner Voir les détails de la première réclamation.
   5. Utilisez l’API Prendre une capture d’écran (TakeScreenshot) des informations de la première réclamation.
   Image 3. Activités utilisées pour prendre une capture d’écran d’une réclamation
   

   

   
   
5. Enfin, après avoir pris la capture d’écran, on revient au menu principal de l’application en utilisant l’activité Appui (Tap) pour sélectionner l’élément d’IU Retour (Back) deux fois.

Utiliser des automatisations codées

Prérequis

Pour automatiser une application mobile à l’aide d’API, enregistrez les éléments mobiles de l’application dans le référentiel d’objets du projet. Pour cet exemple, nous avons créé une application BankOfAmerica avec un ÉcranMobile général contenant tous les éléments d’IU que nous utilisons pour automatiser. Afin de créer des éléments d’IU pour appareils mobiles, établissez une connexion entre l’appareil cible et l’application dans le gestionnaire d’appareils mobiles. Ensuite, directement dans le panneau Référentiel d’objets, créez chaque élément et utilisez l’option Indiquer l’élément pour indiquer l’élément d’IU spécifique sur le périphérique du gestionnaire d’appareils mobiles.

Consultez la liste suivante pour connaître la structure du référentiel d’objets :

• Application BankOfAmerica, menu ÉcranMobile
  • backFromClaimDetails
  • backFromClaimStatus
  • BackToMenu
  • firstClaimSeeDetails
  • Lock
  • LockCard
  • Login
  • ManageDebitCredit
  • Menu
  • Mot de passe (Password)
  • swipeMenu
  • UserId
  • viewmyclaims

Étapes

1. Établissez une connexion entre l’appareil et l’application :
   1. Créez une variable de type Connection à l’aide de l’API Connecter (Connect) avec la deuxième version de surcharge.

      Pour cette surcharge, saisissez le nom du périphérique et le nom de l’application en tant que chaînes de caractères afin d'établir la connexion.

      [TestCase]
              public void Execute()
              {
                  Connection connection = mobile.Connect(
                  "Android mobile device", 
                  "BankOfAmericaSimulator");
      
                  Log("Connection established");

2. Vous pouvez si vous le souhaitez ajouter un message Log après la connexion, à des fins de débogage.
3. Connectez-vous à l'application mobile :
   1. Appelez l’API Appui (Tap) pour cliquer sur le champ ID utilisateur.

      Cette action vous permet de saisir le nom d’utilisateur.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.UserId);

   2. Utilisez l’API DéfinirTexte (SetText) pour saisir un nom d’utilisateur dans le champ ID utilisateur.

      connection.SetText(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.UserId, 
          "[e-mail]", 
          MobileOptions.SetText().WithSendNewline(false));

   3. Appelez l’API Appui (Tap) pour sélectionner le champ Mot de passe afin de pouvoir saisir le mot de passe.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Password);

   4. Utilisez l’API Définir le texte (Set Text) pour saisir un mot de passe dans le champ Mot de passe.
      La méthode WithSendNewLine(false) garantit que l’élément de clavier OK n’est pas activé sur l’appareil mobile après l’envoi du texte. Pour plus d’informations sur les options disponibles de l’API Définir le texte (Set Text), consultez la classe OptionsMobile.OptionsDéfinirTexte.

      connection.SetText(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Password, "abcde", MobileOptions.SetText().WithSendNewline(false));

   5. Utilisez l’API Appui (Tap) pour sélectionner Connexion.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Login);

4. Verrouiller une carte de débit ou de crédit :
   1. Accédez au menu de l’application bancaire mobile à l’aide de l’API Appui (Tap) :

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Menu);

   2. Balayez vers le bas dans le menu à l’aide de l’API Balayer (Swipe).

      Le but est de glisser jusqu’à ce que vous trouviez la section Gérer la carte de crédit/débit.

      connection.Swipe(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.swipeMenu, 
          ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.ManageDebitCredit, 
          SwipeDirection.Down,     
          4);

   3. Sélectionnez la section Gérer la carte de crédit/débit à l’aide de l’API Appuyer (Tap).
      La méthode WithTimeout() permet à l’API de s’interrompre pendant un nombre de secondes prédéterminé. Cette pause durera jusqu’à ce que l’élément d’IU cible s’affiche ou qu’une erreur soit générée.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.ManageDebitCredit, TapTypeEnum.Single, MobileOptions.Tap().WithTimeout(120));

   4. Pour la première carte affichée, sélectionnez l’icône de verrouillage à l’aide de l’API Appui (Tap).

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Lock);

   5. Balayez vers le bas dans le message de verrouillage de la carte, en utilisant l’API Balayage directionnel (Directional Swipe), afin que nous puissions confirmer l’action en sélectionnant Verrouiller la carte.

      connection.DirectionalSwipe(SwipeDirection.Down);

   6. Sélectionnez Verrouiller la carte en utilisant l’API Appui (Tap).

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.LockCard);

5. Prenez une capture d'écran d'une réclamation.
   1. Revenez au menu principal en utilisant l’API Appui (Tap) et l’icône de retour.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.BackToMenu);

   2. Balayez vers le bas dans le menu principal jusqu’à ce que la section Afficher mes réclamations s’affiche.
      Pour cette étape, nous utilisons l’API Balayer (Swipe), en utilisant cette fois la sixième surcharge. Cette surcharge nécessite un descripteur IElementDescriptor pour le conteneur de balayage ainsi qu’une cible SelectorTarget pour l’élément d’IU cible.
      Nous allons d’abord créer une cible SelectorTarget pour la section Afficher mes réclamations, puis nous allons utiliser l’API Balayer (Swipe).
      1. Ouvrez le gestionnaire d’appareils mobiles et créez la connexion entre l’appareil mobile et l’application.
      2. Accédez au référentiel d’objets et créez un nouvel élément pour l’écran mobile.
      3. Sélectionnez Indiquer l’élément.
      4. Dans le menu des options de sélection, copiez le contrôle Web identifié par les sélecteurs.

         Pour cette application de banque mobile, vous devez vous assurer que l’option de sélection Sélecteurs WebView en tant que sélecteurs natifs est bien sélectionnée.

      5. Revenez à l’éditeur de code et créez une variable de type SelectorTarget. Utilisez la méthode MobileTarget.FromSelector qui exige comme argument le contrôle Web que vous avez précédemment copié.

         SelectorTarget viewMyClaimsTarget = MobileTarget.FromSelector("<mbl android:className='android.widget.TextView' text='View My Claims' />");

      6. Utilisez l’API Balayer (Swipe) avec la variable SelectorTarget, afin de terminer l’action de balayage vers le bas.

         connection.Swipe(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.swipeMenu, viewMyClaimsTarget, SwipeDirection.Down, 20);

   3. Appuyez sur la section Afficher mes réclamations .

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.viewmyclaims);

   4. Appuyez sur Voir les détails pour la première réclamation.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.firstClaimSeeDetails);

   5. Utilisez l'API Prendre une capture d'écran (TakeScreenshot) des informations de la première réclamation.

      connection.TakeScreenshot();

6. Enfin, après avoir pris la capture d'écran, on revient au menu principal de l'application en appuyant sur l'élément d'IU Retour (Back) deux fois.

   connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.backFromClaimDetails);
       connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.backFromClaimStatus);