Creating XML Checkpoints

Applies to TestComplete 15.62, last modified on March 19, 2024

XML checkpoints verify values stored in an XML document against baseline values stored in your project as an XMLCheckpoint element of the Stores > XML collection.

You can create XML checkpoints both during test recording and at design time. To help you set up XML checkpoints, TestComplete includes the Checkpoint Wizard. To create an XML checkpoint using the wizard, follow the steps below:

1. Launching the Wizard

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

  • If you are recording a test –

    1. Click Add Check on the Recording toolbar:

      Recording toolbar: the Add Check button
    2. In the Checkpoint Wizard, select File, and then click Next.

      XML Checkpoint: Selecting checkpoint type

      Click the image to enlarge it.

  • 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 File.

      – or –

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

      XML Checkpoint: Adding XML checkpoints to keyword tests
  • If you are editing a script –

    1. Open the script to be edited.

    2. Click on the Code Editor toolbar:

      Adding checkpoints to script tests
    3. In the Checkpoint Wizard, select File, and then click Next.

2. Specifying an XML Document to Check

On the next page of the wizard, you specify the type of the file you want to verify. Click XML to verify an XML file. (If you are configuring the XML Checkpoint operation, the wizard will select the appropriate comparison type automatically.)

In the Specify the XML file name or URL edit box, enter the file name or the URL address of the needed XML document.

XML Checkpoints: Specifying XML file to verify

Click the image to enlarge it.

Click Next to proceed.

3. Specifying the Baseline XML Checkpoint Element

On the third page of the wizard, specify an XMLCheckpoint element storing baseline data that will be used for verification:

XML Checkpoints: Specifying baseline data

Click the image to enlarge it.

  • To create a new element, click Current file contents, and then enter the desired name of the element in the Save the files to Stores as a baseline copy edit box.

    This name will be used to address the element from scripts, so it must be a valid identifier. Scripting languages supported by TestComplete use different naming rules for identifiers. To specify a name that will match the rules of any language, enter a string that starts with a letter and that contains only letters, digits, and underscore characters.

  • To use an existing element, click File from Stores, and then select the desired element from the Select a Stores item drop-down list.

4. Closing the Wizard

Click Finish to complete the checkpoint creation and close the wizard.

Upon closing the wizard, TestComplete will automatically insert the XML checkpoint statement into the test.

If you are creating an XML checkpoint while editing a script test, TestComplete will generate the checkpoint code and display it in the Copy Text to Clipboard dialog in which you can insert the generated code into the script.

See Also

XML Checkpoints
About Checkpoints
Checkpoint Wizard

Highlight search results