Realize pesquisa no navegador e recupere resultados usando APIs de Automação de interface gráfica

Este tutorial ilustra como usar APIs de automação de interface gráfica para criar uma automação que abre o mecanismo de pesquisa do Google, realiza uma pesquisa da UiPath, recupera o resultado do site oficial da UiPath e o exibe no console.

Pré-requisitos

• UiPath Studio 2023.10 ou superior
• UiPath.UIAutomation.Activities 23.10.3 ou superior
• Acesse Uso de objetos em automações codificadas e aprenda os métodos que você pode empregar para usar elementos de repositório de objetos em sua automação codificada.

Etapas

1. Crie um fluxo de trabalho codificado selecionando Novo e, em seguida, Fluxo de trabalho codificado no grupo Arquivo.
2. Capture todos os elementos de interface gráfica que você deseja usar em seu fluxo de trabalho codificado dentro do Repositório de objetos.

   Para este exemplo, você precisa capturar os seguintes elementos de interface gráfica:

   • GoogleHomeScreen - a tela inicial do Google, onde você realiza a pesquisa.
     • googleSearchBar - a barra de pesquisa do Google onde você digita a palavra-chave UiPath.
   • googleResultsScreen - a tela que mostra os primeiros resultados do Google após realizar a pesquisa.
     • firstPageOfResults - a parte da tela que inclui apenas os primeiros resultados.
     • uipathOfficialWebsite - o resultado que leva você ao site oficial da UiPath.
   
   

   

   
   
3. Crie uma variável para a tela inicial do Google e abra-a usando a API Open.

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

4. Digite UiPath na barra de pesquisa do Google, usando a API TypeInto.

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

5. Envie o atalho do teclado Enter para pesquisar o resultado correspondente, usando a API 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. Foque na tela com os resultados do Google, usando a API Anexar.
   Observação: você usa a API Anexar sobre a API Open quando precisa segmentar uma tela específica dentro de um aplicativo que já foi aberto usando a API Open. A API Anexar impede inicializações de aplicativos desnecessárias, garantindo que sua automação permaneça no caminho certo.

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

7. Obtenha o texto dos primeiros resultados do Google e imprima-o no console, usando a API GetText.

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

8. Crie uma cláusula If que imprima o texto do primeiro resultado que contém a string "https://www.uipath.com" dentro dela.

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

A automação abre o mecanismo de pesquisa do Google em seu navegador da Web preferido, realiza uma pesquisa para UiPath, recupera os resultados da página inicial e extrai o texto do resultado que contém o seguinte link: https://uipath.com.

Projeto de amostra

Para seguir as etapas deste tutorial e experimentar por conta própria, você pode baixar o seguinte projeto de exemplo: Resultados do Google usando APIs de automação de interface gráfica.