Description:
- The figure canvas (5.29) is an editor where figures, connections and anchors are displayed.
Figure 5.29: Figure Canvas
|
- Testing GEF components in Jubula involves mapping this figure canvas and locating the figures based on their textpath.
- Use the GEF Inspector View to find out the textpath of the figures in the canvas -->User Manual
. - The figure canvas itself contains various items which can be addressed by Jubula .
- Individual figures (5.30).
Figure 5.30: A selected figure containing another figure
|
- Tools (5.31).
Figure 5.31: Various tools on the palette
|
- Connections (5.32).
Figure 5.32: A connection between two figures
|
- Connection anchors. These are the points where connections join to figures. In Jubula , connection anchors are considered as figures. As such, they can be addressed (clicked, checked etc) using a textpath.
Synopsis:
- Figure Canvas (gef)
-
- Graphics Component (abstract)
GEF_FigureCanvas_CheckFigureExists GEF_FigureCanvas_VerifyFigureProperty GEF_FigureCanvas_CheckToolExists GEF_FigureCanvas_ClickConnection GEF_FigureCanvas_ClickFigure GEF_FigureCanvas_ClickInFigure GEF_FigureCanvas_DragFigure GEF_FigureCanvas_DropOnFigure GEF_FigureCanvas_SelectToolByTextPath
|
New Actions |
Name |
Type |
Parameters |
Check Figure Existence |
e |
String:Textpath String:Operator Boolean:Exists
|
Check Figure Property |
c |
String:Textpath String:Text Operator String:Property Name String:Property Value String:Value Operator
|
Check Tool Existence |
e |
String:Textpath String:Operator Boolean:Exists
|
Click Connection |
e |
String:Source Text Path String:Source Operator String:Target Text Path String:Target Operator Integer:Number of Clicks Integer:Mouse Button
|
Click Figure |
e |
String:Textpath String:Operator Integer:Number of Clicks Integer:Mouse Button
|
Click in Figure |
e |
String:Textpath String:Operator Integer:Number of Clicks Integer:Mouse Button Integer:x-position String:x-units Integer:y-position String:y-units
|
Drag Figure |
e |
String:Textpath String:Operator Integer:Mouse Button String:Modifier Keys Integer:x-position String:x-units Integer:y-position String:y-units
|
Drop on Figure |
e |
String:Textpath String:Operator Integer:x-position String:x-units Integer:y-position String:y-units Integer:Delay before drop (milliseconds)
|
Select Tool |
e |
String:Textpath String:Operator Integer:Number of Clicks
|
Check Figure Existence
- Use this action to check whether a figure exists on the canvas.
- You identify the figure based on its textpath.
Parameters
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this parameter to enter the textpath to the figure you want to check.
- 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 |
Exists |
Boolean |
true false
|
true |
- Enter true if you expect the figure to exist.
- Enter false if you expect the figure not to exist.
Check Figure Property
- Use this action to check a specific property of a figure.
 |
If you want the check a property of the figure canvas as a whole, use the action Check Property on the Graphics Component component. |
- You can check whether a value you enter for a given property matches the actual value for the property.
- Enter the name of the property you want to check, and then what value it should have.
 |
If the property is private, it cannot be checked, as Jubula has no access to it. |
Parameters
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
- 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.
Use the GEF Inspector View to find out the textpath of items on the canvas -->User Manual
.
Name |
Data Type |
Values |
Default |
Text Operator |
String |
equals not equals matches simple match
|
equals |
Use this parameter to enter the operator you wish to use for the textpath to the figure.
- 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 |
Property Name |
String |
- |
none |
- Enter the name of the property you want to check.
- For example, to check the width, enter "width".
Name |
Data Type |
Values |
Default |
Property Value |
String |
- |
none |
- Enter the value you expect the property to have.
- For "width" and "height" properties, enter the value in pixels.
Name |
Data Type |
Values |
Default |
Value Operator |
String |
equals not equals matches simple match
|
equals |
Use this paramter to specify the operator you wish to use for the Value parameter.
- 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 Tool Existence
Use this action to check whether a tool entry exists.
Parameters
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this paramter to enter the textpath to the tool you want to check.
- 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 |
Exists |
Boolean |
true false
|
true |
- Enter true if you expect the tool to exist.
- Enter false if you expect the tool not to exist.
Click Connection
Use this action to click a connection between two figures.
Parameters
Name |
Data Type |
Values |
Default |
Source Text Path |
String |
- |
none |
Use this parameter to enter the textpath of the first figure that has this connection.
- 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.
Use the GEF Inspector View to find out the textpath of items on the canvas -->User Manual
.
Name |
Data Type |
Values |
Default |
Source 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 |
Target Text Path |
String |
- |
none |
Use this parameter to specify the textpath of the second figure which has this connection.
- 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.
Use the GEF Inspector View to find out the textpath of items on the canvas -->User Manual
.
Name |
Data Type |
Values |
Default |
Target 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 |
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.
Click Figure
Use this action to click a figure you specify on the canvas.
Parameters
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this parameter to specify the textpath to the figure you want to click.
- 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 |
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.
Click in Figure
Use this action to click within a figure you specify. The place to click in the figure is given with X and Y units.
Parameters
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this parameter to specify the textpath to the figure you want to click in.
- 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 |
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 |
x-position |
Integer |
- |
50 |
- With this parameter, you can specify where in the component you should click.
- Use this parameter to enter a value for the x-axis (the horizontal position).
- Using the x-units parameter, you can specify whether the value should be in pixels or in percent.
- For example, if you enter "50" and then "percent", then the click will be performed in the middle of the x-axis.
- All positions are calculated from the upper left of the component, with the positive x-axis stretching toward the right side of the component.
 |
