トラブルシューティング

このページでは、UiPath Microsoft Edge 拡張機能が正しく動作しない場合に、その原因である可能性が最も高い問題と、それらの問題を解決する方法について説明します。

Microsoft Edge 拡張機能がインストールされ、有効化されているかを確認する

1. Microsoft Edge で 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.

ChromeNativeMessaging.exe が実行中かどうかを確認する

ChromeNativeMessaging.exe は、UiPath Edge 拡張機能と UiPath Studio/Robot 間の通信を可能にします。

1. Microsoft Edge を開きます。

2. タスク マネージャーを開きます。

3. ChromeNativeMessaging.exe プロセスが実行中であることを確認します。

   

4. プロセスが実行されていない場合は、次の手順を実行します。

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

ComSpec 変数が正しく定義されているかどうかを確認する

説明

ChromeNativeMessaging.exe プロセスは現在のユーザーの下で実行され、cmd.exe を使用してブラウザーを起動します。

ComSpec 環境変数が見つからない場合、または無効な値が設定されている場合は、Microsoft Edge は ChromeNativeMessaging.exe を起動できません。

また、管理者が一部のユーザーのコマンド プロンプトを無効化したり、常に管理者特権で実行するように設定したりする場合があります。

解決策

ComSpec 環境変数に正しい値を手動で追加します。この変数は Windows インストール時に設定され、%SystemRoot%\system32\cmd.exe という値を設定する必要があります。

その他の回避策

ComSpec 環境変数が正しく設定されているにもかかわらず問題が解決しない場合は、コマンド プロンプトを実行する権限がユーザーにない可能性があります。この場合、現在のユーザーで実行されている cmd.exe で ChromeNativeMessaging.exe プロセスを開始することはできません。

Chromium 120.0.6090+ 以降では、NativeHostsExecutablesLaunchDirectly グループ ポリシーにより、管理者は制限された環境 (cmd.exe を禁止しているクラウド PC など) のユーザーに対してこれを有効化できます。

ファイルの URL および InPrivate ブラウズへのアクセスを有効化する

既定では、拡張機能はファイルの URL または InPrivate ブラウズへのアクセスを許可されていません。これらを有効化するには、以下の手順を実行します。

1. Microsoft Edge で edge://extensions/ に移動します。Microsoft Edge の [拡張機能] ページが表示されます。

2. UiPath Browser Automation 拡張機能に移動して、[詳細] ボタンをクリックします。

3. [InPrivate で許可する] と [ファイルの URL へのアクセスを許可する] オプションが選択されていることを確認します。

   

複数のブラウザー プロファイル

複数のユーザー プロファイルを持つ複数の Microsoft Edge インスタンス

UiPath Microsoft Edge 拡張機能は、複数のユーザー プロファイルで同時に実行される複数のブラウザー インスタンスの操作の自動化をサポートしていません。このため、ブラウザー操作を自動化する場合は、Microsoft Edge のアクティブなインスタンスをすべて閉じてから、単一のユーザー プロファイルを使用してブラウザーを再起動する必要があります。

すべての Microsoft Edge インスタンスを停止する

場合によっては、Microsoft Edge のバックグラウンド プロセスが Microsoft Edge を完全に閉じるのを妨げていることがあります。ブラウザー インスタンスが表示されていなくても、これは自動化の妨げになります。

システム トレイの Microsoft Edge アイコンを右クリックして [Microsoft Edge を閉じる] を選択し、Microsoft Edge を閉じることをお勧めします。これにより、他のユーザー プロファイルがバックグラウンドで使用されたままになることはなくなります。

MV3 拡張機能に関する既知の問題

入力メソッドが [シミュレート] に設定された [クリック] アクティビティが Web ページの特定の要素で失敗する

入力メソッドが [シミュレート] に設定された [クリック] アクティビティが、javascript: というURI を含むクリック ハンドラーが設定された HTML 要素に対して機能しません。

この場合、シミュレートされたクリックは無効となり、エラーは報告されません。

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.

回避策

失敗する [クリック] アクティビティの入力メソッドを [シミュレート] から以下のいずれかに変更します。

• Chromium API
• ハードウェア イベント
• ウィンドウ メッセージ

DeveloperToolsAvailability グループ ポリシーの値を 1 に設定する必要がある

DeveloperToolsAvailability には、次のいずれかの値が設定可能です。

• 0 = 企業ポリシーによってインストールされた拡張機能でのデベロッパー ツールの使用を禁止し、その他の状況におけるデベロッパー ツールの使用を許可する
• 1 = デベロッパー ツールの使用を許可する
• 2 = デベロッパー ツールの使用を禁止する

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.

この値は、拡張機能をインストールすると自動的に正しく設定されますが、システム管理者がこのポリシーに別の値を設定している場合は上書きされます。

DeveloperToolsAvailability を 1 以外の値に設定すると、以下のような問題が発生します。

DeveloperToolsAvailability を 0 に設定すると、次の問題が発生します。

• UiPath Edge 拡張機能の適用は、LTS バージョンの UI Automation (19.10.x、20.10.x、21.10.x、22.4.x) のみに制限されます。
• [JS スクリプトを挿入] アクティビティは機能しません。

DeveloperToolsAvailability を 2 に設定すると、次の問題が発生します。

• DeveloperToolsAvailability=0 に設定されている場合の制限がすべて適用されます。
• 入力メソッド [Chromium API] は機能しません。

[UiPath Web Automation] ブラウザー ウィンドウに警告が表示される

ChromeNativeMessaging.exe が起動できない場合は、[UiPath Web Automation] ブラウザー ウィンドウに次の警告が表示されます。

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

UiPath Studio から拡張機能を再インストールします。

See Check If ChromeNativeMessaging.exe Is Running.

[ブラウザーを開く] アクティビティのタイムアウトが短すぎる

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 v20.10.13, the internal timeout for the Open Browser activity has been increased from 20 seconds to 60 seconds.

また、タイムアウトは UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS 環境変数を使用して設定することもできます。たとえば、アクティビティのタイムアウトを 120 秒にするには UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 と設定します。