Description:
A Tree is a component with linked elements (nodes) and a hierarchical structure. One common example is the display of directory structures used in most file managers (e.g. Windows Explorer).
Because the forward slash (/) is a special symbol for trees, if you want to use a slash as part of your parameter value, you have to mask it. See the section later in this document 9 for more details.
Mapping trees
In the Object Mapping Mode , a tree to be mapped looks like this:
 |
Actions on trees (as a hierarchical component) are not supported in the HTML toolkit. Individual nodes must be addressed as single links. |
Synopsis:
- Tree (concrete)
-
- Graphics Component (abstract)
CONCRETE_Tree_VerifyPathByIndices CONCRETE_Tree_VerifyPath CONCRETE_Tree_VerifyTextAtMousePosition CONCRETE_Tree_VerifyTextOfSelectedEntry CONCRETE_Tree_CollapseByIndexPath CONCRETE_Tree_CollapseByTextPath CONCRETE_Tree_DragByIndexPath CONCRETE_Tree_DragByTextPath CONCRETE_Tree_DropByIndexPath CONCRETE_Tree_DropByTextPath CONCRETE_Tree_ExpandByIndexPath CONCRETE_Tree_ExpandByTextPath CONCRETE_Tree_Move CONCRETE_Tree_SelectByIndexPath CONCRETE_Tree_SelectByTextPath CONCRETE_Tree_ReadTextAtMousePosition CONCRETE_Tree_ReadTextOfSelectedEntry
|
New Actions |
Name |
Type |
Parameters |
Check Existence of Node by Indexpath |
c |
String:Path Type Integer:Pre-ascend String:Indexpath Boolean:Exists
|
Check Existence of Node by Textpath |
c |
String:Path Type Integer:Pre-ascend String:Textpath String:Operator Boolean:Exists
|
Check Text (Mouse Position) |
c |
String:Text String:Operator
|
Check Text of Selected Node(s) |
c |
String:Text String:Operator
|
Collapse Node by Indexpath |
e |
String:Path Type Integer:Pre-ascend String:Indexpath
|
Collapse Node by Textpath |
e |
String:Path Type Integer:Pre-ascend String:Textpath String:Operator
|
Drag Node by Indexpath |
e |
Integer:Mouse Button String:Modifier Keys String:Path Type Integer:Pre-ascend String:Tree Indexpath
|
Drag Node by Textpath |
e |
Integer:Mouse Button String:Modifier Keys String:Path Type Integer:Pre-ascend String:Tree Textpath String:Operator
|
Drop on Node by Indexpath |
e |
String:Path Type Integer:Pre-ascend String:Tree Indexpath Integer:Delay before drop (milliseconds)
|
Drop on Node by Textpath |
e |
String:Path Type Integer:Pre-ascend String:Tree Textpath String:Operator Integer:Delay before drop (milliseconds)
|
Expand Node by Indexpath |
e |
String:Path Type Integer:Pre-ascend String:Indexpath
|
Expand Node by Textpath |
e |
String:Path Type Integer:Pre-ascend String:Textpath String:Operator
|
Move |
e |
String:Direction Integer:Number of Nodes Integer:Number of Clicks
|
Select Node by Indexpath |
e |
String:Path Type Integer:Pre-ascend String:Indexpath Integer:Number of Clicks Integer:Mouse Button String:Extend Selection
|
Select Node by Textpath |
e |
String:Path Type Integer:Pre-ascend String:Textpath String:Operator Integer:Number of Clicks Integer:Mouse Button String:Extend Selection
|
Store Text at Mouse Position |
e |
Variable:Variable Name
|
Store Text of Selected Node |
e |
Variable:Variable Name
|
Check Existence of Node by Indexpath
- This action checks that a node in the tree exists.
- You give the path to the node you want to check as an indexpath.
- For example, checking a textpath of ''1/2/3'' would check that the first node in the tree has at least 2 child nodes, and that the 2nd child node has at least 3 child nodes.
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Indexpath |
String |
- |
none |
Enter the indexpath to the item you want to check. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as an indexpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "1/2".
 |
