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

UiPath.UIAutomationNext.Activities.NTakeScreenshot

説明

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

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

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

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

プロジェクトの対応 OS

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

Windows、クロスプラットフォームでの設定

• 作業スコープ - [ スクリーンショットを作成 ] アクティビティが入れ子になった [アプリケーション/ブラウザーを使用 ] カード内に配置された場合に、自動化対象の Web アプリケーションを表示するブラウザー タブを選択します。

• スクリーンショットの対象範囲 - [ページ全体] または [要素] を選択して、ページ全体のスクリーンショットを作成するか、1 つの要素のスクリーンショットを作成するかを選択します。既定のオプションは [ページ全体] です。

• 画面上でターゲットを指定 - ターゲットとして使用する UI 要素を指定します。このボタンは、[スクリーンショット] コンテナーとして [要素] オプションが選択されている場合にのみ使用できます。ターゲットを指定したら、参考スクリーンショットの横のハンバーガー メニューをクリックして、以下のオプションを表示します。

  • ターゲットを指定 - ターゲットをもう一度指定します。記述子がオブジェクト リポジトリで定義されている場合、現在のアクティビティに対してのみ記述子を指定するには、オブジェクト リポジトリから記述子を削除する必要があります。
  • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
  • 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
  • 参考スクリーンショットを変更 - 対象のアプリケーションまたは Web ページのスクリーンショットを変更します。
  • オブジェクト リポジトリに追加 - 現在の UI 要素をライブラリ プロジェクトに追加し、オートメーション プロセス全体で要素を再利用することができます。このオプションは、オブジェクトがまだオブジェクト リポジトリに追加されていない場合にのみ表示されます。
  • オブジェクト リポジトリに表示 - 記述子を選択した状態で [オブジェクト リポジトリ] パネルを開きます。このオプションは、オブジェクトがオブジェクト リポジトリに追加されている場合にのみ表示されます。
  • オブジェクト リポジトリへのリンクを解除 - オブジェクト リポジトリへの記述子のリンクを解除します。このオプションは、オブジェクトがオブジェクト リポジトリに追加されている場合にのみ表示されます。

• 出力先 (Windows プロジェクトでのみ利用可能) - ラジオ ボタンを使用して、出力の種類を選択します。

  • ファイル - スクリーンショットを指定した場所にあるファイルに保存します。既定のオプションです。
  • 画像 - スクリーンショットを指定した画像に保存します。
  • クリップボード - 後から使用するために、スクリーンショットをクリップボードに画像として保存します。

• ファイル名 - 指定した 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)というファイルが生成されます。

プロパティ パネル

ターゲットこのセクションは、[スクリーンショット] コンテナーとして [要素] オプションが選択されている場合にのみ使用できます。

• ターゲットのプロパティを展開/ターゲットのプロパティを折りたたみ - ターゲット コンテナーとそのアンカーのプロパティを表示/非表示にします。
• ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティは、ドロップダウン メニューから任意の組み合わせに設定でき、少なくとも 1 つのターゲット メソッドを選択する必要があります。
  • 厳密セレクター
  • あいまいセレクター
  • 画像 (Windows プロジェクトでのみ利用可能)
  • ネイティブ テキスト (なし、Windows プロジェクトでのみ利用可能)
  • Computer Vision
  • セマンティック セレクター
• ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウに使用されるセレクターです。[ウィンドウ アタッチ モード] が [アプリケーション インスタンス] に設定されている場合にのみ適用されます。
• 厳密セレクター - UI 要素に対して生成される厳密セレクターです。ターゲット メソッド として [厳密選択 ] が選択されている場合にのみ表示されます。
• あいまいセレクター - あいまいセレクターのパラメーターです。ターゲット メソッドが あいまい選択 のターゲット メソッドが選択されている場合にのみ表示されます。
• 画像の精度 - 画像照合の精度レベルを指定します。既定値は 0.8 です。画像のターゲット メソッドが選択されている場合にのみ表示されます。
• 画像の発生 - 複数の一致が見つかった場合に使用する特定の出現位置を指定します。画像のターゲット メソッドが選択されている場合にのみ表示されます。
• ネイティブ テキスト - UI 要素の識別に使用されるテキストです。ネイティブのターゲット メソッドが選択されている場合にのみ表示されます。
• ネイティブ テキストの出現 - 複数の一致が見つかった場合に使用する特定の出現を示します。ネイティブのターゲット メソッドが選択されている場合にのみ表示されます。
• ネイティブ テキスト 大文字と小文字を区別 - 天気のテキストの照合で大文字と小文字が区別されることを示します。ネイティブのターゲット メソッドが選択されている場合にのみ表示されます。
• CV コントロールの種類 - Computer Vision を使用して識別されるコントロールの種類を指定します。ターゲット メソッドが Computer Vision に設定されている場合にのみ表示されます。
• CV テキスト - Computer Vision を使用して識別されたテキストを示します。ターゲット メソッドが Computer Vision に設定されている場合にのみ表示されます。
• CV テキストの精度 - OCR でテキスト照合の精度レベルを示します。既定値は 0.7 です。ターゲット メソッドが Computer Vision に設定されている場合にのみ表示されます。
• CV テキストの出現 回数 - 複数の一致が見つかった場合に使用する特定の出現を示します。ターゲット メソッドが Computer Vision に設定されている場合にのみ表示されます。
• セマンティック セレクター - ターゲットを定義するセマンティックな記述です。セマンティック ターゲット メソッドが選択されている場合にのみ表示されます。
• ページの読み込みを待機 - アプリケーションが入力を受け入れる準備が完了するまで、アクションの実行を待機します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
  • なし - ターゲットの準備ができるまで待機しません。
  • 対話型 - アプリの一部のみが読み込まれるまで待機します。
  • 完了 - アプリ全体が読み込まれるまで待機します。
• 可視性を確認 - UI 要素が表示されているかどうかを確認します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
  • なし - 可視性を確認しません。
  • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
  • 完全に表示されている - UI 要素が表示されるかどうかを確認します。
• レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。
• ターゲット - クリッピング領域 - クリッピング領域を指定します。この領域は、さらに構成することができます。これを使用し、実行時にターゲットのセレクターを使用して見つかった UI 要素のより小さい、または大きい領域を選択したり、ターゲットの [入力要素 ] プロパティで直接指定したりすることができます。
  • アンカー ポイント - [X のオフセット] プロパティと [Y のオフセット] プロパティで設定したオフセットが追加される、カーソルの開始位置を表します。指定できるオプションは、TopLeft、TopRight、BottomLeft、BottomRight、および Center (既定で選択) です。
  • X のオフセット - [ アンカー ポイント ] プロパティで選択した領域を水平方向にずらす距離を指定します。このフィールドでは Int32 型の変数のみがサポートされています。
  • Y のオフセット - [ アンカー ポイント ] プロパティで選択した領域を垂直方向にずらす距離を指定します。このフィールドでは Int32 型の変数のみがサポートされています。
  • オフセットの幅 - オフセット領域の幅です。
  • オフセット高さ - オフセット領域の高さです。

オプション

• Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。

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

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

タイミング

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

入力/出力

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

Windows - レガシでの設定

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

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

• 画面上でターゲットを指定 - ターゲットをもう一度指定します。
• ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
• 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。

• 出力先 - ラジオ ボタンを使用して、出力の種類を選択します。
  • ファイル - スクリーンショットを指定した場所にあるファイルに保存します。既定のオプションです。
  • 画像 - スクリーンショットを指定した画像に保存します。
  • クリップボード - 後から使用するために、スクリーンショットをクリップボードに画像として保存します。
• ファイル名 - 指定した UI 要素のスクリーンショットを保存するファイルの名前です。[ファイルを参照] をクリックし、スクリーンショットを保存するフォルダーを参照して、使用するファイル名と拡張子を指定します。
• 自動インクリメント - ファイル名が競合する場合に、スクリーンショットの保存時にファイル名に追加する文字列を選択します。たとえば、保存するファイルと同じ名前のファイルが既に存在する場合、[インデックス] を選択するとファイル名は保持され、スクリーンショットごとに新しいファイルが作成され、それぞれに連続するインデックス番号が追加されます。
  • なし (上書き) - 同じ名前のファイルが既に存在する場合は置き換えます。
  • インデックス - ファイル名に数値を追加します (例: 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 です。

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

• 保存された画像 - 画像として保存されるスクリーンショットです。[出力] を [ image] に設定した場合に使用します。