Browser öffnen (Open Browser)

UiPath.Core.Activities.OpenBrowser

Ein Container, der das Öffnen eines Browsers zu einer angegebenen URL ermöglicht und verschiedene Aktivitäten in ihm ausführen kann.

Achtung:

Interne URLs können nicht mit dieser Aktivität geöffnet werden, wenn der Browser sie nicht direkt als Befehlszeilenargumente akzeptiert.

Sie können interne Seiten in Chrome (chrome://) oder Edge (edge://) nicht öffnen. Sie können jedoch interne Firefox-Seiten (about:) öffnen.

Im Textkörper der Aktivität

Im Designer-Panel wird die Aktivität als Container dargestellt, in dem Sie Aktivitäten hinzufügen können, um mit dem angegebenen Browser zu interagieren.

Im Feld URL können Sie den Link angeben, zu dem der Browser geöffnet wird.

Klicken auf das Schaltfläche neben dem URL-Feld öffnet eine neue Browsersitzung mit den aktuellen Konfigurationseinstellungen. Dadurch ist es möglich, ein neues Browser-Benutzer-Dataset zu verwenden, während die vorhandene Konfiguration beibehalten wird. Dies kann besonders nützlich sein, wenn Sie Browser in Picture-in-Pictureautomatisieren.

Eine Sequenz ist ebenfalls vorhanden, in der die im Browser ausgeführten Aktionen hinzugefügt werden.

Eigenschaften

Allgemein

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• BrowserType - Wählen Sie den Browsertyp, den Sie verwenden möchten, über die Dropdown-Schaltfläche aus. Die folgenden Optionen sind verfügbar: IE, Firefox, Chrome, Edge, Benutzerdefiniert. Der Typ „Benutzerdefiniert“ ist für andere Chromium-basierte Browser geeignet, z. B. JxBrowser. Die Eigenschaft Hidden wird bei Verwendung des benutzerdefinierten Browsertyps nicht unterstützt. Weitere Informationen zum Konfigurieren des benutzerdefinierten Browsers finden Sie im Abschnitt Benutzerdefinierter Browser .

  Hinweis: Wenn die Eigenschaft BrowserType auf Customfestgelegt ist, muss die Eigenschaft CommunicationMethod auf WebDriver festgelegt werden, damit die Aktivität ordnungsgemäß funktioniert.
• Url (Url) - Die URL, die Sie im angegebenen Browser öffnen möchten.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• AutomaticallyDownloadWebDriver – Wenn diese Option ausgewählt ist, wird die erforderliche ausführbare WebDriver-Datei automatisch aus dem Internet in den Ordner %localappdata%\UiPath\WebdriverExe heruntergeladen. Standardmäßig ist dieses Kontrollkästchen deaktiviert.
• CommunicationMethod – Wählen Sie die Kommunikationsmethode aus. Folgendes ist verfügbar: Nativ, WebDriver.
• Verborgen (Hidden) - Öffnet einen verborgenen Browser.
• NeueSession (NewSession) - Startet eine neue Session im ausgewählten Browser. Diese Option ist spezifisch für Internet Explorer.
• Privat (Private) - Öffnet eine private/inkognito Session.

• BenutzerdatenOrdnermodus – Der BenutzerdatenOrdnermodus, den Sie festlegen möchten. Er wird verwendet, um den Browser mit einem bestimmten Benutzerdatenordner zu starten.

  • BenutzerdatenOrdnermodus.Automatisch: Der Bild-in-Bild-Modus verwendet einen anderen Ordner als der Standardmodus, der automatisch generiert wird, wenn BenutzerdatenOrdnerpfad nicht festgelegt ist.
  • BenutzerdatenOrdnermodus.StandardOrdner – Verwendet den Standard-Browserordner, unabhängig davon, ob er in der Haupt- oder BiB-Sitzung ausgeführt wird.
  • BenutzerdatenOrdnermodus.Benutzerdefinierter Ordner – Verwendet den in BenutzerdatenOrdnerpfad angegebenen Ordner oder einen automatisch generierten Pfad, wenn BenutzerdatenOrdnerpfad nicht festgelegt ist.
• UserDataFolderPath – Der Benutzerdatenordner, den der Browser verwendet. Standardwert ist %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType , wenn nicht festgelegt.

Weitere Details zu UserDataFolderMode und UserDataFolderPath finden Sie hier.

Ausgabe

• UI-Browser (UiBrowser) - Das Ergebnis einer Aktivität als Objekt vom Typ UiBrowser. Speichert alle Information der Browser-Session. Das Feld unterstützt nur Variablen vom Typ Browser.

Benutzerdefinierter Browser

Ein benutzerdefinierter Browser ist ein Browser, der sich von den weit verbreiteten Browsern (Chrome, Chromium Edge, Firefox, IE usw.) unterscheidet und auf dem Chromium-Projekt aufbaut. Wir unterstützen zwei Kategorien solcher Browser: Browser, die mit Chromium Embedded Framework (CEF) erstellt wurden, und Browser, die das JxBrowser-Framework verwenden.

Diese benutzerdefinierten Browser können mithilfe der WebDriver-Kommunikationsmethode automatisiert werden.

Dazu müssen sie den Befehlszeilenparameter --remote-debugging-port unterstützen, so wie ihn alle Chromium-basierten Browser unterstützen.

Konfigurieren eines benutzerdefinierten Browsers

Der benutzerdefinierte Browser, den Sie verwenden möchten, muss über eine ausführbare chromedriver.exe-Datei verfügen, die für die Chromium-Version geeignet ist, auf welcher der benutzerdefinierte Browser in PATH basiert.

Im Registrierungsschlüssel HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE muss unter Software\UiPath\UiPath Platform\CustomBrowser der Befehlswert den Pfad zur ausführbaren Datei des benutzerdefinierten Browsers oder einen Befehl enthalten, der diesen benutzerdefinierten Browser startet.

In Fällen, in denen Sie nur eine einzelne Instanz des benutzerdefinierten Browsers ausführen müssen und aus Sicherheitsgründen den Remote-Debugging-Port angeben möchten, über den die Kommunikation mit dem benutzerdefinierten Browser erfolgt, muss optional ein Registrierungswert mit dem Namen RemoteDebuggingPort im selben Registrierungsschlüssel hinzugefügt werden, in dem der Befehl angegeben wurde.

Selektoren auf Seiten eines solchen benutzerdefinierten Browsers haben den Namen der Browser-App custom_browser.

Beispiel für die Verwendung der Aktivität „Browser öffnen“

Hier sehen Sie, wie die Aktivität Open Browser in einem Beispiel verwendet wird, das mehrere Aktivitäten enthält.