To recognize text in images and on-screen objects, the following requirements must be met:

Your TestComplete version must be 12.60 or later.

If you have an earlier version of TestComplete, you can use the legacy OCR feature to recognize text.
You must have an active license for the TestComplete Intelligent Quality add-on.
You must have the Intelligent Quality add-on installed and enabled in TestComplete.

By default, you install and enable the add-on during TestComplete installation. If the add-on was not installed and enabled during the installation, you can do this at any moment later via the Install Extensions dialog:
1. Select File > Install Extensions from the TestComplete main menu.
2. In the Install Extensions dialog, expand the Intelligent Quality category and enable the Intelligent Quality Core plugin:
Optical Character Recognition support must be enabled in TestComplete. By default, it is enabled automatically if you enable the Intelligent Quality add-on during TestComplete installation.

If you experience issues with optical character recognition in your tests, select File > Install Extensions from the TestComplete main menu and make sure that the Optical Character Recognition plugin is enabled (you can find it in the Intelligent Quality group). If the plugin is disabled, enable it. TestComplete will ask for a confirmation:

In the message, click the link to read a third-party license agreement. If you agree to the license terms, click Enable OCR.

In addition, make sure that you do not have the legacy OCR plugin installed and enabled. You can find the plugin in the Common group. This plugin is not compatible with the Optical Character Recognition. You cannot have them both enabled in TestComplete.
To recognize text, TestComplete uses a web service residing at ocr.api.dev.smartbear.com, which, in its turn, uses Google Vision API. TestComplete sends images to the service and obtains the text recognition results.

A computer, on which your tests run, must have access to the web service. If you have firewalls or proxies running in your network, make sure that they allow the computer to access the web service.
TestComplete communicates with the recognition web service via HTTPS protocol through port 443. Make sure that your firewall allows traffic through that port.

If you use Windows Firewall, create an outbound rule
If you use Windows Firewall, create an outbound ruleIf you use Windows Firewall, create an outbound rule
1. In your Windows operating system, click Start, click Control Panel and then click Windows Firewall.
2. In the Windows Firewall window, click Advanced settings on the left.
3. Click Outbound rules.
4. In the Actions panel, click New Rule.
5. Follow the instructions of the resulting New Outbound Rule Wizard to create a new rule:
  1. On the Rule Type page, click Port.
  2. On the Protocol and Ports page, select TCP. In the Specific remote ports edit box, enter 443.
  3. On the Actions page, click All the connections and click Next.
  4. On the Profile page, select the network location, for which you want to open the port.
  5. On the Name page, in the Name field, enter the rule name.
Recognition results are affected by the size and resolution of the image, in which you recognize your text, and by the language of the recognized text.

For information on resolutions supported by Google Vision API, see cloud.google.com/vision/docs/supported-files.

For information on languages supported by Google Vision API, see cloud.google.com/vision/docs/languages.
The object whose text contents you recognize must exist in your system and be visible on the screen.

If the needed object belongs to a mobile application, your mobile device must be prepared for testing and connected to TestComplete.

Optical Character Recognition - Requirements

See Also