UI Automation クラシックのプロジェクト設定

これらのプロジェクト設定は、Windows - レガシ プロジェクトのクラシック アクティビティと Windows プロジェクトに適用されます。

[プロジェクト設定] を使用して、プロジェクト レベルで変更を設定します。これらのグローバル設定は、以下に示すプロパティを持つ、パッケージ内のすべてのアクティビティに影響を与えます。詳しくは、「アクティビティのプロジェクト設定を行う」をご覧ください。

重要: [プロジェクト設定] 内で設定されたプロパティは、ワークフローのアクティビティにおいて、プロパティが編集されていない場合にのみ有効化されます。プロパティを手動で編集すると、プロジェクトの設定が適用されなくなります。

UI Automation クラシックのプロジェクト設定を構成するには、次の手順を実行します。

1. [プロジェクト] パネルの [プロジェクト設定] に移動します。
2. [アクティビティ設定] > [UI Automation クラシック] に移動します。
3. 変更する内容に従って設定を行います。
4. [OK] をクリックして変更を保存します。

ウィンドウ上部の [一括処理] ドロップダウン メニューを使用すると、すべての設定を既定値にリセットしたり、デバッグ用と運用環境のフィールド間ですべての値をコピーしたりすることができます。

一般

以下の設定は、Windows - レガシ プロジェクトの UI Automation クラシック アクティビティと、次のいずれかのプロパティを持つ Windows プロジェクトに適用されます。

プロパティ名	説明
実行前の待機時間	直前のアクティビティと現在のアクティビティの間の遅延時間 (ミリ秒) です。
実行後の待機時間	現在のアクティビティと次のアクティビティの間の遅延時間 (ミリ秒) です。
タイムアウト (ミリ秒)	エラーをスローする前に現在のアクティビティの実行を待機する時間です。
準備完了まで待機	アプリケーションが入力を受け入れる準備が完了するまで、アクションの実行を待機します。次のオプションが利用可能です。 なし - ターゲットの準備ができるまで待機しません。 対話型 - アプリの一部のみが読み込まれるまで待機します。 完了 - アプリ全体が読み込まれるまで待機します。
無効な場合でも動作を実行	[True] に設定すると、指定した UI 要素が無効化されていても項目の選択が実行されます。このプロパティは、[入力モード] プロパティが [ハードウェア イベント] に設定されている場合は適用されません。
スクリーンショットをキャプチャ	この機能をサポートするすべてのアクティビティで、設計時にスクリーンショットをキャプチャするかどうかを指定します。[False] に設定すると、コンテキスト メニューの [参考スクリーンショットを削除] オプションは無効化されます。
要素が見つからないことを示すエラー メッセージ内に、最も近い一致を表示	[True] に設定すると、要素が見つからない場合に表示されるエラー メッセージを短くします。これは、機密性の高いセレクター情報を保護するのに便利です。

ブラウザー

以下の設定は、[ブラウザーを開く] アクティビティと [ブラウザーにアタッチ] アクティビティに適用されます。

