ドラッグ アンド ドロップ

UiPath.UIAutomation.Activities.NDragAndDrop

説明

ソース UI 要素からターゲット UI 要素へのドラッグ アンド ドロップ操作を実行します。

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

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

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

プロジェクトの対応 OS

Windows - レガシ | Windows

Windows - レガシ、Windows での設定

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

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

  • 画面上でターゲットを指定 - ターゲットをもう一度指定します。
  • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
  • 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
  • オブジェクト リポジトリに追加 - 現在の UI 要素をライブラリ プロジェクトに追加し、オートメーション プロセス全体で要素を再利用することができます。

プロパティ パネル

• ページの読み込みを待機 - アプリケーションが入力を受け入れる準備が完了するまで、アクションの実行を待機します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
  • なし - ターゲットの準備ができるまで待機しません。
  • 対話型 - アプリの一部のみが読み込まれるまで待機します。
  • 完了 - アプリ全体が読み込まれるまで待機します。

• 可視性を確認 - UI 要素が表示されているかどうかを確認します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
  • なし - 可視性を確認しません。
  • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
  • 完全に表示されている - UI 要素が表示されるかどうかを確認します。

• レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。

ターゲット - ターゲット - オフセット ポイント

UI 要素のドラッグ アンド ドロップ先の場所です。使用するターゲットを画面で指定する前は、このフィールドは (null) に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。このフィールドの子プロパティは、[ターゲット] プロパティに固有のプロパティと同じです。

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

入力/出力

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

• 出力要素 - ターゲット UI 要素を出力して、UIElement オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。

オプション

• マウス ボタン - ドラッグ アンド ドロップ操作に使用するマウス ボタンです。利用可能なオプションは、[左]、[右]、[中央] です。
• アクション間の待機時間 - ドラッグ アンド ドロップ操作を実行するために必要な、アクション間の待機時間 (秒単位) です。 このフィールドの既定値は 0.3 です。

• Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
  • 無効化 - このアクティビティの Healing Agent をオフにします。
  • ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセス レベルまたはジョブ レベルで適用します。
  • 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
  • アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。
• キー修飾子 - このフィールドでは、ドラッグ アンド ドロップ操作時に使用するキー修飾子を指定できます。アクションに対して複数のキー修飾子を選択できます。 使用できるオプションとして、[None (なし)]、[Alt]、[Ctrl]、[Shift]、および [Win] があります。
• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

ターゲット

• ターゲットのプロパティを展開 - ターゲットとアンカーのプロパティを表示します。これにより、アクティビティの他のプロパティは非表示になり、ターゲットに関連するプロパティのみが表示されます。

• ターゲットのプロパティを折りたたみ - ターゲットとアンカーのプロパティを非表示にします。これにより、ターゲットに関連するプロパティが非表示になり、アクティビティのプロパティが表示されます。

• ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウン メニュー内の任意の組み合わせを設定できます。
  • None
  • 厳密セレクター - ターゲット UI 要素に対して生成される厳密セレクターです。
  • あいまいセレクター - あいまいセレクターのパラメーターです。

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

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

    • CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
    • CV テキスト - Computer Vision で識別するテキストを指定します。
    • CV テキストの出現 回数 - 複数の一致が見つかった場合に使用する特定の出現を示します。
    • CV テキストの精度 - OCR でテキスト照合の精度レベルを示します。
  • セマンティック セレクター - 大規模言語モデル (LLM) を活用して、人間が書くような UI 要素の機能的な記述を生成します。これらの記述は信頼性が高いため、UI の変更に適応でき、従来のセレクターが失敗した場合のオートメーションの回復性が大幅に向上します。
  • 画像
    • 画像の精度 - 画像照合の精度レベルを指定します。
    • 画像の発生 - 複数の一致が見つかった場合に使用する特定の出現位置を指定します。
  • ネイティブ テキスト
    • ネイティブ テキスト - UI 要素を識別するために検索するテキストです。
    • ネイティブ テキストの出現 - 複数の一致が見つかった場合に使用する特定の出現を示します。
• ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウのセレクターです。[ウィンドウ アタッチ モード] を [アプリケーション インスタンス] に設定している場合にのみ適用されます。
• ページの読み込みを待機 - アクションを実行する前に、アプリケーションが入力を受け入れる準備が整うまで待機します。以下のオプションを利用できます。
  • なし - ターゲットの準備ができるまで待機しません。
  • 対話型 - アプリの一部のみが読み込まれるまで待機します。
  • 完了 - アプリ全体が読み込まれるまで待機します。
• 表示設定の確認 - 有効化すると、アクティビティは UI 要素が表示されているかどうかも確認します。ドロップダウン メニューから次の 3 つのオプションのいずれかを選択できます。
  • なし - 可視性を確認しません。
  • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
  • 完全に表示されている - UI 要素が表示されるかどうかを確認します。
• レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。

ターゲット - オフセット ポイント

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

タイミング

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

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

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