Führen Sie eine Browsersuche durch und rufen Sie Ergebnisse mithilfe von UIAutomation-APIs ab

Dieses Tutorial veranschaulicht, wie Sie UI-Automatisierungs-APIs verwenden, um eine Automatisierung zu erstellen, die die Google-Suchmaschine öffnet, eine UiPath-Suche durchführt, das Ergebnis von der offiziellen UiPath-Website abruft und in der Konsole anzeigt.

Voraussetzungen

• UiPath Studio 2023.10 oder höher
• UiPath.UIAutomation.Activities 23.10.3 oder höher
• Besuchen Sie Verwenden von Objekten in codierten Automatisierungen und lernen Sie die Methoden kennen, die Sie für die Verwendung von Object-Repository-Elementen in Ihrer codierten Automatisierung anwenden können.

Schritte

1. Erstellen Sie einen codierten Workflow, indem Sie Neu und dann Codierter Workflow in der Gruppe Datei auswählen.
2. Erfassen Sie alle UI-Elemente im Objekt-Repository, die Sie in Ihrem codierten Workflow verwenden möchten.

   In diesem Beispiel müssen Sie die folgenden UI-Elemente erfassen:

   • GoogleHomeScreen – Der Google-Startbildschirm, auf dem Sie die Suche durchführen.
     • googleSearchBar – Die Google-Suchleiste, in der Sie das UiPath-Schlüsselwort eingeben.
   • googleResultsScreen – Der Bildschirm, der nach dem Durchführen der Suche die ersten Google-Ergebnisse anzeigt.
     • firstPageOfResults – Der Teil des Bildschirms, der nur die ersten Ergebnisse enthält.
     • uipathOfficialWebsite – Das Ergebnis, das Sie zur offiziellen Website von UiPath führt.
   
   

   

   
   
3. Erstellen Sie eine Variable für den Google-Startbildschirm und öffnen Sie ihn mit der Open-API.

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

4. Geben Sie UiPath mithilfe der TypeInto-API in die Google-Suchleiste ein.

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

5. Senden Sie die Tastenkombination Eingabe, um mit Hilfe der KeyboardShortcut-API nach dem entsprechenden Ergebnis zu suchen.

   // 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. Konzentrieren Sie sich mithilfe der Attach-API auf den Bildschirm mit den Google-Ergebnissen.
   Hinweis: Sie verwenden die Attach-API anstelle der Open-API, wenn Sie einen bestimmten Bildschirm innerhalb einer Anwendung anvisieren müssen, die bereits mit der Open-API geöffnet wurde. Die Attach-API verhindert unnötige Anwendungsstarts und stellt sicher, dass Ihre Automatisierung auf Kurs bleibt.

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

7. Rufen Sie den Text aus den ersten Google-Ergebnissen ab und geben Sie ihn in der Konsole mithilfe der GetText-API aus.

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

8. Erstellen Sie eine If-Klausel, die den Text des ersten Ergebnisses ausgibt, das die Zeichenfolge "https://www.uipath.com" enthält.

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

Ergebnisse

Die Automatisierung öffnet die Google-Suchmaschine in Ihrem bevorzugten Webbrowser, führt eine Suche nach UiPath durch, ruft die Ergebnisse von der Startseite ab und extrahiert den Text aus dem Ergebnis, das den folgenden Link enthält: https://uipath.com.

Beispielprojekt

Um die Schritte dieses Tutorials auszuführen und es selbst auszuprobieren, können Sie sich das folgende Beispielprojekt herunterladen: Google-Ergebnisse mithilfe von UI-Automatisierungs-APIs.