プロパティ名	説明
ブラウザー	ドロップダウン メニューから、使用するブラウザーの種類を選択します。次のオプションが利用できます。 IE Firefox Chrome Edge カスタム - JxBrowser などの他の Chromium ベースのブラウザーに適しています。
プライベート (Private)	[True] に設定すると、変数と引数の値が Verbose レベルでログ記録されなくなります。
新しいセッション	[True] に設定すると、選択したブラウザーの新しいセッションを開始します。このオプションは Internet Explorer に固有です。
非表示	[True] に設定すると、隠しブラウザーを開きます。
WebView2 のネイティブな自動化を有効化	WebView2 は、ブラウザーをデスクトップ アプリケーションに統合したり、Web アプリケーションをデスクトップ アプリケーションとして表示したりする場合に使用するテクノロジです。[True] に設定すると、WebView2 のネイティブ オートメーション プロジェクト設定を使用して、埋め込みブラウザー (例:埋め込み Edge) のオートメーションを HTML 属性ベースのセレクターで操作できます。
MV3 拡張機能使用時のクリックをシミュレートの回避策を有効化	入力メソッドが [シミュレート] に設定された [クリック] アクティビティが特定の Web ページの要素で失敗する問題を回避できます。詳しくは、トラブルシューティングのページをご覧ください。この設定は、クラシック クリックやモダン クリックなど、[入力メソッド] が [シミュレート] で実行されるすべてのクリックに適用されます。
通信方法	通信方法を選択します。次のオプションが利用できます。 ネイティブ WebDriver
ユーザー データ フォルダー モード	設定するユーザー データ フォルダー モードです。特定のユーザー データ フォルダーでブラウザーを起動するために使用します。いくつかのオプションが利用できます。 Automatic - ピクチャ イン ピクチャ モードの場合は既定のモードと異なるフォルダーを使用します。[ユーザー データ フォルダー パス] が設定されていない場合はフォルダーが自動で生成されます。 DefaultFolder - ブラウザーがメインまたは PIP セッションのどちらで実行されても、既定のブラウザー フォルダーを使用します。 CustomFolder - [ユーザー データ フォルダー パス] で指定したフォルダー、またはパスが設定されていない場合は自動生成されるパスを使用します。
ユーザー データ フォルダー パス	ブラウザーが使用するユーザー データ フォルダーです。既定値は以下のとおりです。 %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType (設定されていない場合)。
ランタイム ブラウザー	ランタイム ブラウザーのプロジェクト設定では、実行時にブラウザーを切り替えることができます。これを使用して、設計時に使用したブラウザー以外のブラウザーで実行することができます。設定されている場合、ブラウザーの種類とセレクターが自動的に変換されます。この設定には、以下のオプションがあります。 なし - 設計時に定義されたブラウザーの種類とセレクターを保持します。[なし] に設定されている場合、設定はランタイム実行に一切影響を与えません。このオプションは既定で選択されています。 Chrome - ブラウザーの種類とセレクターのプロパティを Chrome に合わせます。 Edge - ブラウザーの種類とセレクターのプロパティを Edge に合わせます。 Firefox - ブラウザーの種類とセレクターのプロパティを Firefox に合わせます。
Chrome ブラウザー起動用の追加引数	Chrome ブラウザーを開くための追加のコマンド ライン引数です。クラシックの [ブラウザーを開く] アクティビティとモダンの [ブラウザーを使用] アクティビティに適用されます。
Edge ブラウザー起動用の追加引数	Edge ブラウザーを開くための追加のコマンド ライン引数です。クラシックの [ブラウザーを開く] アクティビティとモダンの [ブラウザーを使用] アクティビティに適用されます。
Chrome ブラウザー起動用のカスタムの実行可能ファイル パス	Chrome ブラウザーを開くためのカスタムの実行可能ファイル パスです。クラシックの [ブラウザーを開く] アクティビティとモダンの [ブラウザーを使用] アクティビティに適用されます。
Edge ブラウザー起動用のカスタムの実行可能ファイル パス	Edge ブラウザーを開くためのカスタムの実行可能ファイル パスです。クラシックの [ブラウザーを開く] アクティビティとモダンの [ブラウザーを使用] アクティビティに適用されます。
Chrome ブラウザーの起動リトライを有効化	拡張機能の NativeHost の起動に失敗した場合に、Chrome の起動をリトライします。クラシックの [ブラウザーを開く] アクティビティとモダンの [ブラウザーを使用] アクティビティに適用されます。
Edge ブラウザーの起動リトライを有効化	拡張機能の NativeHost の起動に失敗した場合に、Edge の起動をリトライします。クラシックの [ブラウザーを開く] アクティビティとモダンの [ブラウザーを使用] アクティビティに適用されます。
[ブラウザーを開く] アクティビティのタイムアウト (秒)	ブラウザー起動時のタイムアウト値を設定します。

ロボット ログ

ロボット実行ログに保存される情報です。

プロパティ名	説明
ターゲット情報をログに記録	[True] に設定すると、UI Automation クラシック アクティビティは、アクティビティの種類、アクティビティの表示名、セレクターをログに記録します。また、[ブラウザーを開く] アクティビティの場合は、アクティビティの種類、アクティビティの表示名、URL がログに記録されます。

ツールチップ

以下の設定は、[ツールチップ] アクティビティに適用されます。

プロパティ名	説明
タイマー	ポップアップが自動的に閉じられるまでの期間 (ミリ秒) です。既定では、ポップアップは閉じません。

データ スクレイピング

以下の設定は、[構造化データを抽出] アクティビティに適用されます。

