Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space FUNCTDEV and version SVC2024.1

...

Table of Contents
maxLevel1

Understanding Diff

With support for Binary, Text, XML, and JSON, the Diff tool is the current backbone of a best-practices regression testing solution.The Diff tool compares the data in its editor against the data that it receives from another tool's output or from another input that you specify and reports a failure when it finds a difference.

...

Info
iconfalse
titleConfiguring Regression Options for Diff Tools in a Test Suite

To customize the logic and data source usage for all Diff regression controls in a test suite:

  • Double-click the test suite’s Test Case Explorer node and modify the available options, which are described in Regression Options.

As with other tools, you can specify a data source for the tool if a source was added to the project. The data source for the Diff tool specifies the Data Source to be used for providing control values. For more information on Data Sources, see Parameterizing Tests with Data Sources, Variables, or Values from Other Tests. 

Binary Diff Mode

Choose Binary from the Diff Mode menu to view differences for binary files.

...

  • Ignore XPaths from the Quality Tasks view: This is the easiest way to configure the Diff tool to ignore XPaths. After a failed regression test, you can simply right-click the Quality Tasks view node to choose an XPath to ignore.
  • Manually entering an XPath in the Diff GUI: You can manually enter an XPath by clicking Configure Ignored Differences in the Diff GUI.
  • Ignore XPaths from the Form XML tree: You can right-click an element node from the Form XML tree and configure an XPath to ignore based on the selected element.

Ignoring XPaths from the Quality Tasks View

When entering XPaths to ignore in the Diff tool, it is easier to right-click in the Quality Tasks view than manually entering the XPath position into the Diff tool GUI. XPath positions are displayed in tree form in the Quality Tasks view after a failed regression test:

To ignore an XPath from the Quality Tasks view after a failed regression test:

...

  • XPath: Specifies the XPath position that you selected.
  • Recursive: Select to apply the Ignored XPath settings to child elements.
  • Text Content (Modify/Insert/Delete): Select the content operation you want to ignore.
  • Element/Subtree (Insert/Delete): Select the element or subtree operation you want to ignore.
  • Attribute (Modify/Insert/Delete): Select the attribute operation you want to ignore. If this option is enabled, SOAtest will only ignore the specified attribute name within the XPath. To ignore a specific attribute, enter the attribute name in the field next to the Attribute option. If you want to ignore more than one attribute at an element’s XPath location, leave the attribute name empty or use the wild card * (for example, myAttribute*).
  • Element Name and Namespace (Modify/Insert/Delete): Select the element name operation you want to ignore.

...

Manually Entering XPaths to Manually Entering XPaths to Ignore

You can also manually type or paste an XPath to ignore into the Diff tool configuration panel.

...

Diff tools can either have their own local, exclusive Ignored XPath settings, or they can reference a list of XPaths that can be used by other Diff tools. To create a shared list of ignored XPaths, see Global Ignored XPath Properties. 

Modifying XPath Settings
Anchor
Modifying XPath Settings
Modifying XPath Settings

...