Fehlersuche und ‑behebung

Hinweis:

Für die Durchführung von Browser-Automationen muss Firefox mindestens in Version 52.0 installiert sein.

In diesem Thema werden die häufigsten Gründe vorgestellt, warum die UiPath^®-Erweiterung für Firefox möglicherweise nicht ordnungsgemäß funktioniert, und wie diese Probleme behoben werden können.

Erweiterung in älteren Firefox-Versionen

Beschreibung

Mozilla führte einen Erweiterungssignatur-Verifizierungsalgorithmus in Firefox ein, der Add-ons für Firefox Version 65.0 und niedriger deaktiviert. Wenn Sie die UiPath-Erweiterung für Firefox auf der Browserversion 65.0 oder niedriger installieren, wird die folgende Fehlermeldung angezeigt:

This add-on could not be installed because it appears to be corrupt.

Lösung 1

Aktualisieren Sie Firefox mindestens auf Version v66.0.4.

Lösung 2

Ab Studio 2020.8 wird die Firefox-Erweiterung neu signiert und sollte auf älteren Versionen des Firefox-Browsers ordnungsgemäß installiert werden.

Überprüfen der Erweiterung

Überprüfen Sie, ob die UiPath-Erweiterung für Firefox installiert und aktiviert ist:

1. Gehen Sie in Mozilla Firefox zu about:addons > Extensions.
2. Wenn diese Erweiterung nicht verfügbar ist, installieren Sie sie, wie hier beschrieben.
3. Stellen Sie sicher, das die UiPath-Erweiterung auf die neueste Version aktualisiert ist.

Um möglichen Problemen vorzubeugen:

1. Gehen Sie in Mozilla Firefox zu about:addons > Extensions.

2. Öffnen Sie den Task-Manager oder Prozess-Explorer.

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

   Hinweis:

   Eine eigene ChromeNativeMessaging-Instanz wird für die Chrome-Erweiterung ausgeführt. Daher müssen Sie Google Chrome beenden, wenn Sie die Überprüfung durchführen.

   Wenn ChromeNativeMessagingnicht ausgeführt wird:

4. Gehen Sie in Mozilla Firefox zu about:addons > Extensions.

5. Entfernen Sie die UiPath-Erweiterung manuell mit der Schaltfläche Entfernen (Remove).

6. Installieren Sie es neu, wie hier Beschrieben.

Sollten die obigen Informationen nicht geholfen haben, Ihr Problem zu lösen, können zusätzliche Informationen erhalten, indem Sie Traces anzeigen und die von der UiPath-Erweiterung ausgelösten Fehler analysieren. Die folgenden Arten von Traces können Sie sammeln und analysieren:

Für die allgemeinen Ablaufverfolgungen von Erweiterungen in Mozilla Firefox:

Gehen Sie zu Menü öffnen > Web-Entwickler > Browserkonsole (Strg+Umschalt+J). Die Browserkonsole wird angezeigt. Alle durch die Erweiterung generierten Fehler werden hier angezeigt.

Für Traces, die von einer Webseite generiert wurden, die Sie automatisieren möchten:

Gehen Sie zu: Menü öffnen> Webentwickler > Webkonsole (Strg+Umschalt+K). Die Webkonsole wird angezeigt. Alle Fehler für die aktuelle Webseite werden hier angezeigt.

Für vollständige Traces (nicht nur für Fehler) gehen Sie wie folgt vor:

1. Öffnen Sie den Registrierungs-Editor.

2. Navigieren Sie zu der Taste HKEY_CURRENT_USER\SOFTWARE\UiPath.

3. Doppelklicken Sie auf den REG_DWORD-Wert WebExtensionTrace. Das Fenster DWORD-Wert bearbeiten wird angezeigt.

4. Ändern Sie im Feld Wertdaten den Wert in 1, und klicken Sie auf OK. Der Wert wird gespeichert.

   Hinweis:

   Wenn der WebExtensionTrace REG_DWORD-Wert nicht existiert, müssen Sie ihn erstellen, indem Sie mit der rechten Maustaste auf das rechte Panel klicken und New > DWORD (32-bit)-Wert auswählen und die oben genannten Werte bereitstellen.

   Überprüfen Sie, ob im Registrierungs-Editor Daten fehlen:

5. Öffnen Sie den Registrierungs-Editor.

6. Navigieren Sie zu der Taste HKEY_CURRENT_USER\SOFTWARE\Mozilla\NativeMessagingHosts\com.uipath.chromenativemsg.

7. Öffnen Sie den (Default) REG_SZ-Wert. Das Fenster String bearbeiten(Edit String) wird angezeigt und sollte einen Pfad beinhalten, der C:\Users\YOUR_USER_NAME\AppData\Local\UiPath\uipath-ff.json ähnelt.

8. Öffnen Sie die .json-Datei an dem oben gefundenen Pfad in einem Texteditor, z. B. Notepad++.

9. Überprüfen Sie, dass die Eigenschaft Pfad (path) korrekt auf ChromeNativeMessaging.exe verweist, ähnlich wie C:\Program Files (x86)\UiPath Studio\UiPath\BrowserExtension\ChromeNativeMessaging.exe.

Mehrere Browser-Profile

Ab UiPath Version 2023.10 unterstützt die UiPath-Erweiterung für Firefox die Automatisierung mehrerer Browser-Instanzen, die mit mehreren Benutzerprofilen gleichzeitig laufen.

Hinweis:

Die Automatisierung mehrerer Browserprofile erfordert UiPath.UIAutomation.Activities v23.10 oder neuer und die Browsererweiterung mit UiPathStudio.msi v23.10 oder neuer.

Das Öffnen des Browsers mit einem bestimmten Profil ist jetzt möglich, wenn die Aktivität Use Application/Browser verwendet wird. Um beim Start des Browsers ein Profil anzugeben, müssen Sie ein Argument an die Position in der Browser-Befehlszeile anhängen. Verwenden Sie dazu die Eigenschaft Argumente im Eingabeabschnitt Einheitliches Anwendungsziel .

Für Firefox lautet das erforderliche Argument: -profile "full_profile_path". Um den vollständigen Profilpfad abzurufen, navigieren Sie zu about:profiles und rufen Sie das Stammverzeichnis für dieses Profil ab.