We recommend not using "0" (pixels and percent) or "100"(percent) as positions. |
Name |
Data Type |
Values |
Default |
x-units |
String |
percent pixel
|
percent |
- Use this parameter to tell Jubula whether you want your values for the x-coordinate to be in pixels or percent.
- If you choose percent for this parameter, and "50" for the x-position parameter, the click will always be in the middle of the x-axis.
Name |
Data Type |
Values |
Default |
y-position |
Integer |
- |
50 |
- With this parameter, you can specify where in the component you should click.
- Use this parameter to enter a value for the y-axis (the vertical position).
- Using the y-units parameter, you can specify whether the value should be in pixels or in percent.
- For example, if you enter "50" and then "percent", then the click will be performed in the middle of the y-axis.
- All positions are calculated from the upper left of the component, with the positive y-axis stretching toward the bottom of the component.
 |
We recommend not using "0" (pixels and percent) or "100"(percent) as positions. |
Name |
Data Type |
Values |
Default |
y-units |
String |
percent pixel
|
percent |
- Use this parameter to tell Jubula whether you want your values for the y-coordinate to be in pixels or percent.
- If you choose percent for this parameter, and "50" for the y-position parameter, the click will always be in the middle of the y-axis.
Drag Figure
- This action drags the figure you specify.
- The cursor is moved over the figure.
- The mouse button you specify is held, and the figure is dragged.
- Follow this action with a drop action
If you want to drag multiple items, use an action to select the items you want to drag before using the drag action.
Parameters
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this parameter to specify the textpath to the figure you want to drag.
- 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.
Use the GEF Inspector View to find out the textpath of items on the canvas -->User Manual
.
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 |
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 |
x-position |
Integer |
- |
50 |
- With this parameter, you can specify where in the component you should click.
- Use this parameter to enter a value for the x-axis (the horizontal position).
- Using the x-units parameter, you can specify whether the value should be in pixels or in percent.
- For example, if you enter "50" and then "percent", then the click will be performed in the middle of the x-axis.
- All positions are calculated from the upper left of the component, with the positive x-axis stretching toward the right side of the component.
 |
We recommend not using "0" (pixels and percent) or "100"(percent) as positions. |
Name |
Data Type |
Values |
Default |
x-units |
String |
percent pixel
|
percent |
- Use this parameter to tell Jubula whether you want your values for the x-coordinate to be in pixels or percent.
- If you choose percent for this parameter, and "50" for the x-position parameter, the click will always be in the middle of the x-axis.
Name |
Data Type |
Values |
Default |
y-position |
Integer |
- |
50 |
- With this parameter, you can specify where in the component you should click.
- Use this parameter to enter a value for the y-axis (the vertical position).
- Using the y-units parameter, you can specify whether the value should be in pixels or in percent.
- For example, if you enter "50" and then "percent", then the click will be performed in the middle of the y-axis.
- All positions are calculated from the upper left of the component, with the positive y-axis stretching toward the bottom of the component.
 |
We recommend not using "0" (pixels and percent) or "100"(percent) as positions. |
Name |
Data Type |
Values |
Default |
y-units |
String |
percent pixel
|
percent |
- Use this parameter to tell Jubula whether you want your values for the y-coordinate to be in pixels or percent.
- If you choose percent for this parameter, and "50" for the y-position parameter, the click will always be in the middle of the y-axis.
Drop on Figure
- This action drops a dragged figure onto the figure you specify.
- The cursor is moved over the figure.
- The mouse button is let loose, and the figure is dropped.
- Precede this action with a drag action
Parameters
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this parameter to specify the textpath to the figure you want to drop onto.
- 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.
Use the GEF Inspector View to find out the textpath of items on the canvas -->User Manual
.
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 |
x-position |
Integer |
- |
50 |
- With this parameter, you can specify where in the component you should click.
- Use this parameter to enter a value for the x-axis (the horizontal position).
- Using the x-units parameter, you can specify whether the value should be in pixels or in percent.
- For example, if you enter "50" and then "percent", then the click will be performed in the middle of the x-axis.
- All positions are calculated from the upper left of the component, with the positive x-axis stretching toward the right side of the component.
 |
We recommend not using "0" (pixels and percent) or "100"(percent) as positions. |
Name |
Data Type |
Values |
Default |
x-units |
String |
percent pixel
|
percent |
- Use this parameter to tell Jubula whether you want your values for the x-coordinate to be in pixels or percent.
- If you choose percent for this parameter, and "50" for the x-position parameter, the click will always be in the middle of the x-axis.
Name |
Data Type |
Values |
Default |
y-position |
Integer |
- |
50 |
- With this parameter, you can specify where in the component you should click.
- Use this parameter to enter a value for the y-axis (the vertical position).
- Using the y-units parameter, you can specify whether the value should be in pixels or in percent.
- For example, if you enter "50" and then "percent", then the click will be performed in the middle of the y-axis.
- All positions are calculated from the upper left of the component, with the positive y-axis stretching toward the bottom of the component.
 |
We recommend not using "0" (pixels and percent) or "100"(percent) as positions. |
Name |
Data Type |
Values |
Default |
y-units |
String |
percent pixel
|
percent |
- Use this parameter to tell Jubula whether you want your values for the y-coordinate to be in pixels or percent.
- If you choose percent for this parameter, and "50" for the y-position parameter, the click will always be in the middle of the y-axis.
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.
Select Tool
Use this action to select a tool from the panel in the figure canvas.
Parameters
Name |
Data Type |
Values |
Default |
Textpath |
String |
- |
none |
Use this parameter to specify the textpath to the tool you want to select.
- 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.
Use the GEF Inspector View to find out the textpath of items on the canvas -->User Manual
.
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 |
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.
Copyright BREDEX GmbH 2011. Made available under the Eclipse Public License v1.0.