To access

Select Tools > Options > GUI Testing tab > Text Recognition node.

Important information

• The Restore Factory Defaults button resets all Options dialog box options to their defaults.

• The settings in this pane are used when using OCR to identify text, as described in Text recognition in run-time.

• UFT One versions 2021 R1 and later: To use the ABBYY OCR Engine for text recognition, you must include it when installing UFT One. If ABBYY is not installed, Tesseract is used as the default engine instead.

Related tasks

• Configure text recognition settings

• Insert a checkpoint step

• Insert an output value step

See also

• Text recognition in run-time

• Checking Text in an image - Use-case scenario

• Text and text area checkpoints

The manner in which to recognize text in the application:

• Single text block mode: The single text block mode instructs the OCR mechanism to focus on the area and treat it as a single text block. This is especially useful when trying to capture text on small objects or in a small text area. Select this radio button if the text on the object is uniform in font, size, color, and background. For example:

  

• Multiple text block mode: The multiple text block mode instructs the OCR mechanism to handle each text area in the object that has a different background font and size. The OCR mechanism decides where to divide the text blocks according to an internal algorithm. Select this radio button only if the text on the object comprises different fonts, font sizes, colors, and/or backgrounds. For example:

  

Lists all of the language dictionaries that the OCR mechanism can potentially use when retrieving text from the object.

To specify the language dictionaries used by the OCR mechanism: Move a language to the Supported languages list box by selecting a language and clicking the right arrow button (>).

Lists the language dictionaries that the OCR mechanism uses when capturing text.

Add languages from the Available languages to the Supported languages to specify one or more languages to use for text recognition.

Previews the text recognition result.

Select or customize a set of OCR configuration settings, upload an image of your application, preview the corresponding result, and then adjust your settings if necessary.

For details, see Preview Pane (Options Dialog Box > GUI Testing Tab > Text Recognition) .

(Baidu only)

A single language to support for text recognition, or the combination Chinese and English.

If your Internet connection requires a proxy, specify the proxy server address and authentication details.

Proxy type. Defines the type of proxy to use when connecting to the Digital Lab (UFT Mobile) server:

• System Proxy

• HTTP Proxy

Proxy address. The proxy IP address and port. If System proxy is selected, this field is populated automatically, and is read-only.

Specify authentication. Enables you to connect to the Digital Lab (UFT Mobile) server using a specific account.

Proxy user name and password. The credentials used to connect to the Digital Lab (UFT Mobile) server, if Specify authentication is selected.

Test Connection

Press Test Connection to test your connection details and make sure UFT One can connect to the cloud OCR service.

Upload an image of your application, preview the text recognition result, and adjust your Text Recognition options if necessary.

For details, see Preview Pane (Options Dialog Box > GUI Testing Tab > Text Recognition) .

The manner in which to recognize text in the application:

• Single text block mode: The single text block mode instructs the OCR mechanism to focus on the area and treat it as a single text block. This is especially useful when trying to capture text on small objects or in a small text area. Select this radio button if the text on the object is uniform in font, size, color, and background. For example:

  

• Multiple text block mode: The multiple text block mode instructs the OCR mechanism to handle each text area in the object that has a different background font and size. The OCR mechanism decides where to divide the text blocks according to an internal algorithm. Select this radio button only if the text on the object comprises different fonts, font sizes, colors, and/or backgrounds. For example:

  

Enables you to restrict text recognition to specific characters.

This option is supported for English only.

The current language to use in text recognition. Only one language pack can be used at a time.

To download and install a new language pack, you can visit the Tesseract OCR language pack download site: https://github.com/tesseract-ocr/tessdoc/blob/master/Data-Files.md#data-files-for-version-400-november-29-2016.

After downloading, add the files to the <UFT One installation folder>/dat/tessdata4.1 folder.

Enables you to load configuration settings from an externally defined file.

Not all configuration options are supported for use in UFT One. The Output pane displays a list of parameters that are ignored when running a test:

• %parameter_name% parameter is not supported

• The Tesseract OCR engine has stopped due to an error. Check your Tesseract configuration and try again.

• The value type for the %parameter_name% parameter is incorrect. The parameter was ignored during the test run

• The %parameter_name% parameter is not supported by the Tesseract OCR engine

For details on how to create your own configuration file, see https://github.com/tesseract-ocr/tesseract/blob/master/doc/tesseract.1.asc.

Enables the text recognition to identify image elements before identifying the text in the specified object or area.

When you use this option, UFT One converts the image to a black and white image and resizes it. However, this slows the performance of UFT One when performing text recognition. Therefore, expect additional time in test runs when performing text recognition with this option.

This option should be used when your application uses very small font size (10 pt. and lower).