Skip to Main Content
Return to Navigation

HTMLTable

These are the actions associated with the HTMLTable step type.

CellClick

Description

Clicks on a specific HTMLTable cell based on the index parameter.

Parameters

index=I/R/C:

The table, row, column index string.

For example:

index=&CellIndex

index=1/2/3 ;

In the second example, CellClick clicks on the third column of the second row of the first table.

CellClickOnChkB

Description

Clicks the check box specified in the table cell location based on the index parameter.

Parameters

index=I/R/C:

The table, row, column index string.

For example:

index=&CellIndex

index=1/2/3;

In the second example, this function clicks on a checkbox within the third column of the second row of the first table.

chkidx=value;

The CheckBox object index inside the cell.

check=value;

check=Y – Select the checkbox.

check=N – Clear the checkbox.

This parameter is optional. The default value is Y.

CellClickOnImage

Description

Clicks the image specified in the table cell location based on the index parameter.

Parameters

index=I/R/C:

The table, row, column index string.

For example:

index=&CellIndex

index=1/2/3;

In the second example, this function clicks on an image within the third column of the second row of the first table.

name=value;

The HTMLImage's NameProp value.

CellExists

Description

Determines whether a cell exists.

Parameters

index=I/R/C:

The table, row, column index string.

For example:

index=&CellIndex

index=1/2/3;

In the second example, this function verifies whether a cell exists within the third column of the second row of the first table.

ret=&variable

The return value.

True – the cell exists.

False – the cell does not exist.

CellGetIndex

Description

Searches the page for the text value specified in the text parameter and returns the index string for the first cell that contains the text. The index string is in the form of I/R/C, where I is the table index, R is the row number, and C is the column number. Other actions, such as CellClick, CellGetValue, and so on, use an index string to reference a specific cell.

Use the GetCellIndex button on the recorder toolbar to capture the text value and return a variable for the index.

Parameters

text=value;

The text to look for on the page.

index=value;

Optional. If a value is entered it is used to start the search for the text. . If the value blank, PTF will start to look for the text in the index 1/1/1.

equal=value;

equal=true performs an exact match on the text to search for. This is the default for this optional parameter.

equal=false uses a LIKE statement when performing the search.

ret=&variable

The return value is an index string in the form of I/R/C, where I is the table index, R is the row number, and C is the column number.

For example:

ret=&CellIndex

Example

This is an example of several of the HTMLTable actions:

Image: Example of CellGetIndex action

This example illustrates using the CellGetIndex to return a variable for the index, then create a variable for the html cell that is to the left of the original cell using the sum function. In this example PTF will start to look for the text in table 7, row 1, column 1.

Example of CellGetIndex action

CellGetValue

Description

Returns the contents of an HTMLTableCell.

Use the CellGetValue button on the recorder toolbar to capture the index value and return a variable for the value.

Parameters

index=I/R/C:

The table, row, column index string.

For example:

index=&CellIndex

index=1/2/3;

In the second example, this function returns the contents of the third column of the second row of the first table.

ret=&variable

The return value.

ColCount

Description

Returns the number of columns for the HTMLTable row.

Parameters

table=value;

The table index.

row=value;

The row index.

index=I/R/C:

An index string in the form of I/R/C, where I is the table index, R is the row number, and C is the column number.

As an alternative to specifying the table and row parameters, you can specify an index string, such as the return value from a CellGetIndex action.

For example:

index=&CellIndex;

ret=&variable

The return value.

RowCount

Description

Returns the number of rows for the HTMLTable.

Parameters

table=value;

The table index.

index=I/R/C:

An index string in the form of I/R/C, where I is the table index, R is the row number, and C is the column number.

As an alternative to specifying the table parameter, you can specify an index string, such as the return value from a CellGetIndex action.

For example:

index=&CellIndex;

ret=&variable

The return value.