Description

Use the Table Checkpoint operation to compare the contents of controls that display data in a tabular form with a baseline copy of data that is stored in your project, or to update the baseline copy with the data retrieved from a control. The functioning mode of the operation is specified by the Update Table elements setting (you can modify it in the Stores Options dialog). By default the setting is disabled, and the operation performs the comparison. If the setting is enabled, the operation updates the stored baseline copy.

When you add the operation to your test, TestComplete displays the Checkpoint wizard, where you specify the control, whose data will be verified and specify the data to be retrieved. After you close the wizard, TestComplete gets the data from the control and saves this data as a new Table element to the Stores | Tables collection. This data will be used as a baseline copy. If the operation works in comparison mode, TestComplete will compare the actual contents of the control with this saved copy during the test execution. If the operation works in update mode, TestComplete will update the baseline copy with the information that is stored in the control.

Operation Result

In comparison mode, if the control’s data coincides with the saved baseline copy, the operation returns True and posts a checkpoint message () to the test log. Otherwise, the operation returns False and posts an error message () to the log.

In update mode the operation always returns True.

Scripting Analogue

The operation is analogue to the Table.Check scripting methods.

Child Operations

The operation cannot have child operations.

Operation Parameters

The operation has one parameter:

Table Element

Specifies the control to be checked. This name is displayed in the Operations column of the Keyword Test editor.

To specify another Table element that will be used by the comparison procedure:

Select the operation’s row in the test.
Select the Operation cell and then click within it or press F2. This will activate the in-place editor.
Choose the desired Table element from the drop-down list.
Press Enter to confirm the change and close the in-place editor, or press Esc to close the editor discarding any changes.

To modify the connection settings and data of the stored baseline copy, use the Table Element editor. The stored data can also be changed from scripts. For information, see Modifying Table Elements.

An alternative approach to modifying checkpoint parameters is to repeat the operation’s setup steps in the Table Checkpoint wizard. To invoke this wizard, double-click the operation in the Keyword Test editor.

Remarks

By default, if the Table Checkpoint operation cannot find or access the object the contents of which it verifies, it waits for the object for a period that the Playback > Auto-wait timeout property of your project specifies. If the object has not been found by the end of the period, the operation fails.

For information on database checkpoints, on creating and modifying them and on how the comparison procedure works, see the About Table Checkpoints section.

Table Checkpoint Operation