get tree table cell containing


Retrieve the position of the cell, within its tree table or tree list, containing the specified text value. The position returns are column and node path.


TA name of the window.
TA name of the tree list or tree table.
node path
Path of the node. (Support index).
Text to be searched for.
(Optional) Search each level of the tree table. Default value is off.
Variable to receive the returned column number.
Variable to receive the returned index node path.

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.


  • Search does not include the header row.
  • Column numbers start at 1, from leftmost column.
  • A match is considered found when the contents of the examined cell exactly match the string in text. (That is, it is not sufficient that the contents of text be a substring of the cell contents.)
  • If no matching cell is found, the value of -1 is returned for column numbers. And empty for node path.
  • Search proceeds row by row from top to bottom; within each row, cells are searched from left to right. If multiple cells satisfy the search, TestArchitect returns the position of the first matching cell encountered.
  • If the variables in arguments variable and column have not been declared, the action creates them as globals.
  • If either the variable or column argument is left empty, a variable named var or col, respectively, is created to hold the return value.
  • If either the node path or recursive argument is left empty, TestArchitect will only search the tables in level 1 of the root node.
  • With recursive mode on TestArchitect will search in all the sub nodes. This will decrease test performance, especially with large tree tables.
  • This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Applicable Built-In Settings

The following settings are applicable to this action: case sensitive, ignore blank space, remove double quotes from cells, standard ASCII only, item wait, page wait, object wait, window wait, load invisible controls.

Applicable Controls

This action is applicable to the following controls: Tree table, tree list.

Applicable Platform

Systems Applications and Products in Data Processing (SAP).

Applicable Version

TestArchitect version 8.5 onward.


Action Lines