The Add Table wizard is used to add new elements to the Stores | Tables collection of TestComplete projects. These elements are used to create table checkpoints.
On the Specify Data Range page you can choose the columns whose data will be stored in the Table element and specify the number of stored rows. The wizard will retrieve this data from the control that you specified on the Select Object page of the wizard.
By default, the Table element will store all rows, which the wizard retrieves from the control. However, you can limit this number by selecting the Store only the specified number of rows check box and entering the desired number of rows into the Rows number box. By default, the Rows number box contains the number of retrieved rows and this is the maximum value that can be specified in this box.
Note that if you select the Store only the specified number of rows check box, then when comparing the values during the test run, TestComplete will check whether the number of stored rows coincides with the actual number of rows in the control. If the check box is clear, then TestComplete will compare the rows number only if the stored dataset does not contain the key columns (see How the Table Comparison Procedure Works for details).
The wizard page also contains the table that lists the retrieved columns. To specify the column values to be saved to the Table element, select the check box in the Store cell.
If a column can be used to identify records in the retrieved data set, select the check box in the Key cell. You can mark one or several columns as key columns (for more information on how to select key columns, see Using Key Columns). The presence or absence of key columns affects the way, in which TestComplete compares the Table element’s data with the control’s data (see How the Table Comparison Procedure Works).
If you select the Key check box for a column, you should also select the Stored check box (that is, key columns should be stored). Otherwise, specifying the column as a key is meaningless.
After selecting the desired columns and the number of rows, click Next to proceed.
See Also
Add Table Wizard
About Tables Collection
About Table Checkpoints
How the Table Verification Works
Using Key Columns