UiPath Activities Guide

CV Get Text

UiPath.CV.Activities.CVGetTextWithDescriptor

Extracts the text from a specified UI element by using the UiPath Computer Vision neural network. A drop-down menu in the body of the activity enables you to quickly select the method you want to use to retrieve the target text. Choosing an option in this drop-down modifies the Method property.

Properties

Common

  • ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

Note:

If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

  • DelayAfter - Delay time (in milliseconds) after executing the activity.
  • DelayBefore - Delay time (in milliseconds) before the activity begins performing any operations.
  • DisplayName - The display name of the activity.

Input

  • Descriptor - The on-screen coordinates of the Target and each Anchor that is used, if any. These values are stored in a CvDescriptor proprietary object. Once the Indicate On Screen feature is used at runtime, the CvDescriptor is automatically generated in this field and has the following structure:
"Target: Image (14,61,105,54) OffsetPoint: (-10,-75)" +
"Anchor: Text 'Anchor1' (41,36,19,9)" +
"Anchor: Text 'Anchor2' (75,36,37,9)" +
  • Method - Specifies what method you want to use to retrieve the text. The following options are available:
    • OCR - Uses the OCR engine specified in the parent CV Screen Scope activity to retrieve the text.
    • Select - all - Copies the entire text by using the clipboard. This simulates a copy/paste action and can only be used on selectable text, on either local or remote sessions.
    • Select - row - Copies the text in the entire row by using the clipboard. This simulates a copy/paste action and can only be used on selectable text, on either local or remote sessions.
  • TimeoutMS - Specifies the amount of time (in milliseconds) to wait for the activity to run before an error is thrown. The default value is 30000 milliseconds (30 seconds).

Misc

  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Output

  • Result - The retrieved text, stored in a String variable. This field supports only String variables.

Reusable Region

  • InputRegion - Receives the target of another CV activity stored in a Rectangle variable, using it as a target for this activity. This enables you to pass the same target from one activity to another. Especially useful at design time, as it makes performing multiple actions on the same UI element easier. If a variable is set to this field, the current target and anchor elements of the activity are disabled. This field supports only Rectangle variables.
  • OutputRegion - Saves the target of this activity as a Rectangle variable. This enables you to pass the same target from one activity to another. Especially useful at design time, as it makes performing multiple actions on the same UI element easier.

CV Get Text


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.