Firefox 拡張機能のトラブルシューティング

注: ブラウザー操作を自動化するには、Firefox のバージョン 52.0 およびそれ以降を使用する必要があります。

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

Firefox 旧バージョンの拡張機能

説明

Mozilla は Firefox に拡張機能の署名検証アルゴリズムを導入しました。これにより、Firefox の 65.0 以前のバージョンではアドオンが無効化されます。したがって、バージョン 65.0 以前のブラウザーに UiPath Firefox 拡張機能をインストールすると、以下のエラー メッセージが表示されます。

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

解決策 1

Firefox を v66.0.4 以降に更新する

解決策 2

Studio v2020.8 より Firefox 拡張機能の署名が新しくなったため、古いバージョンの Firefox ブラウザーでも適切にインストールされます。

拡張機能を確認する

UiPath Firefox 拡張機能がインストールされ、有効化されているかどうかを確認します。

1. Mozilla Firefox で、[about:addons] > [拡張機能] にアクセスします。
2. 拡張機能がない場合は、こちらの説明に従ってインストールします。
3. UiPath 拡張機能が最新バージョンに更新されていることを確認します。

発生の可能性がある問題を防ぐには、次の操作を実行してください。

1. Mozilla Firefox で、[about:addons] > [拡張機能] にアクセスします。
2. タスク マネージャーまたは Process Explorer を開きます。
3. ChromeNativeMessaging.exe プロセスが実行中であることを確認します。
   注: 別の ChromeNativeMessaging インスタンスが Chrome 拡張機能用に実行されているため、このチェックを実行するときには Google Chrome を終了する必要があります。

ChromeNativeMessaging が実行されていない場合は、以下の手順を実行します。

1. Mozilla Firefox で、[about:addons] > [拡張機能] にアクセスします。
2. [削除] ボタンをクリックして、UiPath 拡張機能を手動で削除します。
3. こちらの説明に従って再インストールします。

上記の情報で問題が解決しない場合は、トレースを表示して追加情報を取得し、UiPath 拡張機能によってスローされたエラーを分析することができます。以下は、収集して分析できるトレースの種類です。

Mozilla Firefox の一般的な拡張機能の場合は、次の操作を実行します。

メニューを開き、[ウェブ開発] < [ブラウザー コンソール] に移動します (Ctrl+Shift+J)。[ブラウザー コンソール] が表示されます。拡張機能によって生成されたすべてのエラーがここに表示されます。

自動化しようとしている Web ページによって生成されたトレースの場合は、次の操作を実行します。

メニューを開き、[ウェブ開発] > [ウェブ コンソール] に移動します (Ctrl+Shift+K)。[ウェブ コンソール] が表示されます。現在の Web ページのすべてのエラーがここに表示されます。

フルトレースの場合、(エラー対応だけでなく) 次の操作を実行します。

1. レジストリ エディターを開きます。
2. HKEY_CURRENT_USER\SOFTWARE\UiPath キーに移動します。
3. [WebExtensionTrace] REG_DWORD 値をダブルクリックします。[Edit DWORD Value] ウィンドウが表示されます。
4. [Value Data] フィールドで値を 1 に変更し、[OK] をクリックします。この値が保存されます。
   注: WebExtensionTrace REG_DWORD 値が存在しない場合は、右側のパネルを右クリックし、[新規] > [DWORD (32-bit) 値] を選択し、上記の値を指定して作成する必要があります。

レジストリ エディターでデータの欠落がないかを確認します。

1. レジストリ エディターを開きます。
2. HKEY_CURRENT_USER\SOFTWARE\Mozilla\NativeMessagingHosts\com.uipath.chromenativemsg キーに移動します。
3. (Default) REG_SZ 値を開きます。[文字列の編集] ウィンドウが表示され、そこに C:\Users\YOUR_USER_NAME\AppData\Local\UiPath\uipath-ff.json のようなパスが含まれているはずです。
4. 上記のパスにある .json ファイルを Notepad++ などのテキストエディターで開きます。
5. [path] プロパティが ChromeNativeMessaging.exe がある場所を正しく指定していることを確認します。これは、C:\Program Files (x86)\UiPath Studio\UiPath\BrowserExtension\ChromeNativeMessaging.exe のように指定されています。

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

v2023.10 以降の UiPath では、UiPath Firefox 拡張機能は複数のユーザー プロファイルで同時に実行される複数のブラウザー インスタンスの自動化をサポートしています。

Firefox の場合、必須の引数は -profile "full_profile_path" です。完全なプロファイル パスを取得するには、about:profiles に移動し、そのプロファイルのルート ディレクトリを取得します。