Comparing and updating verification point data using the Comparator

Use the Verification Point Comparator to compare verification point data after you play back a script with a verification point and to update the baseline file. If the verification point failed, the Comparator shows both the expected and actual values, so you can analyze the differences. You can then load the baseline file and update it with the values from the actual file.

About this task

To open the Comparator, click the View Results link in the HCL DevOps Test UI (Test UI) HTML log. For information, see the related topic about viewing results in the log. The Comparator banner displays the name of your verification point.

Procedure

  1. Play back the script that contains the verification point on a new build of the application under test.
    The log for the playback is displayed. For information about setting the option that makes the log open automatically after playback, see Logging Preferences Page.
  2. Open the log for the verification point.
    • If you are using the HTML log, click the View Results link. (Note that if you experience an error regarding the Java™ plug-in when trying to start the Comparator from the View Results link in the HTML log, verify that your plug-in is configured properly.
  3. Open the Comparator from the log.
    • If one verification point failed, select the log in the Projects view, right-click the log, and click Failed Verification Points.
    • If you have more than one failed verification points the Results for Verification Points wizard opens. Click a failed verification point in the list and click View Results or Finish.
    The Verification Point Comparator opens to display that verification point. The Comparator includes the expected and actual data values. The expected values were tested. The actual values were captured in the application during playback. If the verification point failed, the differences are shown in red.

    For the data verification point types list, table and text, the expected values are displayed on the left and the actual values are displayed on the right. The differences are shown in red. For the data (menu hierarchy) and data (tree hierarchy) verification points, the expected and actual values are shown contiguously. The expected values of the differences are shown in red, and the actual values of the differences are shown underneath them in green.

  4. Look at the two data files to compare any differences between the expected and actual files. By analyzing differences in the Comparator, you can determine if they are intentional changes to the application or defects.
    To navigate through the differences, use the navigation buttons on the toolbar above the data display.
  5. If you want to edit the baseline file to update the information for future playbacks, you must load the baseline file. Click File > Baseline or click the Load Baseline to Edit toolbar button Load Baseline to Edit.
    The baseline file replaces the expected file on the left side of the display.
  6. To edit individual items in the data, edit them in the baseline (left) column of the display. When you finish editing the data, click Save.

    For a Data (Text) verification point, click Edit Text Edit Text to start a text editor to make your edits. For other verification point types, you can edit directly in the baseline data display.

  7. For a Properties verification point, if you determine that the baseline value and actual value for a specific property are different, you can update the baseline value. In the Verification Point Comparator, right-click the property where the values are different, and click Replace Baseline on Current Selection.
  8. If you determine that all the differences reflect intentional changes to the application under test, and you want to update the baseline to reflect the changes, you can use the Replace Baseline with Actual Value toolbar button Replace Baseline with Actual Value to replace the entire baseline file.
  9. If you have made any individual changes to the baseline data file (not by using the Replace Baseline with Actual Value command), click File> Save to save the changes.
  10. When you finish comparing and updating verification point data, click File > Exit to exit the Verification Point Comparator.