ホバー

UiPath.UIAutomationNext.Activities.NHover

説明

指定した UI 要素上でホバーします。

このアクティビティは [アプリケーション/ブラウザーを使用] アクティビティに追加する必要があります。

このアクティビティを [アプリケーション/ブラウザーを使用] アクティビティの外で使用するには、入力要素を指定する必要があります。

このアクティビティはオブジェクト リポジトリに対応しています。

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

Windows and Cross-platform configuration

• 作業スコープ - 自動化対象の Web アプリケーションを表示するブラウザー タブを選択します。

• 画面上でターゲットを指定 - ターゲットとして使用する UI 要素を指定します。

  ターゲットを指定したら、プラス ボタンをクリックします。以下のオプションが表示されます。

  • 画面上でターゲットを指定 - ターゲットをもう一度指定します。
  • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
• 継続時間 - UI 要素上でホバーする時間 (秒単位) です。既定の時間は 1 秒です。
• Verify - Define activity execution verification step.
  • None - Indicates that no verification is performed on the target element.
  • Element appeared - Checks whether the element appears.
  • Element disappeared - Checks whether the element disappears.
  • Element text changed - Checks whether there are any changes in the text of the element.

プロパティ パネル

入力/出力

• 入力要素 - アクティビティの実行対象となる UI 要素で、UIElement オブジェクトに保存されます。このフィールドでは UIElement オブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティ フィールドから取得できます。
• 出力要素 - ターゲット UI 要素を出力して、UIElement オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。

オプション

• カーソルの動きの種類 - マウス カーソルにより実行される動きの種類を指定します。次の 2 つの利用可能なオプションがあります。
  • Instant - カーソルは要素にジャンプします。これは既定のオプションです。
  • Smooth - カーソルは要素まで滑らかに移動します。この設定は、[ハードウェア イベント] 入力モードが使用されている場合にのみ有効です。
• 入力モード - ロボットが対象のアプリケーションと対話するメソッドを、以下より選択します。
  • アプリ/ブラウザーと同一 - [アプリケーション/ブラウザーを使用] アクティビティと同じ入力モードを使用します。
  • ハードウェア イベント - ハードウェア ドライバーを使用してアクションを実行します。動作が極めて遅く、バックグラウンドでは動作しませんが、すべてのデスクトップ アプリに対して使用できます。
  • シミュレート - アクセシビリティ API を使用してシミュレートします。ブラウザー、Java ベースのアプリケーション、および SAP を使用する場合に推奨されます。通常はハードウェア イベントよりも信頼性が高くなります。すべてのテキストを 1 回の操作で送信します。対象のアプリにフォーカスしていなくても動作します。対象のアプリケーションの UI 要素がこの方法をサポートしているかどうかをテストしてください。
  • Chromium API - Performs actions using debugger APIs. Works only for Chromium elements. Sends all text in one go. Works even if target app is not in focus. For more details, refer to Chromium API.
  • Window Messages (Windows only) - Simulate using Win32 messages. Recommended for desktop apps. Usually more reliable than Hardware Events. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.
• Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
  • 無効化 - このアクティビティの Healing Agent をオフにします。
  • ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセス レベルまたはジョブ レベルで適用します。
  • 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
  • アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。
• Continue on error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

ターゲット

• Expand target properties - Display target and anchor properties. This will hide the other activity properties and display only those related to the target.

• Collapse target properties - Hide target and anchor properties. This will hide target related properties and display the activity properties.

• ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウン メニュー内の任意の組み合わせを設定できます。
  • None
  • Strict selector - The strict selector generated for the target UI element.
  • Fuzzy selector - The fuzzy selector parameters.

  • Computer Vision - ターゲット メソッドとして Computer Vision を使用するには、[プロジェクト設定] > [Computer Vision] に移動し、正しいサーバー エンドポイントを設定する必要があります。このフィールドはそのままにして、既定で入力されている「UiPath Cloud」を使用するか、他のパブリック エンドポイントを選択して別の値を入力できます。別の値を入力する場合、サーバー リージョンまたは独自のオンプレミス サーバー専用のエンドポイントを選択します。

    Another way of using Computer Vision as a targeting method is to set Use Local Server to True. This implies that the UiPath.ComputerVision.LocalServer package is installed in your project. When Local Server is enabled, the server value is over-written. However, the Local Server is not available in cross-platform projects.

    • CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
    • CV テキスト - Computer Vision で識別するテキストを指定します。
    • CV Text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
    • CV Text accuracy - Indicates the accuracy level for OCR text matching.
  • Semantic selector - Leverages large language models (LLMs) to generate functional, human-like descriptions of UI elements. These descriptions are highly reliable making them adaptable to UI changes and significantly improving automation resilience when traditional selectors fail.
  • Image (Windows only)
    • Image accuracy - Indicates the accuracy level for image matching.
    • Image occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
  • Native text (Windows only)
    • Native text - The text to find to identify the UI element.
    • Native text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
• Window selector (Application instance) - Selector for the application window. Only applicable when window attach mode is set to application instance.
• Wait for page load - Before performing the action, wait for the application to becaome ready to accept input. The options are:
  • なし - ターゲットの準備ができるまで待機しません。
  • 対話型 - アプリの一部のみが読み込まれるまで待機します。
  • 完了 - アプリ全体が読み込まれるまで待機します。
• Visibility check - When enabled, the activity also checks whether the UI element is visible or not. You can choose one of three options from the drop-down menu:
  • なし - 可視性を確認しません。
  • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
  • 完全に表示されている - UI 要素が表示されるかどうかを確認します。
• レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。

Target - Clipping region

• アンカー ポイント - [X のオフセット] プロパティと [Y のオフセット] プロパティで設定したオフセットが追加される、カーソルの開始位置を表します。指定できるオプションは、TopLeft、 TopRight、BottomLeft、BottomRight および Center です。既定では、Center が選択されています。
• X のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から水平方向にずらす距離を指定します。既定値は 300 秒です。このフィールドは、Int32 型変数のみをサポートします。
• Y のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から垂直方向にずらす距離を指定します。既定値は 300 秒です。このフィールドは、Int32 型変数のみをサポートします。
• Offset width - Width of the offset region.
• Offset height - Height of the offset region.

Target - Offset point

• アンカー ポイント - [X のオフセット] プロパティと [Y のオフセット] プロパティで設定したオフセットが追加される、カーソルの開始位置を表します。指定できるオプションは、TopLeft、TopRight、BottomLeft、BottomRight および Center です。既定では、Center が選択されています。
• X のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から水平方向にずらす距離を指定します。
• Y のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から垂直方向にずらす距離を指定します。

タイミング

• 実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• 実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

Windows - レガシでの設定

• [アプリ/ブラウザーで指定] を選択して、ターゲットとして使用する UI 要素を指定します。

  ターゲットを指定したら、メニュー ボタンをクリックします。以下のオプションが表示されます。

  • 画面上でターゲットを指定 - ターゲットをもう一度指定します。
  • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
  • 検証を追加/検証を削除 - アクティビティ カードの [画面上で検証ターゲットを指定] 機能を追加または削除します。検証の実行は既定で有効化されています。
  • 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
  • オブジェクト リポジトリに追加 - 現在の UI 要素をライブラリ プロジェクトに追加し、オートメーション プロセス全体で要素を再利用することができます。
• Duration - The duration (in seconds) during which the specified UI element is hovered. You can choose a predetermined value from the drop-down menu: 1, 3, 5. The default value is 1 second. Alternatively, you can select the Plus button and use one of the options in the menu to enter the duration.
• 画面上で検証ターゲットを指定 - ターゲットとして使用し、操作の実行後に表示または非表示にする必要のある UI 要素を指定します。この機能は、アクティビティによって実行される特定の操作が実行時に正しく実行されたことを確認する場合に使用します。この機能は特に、自動化されたプロセスで、ある操作の結果として特定の UI 要素が表示されたか、または表示されなくなったかを確認する必要がある場合に便利です。プロセスが期待どおりに実行されていることを確認するための検証レイヤーを追加できます。オートメーション プロセスが特定の手順が正しく実行されることに依存している場合は、実行を検証することをお勧めします。この機能は [プロジェクト設定] で鵜有効化するか、アクティビティの本体で [検証を追加] を選択して有効化できます。

