Fehlersuche und ‑behebung

Auf dieser Seite werden die häufigsten Gründe erläutert, warum die UiPath-Erweiterung für Chrome nicht funktioniert. Darüber hinaus finden Sie hier Informationen zum Beheben dieser Probleme.

Beachten Sie, dass Browserautomatisierungen mit der Erweiterung für Chrome derzeit in einem einzelnen Chrome-Fenster möglich sind.

Hinweis:

Für die Durchführung von Browser-Automationen brauchen Sie mindesten Google Chrome Version 64.

Überprüfen Sie, ob die Erweiterung für Chrome installiert und aktiviert ist

1. In Google Chrome navigieren Sie zu chrome://extensions/.

2. Make sure the extension is installed and enabled, as explained here.

3. If the extension was installed correctly but does not appear in Chrome, check if there are Group Policies that affect the extension, as explained here.

   

   Hinweis:

   Selecting the Developer mode check box at the top of the chrome://extensions/ page displays the Update button on the extension Details page.

Überprüfen Sie, ob ChromeNativeMessaging.exe ausgeführt wird

ChromeNativeMessaging.exe ermöglicht die Kommunikation zwischen der UiPath-Erweiterung für Chrome und UiPath Studio/Robot.

1. Öffnen Sie Chrome.

2. Öffnen Sie den Task-Manager.

3. Überprüfen Sie, ob der Prozess ChromeNativeMessaging.exe ausgeführt wird.

   

4. Wenn der Prozess nicht ausgeführt wird:

• Make sure the extension is installed. For more information, check the installation methods described in the Extension for Chrome page.
• Check if there are Group Policies affecting ChromeNativeMessaging.exe. See Group Policies for more information.
• Check if ComSpec variable is defined correctly.

Überprüfen der korrekten Definition der ComSpec-Variablen

Beschreibung

Der ChromeNativeMessaging.exe-Prozess wird unter dem aktuellen Benutzer ausgeführt und verwendet cmd.exe, um den Browser zu starten.

Wenn die ComSpec-Umgebungsvariable fehlt oder einen ungültigen Wert hat, kann ChromeNativeMessaging.exe von Google Chrome nicht gestartet werden.

Zudem kann der Administrator die Eingabeaufforderung für einige Benutzer deaktivieren oder sie so konfigurieren, dass sie immer mit erweiterten Berechtigungen ausgeführt wird.

Lösung

Fügen Sie den richtigen Wert für die ComSpec-Umgebungsvariable manuell hinzu. Diese Variable wird bei der Windows-Installation festgelegt und muss festgelegt sein auf: %SystemRoot%\system32\cmd.exe.

Andere Problemumgehungen

Wenn die Umgebungsvariable ComSpec korrekt festgelegt ist, aber das Problem weiterhin besteht, hat der Benutzer möglicherweise keine Berechtigung zum Ausführen der Eingabeaufforderung. In diesem Fall kann der Prozess ChromeNativeMessaging.exe nicht gestartet werden, wenn cmd.exe unter dem aktuellen Benutzer ausgeführt wird.

Starting with Chromium 120.0.6090+, a NativeHostsExecutablesLaunchDirectlyGroup Policy allows admins to turn this on for users in restricted environments (Cloud PCs that forbid cmd.exe, for example).

Aktivieren Sie den Zugriff auf Datei-URLs und den Inkognito-Modus

Standardmäßig hat die Erweiterung keinen Zugriff auf Datei-URLs oder den Inkognito-Modus. So aktivieren Sie diese:

1. Navigieren Sie in Google Chrome zu chrome://extensions/. Die Seite der Chrome-Erweiterungen wird angezeigt.

2. Navigieren Sie zur UiPath Web Automation-Erweiterung und klicken Sie auf die Schaltfläche Details. Die Seite mit den UiPath Web Automation-Details wird angezeigt.

3. Stellen Sie sicher, dass die Optionen Inkognito zulassen (Allow in incognito) und Zugriff auf Datei-URLs zulassen (Allow access to file URLs) aktiviert sind.

   

Mehrere Browser-Profile

Mehrere Chrome-Instanzen mit mehreren Benutzerprofilen

Die UiPath Erweiterung für Chrome unterstützt nicht die Automatisierung mehrerer Browser-Instanzen, die mit mehreren Benutzerprofilen gleichzeitig ausgeführt werden. Daher müssen Sie bei der Browser-Automatisierung alle aktiven Chrome-Instanzen schließen und den Browser mit einem einzigen Benutzerprofil neu starten.

