Go to Definition
Often, while editing or reviewing a test, you’ll come across the name of an item whose definition you wish to see or modify. Rather than have to locate that item in the TestArchitect explorer tree, you can take advantage of a one-click shortcut. TestArchitect’s Go to Definition feature enables you to navigate instantaneously to an item from a reference to it in the test editor.
Test editors in which Go to definition is available:
- Test module
- User-defined action
Go to definition can be used to navigate to the following project item types:
- Test modules
- Test suites
- User-defined actions
- Data sets
- Interface entities
- Interface elements
The following table indicates the “hot spots” in a test module or action from which you can typically navigate to each type of project item:
Project item type | Editor cell from which the definition is accessed |
---|---|
test module | run test action line / name argument |
test suite | run test action line / name argument |
user-defined action | Column A of action line invoking the user-defined action |
data set | use data set action line / name argument |
interface entity | Any action argument whose data type is defined as Interface Entity. (For User Interface built-in actions, this is almost always the window argument. User-defined and user-scripted actions may also use this data type for some arguments.) |
interface element | Any action argument whose data type is defined as Interface Element. (For User Interface built-in actions, this is usually the control1 argument. User-defined and user-scripted actions may also use this data type for some arguments.) |
To open a definition of a named project item from within a test module or action, do the following:
In the test editor, right-click the cell holding the name of the item of interest.
Select Go to Definition from the context menu.
Fastpath: As an alternative to steps 1 and 2, simply select the cell and press F3 on your keyboard.
The referenced action, interface entity, data set, test suite, or test module is opened in its own editor window.
Notes:In the case of a referenced interface element, the parent interface entity is opened, with the interface element highlighted.
TestArchitect navigates to the definition of the selected project item, making it the active tab in the main client window.
In most cases, the context menu displays the full list of variations, including the default variation, allowing you to select the one of your choosing:
(Note that interface elements are the exception, as Go to definition always opens their default parent interface entities.)
Using the F3 option always opens the default variation of the given project item.