...
Table of Contents | ||
---|---|---|
|
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 | ||||
---|---|---|---|---|
| ||||
To customize the logic and data source usage for all Diff regression controls in a test suite:
|
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:
- Right-click the error and choose Ignore XPath. An Ignored XPath Settings dialog opens with the selected XPath automatically entered.
- Enable the options related to the XPath operations you would like to ignore. The following options are available:
- 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.
- Click OK.
The XPath you specified will now be ignored for any future test runs. In addition, the XPath you specified now appears in the Ignored Differences tab of the XML Mode in the Diff tool. To modify the XPath, see Modifying XPath Settings.
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 | ||||
---|---|---|---|---|
|
...