Browser anhängen (Attach Browser)

UiPath.Core.Activities.BrowserScope

Ein Container, der das Anhängen an einen bereits geöffneten Browser erlaubt und verschiedene Aktionen in ihm ausführen kann. Diese Aktivität wird bei Verwendung des Web Recorders auch automatisch generiert.

Eigenschaften

Eingabe

• Selektor - Texteigenschaft zum Finden eines bestimmten UI-Elements, wenn die Aktivität ausgeführt wird. Die Eigenschaft ist genau genommen ein XML-Fragment, das Attribute des gesuchten GUI-Elements und einige übergeordnete Elemente angibt. Wenn sowohl diese Eigenschaft als auch die Browser-Eigenschaft konfiguriert sind, wird die Selektor-Eigenschaft zur Entwurfszeit und die Browser-Eigenschaft zur Laufzeit verwendet.
• BrowserType – Wählen Sie den Browsertyp aus, den Sie verwenden möchten. 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 .
• Browser – Die vorhandene Browservariable, die Sie anfügen möchten. Wenn sowohl diese Eigenschaft als auch die Selektor-Eigenschaft konfiguriert sind, wird die Selektor-Eigenschaft zur Entwurfszeit und die Browser-Eigenschaft zur Laufzeit verwendet.
• AuszeitMS (TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe einer laufenden Aktivität an. Der Standardwert ist 30000 Millisekunden (30 Sekunden).

Optionen

• SucheUmfang (SearchScope) - Das Anwendungsfenster, in dem nach dem in der Selektoreigenschaft definierten UI-Element gesucht werden soll.

Ausgabe

• UIBrowser – Die Browser-Variable, die von der Aktivität zurückgegeben wird. Um zu vermeiden, dass dieselbe Instanz eines Browsers erneut angegeben werden muss und auch um sicherzustellen, dass sich die Browserinstanz, die Sie automatisieren, nicht ändert, können Sie diese Ausgabevariable als Eingabevariable in einer anderen Aktivität wiederverwenden, z. B. Attach Browser oder Use Application/Browser, oder Sie können es beispielsweise als Argument in einem anderen Workflow wiederverwenden.

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

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

Sonstiges

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

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.