プロパティ パネル

共通

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

• 実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• 実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

• 表示名 - デザイナー パネルに表示される、アクティビティの名前です。表示名は、ターゲットを指定すると自動的に生成されます。

• タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

• カーソルの動きの種類 - マウス カーソルにより実行される動きの種類を指定します。次の 2 つの利用可能なオプションがあります。

  • Instant - カーソルは要素にジャンプします。これは既定のオプションです。
  • Smooth - カーソルは要素まで滑らかに移動します。この設定は、[ハードウェア イベント] 入力モードが使用されている場合にのみ有効です。
• ターゲット - ターゲット要素です。ターゲット要素を設定する必要があります。画面で指定する前は、このフィールドは (null) に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。
  • クリックのオフセット - [クリック] アクティビティのオフセットを詳細に設定できます。
    • アンカー ポイント - [X のオフセット] プロパティと [Y のオフセット] プロパティで設定したオフセットが追加される、カーソルの開始位置を表します。指定できるオプションは、TopLeft、 TopRight、BottomLeft、BottomRight および Center です。既定では、Center が選択されています。
    • X のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から水平方向にずらす距離を指定します。このフィールドでは、Int32 型の変数のみがサポートされています。
    • Y のオフセット - カーソルの位置を、[アンカー ポイント] プロパティで選択した位置から垂直方向にずらす距離を指定します。このフィールドでは、Int32 型の変数のみがサポートされています。
  • CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
  • CV テキスト - Computer Vision で識別するテキストを指定します。
  • あいまいセレクター - あいまいセレクターのパラメーターです。
  • ネイティブ テキスト - UI 要素の識別に使用されるテキストです。
  • レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。
  • 厳密セレクター - UI 要素に対して生成される厳密セレクターです。
  • ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウン メニュー内の任意の組み合わせを設定できます。
    • None
    • 厳密セレクター
    • あいまいセレクター
    • 画像
    • ネイティブ テキスト
    • Computer Vision - ターゲット メソッドとして Computer Vision を使用するには、[プロジェクト設定] > [Computer Vision] に移動し、正しいサーバー エンドポイントを設定する必要があります。このフィールドはそのままにして、既定で入力されている「UiPath Cloud」を使用するか、他のパブリック エンドポイントを選択して別の値を入力できます。別の値を入力する場合、サーバー リージョンまたは独自のオンプレミス サーバー専用のエンドポイントを選択します。

      Computer Vision をターゲット メソッドとして使用するもう 1 つの方法は、[ローカル サーバーを使用] を [True] に設定することです。これは、UiPath.ComputerVision.LocalServer パッケージがプロジェクトにインストールされていることを意味します。ローカル サーバーが有効な場合、サーバーの値は上書きされます。ただし、ローカル サーバーはクロスプラットフォーム プロジェクトでは利用できません。

    • セマンティック セレクター - 大規模言語モデル (LLM) を活用して、人間が書くような UI 要素の機能的な記述を生成します。これらの記述は信頼性が高いため、UI の変更に適応でき、従来のセレクターが失敗した場合のオートメーションの回復性が大幅に向上します。
  • 可視性を確認 - UI 要素が表示されているかどうかを確認します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
    • なし - 可視性を確認しません。
    • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
    • 完全に表示されている - UI 要素が表示されるかどうかを確認します。
  • ページの読み込みを待機 - アプリケーションが入力を受け入れる準備が完了するまで、アクションの実行を待機します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
    • なし - ターゲットの準備ができるまで待機しません。
    • 対話型 - アプリの一部のみが読み込まれるまで待機します。
    • 完了 - アプリ全体が読み込まれるまで待機します。
  • ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウに使用されるセレクターです。[ウィンドウ アタッチ モード] が [アプリケーション インスタンス] に設定されている場合にのみ適用されます。