プロパティ名	説明
ページ間の待機時間 (ミリ秒)	次のページが読み込まれるまで待機する時間をミリ秒で指定します。ページの読み込み時間が長いほど、この値を大きくする必要があります。

要素の存在を確認

以下の設定は、[要素の存在を確認] アクティビティに適用されます。

プロパティ名	説明
タイムアウト (ミリ秒)	要素が存在しない場合にアクティビティが実行されるまでの待機時間 (ミリ秒単位) を指定します。

強調表示

以下の設定は、[強調表示] アクティビティに適用されます。

プロパティ名	説明
強調表示する時間	指定した UI 要素が強調表示される時間 (ミリ秒単位) です。

キーボード イベント

以下の設定は、[選択されたテキストをコピー]、[文字を入力]、[SecureString で文字を入力] アクティビティに適用されます。

注: 入力メソッド [ウィンドウ メッセージを送信] および [入力をシミュレート] は相互に排他的であり、両方を選択すると実行時にエラーがスローされます。

プロパティ名	説明
ウィンドウ メッセージを送信	[True] に設定すると、対象のアプリケーションに特定のメッセージを送信する方法で操作が実行されます。この入力メソッドはバックグラウンドで動作し、ほとんどのデスクトップ アプリに対応していますが、最速のメソッドではありません。
入力前にクリック	[True] に設定すると、指定した UI 要素がテキストを書き込む前にクリックされます。
フィールド内を削除	[True] に設定すると、UI 要素内に既に存在するすべての内容がテキストを書き込む前に削除されます。
入力をシミュレート	[True] に設定すると、対象のアプリケーションのテクノロジを使用して入力操作がシミュレートされます。この入力メソッドは最速であり、バックグラウンドでの動作が可能です。

SAP

SAP の操作を自動化する時にすべての UI Automation アクティビティに適用されます。

重要: このプロジェクト設定は、UI Automation クラシック アクティビティと UI Automation モダン アクティビティの両方に適用されます。

プロパティ名	説明
ハード タイムアウトを強制 (SAP WinGUI にのみ)	SAP WinGUI の操作を自動化するすべてのアクティビティにハード タイムアウトを強制適用します。
追加のスケーリングを有効化	SAP WinGUI の追加スケーリングを有効化して、SAP ネイティブのマルチモニター スケーリングに対応できるようにします。
SAP の監視を有効化	実行時に SAP のオートメーションの監視を有効化します。SAP WinGUI、SAP WebGUI、および SAP Fiori に適用されます。

ホットキーを押下

以下の設定は、[ホットキーを押下] アクティビティに適用されます。

プロパティ名	説明
ウィンドウ メッセージを送信	[True] に設定すると、対象のアプリケーションに特定のメッセージを送信する方法で操作が実行されます。この入力メソッドはバックグラウンドで動作し、ほとんどのデスクトップ アプリに対応していますが、最速のメソッドではありません。

MouseEvents

以下の設定は、[クリック]、[ダブルクリック]、[ホバー]、[構造化データを抽出] アクティビティに適用されます。

プロパティ名	説明
ウィンドウ メッセージを送信	[True] に設定すると、対象のアプリケーションに特定のメッセージを送信する方法で操作が実行されます。この入力メソッドはバックグラウンドで動作し、ほとんどのデスクトップ アプリに対応していますが、最速のメソッドではありません。
クリックをシミュレート	[True] に設定すると、対象のアプリケーションのテクノロジを使用してクリック操作がシミュレートされます。この入力メソッドは最速であり、バックグラウンドでの動作が可能です。
ホバーをシミュレート	[True] に設定すると、対象のアプリケーションのテクノロジを使用してホバー操作がシミュレートされます。この入力メソッドは最速であり、バックグラウンドでの動作が可能です。

スクリーンショット

以下の設定は、[スクリーンショットを作成] アクティビティに適用されます。

プロパティ名	説明
待ち時間	指定した UI 要素のスクリーンショットを作成する前の待機時間 (ミリ秒単位) です。既定の時間は 300 ミリ秒です。

その他のアクティビティ

以下の設定は、[JS スクリプトを挿入] アクティビティに適用されます。

プロパティ名	説明
JS スクリプトを挿入 - 実行環境	InjectJs.ExecutionWorld 設定をグローバルに適用します。詳しくは、「JS スクリプトを挿入」をご覧ください。