CV 画面スコープ

UiPath.CV.Activities.CVScope

説明

UiPath Computer Vision のニューラル ネットワークを初期化して、指定したウィンドウの分析を実行し、それに続くすべての Computer Vision アクティビティのスコープを提供します。このアクティビティでは、対象アプリケーションのテキストのスクレイピングに使用する OCR エンジンを選択できるようになります。このアクティビティに使用される既定の OCR エンジンは、UiPath Screen OCR です。既定エンジンは、好きなエンジンに手動で変更できます。

注: オンプレミスの Linux Computer Vision サーバーのデプロイを使用している場合は、このアクティビティで UiPath Screen OCR エンジンも使用できます。

プロジェクトの対応 OS

Windows - レガシ | Windows

構成

共通

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

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

入力

• CV メソッド - このアクティビティで使用する検出方法を指定するドロップダウン リストです。既定では、[ElementDetection] と [OCR] の両方のオプションが選択されています。次のオプションが利用できます。

  • None - 画像ベースのオートメーションのみを使用します。
  • ElementDetection - Computer Vision を使用します。
  • OCR - OCR を使用します。
• Target.ClippingRegion - UiElement を基準とし、左、上、右、下の方向で、クリッピング四角形 (ピクセル単位) を定義します。正と負の両方の値をサポートしています。
• Target.Element - 別のアクティビティから返される UiElement 変数を使用します。このプロパティを Selector プロパティと一緒に使用することはできません。このフィールドでは UiElement 変数のみサポートされています。
• Target.Selector - アクティビティの実行時に特定の UI 要素の検索に使用する Text プロパティです。実際には、検索しようとする GUI 要素とそのいくつかの親要素の属性を指定する XML フラグメントです。
• タイムアウト (ミリ秒) - SelectorNotFoundException エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。既定値は 30000 ミリ秒 (30 秒) です。

• Target.WaitForReady - アクティビティを実行する前にターゲットが準備完了になるまで待機します。既定では、このフィールドは INTERACTIVE に設定されています。次のオプションを使用できます。

  • NONE - ターゲット要素以外の要素の読み込みを待たずに、アクションを実行します。たとえば、UI 要素がすべて読み込まれるまで待つことなく、Web ページからテキストを取得したり、特定のボタンをクリックしたりする場合に、このオプションを使用できます。ボタンがまだ読み込まれていない要素 (スクリプトなど) に依存している場合、これは望ましくない結果を招く可能性があります。
  • INTERACTIVE - アクションを実行する前に、ターゲット アプリで作業している UI 要素が存在するまで待ちます。

  • 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 レベルでログに出力されなくなります。

スクロール

• スクロールのオフセット - このスコープ内の各 Computer Vision アクティビティでターゲットを見つけるためにスクロール時に使用される、スクロールのオフセットです。

サーバー (同期済み)

• API キー - Computer Vision サーバーへのアクセスに必要な API キーです。このフィールドは、文字列と String 型変数のみをサポートします。これは、グローバル プロパティであり、ワークフロー内のすべての [CV 画面スコープ] アクティビティ間で共有されます。

  注: API キーは、UiPath Automation Cloud サーバーに接続する場合にのみ必要であることに注意してください。キー取得の詳細については、こちらをご覧ください。
  注: 1 つのスコープのアクティビティので ApiKey プロパティを編集すると、現在のワークフローの他のすべてのスコープについて値が変更されるため、手動で行う必要はありません。
• URL - Computer Vision サービスを実行するサーバーの URL。既定では、このプロパティは https://cv.uipath.com/ に設定されています 。これは、ワークフローのすべての [CV 画面スコープ] アクティビティ間で共有されるグローバル プロパティです。

• ローカル サーバーを使用 - 選択すると、ローカル サーバーが分析に使用されます。ローカル サーバーを使用するには、UiPath.ComputerVision.LocalServer パッケージをインストールする必要があります。

  注:

  ニューラル ネットワーク モデルのオンプレミスのサーバー デプロイを利用する際、これを Computer Vision の各種アクティビティに接続するには、[CV 画面スコープ] アクティビティの [URL] プロパティを、自分のサーバーの URL に変更しなければなりません。

  サーバーへの接続について詳しくは、こちらをご覧ください。

アクティビティの本体

自動化するアプリケーションは、アクティビティの本体にある [画面上で指定] ボタンを使用することで、[CV 画面スコープ] アクティビティに指定できます。これを実行すると、指定した画面のキャプチャがアクティビティの本体に表示されます。

アプリケーションの自動化時に複数の画面を指定する場合は、方向ボタン (< 、>) を使用して画面を切り替えることで、アクティビティが使用している画面を簡単に確認できます。

[画面名] ドロップダウンから画面の名前を選択し、 ボタンをクリックして、名前を変更することもできます。