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 に変更しなければなりません。

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