スクリーンショットを作成

UiPath.UIAutomationNext.Activities.NTakeScreenshot

説明

指定した UI 要素またはアプリケーションのスクリーンショットを作成して、画像ファイルとして保存します。

このアクティビティは、[アプリケーション/ブラウザーを使用] アクティビティの内部と外部の両方で使用できます。

[アプリケーション/ブラウザーを使用] アクティビティの内部に追加した場合、対象のアプリケーションのみがキャプチャされます。アプリケーション カードの外部に追加した場合は、ターゲットが指定されないため、デスクトップ全体がキャプチャされます。

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

プロジェクトの対応 OS

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

Windows and Cross-platform configuration

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

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

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

  • 画面上でターゲットを指定 - ターゲットをもう一度指定します。
  • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
• スクリーンショットの対象範囲 - [ページ全体] または [要素] を選択して、ページ全体のスクリーンショットを作成するか、1 つの要素のスクリーンショットを作成するかを選択します。既定のオプションは [ページ全体] です。
• Output to (for Windows) - Use the radio buttons to choose the output type:
  • ファイル - スクリーンショットを指定した場所にあるファイルに保存します。既定のオプションです。
  • 画像 - スクリーンショットを指定した画像に保存します。
  • クリップボード - 後から使用するために、スクリーンショットをクリップボードに画像として保存します。

• ファイル名 - 指定した UI 要素のスクリーンショットを保存するファイルの名前です。

• 自動インクリメント - ファイル名が競合する際、ファイル名に追加する文字列を定義します。ドロップダウン メニューから以下のいずれかのオプションを選択します。
  • なし (上書き) - ファイル名は指定した値と完全に一致します。同じ名前の別のファイルが既に存在する場合は、そのファイルが上書きされます。これは既定のオプションです。
  • インデックス - パターン Filename (XX) と一致するファイルが既に 1 つまたは複数存在する場合、新しく作成されるファイルの名前は Filename (N+1) となります。N は既存ファイルの最大のインデックスを示します。
  • YYYY.MM.DD at HH.MM.SS - 指定した名前のファイルが 1 つ既に存在する場合は、Filename YYYY.MM.DD at HH.MM.SS という名前で新しいファイルが作成されます。Filename YYYY.MM.DD at HH.MM.SS という名前のファイルが既に存在し、インデックスが追加されている場合は、[インデックス] の場合と同様に Filename YYYY.MM.DD at HH.MM.SS (1) というファイルが生成されます。

プロパティ パネル

入力/出力

• スクリーンショットのファイル - .png ファイルとして保存されるスクリーンショットです。
• Input element - The UI element on which the activity is executed, stored in an UIElement object. This field supports only UIElement objects. This object can be obtained from the Output Element property field of other UI Automation activities.
• Output element - Outputs a target UI Element and stores it in a UIElement object, which can be further used to target the same element with other activities.

オプション

• Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
  • 無効化 - このアクティビティの Healing Agent をオフにします。
  • ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセス レベルまたはジョブ レベルで適用します。
  • 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
  • アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。

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

タイミング

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

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

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

Windows - レガシでの設定

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

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

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

• 出力先 - ラジオ ボタンを使用して、出力の種類を選択します。

  • ファイル - スクリーンショットを指定した場所にあるファイルに保存します。既定のオプションです。
  • 画像 - スクリーンショットを指定した画像に保存します。
  • クリップボード - 後から使用するために、スクリーンショットをクリップボードに画像として保存します。
• File Name - The name of the file where the screenshot of the specified UI element is saved. Click Browse for File, then browse to the folder where to save the screenshot, and specify the file name and extension to use.

• 自動インクリメント - ファイル名が競合する場合に、スクリーンショットの保存時にファイル名に追加する文字列を選択します。たとえば、保存するファイルと同じ名前のファイルが既に存在する場合、[インデックス] を選択するとファイル名は保持され、スクリーンショットごとに新しいファイルが作成され、それぞれに連続するインデックス番号が追加されます。

  • なし (上書き) - 同じ名前のファイルが既に存在する場合は置き換えます。
  • インデックス - ファイル名に数値を追加します (例: screenshot (1).png)。
  • YYYY.MM.DD at HH.MM.SS - スクリーンショットの作成日時をファイル名に追加します (例: screenshot 2020.06.22 at 10:22:32)。

プロパティ パネル

共通

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

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

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

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

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

• 自動インクリメント - デザイナー パネルの [自動インクリメント] の説明をご覧ください。
• ファイル名 - デザイナー パネルの [ファイル名] の説明をご覧ください。
• ターゲット - ターゲット要素です。ターゲット要素を設定する必要があります。画面で指定する前は、このフィールドは (null) に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。
  • 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 つのオプションのいずれかを選択できます。
    • なし - ターゲットの準備ができるまで待機しません。
    • 対話型 - アプリの一部のみが読み込まれるまで待機します。
    • 完了 - アプリ全体が読み込まれるまで待機します。
  • ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウに使用されるセレクターです。[ウィンドウ アタッチ モード] が [アプリケーション インスタンス] に設定されている場合にのみ適用されます。

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

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

• 保存先のファイル パス - 追加されたサフィックスを含む (該当する場合)、スクリーンショットを保存するファイルのフル パスです。[自動インクリメント] プロパティがインデックス付きのスクリーンショット ファイルを保存する場所も指定します。
• 保存された画像 - 画像として保存されるスクリーンショットです。出力を [画像] に設定した場合に使用します。