The first node is '1' |
Name |
Data Type |
Values |
Default |
Exists |
Boolean |
true false
|
true |
- Set to true if you expect the indexpath to exist.
- Set to false if you expect the indexpath not to exist.
Check Existence of Node by Textpath
- This action checks that a node in the tree exists.
- You give the path to the node you want to check as a textpath.
- For example, checking a textpath of ''Dog/Bird/Cat'' would check whether an entry ''Cat'' exists beneath an entry for ''Bird'' in the tree, which furthermore lies beneath an entry ''Dog''.
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Enter the textpath to the node you want to check. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as a textpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "File/Open" or "Category/Horror".
- Either make sure that your path is written exactly as it appears in the interface, or use a regular expression to match the text.
- Each segment of the path will be used to find a corresponding node, using the operator provided.
Name |
Data Type |
Values |
Default |
Operator |
String |
equals not equals matches simple match
|
equals |
- The operator parameter has four possible values.
- "not equals" looks for something that does not exactly match.
- "equals" looks for an exact match.
- Select "simple match" to use a simple match expression 3.
- Select "matches" to use a regular expression 3.
- Regardless of the operator used: If there is more than one match, the first found will be chosen.
 |
When you use a regular expression for a textpath, bear in mind that each subpath is considered separately. The first path which corresponds to each subpath will be chosen. It is therefore advisable to make your regular expressions as unambiguous as possible. |
Name |
Data Type |
Values |
Default |
Exists |
Boolean |
true false
|
true |
- Set to true if you expect the textpath to exist.
- Set to false if you expect the textpath not to exist.
Check Text (Mouse Position)
- Use this action to check the text on a node in a tree based on the current position of the cursor.
- This can be used in conjunction with the action "select node" with a click count of 0.
Parameters
Name |
Data Type |
Values |
Default |
Text |
String |
- |
none |
- Enter the text you want to check.
- This parameter will be compared to the text on the node, using the operator provided.
Name |
Data Type |
Values |
Default |
Operator |
String |
equals not equals matches simple match
|
equals |
- The operator parameter has four possible values.
- "not equals" looks for something that does not exactly match.
- "equals" looks for an exact match.
- Select "simple match" to use a simple match expression 3.
- Select "matches" to use a regular expression 3.
- Regardless of the operator used: If there is more than one match, the first found will be chosen.
Check Text of Selected Node(s)
- Use this action to check the text in a selected node or selected nodes in the tree.
Parameters
Name |
Data Type |
Values |
Default |
Text |
String |
- |
none |
- Use this parameter to enter the text (or regular expression 3) you want to check.
- If you want to select multiple values, separate the values with a comma ','
- This parameter will be compared to the selected nodes, using the operator provided.
Name |
Data Type |
Values |
Default |
Operator |
String |
equals not equals matches simple match
|
equals |
- The operator parameter has four possible values.
- "not equals" looks for something that does not exactly match.
- "equals" looks for an exact match.
- Select "simple match" to use a simple match expression 3.
- Select "matches" to use a regular expression 3.
- Regardless of the operator used: If there is more than one match, the first found will be chosen.
Collapse Node by Indexpath
- Use this action to collapse a tree or part of a tree along an indicated path.
- You enter the path as an indexpath.
- Jubula realises this by activating the command in the tree to collapse it.
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Indexpath |
String |
- |
none |
Use this parameter to specify the indexpath of the subtree you want to collapse. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as an indexpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "1/2".
 |
