Versions Compared

Key

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

...

  • Editor: Choose this option from the menu and enter text you want to use as a regression control in the related field.

  • File: Choose this option from the menu and specify a file to use as a regression control.

    • If you want to ensure that this file's path is always relative to your project file, enable

    the
    • Persist as Relative Path

     option
    • .

  • Data Source: Choose this option from the menu and specify a value from the designated data source column as regression controls. This option is only available if your project includes a data source.

...

  • Editor: Choose this option from the menu and enter text you want to use as a regression control in the related field.

  • File: Choose this option from the menu and specify a file to use as a regression control.

    • If you want to ensure that this file's path is always relative to your project file,

    enable
    • enable Persist as Relative Path.

  • Data Source: Choose this option from the menu and specify a value from the designated data source column as regression controls. This option is only available if your project includes a data source.

Ignored Differences

From the Ignored Differences tab of the Diff tool for Text mode, you can delete any ignored text differences by clicking the Delete button.

Options

    • If your file has variables that you want resolved before performing the diff comparison, enable Resolve Variables. Environment variables, test suite variables, data source columns, and data bank extractions will be used to resolve variables with ${} notation in the regression control source file at runtime.
      • Note: When enabled, regression control outputs (for example, created by chaining a Write tool output to this Diff tool) will contain the control source used at runtime with its variables resolved.
  • Data Source: Choose this option from the menu and specify a value from the designated data source column as regression controls. This option is only available if your project includes a data source.

Ignored Differences

From the Ignored Differences The following options are available in the Options tab of the Diff tool for Text mode, you can delete any ignored text differences by clicking the Delete button.

Options

The following options are available in the Options tab of the Diff tool for Text mode.

  • Regular Expression: Determines whether the expected value will be parsed as a regular expression. If this option is not enabled, the control value will not be parsed as a regular expression. If this option is enabled, the control value will be parsed as a regular expression.
    For example, the following regular expression may be entered:
    Java[a-zA-Z ]+\Q(\E[4-9]+th Edition\Q)\E
    Where the actual string extracted may be the following: Java How to Program (4th Edition)
    The regular expression will parse through the above string to check if "Java" appears as the first substring, followed by one or more occurrences (indicated by the + operator after the open and closed brackets) whereas the occurrences are limited to only letters ranging between a-z and A-Z and whitespace. Notice we escaped ( and ) by adding \Q and \E around ( and ). This needs to be done because open and closed parentheses can be part of a regular expression, therefore they need to be escaped if they are represented to be substrings. We also have a digit appear after the first open parenthesis which is indicated by [4-9]+. This specifies at least one occurrence of a digit between 4 and 9 that should appear and be followed by "th Edition". Lastly, we have the closed parenthesis which we escape with \Q\E. For more information regarding supported regular expression syntax, click here.
  • Ignore Whitespace: Determines whether empty lines and whitespaces at the end and beginning of input lines and diff control lines are ignored. If this option is not enabled, empty lines and leading/trailing whitespaces will cause the regression test to fail. If this option is enabled, empty lines and leading/trailing whitespaces will be ignored.
    A whitespace is any of the following: horizontal tabulation, new line, form feed, carriage return, space. An empty line is a line that contains one or more of these whitespaces.
  • Output results as UNIX-style diff: Determines the diff output format. If this option is not enabled, the output will display in table form. If this option is enabled, the output will display in UNIX-style.

...

  • Editor: Choose this option to populate a control image from a test run. See Visual Regression Testing for more information about using the Diff tool for regression testing, including how to populate a control screenshot from a test run.

  • File: Choose this option and specify a file to use as a regression control.

    • If you want to ensure that this file's path is always relative to your project file, enable

    the
    • Persist as Relative Path

     option
    • .

  • Data Source: Choose this option and specify a value from the designated data source column as regression controls. This option is only available if your project includes a data source.

...

The following options are available in the Regression Control tab of the Diff tool for Literal XML mode.

  • Editor: Choose this option from the menu and enter text you want to use as a regression control in the related field.

  • File: Choose this option from the menu and specify a file to use as a regression control.

    • If you want to ensure that this file's path is always relative to your project file,

  • enable
    • enable Persist as Relative Path.

  • Data Source: Choose this option from the menu and specify a value from the designated data source column as regression controls. This option is only available if your project includes a data source.

    • If your file has variables that you want resolved before performing the diff comparison, enable Resolve Variables. Environment variables, test suite variables, data source columns, and data bank extractions will be used to resolve variables with ${} notation in the regression control source file at runtime.
      • Note: When enabled, regression control outputs (for example, created by chaining a Write tool output to this Diff tool) will contain the control source used at runtime with its variables resolved.
  • Data Source: Choose this option from the menu and specify a value from the designated data source column as regression controls. This option is only available if your project includes a data source.

  • Set From WSDL: Initializes the Form XML content Set From WSDL: Initializes the Form XML content with the expected response based on the WSDL. This button is only available if a WSDL document exists for the particular SOAP client.

...

  • Name: Specifies the name of the Diff tool.
  • Regression Control Source: Determines what data source values, file, or text is used as the "control" value (the value against which it will compare all subsequent results).data source values, file, or text is used as the "control" value (the value against which it will compare all subsequent results).

    • Editor: Choose this option from the menu and enter text you want to use as a regression control in the related field.

    • File: Choose this option from the menu and specify a file to use as a regression control.

      • If you want to ensure that this file's path is always relative to your project file, enable Persist as Relative Path.

      • If your file has variables that you want resolved before performing the diff comparison, enable Resolve Variables. Environment variables, test suite variables, data source columns, and data bank extractions will be used to resolve variables with ${} notation in the regression control source file at runtime.
        • Note: When enabled, regression control outputs (for example, created by chaining a Write tool output to this Diff tool) will contain the control source used at runtime with its variables resolved
    • Editor: Choose this option from the menu and enter text you want to use as a regression control in the related field.

    • File: Choose this option from the menu and specify a file to use as a regression control. If you want to ensure that this file's path is always relative to your project file, enable Persist as Relative Path
        • .
    • Data Source: Choose this option from the menu and specify a value from the designated data source column as regression controls. This option is only available if your project includes a data source.

...