画面上の画像をクリック

UiPath.Core.Activities.SAP.ClickPictureOnScreen

説明

SAP GUI 画面に表示される画像をクリックします。

プロジェクトの対応 OS

Windows - レガシ | Windows

構成

デザイナー パネル

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

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

  • 画面上で指定 - ターゲットをもう一度指定します。
  • セレクターを編集 - セレクター エディター ウィザードが開き、セレクターを設定できます。
  • UI Explorer で開く - ビジュアル ツリーで選択した UI 要素で UI Explorer が開きます。
  • 参考スクリーンショットを変更 - 対象のアプリケーションまたは Web ページのスクリーンショットを変更します。
  • 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
  • 参考スクリーンショットを表示 (ダブルクリック) - 対象のアプリケーションまたは Web ページのスクリーンショット全体を表示します。
  • オブジェクト リポジトリに追加 - 現在の UI 要素をライブラリ プロジェクトに追加し、オートメーション プロセス全体で要素を再利用することができます。
• クリックの種類 - クリック イベントをシミュレートする際に実行するマウス クリックの種類をドロップダウンから選択します。[シングル]、[ダブル]、[マウス ダウン]、または [マウス アップ] から選択します。既定のオプションは [シングル] です。

プロパティ パネル

共通

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

  注: このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True に設定されている場合、プロジェクトが実行されたときにエラーは発生しません。
• 実行後の待機時間 - アクティビティの実行後の遅延時間 (ミリ秒単位) です。既定の時間は 300 ミリ秒です。
• 実行前の待機時間 - アクティビティが何らかの操作の実行を開始する前の遅延時間 (ミリ秒単位) です。既定の時間は 200 ミリ秒です。
• 表示名 - アクティビティの表示名です。

入力

• クリックの種類 - クリック イベントをシミュレートする際に実行するマウス クリックの種類をドロップダウンから選択します。[シングル]、[ダブル]、[マウス ダウン]、または [マウス アップ] から選択します。既定のオプションは [シングル] です。
• ターゲット - ターゲット要素です。ターゲット要素を設定する必要があります。画面で指定する前は、このフィールドは (null) に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。
  • クリッピング領域 - UiElement を基準とし、左、上、右、下の方向で、クリッピング四角形 (ピクセル単位) を定義します。正と負の両方の値をサポートしています。
  • 要素 - 別のアクティビティから返される UiElement 変数を使用します。このプロパティを [セレクター] プロパティと一緒に使用することはできません。このフィールドは UiElement 変数のみをサポートします。
  • Selector - アクティビティの実行時に特定の UI 要素の検索に使用する Text プロパティです。実際には、検索しようとする GUI 要素とそのいくつかの親要素の属性を指定する XML フラグメントです。
  • タイムアウト (ミリ秒) - アクティビティの実行が完了するまで待機する時間をミリ秒単位で指定します。指定した時間が経過しても実行が完了しない場合には例外 SelectorNotFoundException をスローします。既定値は 30000 ミリ秒 (30 秒) です。
  • 準備完了まで待機 - アクションを実行する前にターゲットの準備が完了するまで待機します。次のオプションが使用できます。
    • NONE - ターゲット要素以外の要素の読み込みを待たずに、アクションを実行します。たとえば、UI 要素がすべて読み込まれるまで待つことなく、Web ページからテキストを取得したり、特定のボタンをクリックしたりする場合に、このオプションを使用できます。ボタンがまだ読み込まれていない要素 (スクリプトなど) に依存している場合、これは望ましくない結果を招く可能性があります。

    • Interactive/Complete - 実際に操作を実行する前に、対象アプリのすべての UI 要素が存在するようになるまで待ちます。

      アプリケーションが対話または完了のどちらのステートにあるか調べるには、以下のタグを検証します。

      • Desktop applications - <wnd> タグ、<ctrl> タグ、<java> タグ、または <uia> タグの存在を確認するために wm_null メッセージが送信されます。存在する場合、アクティビティが実行されます。
      • Web アプリケーション：
        • Internet Explorer - <webctrl> タグは、HTML ドキュメントの Ready ステートが Complete に設定されているかどうかを確認するために使用されます。また、Busy ステートでは、False に設定する必要があります。
        • Others - <webctrl> タグは、HTML ドキュメントの Ready ステートが Complete であるかどうかを確認するために使用されます。
      • SAP applications - 最初に <wnd> タグを確認した後、SAP 固有の API を使用して、セッションがビジーかどうかを検出します。

その他

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

オプション

• キー修飾子 - アクティビティのアクションと組み合わせて使用する修飾キーを 1 つ追加できます。使用できるオプションとして、[None (なし)]、[Alt]、[Ctrl]、[Shift]、および [Win] があります。既定のオプションは [なし] です。

  注: [キー修飾子] は、[クリックをシミュレート] オプションおよび [ウィンドウ メッセージを送信] オプションと併用できません。これらのオプションの組み合わせのいずれかを使用したアクティビティを含むワークフローを実行しても、エラーはスローされません。
• PictureOffsetX - 画像の左上の角を起点として水平方向にずらす距離を指定します。このフィールドでは Int32 型の変数のみがサポートされています。
• PictureOffsetX - 画像の左上の角を起点として水平方向にずらす距離を指定します。このフィールドでは Int32 型の変数のみがサポートされています。