The first node is '1' |
Example:
- Your tree looks like this:
- You want to collapse node "C".
- Enter "1/1/2":
- To collapse node "A", enter "1/1":
- To collapse a whole tree, enter "1".
Collapse Node by Textpath
- Use this action to collapse a tree or part of a tree along an indicated path.
- You enter the path as a textpath.
- Jubula realises this by activating the command in the tree to collapse it.
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this parameter to specify the textpath of the subtree you want to collapse. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as a textpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "File/Open" or "Category/Horror".
- Either make sure that your path is written exactly as it appears in the interface, or use a regular expression to match the text.
- Each segment of the path will be used to find a corresponding node, using the operator provided.
Example:
- Your tree looks like this:
- You want to collapse node "C".
- Enter "Category/A/C":
- To collapse node "A", enter "Category/A":
Name |
Data Type |
Values |
Default |
Operator |
String |
equals not equals matches simple match
|
equals |
- The operator parameter has four possible values.
- "not equals" looks for something that does not exactly match.
- "equals" looks for an exact match.
- Select "simple match" to use a simple match expression 3.
- Select "matches" to use a regular expression 3.
- Regardless of the operator used: If there is more than one match, the first found will be chosen.
 |
When you use a regular expression for a treepath, bear in mind that each subpath is considered separately. The first path in the tree which corresponds to each subpath will be chosen. It is therefore advisable to make your regular expressions as unambiguous as possible. |
Drag Node by Indexpath
- This action drags the node you specify.
- You give the path to the node to be dragged using an indexpath.
- Jubula realizes this by:
- Moving the cursor over the component.
- If the tree is not expanded, Jubula expands it.
- Holding the mouse button you specify, and the item is dragged.
- You must follow this action with a drop action
Parameters
Name |
Data Type |
Values |
Default |
Mouse Button |
Integer |
1 2 3
|
1 |
- Use this parameter to select which mouse button you want to click with.
- "1" = left mouse button
- "2" = middle mouse button
- "3" = right mouse button
- The mouse button you use to click with can also have an effect on what happens.
- The button to click will depend on your AUT and what the click should achieve.
Name |
Data Type |
Values |
Default |
Modifier Keys |
String |
none shift control alt meta cmd mod
|
none |
- Use this parameter to specify a key or keys to be pressed at the same time as the action is being executed.
- You can use this parameter to specify the following keys, or combinations thereof:
- "shift"
- "control"
- This is the first modifier for Windows and Linux
- "cmd"
- This is the first modifier for Mac
- "mod"
- This is the platform-independent first modifier. It corresponds to »CONTROL« for Windows and Linux, and »CMD« for Mac.
- "meta"
- "alt"
- You can also select "none" if you do not need a modifier.
- You can enter multiple modifiers for a key combination by entering a space-separated list of modifiers, e.g. "alt shift".
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Tree Indexpath |
String |
- |
none |
Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as an indexpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "1/2".
 |
The first node is '1' |
Drag Node by Textpath
- This action drags the node you specify.
- You give the path to the node to be dragged using a textpath.
- Jubula realizes this by:
- Moving the cursor over the component.
- If the tree is not expanded, Jubula expands it.
- Holding the mouse button you specify, and the item is dragged.
- You must follow this action with a drop action
Parameters
Name |
Data Type |
Values |
Default |
Mouse Button |
Integer |
1 2 3
|
1 |
- Use this parameter to select which mouse button you want to click with.
- "1" = left mouse button
- "2" = middle mouse button
- "3" = right mouse button
- The mouse button you use to click with can also have an effect on what happens.
- The button to click will depend on your AUT and what the click should achieve.
Name |
Data Type |
Values |
Default |
Modifier Keys |
String |
none shift control alt meta cmd mod
|
none |
- Use this parameter to specify a key or keys to be pressed at the same time as the action is being executed.
- You can use this parameter to specify the following keys, or combinations thereof:
- "shift"
- "control"
- This is the first modifier for Windows and Linux
- "cmd"
- This is the first modifier for Mac
- "mod"
- This is the platform-independent first modifier. It corresponds to »CONTROL« for Windows and Linux, and »CMD« for Mac.
- "meta"
- "alt"
- You can also select "none" if you do not need a modifier.
- You can enter multiple modifiers for a key combination by entering a space-separated list of modifiers, e.g. "alt shift".
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Tree Textpath |
String |
- |
none |
Use this parameter to specify the textpath. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as a textpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "File/Open" or "Category/Horror".
- Either make sure that your path is written exactly as it appears in the interface, or use a regular expression to match the text.
- Each segment of the path will be used to find a corresponding node, using the operator provided.
Name |
Data Type |
Values |
Default |
Operator |
String |
equals not equals matches simple match
|
equals |
- The operator parameter has four possible values.
- "not equals" looks for something that does not exactly match.
- "equals" looks for an exact match.
- Select "simple match" to use a simple match expression 3.
- Select "matches" to use a regular expression 3.
- Regardless of the operator used: If there is more than one match, the first found will be chosen.
Drop on Node by Indexpath
- This action drops a dragged item onto the node you specify.
- You give the path to the node you want to drop the item onto using an indexpath.
- Jubula realizes this by:
- Moving the cursor over the node.
- If the tree is not expanded, Jubula expands it.
- Letting loose the mouse button you specify.
- Precede this action with a drag action
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Tree Indexpath |
String |
- |
none |
Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as an indexpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "1/2".
 |
