Effectuez une recherche par navigateur et récupérez les résultats à l'aide des API UI Automation

Ce didacticiel montre comment utiliser les API UI Automation pour créer une automatisation qui ouvre le moteur de recherche Google, effectue une recherche UiPath, récupère le résultat du site Web officiel UiPath et l'affiche dans la console.

Prérequis

• UiPath Studio 2023.10 ou version ultérieure
• UiPath.UIAutomation.Activities 23.10.3 ou version ultérieure
• Visiter la page Utilisation d’objets dans des automatisations codées et découvrez les méthodes que vous pouvez utiliser pour utiliser les éléments du référentiel d’objets dans votre automatisation codée.

Étapes

1. Créez un workflow codé en sélectionnant Nouveau (New), puis Workflow codé (Coded Workflow) à partir du groupe Fichier (File).
2. Capturez tous les éléments d'IU que vous souhaitez utiliser dans votre workflow codé à l'intérieur du Référentiel d’objets.

   Pour cet exemple, vous devez capturer les éléments d'IU suivants :

   • GoogleHomeScreen : l'écran d'accueil Google, où vous effectuez la recherche.
     • googleSearchBar : la barre de recherche Google où vous saisissez le mot clé UiPath.
   • googleResultsScreen : l'écran qui affiche les premiers résultats Google après la recherche.
     • firstPageOfResults : la partie de l'écran qui inclut uniquement les premiers résultats.
     • uipathOfficialWebsite : résultat qui vous dirige vers le site Web officiel d'UiPath.
   
   

   

   
   
3. Créer une variable pour l'écran d'accueil Google et l'ouvrir à l'aide de l'API Ouvrir (Open).

   public class Search : CodedWorkflow
       {
           [Workflow]
           public void Execute()
           {
               // 1. Open Google
              var homeScreen = uiAutomation.Open(ObjectRepository.Descriptors.Google.GoogleHomeScreen);

4. Saisir UiPath dans la barre de recherche Google, à l'aide de l'API Saisir dans (Type Into).

   // 2. Type "UiPath" in the Google search bar
               homeScreen.TypeInto(ObjectRepository.Descriptors.Google.GoogleHomeScreen.googleSearchBar, "UiPath");

5. Envoyer le raccourci clavier Entrée pour rechercher le résultat correspondant à l'aide de l'API Raccourci clavier (KeyboardShortcut).

   // 3. Send the "Enter" keyboard shortcut to search for the corresponding Google results
               homeScreen.KeyboardShortcut(ObjectRepository.Descriptors.Google.GoogleHomeScreen.googleSearchBar, "[d(hk)][k(enter)][u(hk)]");

6. Se concentrer sur l'écran avec les résultats Google en utilisant l'API Joindre (Attach).
   Remarque : utilisez l'API Joindre (Attach) sur l'API Ouvrir (Open) lorsque vous devez cibler un écran spécifique dans une application qui a déjà été ouverte à l'aide de l'API Ouvrir (Open). L'API Joindre (Attach) empêche les lancements d'applications inutiles, garantissant que votre automatisation reste sur la bonne voie.

   var googleScreen = uiAutomation.Attach(ObjectRepository.Descriptors.Google.googleResultsScreen);

7. Obtenir le texte des premiers résultats Google et l'imprimer dans la console, à l'aide de l'API Obtenir le texte (Get Text).

   string firstresultsText = googleScreen.GetText(ObjectRepository.Descriptors.Google.googleResultsScreen.firstPageOfResults);
               Console.WriteLine(firstresultsText);

8. Créer une clause Si (If) pour imprime le texte du premier résultat qui contient la chaîne "https://www.uipath.com".

   // Initialize with an empty string
           string officialWebsiteUiPath = "";
               if (firstresultsText.Contains("https://www.uipath.com"))
               {
                officialWebsiteUiPath = googleScreen.GetText(ObjectRepository.Descriptors.Google.googleResultsScreen.uipathOfficialWebsite);
               }
               Console.WriteLine(officialWebsiteUiPath);

Résultats

L'automatisation ouvre le moteur de recherche Google dans votre navigateur Web préféré, effectue une recherche d'UiPath, récupère les résultats de la page initiale et extrait le texte du résultat qui contient le lien suivant : https://uipath.com.

Exemple de projet

Pour suivre les étapes de ce tutoriel et l'essayer vous-même, vous pouvez télécharger l'exemple de projet suivant : Résultats Google en utilisant des API UI Automation.