Fehlersuche und ‑behebung

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

Sehen Sie sich die folgenden Seiten an:

• Kommunikation mit Browser nicht möglich
• Die Edge-Erweiterung wird automatisch entfernt
• Möglicherweise ist die Erweiterung beschädigt
• Überprüfen, ob die Erweiterung für Microsoft Edge installiert und aktiviert ist
• Überprüfen Sie, ob ChromeNativeMessaging.exe ausgeführt wird
• Überprüfen der korrekten Definition der ComSpec-Variablen
• Aktivieren des Zugriffs auf Datei-URLs und den InPrivate-Modus
• Mehrere Browser-Profile
• Gruppenrichtlinienkonflikt
• Spezifische bekannte Probleme für MV3-Erweiterungen

Überprüfen, ob die Erweiterung für Microsoft Edge installiert und aktiviert ist

1. Navigieren Sie in Microsoft Edge zu edge://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 Microsoft Edge, check if there are Group Policies that affect the extension, as explained here.

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

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

1. Öffnen Sie Microsoft Edge.

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 on how to install it, check the docs page.
   • Check if there are Group Policies affecting ChromeNativeMessaging.exe. See the docs page for more information.
   • Check if the ComSpec environment 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 Microsoft Edge 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.

Ab Chromium 120.0.6090+ ermöglicht die NativeHostsExecutablesLaunchDirectly-Gruppenrichtlinie es Administratoren, diese für Benutzer in eingeschränkten Umgebungen zu aktivieren (z. B. Cloud-PCs, die cmd.exe verbieten).

Aktivieren des Zugriffs auf Datei-URLs und den InPrivate-Modus

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

1. Navigieren Sie in Microsoft Edge zu edge://extensions/. Die Seite „Erweiterungen“ von Microsoft Edge wird angezeigt.

2. Navigieren Sie zur UiPath Browser Automation-Erweiterung und klicken Sie auf die Schaltfläche Details.

3. Stellen Sie sicher, dass die Optionen InPrivate zulassen und Zugriff auf Datei-URLs zulassen aktiviert sind.

   

Mehrere Browser-Profile

Mehrere Microsoft Edge-Instanzen mit mehreren Benutzerprofilen

Die UiPath-Erweiterung für Microsoft Edge 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 Microsoft Edge-Instanzen schließen und den Browser mit einem einzigen Benutzerprofil neu starten.

Beenden aller Microsoft Edge-Instanzen

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

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

Gruppenrichtlinienkonflikt

Bei der Installation der UiPath-Erweiterung für Edge mithilfe einer Gruppenrichtlinie wird die ExtensionInstallForcelist auf Maschinenebene aktualisiert.

Dies kann einen Konflikt verursachen, wenn ExtensionInstallForcelist auch auf Benutzerebene definiert ist.

Da die Maschinenebene Priorität hat, werden die auf Benutzer-/Cloud-Ebene festgelegten Erweiterungen deinstalliert.

Um dies zu bestätigen, aktivieren Sie, edge://policyob diese Warning unter ExtensionInstallForcelist angezeigt wird:

More than one source with conflicting values is present for this policy!

Um diesen Konflikt zu beheben, führen Sie die folgenden Schritte aus:

1. Install the UiPath extension for Edge using theNativeHostOnly installation method.

Diese Installationsmethode ermöglicht die Kommunikation zwischen der Erweiterung und UiPath Studio/Robot.

Es werden keine Änderungen an den Gruppenrichtlinien vorgenommen.

To use this installation method add EDGE_INSTALL_TYPE=NativeHostOnly to the installation command for UiPathStudio.msi.

Beispiel:

UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,EdgeExtension EDGE_INSTALL_TYPE=NativeHostOnly

2. In the ExtensionInstallForcelist policy, add the value:

kcgmcmhhfbcacnlnopghneecffhelmhe;https://edge.microsoft.com/extensionwebstorebase/v1/crx

3. In the NativeMessagingAllowlist policy, add the value:

com.uipath.chromenativemsg_v2

4. Set DeveloperToolsAvailability Group Policy to the value1 (Allow usage of the Developer Tools).

Diese Einstellung ist erforderlich, um die vollständige Erweiterungsfunktionalität zu aktivieren.

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.

Problemumgehungen

Für dieses Problem sind zwei Problemumgehungen verfügbar:

1. Identify the failing Click activity in your workflow and change the input method from Simulate to any other input method (Chromium API, Hardware Events, Window Messages).
2. Aktualisieren Sie auf das UiPath.UIAutomation.Activities-Paket v22.12 oder höher und verwenden Sie die Option Problemumgehung für Simulation eines Klicks mit MV3-Erweiterung aktivieren in den Projekteinstellungen.

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 Edge 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 Edge 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 „Inject Js Script“ kann nicht mehr für den Zugriff auf Seitenvariablen und -code verwendet werden.

By default, the Inject Js Script activity can no longer be used to access page variables, such as jQuery $ , or to interact with page code (e.g., window.alert). The Inject Js Script activity won't report an error, but the script will fail to execute and the following error will be reported in the browser DevTools (F12): Refused to execute inline script because it violates the following Content Security Policy directive.

Dies ist eine Einschränkung, die von der MV3-Plattform eingeführt wurde.

Um dieses Problem zu beheben, wählen Sie die Option Execution world - Page in der Aktivität Inject Js Script aus.

Your existing JavaScript code doesn't require any changes, and by using the Execution world - Page option it will work for both MV2 and MV3 extensions.

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 can reach the internal timeout of 60 seconds before the extension has started.

Starting with UiPath.UiAutomation.Activities v22.10.6, the internal timeout for the Open Browser activity can be configured 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.