Configure checkpoint details

Relevant for: GUI tests and components

Use the Checkpoint Properties dialog box to specify checkpoint details.

Access the Checkpoint Properties dialog box

  1. Ensure that a GUI action or component is in focus in the document pane.

  2. Do one of the following:

    • Insert a checkpoint step and select an object from your application.

    • Click in the Value cell of an existing checkpoint step, and click the checkpoint properties icon .

    • In an action or a scripted component: Right-click an existing checkpoint step and select Checkpoint Properties.

    • In the local or shared object repository, click an existing checkpoint object. The Checkpoint details are displayed on the right side of the object repository window, in the Object Details area.

Note: The advanced properties of standard checkpoint objects cannot be viewed or edited in ALM. Therefore, if one or more advanced properties are selected in a standard checkpoint object, and an ALM user views its properties in ALM, the dialog box displays text indicating that some properties are not shown.

The Checkpoint Properties dialog box includes the following areas. The options in each area vary depending on the checkpoint type.

Back to top

Object Details Area

UI Element


The name that UFT One assigns to the checkpoint object. By default, the name is the same as the name of the object on which the checkpoint step is being performed. You can specify a different name for the checkpoint object or accept the default name.


The type of object (read-only).

Note for keyword components: The class of the object is not displayed in ALM.

Find in Repository. Displays the checkpoint object in its object repository. This option is only available when editing an existing checkpoint step.

Note for keyword components: This option only available in advanced mode.

(only available for Keyword components)

Advanced Mode/Simple Mode. Switches the dialog box between Advanced Mode and Simple Mode.

Back to top

Properties Grid Area

The Properties grid area displays the properties to check in the object.

Standard / page / image / PDFPage checkpoints

Properties Grid Area (Checkpoint Properties Dialog Box) - Standard, Page, Image, and PDFPage Checkpoints

Bitmap checkpoints

Bitmap Options Section (Checkpoint Properties Dialog Box) - Bitmap Checkpoints

Table checkpoints

Properties Grid Area (Checkpoint Properties Dialog Box) - Table Checkpoints

Text/Text Area checkpoints

Checkpoint Summary Area (Checkpoint Properties Dialog Box) - Text/Text Area Checkpoints

File Content checkpoints

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

Database checkpoints

Properties Grid Area (Checkpoint Properties Dialog Box) - Database Checkpoints

Accessibility checkpoints

Current Settings Area (Checkpoint Properties Dialog Box) - Accessibility Checkpoints

XML checkpoints

XML Tree/Options Area (Checkpoint Properties Dialog Box) - XML Checkpoints

Back to top

Configure Value Area

The Configure Value area displays the options to configure the value of the object to be checked.

Standard checkpoints

Configure Value Area

Table/Database checkpoints

Configure Value Area (Checkpoint Properties Dialog Box) - Table/Database Checkpoints

Text/Text Area checkpoints

Checkpoint Options Area (Checkpoint Properties Dialog Box) - Text/Text Area Checkpoints

Page checkpoints

Configure Value Area (Checkpoint Properties Dialog Box) - Page Checkpoints

PDFPage checkpoints

Configure Value Area (Checkpoint Properties Dialog Box) - PDFPage Checkpoints

Back to top

Statement Location and Checkpoint Timeout Area

Note: If you are working with a keyword GUI component, this option is available only in Advanced Mode.

User interface elements are described below:

UI Element


Checkpoint timeout

Specifies the time interval (in seconds) during which UFT One attempts to perform the checkpoint successfully. UFT One continues to perform the checkpoint until it passes or until the timeout occurs. If the checkpoint does not pass before the timeout occurs, the checkpoint fails.

Example: Suppose it takes some time for an object to achieve an expected state. Increasing the checkpoint timeout value in this case can help ensure that the object has sufficient time to achieve that state, enabling the checkpoint to pass (if the data matches) before the maximum timeout is reached.

If you specify a checkpoint timeout other than 0, and the checkpoint fails, the run results display information on the checkpoint timeout.

The maximum allowed timeout for a checkpoint is 99999 seconds.

Insert statement

Specifies whether to insert the checkpoint step before or after the currently selected step. The default value is Before current step.

Available only when inserting a new checkpoint step during an editing session. During a recording session, the checkpoint step is always inserted as the next step.

Back to top