Realizar búsquedas en el navegador y recuperar resultados mediante las API de automatización de IU

Este tutorial ilustra cómo utilizar las API de automatización de IU para crear una automatización que abre el motor de búsqueda Google, realiza una búsqueda UiPath, recupera el resultado del sitio web oficial de UiPath y lo muestra en la consola.

Requisitos previos

• UiPath Studio 2023.10 o posterior
• UiPath.UIAutomation.Activities 23.10.3 o posterior
• Consulta Utilizar objetos en automatizaciones codificadas y aprende los métodos que puedes emplear para utilizar elementos del repositorio de objetos dentro de tu automatización codificada.

Pasos

1. Crea un flujo de trabajo codificado seleccionando Nuevo y luego Flujo de trabajo codificado en el grupo Archivo.
2. Captura todos los elementos de IU que quieres utilizar en tu flujo de trabajo codificado dentro del Repositorio de objetos.

   Para este ejemplo, debes capturar los siguientes elementos

   • GoogleHomeScreen - la pantalla de inicio de Google, donde realizas la búsqueda.
     • googleSearchBar - la barra de búsqueda de Google donde se escribe la palabra clave UiPath.
   • googleResultsScreen - la pantalla que muestra los primeros resultados de Google después de realizar la búsqueda.
     • firstPageOfResults - la parte de la pantalla que incluye solo los primeros resultados.
     • uipathOfficialWebsite - el resultado que te lleva a la página web oficial de UiPath.
   
   

   

   
   
3. Crea una variable para la pantalla de inicio de Google y ábrela utilizando la API Abrir.

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

4. Escribe UiPath en la barra de búsqueda de Google, utilizando la API EscribirEn.

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

5. Envía el atajo de teclado Enter para buscar el resultado correspondiente, utilizando la API AtajoDeTeclado.

   // 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. Concéntrate en la pantalla con los resultados de Google, utilizando la API Adjuntar.
   Nota: utilizas la API Adjuntar sobre la API Abrir cuando necesitas apuntar a una pantalla específica dentro de una aplicación que ya se ha abierto utilizando la API Abrir. La API de Adjuntar evita los lanzamientos de aplicaciones innecesarios, lo que garantiza que tu automatización se mantenga en marcha.

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

7. Obtiene el texto de los primeros resultados de Google y lo imprime en la consola, utilizando la API ObtenerTexto.

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

8. Crea una cláusula Si que imprime el texto del primer resultado que contiene la cadena "https://www.uipath.com" dentro de él.

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

Resultados

La automatización abre el motor de búsqueda Google en tu navegador web preferido, realiza una búsqueda para UiPath, recupera los resultados de la página inicial y extrae el texto del resultado que contiene el siguiente enlace: https://uipath.com.

Proyecto de ejemplo

Para seguir los pasos de este tutorial y probarlo tú mismo, puedes descargar el siguiente proyecto de ejemplo: Resultados de Goggle mediante las API de automatización de la IU.