The first node is '1' |
Name |
Data Type |
Values |
Default |
Delay before drop (milliseconds) |
Integer |
- |
100 |
- Use this parameter to wait before dropping the item you have dragged.
- This can be useful to give the user interface time to scroll etc.
- Give the time to delay in milliseconds.
Drop on Node by Textpath
- This action drops a dragged item onto the node you specify.
- You give the path to the node you want to drop the item onto using a textpath.
- Jubula realizes this by:
- Moving the cursor over the node.
- If the tree is not expanded, Jubula expands it.
- Letting loose the mouse button you specify.
- Precede this action with a drag action
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Tree Textpath |
String |
- |
none |
Use this parameter to specify the textpath. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as a textpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "File/Open" or "Category/Horror".
- Either make sure that your path is written exactly as it appears in the interface, or use a regular expression to match the text.
- Each segment of the path will be used to find a corresponding node, using the operator provided.
Name |
Data Type |
Values |
Default |
Operator |
String |
equals not equals matches simple match
|
equals |
- The operator parameter has four possible values.
- "not equals" looks for something that does not exactly match.
- "equals" looks for an exact match.
- Select "simple match" to use a simple match expression 3.
- Select "matches" to use a regular expression 3.
- Regardless of the operator used: If there is more than one match, the first found will be chosen.
Name |
Data Type |
Values |
Default |
Delay before drop (milliseconds) |
Integer |
- |
100 |
- Use this parameter to wait before dropping the item you have dragged.
- This can be useful to give the user interface time to scroll etc.
- Give the time to delay in milliseconds.
Expand Node by Indexpath
- Use this action to expand a tree or part of a tree along an indicated path.
- You enter the path as an indexpath.
- Jubula realises this by activating the command in the tree to expand it.
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Indexpath |
String |
- |
none |
Use this parameter to specify the indexpath of the subtree you want to expand. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as an indexpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "1/2".
 |
The first node is '1' |
Example:
- Your tree looks like this:
- You want to expand the tree to node A
- Enter "1/1":
Expand Node by Textpath
- Use this action to expand a tree or part of a tree along an indicated path.
- You enter the path as a textpath.
- Jubula realises this by activating the command in the tree to expand it.
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this parameter to specify the textpath of the subtree you want to expand. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as a textpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "File/Open" or "Category/Horror".
- Either make sure that your path is written exactly as it appears in the interface, or use a regular expression to match the text.
- Each segment of the path will be used to find a corresponding node, using the operator provided.
Example:
- Your tree looks like this:
- You want to expand the tree to node A
- Enter "Category/A":
Name |
Data Type |
Values |
Default |
Operator |
String |
equals not equals matches simple match
|
equals |
- The operator parameter has four possible values.
- "not equals" looks for something that does not exactly match.
- "equals" looks for an exact match.
- Select "simple match" to use a simple match expression 3.
- Select "matches" to use a regular expression 3.
- Regardless of the operator used: If there is more than one match, the first found will be chosen.
 |
