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

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

1. Google Chrome で、chrome://extensions/ に移動します。
2. こちらの説明に従って、拡張機能がインストールされ、有効化されていることを確認してください。
3. 拡張機能が正しくインストールされているが、Chrome に表示されない場合は、こちらの説明に従って、拡張機能に影響を与えるグループ ポリシーがあるかどうかを確認してください。

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

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

1. Chrome を開きます。
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 変数が正しく定義されているかどうかを確認する

ComSpec 環境変数が見つからない場合、または無効な値が設定されている場合は、Google Chrome は ChromeNativeMessaging.exe を起動できません。
この問題を解決するには、 ComSpec 環境変数に正しい値を手動で追加します。

この変数は Windows インストール時に設定され、%SystemRoot%\system32\cmd.exe という値が設定されています。

ファイルの URL およびシークレット モードへのアクセスを有効化する

既定では、拡張機能はファイルの URL またはシークレット モードへのアクセスを許可されていません。これらを有効化するには、以下の手順を実行します。

1. Google Chrome で、chrome://extensions/ に移動します。Chrome 拡張機能のページが表示されます。
2. UiPath Web Automation 拡張機能に移動して、[詳細] ボタンをクリックします。[UiPath Web Automation] の詳細ページが表示されます。
3. [シークレット モードでの実行を許可する] と [ファイルの URL へのアクセスを許可する] オプションが選択されていることを確認します。

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

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

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

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

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

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

グループ ポリシーの競合

When installing the UiPath extension for Chrome using Group Policy the ExtensionInstallForcelist is updated at the machine level.
This can cause a conflict if the ExtensionInstallForcelist is also defined at the user level or using Chrome Cloud Policies.
マシン レベルが優先されるため、ユーザー/クラウド レベルで設定した拡張機能はアンインストールされます。
To confirm this, check at chrome://policy if this warning is displayed under ExtensionInstallForcelist:
This policy is working as intended but a conflicting value is set elsewhere and is overridden by this policy.

この競合を解決するには、以下の手順を実行します。

1. Install the UiPath extension for Chrome using the NativeHostOnly installation method.
この方法を使用すると、拡張機能と UiPath Studio/Robot 間の通信が可能になります。
グループ ポリシーに変更は加えられません。
To use this installation method add CHROME_INSTALL_TYPE=NativeHostOnly to the installation command for UiPathStudio.msi.
例：

UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=NativeHostOnly

2. In the ExtensionInstallForceList policy, add the value:

gflmmjnkmhahgnfcgjckfaekifpehnjk;https://clients2.google.com/service/update2/crx

3. In the NativeMessagingAllowList policy, add the value:

com.uipath.chromenativemsg_v2

4. Set DeveloperToolsAvailability Group Policy to the value 1 (Allow usage of the Developer Tools).
拡張機能のすべての機能を使用するには、この設定が必要です。
For more information about this setting, please see this troubleshooting section.

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

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

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

この場合、シミュレートされたクリックは無効となり、エラーは報告されません。
This was reported as a Chromium bug. This issue is quite rare as very few HTML elements have click handlers in this form.

回避策

この問題の回避策は 2 つあります。

1. ワークフロー内の失敗する [クリック] アクティビティを特定し、入力メソッドを [シミュレート] から他のいずれかの入力メソッド (Chromium API、ハードウェア イベント、ウィンドウ メッセージ) に変更します。

2. UiPath.UIAutomation.Activities パッケージを v22.12 以降にアップグレードして、[プロジェクト設定] の [MV3 拡張機能使用時のクリックをシミュレートの回避策を有効化] オプションを使用します。

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

The DeveloperToolsAvailability has the following possible values:

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

If the UiPath Extension for Chrome is installed using Group Policy, then the DeveloperToolsAvailability must be set to 1 to enable the full functionality of the extension.
この値は、拡張機能をインストールすると自動的に正しく設定されますが、システム管理者がこのポリシーに別の値を設定している場合は上書きされます。

The other values for DeveloperToolsAvailability cause the problems listed below.
If DeveloperToolsAvailability is set to 0 then:

• この制限が設定されると、UiPath Chrome 拡張機能 v22.4 は一切機能しません。v22.10 の拡張機能へのアップグレードを検討してください。このバージョンは、UiPathStudio.msi 2022.4.4 を実行することで利用可能です。
• The UiPath Extension for Chrome v22.10 will be restricting to working with LTS versions of UiAutomation (19.10.x, 20.10.x, 21.10.x, 22.4.x, 22.10.x)
• The InjectJS Activity will not work.

If DeveloperToolsAvailability is set to 2 then:

• DeveloperToolsAvailability=0 に設定されている場合の制限がすべて適用されます。
• The ChromiumAPI input method will not work.

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

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

Cannot communicate with UiPath Platform
The native part of the extension is not configured correctly.
Re-install the extension from UiPath Studio.

Check the Troubleshooting guide for ChromeNativeMessaging.exe.

[JS スクリプトを挿入] アクティビティを使用してページ変数やページ コードにアクセスできなくなった

既定で、[JS スクリプトを挿入] アクティビティを使用してページ変数 (jQuery $ など) にアクセスしたり、ページ コードを操作 (例: window.alert) したりできなくなりました。[JS スクリプトを挿入] アクティビティではエラーは発生しませんが、スクリプトの実行は失敗し、次のエラー メッセージがブラウザーの DevTools (F12 キー) に表示されます。
Refused to execute inline script because it violates the following Content Security Policy directive です。

これは、MV3 プラットフォームによる制限です。

To fix this issue, select the Execution world - Page option from the Inject Js Script activity.
このプロパティは UiPath.UIAutomation.Activities v22.12.0-preview 以降で使用できます。
既存の JavaScript コードへの変更は必要ありません。また、[実行環境] で [ページ] オプションを選択すると、MV2 と MV3 の両方の拡張機能で機能します。