Creating OCR Checkpoints

1. Launch the Wizard

2. Specify an Object to Check

3. Specify the Data to Check

4. Close the Wizard

Note for mobile testing: Select the object on the Mobile Screen (make sure the Mobile Screen window is not hidden before selecting the object). Also note that the application under test and the mobile device, where the application is running, must be prepared for testing for TestComplete to be able to access the application’s objects.

Connecting to Mobile Device Clouds and Opening Testing Sessions

Preparing for Android Testing (Legacy Mobile Support)

Preparing for iOS Testing (Legacy Mobile Support)

Preparing for Xamarin.Forms Testing (Legacy Mobile Support)

The way you call the wizard depends on whether you are recoding a test or creating a test manually:

• If you are recording a test

  1. Click Add Check on the Recording toolbar.

  2. In the Checkpoint Wizard, select Test or property, and then click Next.

     

• If you are editing a keyword test

  1. Select the Checkpoints category in the Operations panel of the Keyword Test editor.

  2. Find the Checkpoint Wizard operation in the list and drag it to your test. In the Checkpoint wizard, click Text or property.

     – or –

     Find the OCR Checkpoint operation in the list and drag it to your test.

     

• If you are editing a script

  1. Open the script to be edited.

  2. Click on the Code Editor toolbar:

     

  3. In the Checkpoint Wizard, select Text or property, and then click Next.

Select a UI element (for example, a chart, image, button, text box, list view, and so on), or a window, or any other onscreen object whose text content you want to verify.

You can specify the object in one of the following ways:

• Pick the object with the target icon ()

  See instructions

  See instructionsSee instructions

  1. Drag the target icon () to the desired onscreen object in the tested application.

     To select an object in a mobile application, drag the target glyph to the desired object on the Mobile Screen (see Select an Object on the Mobile Screen).

     Select an object in a mobile device cloud

     Select an object in an Android application (Legacy mobile support)

     Select an object in an iOS application (Legacy mobile support)

  2. While dragging, a red frame appears around the object that is currently under the mouse pointer.

  3. Wait until a red frame appears around the needed object and release the mouse button.

  Watch video: Selecting Objects: 'Drag the Target...' Mode

• Select the object and press a shortcut ()

  See instructions

  See instructionsSee instructions

  1. Click icon.

  2. Perform the actions needed to activate the desired object in the tested application (for example, invoke the popup window).

  3. Move the mouse pointer over the desired object.

     To select an object in a mobile application, move the mouse pointer over the desired object on the Mobile Screen (see Select an Object on the Mobile Screen).

     Select an object in a mobile device cloud

     Select an object in an Android application (Legacy mobile support)

     Select an object in an iOS application (Legacy mobile support)

  4. Wait until a red frame appears around that object and press Shift+Ctrl+A. (The shortcut can be changed in the Global Shortcuts options.)

  Watch video: Selecting Objects: 'Point and Fix' Mode

• Enter the object name manually

  Enter the full name (or full mapped name, or alias) of the desired object into the Object box.

  For web objects: If your project is configured to use XPath expressions and CSS selectors to locate web objects, the dialog will show the list of available locators (if any) for the specified web object. You can select the needed locator from the drop-down list.

Once you have selected the object, click Next to proceed.

On the next page of the wizard, click OCR to command TestComplete to recognize the text content of the selected object (if you are configuring the OCR checkpoint, the wizard will do it automatically).

The page will show the captured image of the specified object and the text it has recognized in the image:

In the Pattern for verifying recognized text box, enter the string pattern against which you want to verify the recognized text. You can type it manually or you can select the needed text fragment in the Recognized text box.

The pattern can contain asterisk (*) or question mark (?) wildcards. The asterisk corresponds to a string of any length (including an empty string), the question mark corresponds to any single character (including none). Whether the string is case-sensitive depends on the Playback > Use case-sensitive parameters property of your project.

Click Finish to exit the Checkpoint wizard. TestComplete will add the checkpoint statement to your test.

If you are creating a checkpoint while editing a script test, TestComplete will show the Copy Text to Clipboard dialog containing the generated checkpoint code. Copy this clipboard and then paste it to the needed place in your script test.