When you use a regular expression for a treepath, bear in mind that each subpath is considered separately. The first path in the tree which corresponds to each subpath will be chosen. It is therefore advisable to make your regular expressions as unambiguous as possible. |
Move
- Use this action to move from a currently selected node to another node.
- You specify in which direction you want to move, and how far (number of nodes).
- You also specify how many clicks should be made on the new node, if any.
- This action is useful for navigating in a tree.
- Jubula realises this by:
- searching for the node to move to
- placing the cursor on this node
- clicking the amount of times you specify
- The movement is carried out relative to the currently selected node.
- If no node is currently selected, the test will fail.
Parameters
Name |
Data Type |
Values |
Default |
Direction |
String |
up down next previous
|
up |
- Use this parameter to define the direction you want to move in.
- Combined with the node count, you can move any number of nodes in any direction.
- The following directions can be used:
- ''next'' searches only through sibling nodes (nodes that share a parent with the currently selected node). This search begins with the sibling node directly below the currently selected node and continues downward. If the search proceeds past the bottom sibling, the component is not found.
- ''up'' progressively searches parent nodes. This means that the first node found is the parent of the currently selected node. The second node found is the parent of that node, and so on. If the search proceeds beyond the root node, the component is not found.
- ''down'' progressivly searches first children nodes. This means that the first node found is the top child of the currently selected node. The second node found is the top child of that node, and so on. If the search proceeds beyond a node that has no children, the component is not found.
- ''previous'' searches only through sibling nodes (nodes that share a parent with the currently selected node). This search begins with the sibling node directly above the currently selected node and continues upward. If the search proceeds past the top sibling, the component is not found.
Name |
Data Type |
Values |
Default |
Number of Nodes |
Integer |
- |
1 |
- Use this parameter to specify how many nodes you want to move in the given direction.
Name |
Data Type |
Values |
Default |
Number of Clicks |
Integer |
- |
1 |
- Enter the amount of clicks that should be performed on the component or item.
- If you enter "0", the mouse pointer will just be moved over the specified component or item.
- Entering "1" will single-click on the component or item.
- Entering "2" will double-click on the component or item.
Select Node by Indexpath
- Use this item to select a node from a tree.
- You give the path to the node using an indexpath.
- Jubula realises this by:
- Searching for the node you specify.
- If the tree is not expanded, Jubula expands it.
- Clicking on the node, the amount of times you specify.
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Indexpath |
String |
- |
none |
Use this parameter to specify the node you want to select. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as an indexpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "1/2".
 |
The first node is '1' |
Name |
Data Type |
Values |
Default |
Number of Clicks |
Integer |
- |
1 |
- Enter the amount of clicks that should be performed on the component or item.
- If you enter "0", the mouse pointer will just be moved over the specified component or item.
- Entering "1" will single-click on the component or item.
- Entering "2" will double-click on the component or item.
Name |
Data Type |
Values |
Default |
Mouse Button |
Integer |
1 2 3
|
1 |
- Use this parameter to select which mouse button you want to click with.
- "1" = left mouse button
- "2" = middle mouse button
- "3" = right mouse button
- The mouse button you use to click with can also have an effect on what happens.
- The button to click will depend on your AUT and what the click should achieve.
Name |
Data Type |
Values |
Default |
Extend Selection |
String |
yes no
|
no |
- The Extend Selection parameter has two possible values.
- "yes" indicates the chosen item will be added to the current selection.
- Select "no" to begin a new selection with the chosen item.
Select Node by Textpath
- Use this item to select a node from a tree.
- You give the path to the node using a textpath.
- Jubula realises this by:
- Searching for the node you specify.
- If the tree is not expanded, Jubula expands it.
- Clicking on the node, the amount of times you specify.
Parameters
Name |
Data Type |
Values |
Default |
Path Type |
String |
absolute relative
|
absolute |
- The path type parameter has two values.
- "absolute" begins searching for the path at the root of the tree. Use this value when you enter the full path.
- Select "relative" to begin the search for the path at the currently selected node. This allows you to enter a partial path, ignoring all elements above the selected node.
Name |
Data Type |
Values |
Default |
Pre-ascend |
Integer |
- |
0 |
- Use this parameter with a relative path to start the search above the currently selected node.
- The search will begin n nodes above the currently selected node, where n is the value of this parameter.
- For example, a value of 0 will simply begin with the currently selected node, and a value of 2 will begin with the parent of the parent of the currently selected node.
- A value can be given such that the search begins 1 level above the topmost visible level. This is then equivalent to an absolute path.
- If the search would begin any higher than this, the action fails: The tree node cannot be found.
 |