Beenden aller Chrome-Instanzen

In einigen Fällen verhindern Hintergrundprozesse von Chrome, dass der Browser vollständig geschlossen wird, was die Automatisierungen beeinträchtigt, auch wenn die Browser-Instanz nicht sichtbar ist.

Es wird empfohlen, Chrome zu schließen, indem Sie mit der rechten Maustaste auf das Chrome-Symbol in der Task-Leiste klicken und Fenster schließen auswählen. Dadurch wird sichergestellt, dass keine anderen Benutzerprofile im Hintergrund verwendet werden.

Spezifische bekannte Probleme für MV3-Erweiterungen

Click-Aktivität mit „Simulieren“ schlägt bei bestimmten Webseitenelementen fehl

Die „Click“-Aktivität mit der Eingabemethode Simulate funktioniert nicht mehr bei HTML-Elementen, die einen Klick-Handler mit javascript:-URI haben.

In diesem Fall wird der simulierte Klick nicht durchgeführt und es werden keine Fehler gemeldet.

This was reported as a Chromium bug here: https://bugs.chromium.org/p/chromium/issues/detail?id=1299742 This issue is quite rare as very few HTML elements have click handlers in this form.

Problemumgehung

Ändern Sie die Eingabemethode für die fehlgeschlagene „Click“-Aktivität von Simulate zu einer anderen Eingabemethode:

• Chromium-API
• Hardware-Ereignisse
• Windows-Meldungen

Der Wert der Gruppenrichtlinie „DeveloperToolsAvailability“ muss auf 1 festgelegt sein

DeveloperToolsAvailability kann die folgenden Werte haben:

• 0 = Verwendung der Entwicklertools für Erweiterungen, die durch eine Unternehmensrichtlinie installiert wurden, nicht zulassen; Verwendung der Entwicklertools in anderen Kontexten zulassen
• 1 = Verwendung der Entwicklertools zulassen
• 2 = Verwendung der Entwicklertools nicht zulassen

If the UiPath Extension for Chrome is installed using Group Policy, then the DeveloperToolsAvailability must be set to 1 to enable the full functionality of the extension.

Dieser Wert wird automatisch korrekt festgelegt, wenn die Erweiterung installiert wird, aber er wird überschrieben, wenn Ihr Systemadministrator einen anderen Wert für diese Richtlinie festgelegt hat.

Die anderen Werte für DeveloperToolsAvailability verursachen die unten aufgeführten Probleme.

Wenn DeveloperToolsAvailability auf eingestellt ist, dann:0

• Die UiPath-Erweiterung für Chrome v22.4 funktioniert mit dieser Einschränkung überhaupt nicht. Es wird empfohlen, die Erweiterung auf v22.10 zu aktualisieren, die mit UiPathStudio.msi 2022.4.4 verfügbar ist.
• Die UiPath-Erweiterung für Chrome v22.10 wird nur noch mit LTS-Versionen von UIAutomation funktionieren (19.10.x, 20.10.x, 21.10.x, 22.4.x).
• Die InjectJS-Aktivität funktioniert nicht.

Wenn DeveloperToolsAvailability auf eingestellt ist, dann:2

• Alle Einschränkungen von DeveloperToolsAvailability=0 gelten.
• Die Eingabemethode ChromiumAPI wird nicht funktionieren.

Im UiPath Web Automation-Browserfenster wird eine Warnung angezeigt

Das UiPath Web Automation-Browserfenster zeigt die folgende Warnung an, wenn ChromeNativeMessaging.exe nicht gestartet werden konnte:

Cannot communicate with UiPath Platform The native part of the extension is not configured correctly.

Installieren Sie die Erweiterung erneut von UiPath Studio.

See Check if ChromeNativeMessaging.exe is running.

Die Aktivität „Open Browser“ hat ein unzureichendes Timeout

For MV3 extensions, the browser loads the extension later, after the web pages have loaded. This means that on slower machines, the Open Browser activity from UiPath.UiAutomation.Activities version 20.10 or older can reach the internal timeout of 20 seconds before the extension has started.

Starting with v21.10.8, you can configure the timeout through the UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS environment variable. For example, set UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 to use 120 seconds for the activity's timeout, instead of the default value of 60 seconds.