• 実行を検証 - 実行時に、アクティビティによって実行された操作が正しいかどうかを検証します。それには、操作の実行後も表示されている必要のある要素、または表示されている必要のない要素を指定して、それをアクティビティの実行後に監視および検証します。この機能は [プロジェクト設定] で有効化するか、アクティビティの本体でコンテキスト メニューから [検証を追加] を選択して有効化します。

  • 表示名 - 検証アクションの表示名です。このフィールドは、選択した検証アクションと要素に基づいて自動入力されます。実行の検証を設定すると、この表示名がアクティビティ カード内に表示されます。
  • リトライ - オンにすると、期待される結果が達成されない場合は、アクティビティのタイムアウトまでの期間、アクションがリトライされます。既定では、このチェック ボックスはオンになっています。
  • ターゲット - このターゲットを使用して、実行時に検証する要素を指定します。このプロパティの下で展開できるプロパティ フィールドの詳細については、上の [ターゲット] プロパティをご覧ください。プロパティの機能は同じです。
  • タイムアウト - 検証対象の要素が出現、消滅、または変化するまで待機する時間 (秒) です。[リトライ] チェックボックスをオンにすると、アクションが再度実行された後、アクティビティの [タイムアウト] プロパティで指定した時間の間、検証が行われます。既定値は 10 秒です。
  • 要素の次の動作を検証 - 検証ターゲットのどのような変更を確認するかを定義します。利用可能なオプションは次のとおりです。
    • 出現 - 要素が出現するかどうかを確認します。
    • 消滅 - 要素が消滅するかどうかを確認します。
    • テキストの変化 - 要素のテキストに変化があるかどうかを確認します。
    • 表示の変化 - 要素の画像に変化があるかどうかを確認します。

• 入力要素 - アクティビティの実行対象となる UI 要素で、UIElement オブジェクトに保存されます。このフィールドでは UIElement オブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティ フィールドから取得できます。
• 出力要素 - ターゲット UI 要素を出力して、UIElement オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。

• プライベート - オンにすると、変数および引数の値が Verbose レベルでログに出力されなくなります。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。

• 継続時間 - デザイナー パネルの [継続時間] の説明をご覧ください。

• 入力モード - ロボットが対象のアプリケーションと対話するメソッドを、以下より選択します。

  • アプリ/ブラウザーと同一 - [アプリケーション/ブラウザーを使用] アクティビティと同じ入力モードを使用します。

  • ハードウェア イベント - ハードウェア ドライバーを使用してアクションを実行します。動作が極めて遅く、バックグラウンドでは動作しませんが、すべてのデスクトップ アプリに対して使用できます。

  • シミュレート - アクセシビリティ API を使用してシミュレートします。ブラウザー、Java ベースのアプリケーション、および SAP を使用する場合に推奨されます。通常はハードウェア イベントよりも信頼性が高くなります。すべてのテキストを 1 回の操作で送信します。対象のアプリにフォーカスしていなくても動作します。対象のアプリケーションの UI 要素がこの方法をサポートしているかどうかをテストしてください。

  • Chromium API - デバッガー API を使用してアクションを実行します。これは、Chromium の要素に対してのみ動作します。すべてのテキストを一度に送信します。対象のアプリにフォーカスしていなくても動作します。詳しくは、こちらのページをご覧ください。

  • ウィンドウ メッセージ - Win32 メッセージを使用してシミュレートします。デスクトップ アプリに適しています。通常はハードウェア イベントよりも信頼性が高くなります。すべてのテキストを 1 回の操作で送信します。対象のアプリにフォーカスしていなくても動作します。対象のアプリケーションの UI 要素がこの方法をサポートしているかどうかをテストしてください。