The Pre-ascend parameter is simply ignored for absolute paths. |
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this parameter to specify the node you want to select. Make sure you give the whole path (either starting from the top of the tree, or at the position defined by the pre-ascend and path type parameters).
- Enter the path to the item as a textpath.
- Use slash '/' as a path separator (to separate parent nodes from child nodes).
- For example, "File/Open" or "Category/Horror".
- Either make sure that your path is written exactly as it appears in the interface, or use a regular expression to match the text.
- Each segment of the path will be used to find a corresponding node, using the operator provided.
Name |
Data Type |
Values |
Default |
Operator |
String |
equals not equals matches simple match
|
equals |
- The operator parameter has four possible values.
- "not equals" looks for something that does not exactly match.
- "equals" looks for an exact match.
- Select "simple match" to use a simple match expression 3.
- Select "matches" to use a regular expression 3.
- Regardless of the operator used: If there is more than one match, the first found will be chosen.
 |
When you use a regular expression for a treepath, bear in mind that each subpath is considered separately. The first path in the tree which corresponds to each subpath will be chosen. It is therefore advisable to make your regular expressions as unambiguous as possible. |
Name |
Data Type |
Values |
Default |
Number of Clicks |
Integer |
- |
1 |
- Enter the amount of clicks that should be performed on the component or item.
- If you enter "0", the mouse pointer will just be moved over the specified component or item.
- Entering "1" will single-click on the component or item.
- Entering "2" will double-click on the component or item.
Name |
Data Type |
Values |
Default |
Mouse Button |
Integer |
1 2 3
|
1 |
- Use this parameter to select which mouse button you want to click with.
- "1" = left mouse button
- "2" = middle mouse button
- "3" = right mouse button
- The mouse button you use to click with can also have an effect on what happens.
- The button to click will depend on your AUT and what the click should achieve.
Name |
Data Type |
Values |
Default |
Extend Selection |
String |
yes no
|
no |
- The Extend Selection parameter has two possible values.
- "yes" indicates the chosen item will be added to the current selection.
- Select "no" to begin a new selection with the chosen item.
Store Text at Mouse Position
- Use this action to read the value on the node where the mouse is currently placed so that you can use the value of the node as data for other Test Steps .
- This can be used in conjunction with the action "select node" with a click count of 0.
Parameters
Name |
Data Type |
Values |
Default |
Variable Name |
Variable |
- |
none |
- Enter the name you want to give to this variable.
- Variable names may only contain letters, numbers and underscores.
- You can then enter this variable name as data for other Test Steps .
- When you enter the variable name as data, place a dollar sign before it.
- The data associated with this variable name remains the same until the Project is closed, or until you overwrite the name by using it for another value.
Store Text of Selected Node
- Use this action to read the value from the currently selected node so that you can use the value as data for other Test Steps .
Parameters
Name |
Data Type |
Values |
Default |
Variable Name |
Variable |
- |
none |
- Enter the name you want to give to this variable.
- Variable names may only contain letters, numbers and underscores.
- You can then enter this variable name as data for other Test Steps .
- When you enter the variable name as data, place a dollar sign before it.
- The data associated with this variable name remains the same until the Project is closed, or until you overwrite the name by using it for another value.
(SWT) Tree (swt)
Tree Table (swt)
Copyright BREDEX GmbH 2011. Made available under the Eclipse Public License v1.0.