Fehlerbehebung bei der Chrome-Erweiterung

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. Stellen Sie sicher, dass die Erweiterung installiert und aktiviert ist, wie hier erläutert.
3. Wenn die Erweiterung korrekt installiert wurde, aber nicht in Chrome angezeigt wird, überprüfen Sie, ob Gruppenrichtlinien vorhanden sind, die sich auf die Erweiterung auswirken, wie hier erläutert.
   

   Hinweis: Wenn Sie das Kontrollkästchen Entwicklermodus oben auf der Seite chrome://extensions/ aktivieren, wird die Schaltfläche Aktualisieren auf der Seite Details der Erweiterung angezeigt.

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

   • Stellen Sie sicher, dass die Erweiterung installiert ist. Weitere Informationen dazu, wie Sie sie installieren, finden Sie auf der Seite „Dokumente“.
   • Überprüfen Sie, ob es Gruppenrichtlinien gibt, die ChromeNativeMessaging.exe betreffen. Weitere Informationen finden Sie auf der Seite „Dokumente“.
   • Überprüfen Sie, ob die Umgebungsvariable ComSpec korrekt definiert ist.

Wenn die obigen Informationen Ihr Problem nicht gelöst haben, können Sie versuchen, zusätzliche Informationen zu erhalten, indem Sie die Ablaufverfolgungen anzeigen wie hier erklärt und die Fehler, die von der UiPath-Erweiterung ausgegeben wurden, analysieren. Im Folgenden finden Sie Typen von Traces, die Sie sammeln und analysieren können: Traces aktivieren.

Aktivieren der Nachverfolgung

Allgemeine Erweiterungs-Nachverfolgung in Google Chrome

1. In Google Chrome gehen Sie zu chrome://extensions/.
2. Aktivieren Sie das Kontrollkästchen „Entwicklermodus“ oben auf der Webseite.
3. Gehen Sie zur UiPath-Erweiterung und klicken Sie auf die Hintergrundseite. Die Seite „Entwicklertools“ wird angezeigt.
4. Navigieren Sie zur Registerkarte „Konsole“. Hier werden alle von der Erweiterung erzeugten Traces angezeigt.
   Hinweis: Fehler werden rot angezeigt.

Nachverfolgung generiert von der Webseite, die Sie automatisieren möchten

1. Navigieren Sie auf der Webseite, die Sie automatisieren möchten, zu Seitennavigationsleiste > Weitere Werkzeuge > Entwicklerwerkzeuge(Side Navigation Bar > More tools > Developer tools) (oder drücken Sie Strg+Umschalt+I). Die von der UiPath-Erweiterung für die aktuelle Seite generierten Traces werden angezeigt.
   Hinweis: Fehler werden rot angezeigt.

Vollständige Nachverfolgung

1. Öffnen Sie den Registrierungs-Editor.
2. Navigieren Sie zu der Taste HKEY_CURRENT_USER\SOFTWARE\UiPath.
3. Doppelklicken Sie auf den WebExtensionTrace DWORD-Wert. Das Fenster DWORD-Wert bearbeiten(Edit DWORD Value) wird angezeigt.
4. Ändern Sie den Wert im Feld Value Data auf 1 und klicken Sie auf OK (OK). Der Wert wird gespeichert.
   Hinweis: Wenn der WebExtensionTrace DWORD-Wert nicht existiert, müssen Sie ihn erstellen, indem Sie mit der rechten Maustaste auf das rechte Panel klicken und Neu > DWORD (32-bit) Wert(New > DWORD (32-bit) Value) auswählen und die oben genannten Werte bereitstellen.

   Wenn die Erweiterung für Chrome immer noch nicht funktioniert, entfernen Sie die Erweiterung aus chrome://extensions/ und installieren Sie sie neu.

Überprüfen der korrekten Definition der ComSpec-Variablen

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

Die Lösung besteht darin, den richtigen Wert für die Umgebungsvariable ComSpec manuell hinzuzufügen.

Diese Variable wird bei der Windows-Installation festgelegt und sollte den Wert %SystemRoot%\system32\cmd.exe haben.

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.

Dies wurde hier als Chromium-Fehler gemeldet: https://bugs.chromium.org/p/chromium/issues/detail?id=1299742 Dieses Problem ist sehr selten, da nur sehr wenige HTML-Elemente Klick-Handler in dieser Form haben.

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

Wenn die UiPath-Erweiterung für Chrome per Gruppenrichtlinieinstalliert wird, muss DeveloperToolsAvailability auf 1 festgelegt werden, um die vollständige Funktionalität der Erweiterung zu aktivieren.

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 0 festgelegt ist, dann gilt Folgendes:

• 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 2 festgelegt ist, dann gilt Folgendes:

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

Kommunikation mit UiPath Platform nicht möglich. Der native Teil der Erweiterung ist nicht richtig konfiguriert.

Installieren Sie die Erweiterung erneut von UiPath Studio.

Weiter Informationen finden Sie unter Überprüfen Sie, ob ChromeNativeMessaging.exe ausgeführt wird.

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

Bei MV3-Erweiterungen lädt der Browser die Erweiterung später, nachdem die Webseiten geladen wurden. Das bedeutet, dass die Aktivität Browser öffnen ( Open Browser ) von UiPath.UiAutomation.Activities- Version 20.10 oder älter auf langsameren Maschinen das interne Timeout von 20 Sekunden erreichen kann, bevor die Erweiterung gestartet wurde.

Ab v20.10.13 wurde das interne Timeout für die Aktivität Open Browser von 20 Sekunden auf 60 Sekunden erhöht.

Darüber hinaus können Sie das Timeout über die Umgebungsvariable UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS konfigurieren. Legen Sie beispielsweise UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 fest, um 120 Sekunden für das Timeout der Aktivität zu verwenden.