CompareInSubTreeMode Property

Applies to TestComplete 15.47, last modified on January 20, 2023

Description

The CompareInSubTreeMode property specifies how TestComplete will compare the nodes of the stored and actual documents when comparing XML documents with the Compare method of the XMLCheckpoint object. If the property is True, TestComplete will only compare the values of those nodes that belong to the stored document (that is, the stored nodes must form a subtree of the actual document's nodes tree). In this case, the comparison results will not include messages that inform you about nodes that only exist in the actual document and do not exist in the stored document. These nodes are ignored during the comparison.

Declaration

XMLCheckpointOptionsObj.CompareInSubTreeMode

Read-Write Property Boolean
XMLCheckpointOptionsObj An expression, variable or parameter that specifies a reference to an XMLCheckpointOptions object

Applies To

The property is applied to the following object:

Property Value

True, if TestComplete will compare XML documents in subtree mode and False otherwise.

Remarks

The XMLCheckpointOptions object provides access to a copy of the element’s data. Changes made to the comparison settings via the CompareInSubTreeMode property will not be stored in the XMLCheckpoint element and will not be displayed in the XMLCheckpointOptions Element editor.

Example

The following example demonstrates how you can obtain the XMLCheckpointOtions object, set its CompareInSubTreeMode property value to True and compare XMLCheckpoint with the XML document.

JavaScript, JScript

function CompareInSubTreeModeDemo()
{

  var XMLCheckpoint, XMLOptions, XMLDoc;
  // Obtains the XMLCheckpoint object.
  XMLCheckpoint = XML.MyXMLCheckpoint;
  // Obtains the XMLCheckpointOptions object.
  XMLOptions = XMLCheckpoint.Options;

  // Enables the CompareInSubTreeMode XML checkpoint option.
  XMLOptions.CompareInSubTreeMode = true;

  // Specifies the XML document path.
  XMLDoc = "D:\\Work Folder\\XMLFile.xml";
  // Compares MyXMLCheckpoint with the XML document.
  XMLCheckpoint.Compare(XMLDoc)

}

Python

def CompareInSubTreeModeDemo():
  # Obtains the XMLCheckpoint object.
  XMLCheckpoint = XML.MyXMLCheckpoint
  # Obtains the XMLCheckpointOptions object.
  XMLOptions = XMLCheckpoint.Options
  # Enables the CompareInSubTreeMode XML checkpoint option.
  XMLOptions.CompareInSubTreeMode = True
  # Specifies the XML document path.
  XMLDoc = "D:\\Work Folder\\XMLFile.xml"
  # Compares MyXMLCheckpoint with the XML document.
  XMLCheckpoint.Compare(XMLDoc)

VBScript

Sub CompareInSubTreeModeDemo
Dim XMLCheckpoint, XMLOptions, XMLDoc

  ' Obtains the XMLCheckpoint object.
  Set XMLCheckpoint = XML.MyXMLCheckpoint
  ' Obtains the XMLCheckpointOptions object.
  Set XMLOptions = XMLCheckpoint.Options

  ' Enables the CompareInSubTreeMode XML checkpoint option.
  XMLOptions.CompareInSubTreeMode = True

  ' Specifies the XML document path.
  XMLDoc = "D:\Work Folder\XMLFile.xml"
  ' Compares MyXMLCheckpoint with the XML document.
  XMLCheckpoint.Compare(XMLDoc)

End Sub

DelphiScript

procedure CompareInSubTreeModeDemo();
var XMLCheckpoint, XMLOptions, XMLDoc;
begin

  // Obtains the XMLCheckpoint object.
  XMLCheckpoint := XML.MyXMLCheckpoint;
  // Obtains the XMLCheckpointOptions object.
  XMLOptions := XMLCheckpoint.Options;

  // Enables the CompareInSubTreeMode XML checkpoint option.
  XMLOptions.CompareInSubTreeMode := True;

  // Specifies the XML document path.
  XMLDoc: = 'D:\Work Folder\XMLFile.xml';
  // Compares MyXMLCheckpoint with the XML document.
  XMLCheckpoint.Compare(XMLDoc);

end;

C++Script, C#Script

function CompareInSubTreeModeDemo()
{

  var XMLCheckpoint, XMLOptions, XMLDoc;
  // Obtains the XMLCheckpoint object.
  XMLCheckpoint = XML["MyXMLCheckpoint"];
  // Obtains the XMLCheckpointOptions object.
  XMLOptions = XMLCheckpoint["Options"];

  // Enables the CompareInSubTreeMode XML checkpoint option.
  XMLOptions["CompareInSubTreeMode"] = true;

  // Specifies the XML document path.
  XMLDoc = "D:\\Work Folder\\XMLFile.xml";
  // Compares MyXMLCheckpoint with the XML document.
  XMLCheckpoint["Compare"](XMLDoc)

}

See Also

About XML Collection
Creating XML Checkpoints
About XML Checkpoints

Highlight search results