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

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

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

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

これは Chromium のバグとして報告されました。この形式のクリック ハンドラーが設定された HTML 要素は非常に少ないため、この問題はまれにしか発生しません。

回避策

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

1. ワークフロー内の失敗する [クリック] アクティビティを特定し、入力メソッドを [シミュレート] から他のいずれかの入力メソッド (Chromium API、ハードウェア イベント、ウィンドウ メッセージ) に変更します。
2. UiPath.UIAutomation.Activities パッケージを v22.12 以降にアップグレードして、[プロジェクト設定] の [MV3 拡張機能使用時のクリックをシミュレートの回避策を有効化] オプションを使用します。

開発者ツールへのアクセスは明示的に許可される必要があります

Microsoft Edge 149 以降では、 グループ ポリシーを使用して UiPath Edge 拡張機能をインストールする場合は、開発者ツールへのアクセスを明示的に許可する必要があります。

回避策

オプション 1.DeveloperToolsAvailabilityAllowlist と DeveloperToolsAvailabilityBlocklist を使用する

DeveloperToolsAvailabilityAllowlist ポリシーと DeveloperToolsAvailabilityBlocklist ポリシーを使用すると、開発者ツールは UiPath 拡張機能 ID に対してのみ有効化され、他のすべての拡張機能では無効化されたままになります。このアプローチは、ブラウザーのセキュリティ強化ポスチャを維持するため、マネージド環境またはセキュリティで保護された環境に推奨されるオプションです。

グループ ポリシーを使用して UiPath Edge 拡張機能をインストールする場合は、DeveloperToolsAvailabilityAllowlist と DeveloperToolsAvailabilityBlocklist が自動的に構成され、拡張機能の完全な機能が有効化されます。

これを適用するには、次の内容の .reg ファイルを実行するか、レジストリでポリシーを手動で構成します。

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\DeveloperToolsAvailabilityAllowlist]
"1"="chrome-extension://ndmegdjihnhfmljjoaiimbipfhodnbgf"
"2"="chrome-extension://cdfjcmjmgdnojgaojdnefhjjpaijapci"

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\DeveloperToolsAvailabilityBlocklist]
"1"="https://uipath-devtools-blocklist-placeholder.invalid/"

注:

変更を有効にするには、 DeveloperToolsAvailabilityAllowlist ポリシー値と DeveloperToolsAvailabilityBlocklist ポリシー値の両方を適用する必要があります。DeveloperToolsAvailabilityAllowlist だけを設定するのでは不十分です。

これらのポリシー値が正しく設定されていれば、 DeveloperToolsAvailability=2 (デベロッパー ツールの使用を禁止する) 場合でも、UiPath 拡張機能の完全な機能が復元されます。

オプション 2.DeveloperToolsAvailability を 1 に設定します。

DeveloperToolsAvailability ポリシーを構成して、GPO で1するか、影響を受けるマシンの Windows レジストリで直接 (デベロッパー ツールの使用を許可する) ようにします。

これを適用するには、次の内容の .reg ファイルを実行するか、レジストリでポリシーを手動で設定します。

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge]
"DeveloperToolsAvailability"=dword:00000001

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

• 0 - 企業ポリシーによってインストールされたアプリおよび拡張機能、またはバージョン 114 以降、および管理対象ユーザーである場合はブラウザーに組み込まれた拡張機能でのデベロッパー ツールの使用を禁止します。その他の状況における開発者ツールの使用を許可する
• 1 - 開発者ツールの使用を許可する
• 2 - 開発者ツールの使用を禁止する

DeveloperToolsAvailability が 2 に設定されている場合、以下の制限が適用されます。

• [JS スクリプトを挿入] アクティビティは機能しません。
• 入力メソッド [Chromium API] は機能しません。
• UiPath Edge 拡張機能は、 UiPath.UiAutomation.Activitiesの LTS バージョンに制限されています。

注:

組織でブラウザー拡張機能の管理にグループ ポリシーを使用していて、異なる値が設定されている場合、 DeveloperToolsAvailabilityAllowlist / DeveloperToolsAvailabilityBlocklist または DeveloperToolsAvailability ポリシーの値が上書きされる可能性があります。

オプション 3.ブラウザー拡張機能の代わりに Chromium オートメーションを使用するように切り替えてください

この方法では、 ブラウザー拡張機能 の代わりに Chromium の自動化 方法を使用してブラウザーを自動化します。

注:

DeveloperToolsAvailability グループ ポリシーが [2] に設定されている場合、Chromium の自動化はブロックされます。

[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 から拡張機能を再インストールします。

「ChromeNativeMessaging.exe が実行中かどうかを確認する」をご覧ください。

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

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

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

この問題を修正するには、[ JS スクリプトを挿入] アクティビティの [ 実行環境] で [ページ] オプションを選択します。

既存の JavaScript コードへの変更は必要ありません。また、[実行環境] で [ページ] オプションを選択すると、MV2 と MV3 の両方の拡張機能で機能します。

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

MV3 拡張機能の場合、ブラウザーは Web ページが読み込まれた後に拡張機能を読み込みます。つまり、マシンの速度が遅い場合、v22.10 以前の UiPath.UiAutomation.Activities アクティビティの [ブラウザーを開く] アクティビティでは、拡張機能が開始される前に 20 秒の内部タイムアウトに達する可能性があります。

v22.12.0-preview より、[ブラウザーを開く] アクティビティの内部タイムアウトの値を 20 秒から 60 秒に引き上げました。

ブラウザーの起動タイムアウトを長く設定しなければならない場合のために、[アプリケーション/ブラウザーを使用] アクティビティと [ブラウザーを開く] アクティビティからタイムアウトを設定できるようになりました。以下のプロジェクト設定が追加されています。

• [UI Automation クラシック] → [ブラウザー] → [[ブラウザーを開く] アクティビティのタイムアウト (秒)]
• [UI Automation モダン] → [アプリケーション/ブラウザー] → [[ブラウザーを開く] アクティビティのタイムアウト (秒)]

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