Identifying the target control of an action
The target control of an action is the control in the web page that the action has an effect on.
When editing tests, to point at the target control you want to affect, you use a combination of different properties, in particular: Source frame, Reference name, Occurrence rank (or Rank), Record row index (or Row index or Row), Context reference name, and Context occurrence rank.
The picture below illustrates the principle. A page has 6 fields with Reference name = FIELD_A, which is the value of the HTML testref attribute for each of these fields:
•The first 2 fields occur in a single-record display contained directly by the ApplicationFrame object. They can be uniquely identified by the combination of their Context reference name and Occurrence rank.
•The last 4 fields occur in rows in a multi-record display (a grid). They can be uniquely identified by the combination of their Context reference name, Occurrence rank, and Record row index.