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.

Hinweis:

Interne URLs können mit dieser Aktivität nicht geöffnet werden, wenn der Browser sie nicht direkt als Befehlszeilenargumente akzeptiert. Interne Seiten von Chrome (chrome://) oder Edge (edge://) können nicht geöffnet werden. Sie können jedoch interne Seiten von Firefox (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.

Durch Klicken auf neben dem Feld URL wird eine neue Browsersitzung mit den aktuellen Konfigurationseinstellungen geöffnet. Dies ermöglicht es, einen neuen Browser-Benutzerdatensatz zu verwenden und gleichzeitig die vorhandene Konfiguration beizubehalten. Dies kann besonders nützlich sein, wenn Sie Browser in Bild-in-Bild automatisieren.

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

Eigenschaften

Allgemein

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• 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:

  If the BrowserType property is set to Custom, the CommunicationMethod property must be set to WebDriver for the activity to work properly.

• 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 - If selected, automatically downloads from the Internet the required WebDriver executable into the %localappdata%\UiPath\WebdriverExe folder. By default, this check box is cleared.
• CommunicationMethod - Choose the communication method. The following are available: Native, WebDriver.
• Verborgen (Hidden) - Öffnet einen verborgenen Browser.
• NewSession - Starts a new session of the selected browser. This option is specific to Internet Explorer.
• Privat (Private) - Öffnet eine private/inkognito Session.
• UserDataFolderMode - The UserDataFolderMode you want to set. It is used to start the browser with a specific user data folder.
  • UserDataFolderMode.Automatic - Picture In Picture mode uses a different folder than the default mode, automatically generated if UserDataFolderPath is not set.
  • UserDataFolderMode.DefaultFolder - Uses the default browser folder, no matter if it runs in the main or PIP session.
  • UserDataFolderMode.CustomFolder - Uses the folder specified in UserDataFolderPath or an auto generated path if UserDataFolderPath is not set.
• UserDataFolderPath - The user data folder that the browser will use. Defaults to %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType if not set.

Weitere Informationen zu BenutzerdatenOrdnermodus und BenutzerdatenOrdnerpfad 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.