File Content Editor (Checkpoint Properties Dialog Box) - File Content Checkpoints

Relevant for: GUI tests and scripted GUI components

When working with a file content checkpoint, the Properties Grid area displays a File Content Editor which enables you to specify the text to check in a document that is generated or accessed during a run session.

User interface elements are described below:

UI Element

Description

Comparison file path

The file path of the generated document that you want to compare during the run session.

You can enter a path manually or click the Select Comparison File button to navigate to the required file. The path can be relative or absolute (unless you use a regular expression). The file must be located in the file system.

When you initially specify a file to compare, the textual content from that file is displayed in the file content editor of the dialog box as the expected value of the checkpoint. If you later change this path, the content in the file content editor is not affected.

Note: The document must not be password-protected, otherwise, UFT One will not be able to access it during a run session.

You can use the following when specifying the document path:

  • Configure Verification Value (Parameter/Regular Expression). Opens the Value Configuration Options Dialog Box. You use this dialog box to define the file path as a constant or parameter value, with or without a regular expression.

    For example, suppose your application is being released in multiple languages, and you want to compare a different source file for each language. You can specify a data table parameter to instruct UFT One to use a different file for each iteration.

    Displayed only when you hover over the Comparison file path text box.

    Note: If you specify a parameter value for the comparison file path and multiple files that match the value exist in the specified location, UFT One performs the checkpoint on the latest generated file (according to its creation time).

    If you use a regular expression, you must specify a mapped drive, for example: C:\\Program Files (x86)\\OpenText\\UFT One\\Tests\\.*\.txt

  • Select Comparison File. Enables you to navigate to the file you want to compare.

Select/Clear Line for Verification. This switch enables you to select or clear a line to compare with the generated file during a run session.

When you select a line, UFT One highlights it and selects the check box to the left of the line.

(Also available from the context menu)

Treat Line as Regular Expression/Plain Text. This switch enables you to instruct UFT One to look for and handle regular expressions in the line.

Note: The line does not need to be selected for comparison to insert a regular expression (or to modify the text in general).

(Also available from the context menu)

Add Parameter to Line. Opens the Value Configuration Options Dialog Box. You use this dialog box to define a parameter as a constant or parameter value.

For example, suppose you inserted a parameter in the Comparison file path box because you want to compare a different file during each iteration. You can specify a data table parameter to instruct UFT One to use a different value for each iteration.

(Also available from the context menu)

Open Regular Expression Evaluator. Opens the Value Configuration Options Dialog Box. You use this dialog box to create and test a regular expression enabling you to determine whether it suits your needs.

(Also available from the context menu)

Preview Comparison. Opens a comparison window showing the differences between the source file in the file system and the currently displayed file in the file content editor.

Note:  

If you select Checkpoint Properties in the Advanced File Content Checkpoint Properties Dialog Box), these properties are ignored during a preview comparison. (Comparison Settings, however, are included in the preview comparison.)

--

Search for. Text box in which you can optionally enter text for which to search. As you type, all instances of the specified text are highlighted. Press Enter to jump to the first instance if it is not visible in the file content editor.

You can use the following buttons to navigate between each instance of the specified text:

Find Next. Jumps to the next instance of the specified text in the file content editor.

Find Previous. Jumps to the previous instance of the specified text in the file content editor. (Enabled only after you click Find Next.)

Advanced

Opens the Advanced File Content Checkpoint Properties Dialog Box. This dialog box enables you to set additional comparison settings and checkpoint properties.

Page

The page from the source file being compared.

Pages are displayed only when the content from the source file exceeds one page.

You can:

  • View the number of pages in the file being compared.

  • Expand or contract a specific page to view or hide the content on that page.

  • Select the adjacent check box to select all of the lines on a page.

  • Clear the adjacent check box to clear the selection of all of the lines on a particular page.