Creating Property Checkpoints

1. Launching the Wizard

2. Specifying a Control, Window, or Object to Check

3. Selecting an Object Property or Field to Verify

5. Closing the Wizard

Preparing for Android Testing

Preparing for iOS Testing

Preparing for Xamarin.Forms Testing

The way you open the wizard depends on the test creation mode:

• If you are recording a test–

  1. Click Add Check on the Recording toolbar:

     

  2. In the Checkpoint Wizard, select Object 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 Object property.

     – or –

     Find the Property 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 Object property, and then click Next.

Select a control (for example, a button, a text box, a list view, and so on), or a window, or any other object whose property you want to check.

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 on the Mobile Screen (for Android Applications)

     Select an Object on the Mobile Screen (for iOS Applications)

  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 on the Mobile Screen (for Android Applications)

     Select an Object on the Mobile Screen (for iOS Applications)

  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.

Tips for selecting objects:

TestComplete will display the name of the selected object in the Object box and show the object image in the Preview area.

If the Map object names automatically option is selected, TestComplete automatically adds the specified object to the Name Mapping repository (if it is not there already). Your tests will take the object alias from the repository.

After you selected the object, click Next to proceed.

On the Select data to check page of the wizard, click Properties to view the list of object properties and fields. (If you are configuring the Property Checkpoint operation, the wizard will show the property list automatically.)

Select one or several properties or fields to check, verification parameters and the expected value:

1. Select the property you want to check from the list.

   By default, the wizard shows only the suggested properties. To view all the available properties, click More Properties.

   To find the needed property faster, you can type its name or value in the Search box. The wizard will filter out the property list according to the text you are typing.

2. Select the Selected check box for the property you want to check.

3. In the Condition column, select the needed verification condition.

4. In the Value column, enter the expected value of the object property. By default, it holds the current property value.

   The object property value and the expected value should be of the same type. If the compared values are of different types, TestComplete will try to convert the object property value to the type of the expected value and then perform a verification. In this case, the comparison may be performed incorrectly.

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

If you are creating a property checkpoint while editing a test script, then the generated checkpoint code will be displayed in the Copy Text to Clipboard dialog. You will be able to copy this code to the clipboard and then paste it to the desired place in your script.