Description:
- The Application component is the container for all other components.
- It represents the AUT as a whole.
Synopsis:
CONCRETE_GraphicApplication_Activate CONCRETE_GraphicApplication_CheckExistenceOfWindow CONCRETE_GraphicApplication_CheckValues CONCRETE_GraphicApplication_CheckStringValues CONCRETE_GraphicApplication_ClickInActiveWindow CONCRETE_GraphicApplication_CopyToClipboard CONCRETE_GraphicApplication_ExecuteCommand CONCRETE_GraphicApplication_NativeInputText CONCRETE_GraphicApplication_NativeKeyStroke CONCRETE_GraphicApplication_InputTextDirect CONCRETE_GraphicApplication_KeyStroke CONCRETE_GraphicApplication_ManualTestStep CONCRETE_GraphicApplication_Pause CONCRETE_GraphicApplication_ReadTimer CONCRETE_GraphicApplication_Restart CONCRETE_GraphicApplication_KeyToogle CONCRETE_GraphicApplication_StartTimer CONCRETE_GraphicApplication_ReadValue CONCRETE_GraphicApplication_TakeScreenshot CONCRETE_GraphicApplication_TakeScreenshotOfActiveWindow CONCRETE_GraphicApplication_Wait CONCRETE_GraphicApplication_WaitForWindow CONCRETE_GraphicApplication_WaitForWindowActivation CONCRETE_GraphicApplication_WaitForWindowToClose
|
New Actions |
Name |
Type |
Parameters |
Activate |
e |
String:Activation Method
|
Check Existence of Window |
e |
String:Title String:Operator Boolean:Exists
|
Check Numeric Values |
e |
String:Value 1 String:Comparison Method String:Value 2
|
Check String Values |
e |
String:Value 1 String:Value 2 Operator String:Value 2
|
Click in Active Window |
e |
Integer:Number of Clicks Integer:Mouse Button Integer:x-position String:x-units Integer:y-position String:y-units
|
Copy Text to Clipboard |
e |
String:Text
|
Execute External Command |
e |
String:Command Integer:Expected Exit Code Boolean:Local Integer:Timeout in ms
|
External Input Text |
e |
String:Text
|
External Key Combination |
e |
String:Modifier Keys String:Base Key
|
Input Text |
e |
String:Text
|
Key Combination |
e |
String:Modifier Keys String:Base Key
|
Manual Test Step |
e |
String:Action to perform String:Expected Behavior Integer:Timeout in ms
|
Pause Test Execution |
e |
Read Timer |
e |
String:Timer Name Variable:Timer Value Variable Name
|
Restart |
e |
Set Toggle Key |
e |
Integer:Key Boolean:Activate Key
|
Start Timer |
e |
String:Timer Name Variable:Start Time Variable Name
|
Store Value |
e |
Variable:Variable Name String:Value
|
Take Screenshot |
e |
String:Destination Integer:Delay String:File Access Integer:Scaling Factor Boolean:Create Directories
|
Take Screenshot of Active Window |
e |
String:Destination Integer:Delay String:File Access Integer:Scaling Factor Boolean:Create Directories Integer:Margin Top Integer:Margin Right Integer:Margin Bottom Integer:Margin Left
|
Wait |
e |
Integer:Millisecs
|
Wait for Window |
e |
String:Title String:Operator Integer:Timeout in ms Integer:Delay after Visibility
|
Wait for Window Activation |
e |
String:Title String:Operator Integer:Timeout in ms Integer:Delay after Visibility
|
Wait for Window to Close |
e |
String:Title String:Operator Integer:Timeout in ms Integer:Delay after Closure
|
Inherited Actions
none
Activate
- When the ITE and AUT Agent are running on the same computer, you may need to bring the AUT into focus before a test can begin.
- Exactly how to activate the application can vary from one system to another.
- This action offers various different ways of activating the application.
- Jubula realises this action by clicking in the location indicated in the activation method parameter.
- In the AUT configuration -->User Manual
, the default is that no activation is carried out. - You can set an activation method for the whole AUT in its configuration, and use this in your Test Steps (e.g. set the activation method parameter to "AUT_DEFAULT") or you can use a different activation method.
- In this way, you can centrally define a default for a given operating system, which you can easily change when you test on another operating system.
- Using the activate action, you can also specify activation methods which differ from the default.
 |
This action is used to ensure that an AUT has the current focus. It cannot be used to maximize a minimized AUT . |
Parameters
Name |
Data Type |
Values |
Default |
Activation Method |
String |
AUT_DEFAULT NONE TITLEBAR NW NE SW SE CENTER
|
AUT_DEFAULT |
- Use this parameter to specify how you want the AUT to be activated.
- You have a choice of possible values:
Value |
Description |
"NONE" |
does not activate the AUT : in effect, this parameter does nothing. |
"AUT_DEFAULT" |
uses the default from the AUT configuration |
"NE" |
click in the northeast corner of the AUT window |
"NW" |
click in the northwest corner of the AUT window |
"SE" |
click in the southeast corner |
"SW" |
click in the southwest corner |
"TITLEBAR" |
click in the window's titlebar. This does not work with small or non-existent titlebars. |
Check Existence of Window
- Use this action to check the existence of a window based on its title.
Parameters
Name |
Data Type |
Values |
Default |
Title |
String |
- |
none |
- Enter the title of the window you are waiting for.
- The title you provide will be compared to the title bar of each window as it opens, 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 |
- Set this parameter to true if you expect the window to exist.
- Set this parameter to false if you do not expect the window to exist.
Check Numeric Values
- Use this action to compare two numeric values during your test.
- This action can be used with the start timer and read timer actions to compare the time difference to a value you specify (i.e. to measure the performance of your application).
- You can also compare other variables you have read from your application with this action.
Parameters
Name |
Data Type |
Values |
Default |
Value 1 |
String |
- |
none |
- Enter the first value or variable you want this action to check.
Name |
Data Type |
Values |
Default |
Comparison Method |
String |
less than less or equal than equal to greater or equal than greater than
|
equal to |
- Select the comparison method you want to use to check the two values or variables.
Name |
Data Type |
Values |
Default |
Value 2 |
String |
- |
none |
- Enter the second value or variable you want this action to check.
Check String Values
Use this action to compare the values of two strings in your test. This can be used if you want to check the value of a variable, for example.
Parameters
Name |
Data Type |
Values |
Default |
Value 1 |
String |
- |
none |
- Enter the value or variable you want to perform the check against.
- With the other parameters, you can enter how the value should be compared and what it should be compared to.
Name |
Data Type |
Values |
Default |
Value 2 Operator |
String |
equals not equals matches simple match
|
equals |
Use this parameter to define the operator for the value 2 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.
Name |
Data Type |
Values |
Default |
Value 2 |
String |
- |
none |
- Enter the value or variable you want to use to perform the check against the value 1 parameter.
- If you want to check that value one begins with "A" and ends with "Z" then you could use matches as the operator parameter, and enter "A.*Z" as the parameter for value 2.
Click in Active Window
- Use this action to send one or more clicks with any mouse button to the currently active window.
- You can specify where to click, how many times, and with which mouse button.
Parameters
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. |
 |
Do not use this action with the value 100% on Linux systems, as this causes a timeout. |
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.
Copy Text to Clipboard
This action allows you to copy one string to the clipboard on your operating system. It can be used in combination with the key combination »CTRL+V« to paste text into your AUT , or into native dialogs (e.g. file choosers) opened by your AUT .
Parameters
Name |
Data Type |
Values |
Default |
Text |
String |
- |
none |
- Enter the text you wish you copy to the clipboard.
- If the text contains any special characters, use the symbol for verbatim text to mask any special functions of the characters 9.1.
Execute External Command
- Use this action to run an external script or command during your test.
- You enter the command and the exit code that Jubula should wait for, as well as a timeout to tell Jubula how long to wait for the code.
Parameters
Name |
Data Type |
Values |
Default |
Command |
String |
- |
none |
 |
Use .cmd commands instead of .bat commands. |
Name |
Data Type |
Values |
Default |
Expected Exit Code |
Integer |
- |
0 |
- Scripts generally have an exit code (for example, 0 usually means that the script was successfull).
- Use this paramter to define the exit code that Jubula should expect.
Name |
Data Type |
Values |
Default |
Local |
Boolean |
true false
|
false |
- Use this parameter to define whether the command should be run locally (on the same machine as the ITE , the same machine as Jubula is installed on) or remotely (on the machine where the AUT Agent is installed, and the AUT is running.).
- Set this parameter to true to run the command locally.
- Set this parameter to false to run the command remotely.
 |
If you are running your AUT on the same machine as the ITE , there is no difference between running the command locally or remotely. |
- For information on using relative paths to the location of the commands on local and remote machines, see the section in this document 8.
Name |
Data Type |
Values |
Default |
Timeout in ms |
Integer |
- |
5000 |
- Enter the amount of time (in milliseconds) Jubula should wait for the exit code for the command.
- If the exit code is not delivered in this timeframe, the Test Step is unsuccessful.
External Input Text
- Use this action to input text into dialogs that are not supported by Jubula (e.g. file choosers).
- Jubula can send keystrokes to these dialogs, but cannot check if they have arrived.
- For this action to work, the dialog must be in focus, and the cursor must be in the text field to be filled in.
- Combine this action with the "External Key Combination" action to send key combinations to native dialogs to be able to work with file choosers during your test.
Native dialogs in SWT and RCP AUT's
In SWT and RCP AUT's , this action can only enter ASCII characters (large and small letters, and numbers).
To enter characters such as spaces, periods and slashes, use the action External Key Combination.
We recommend using the action Copy to Clipboard to help fill out native dialogs in SWT and RCP AUT's . The string you copy to the clipboard can then simply be entered into the textfield in the dialog using »CTRL+V« as an External Key Combination action.
Parameters
Name |
Data Type |
Values |
Default |
Text |
String |
- |
none |
- Use this parameter to specify the text you want to enter into the component.
External Key Combination
- Use this action to send a key combination to a dialog that is not supported by Jubula (e.g. file choosers).
- Jubula can send a keystroke to these dialogs, but cannot check if it have arrived.
- For this action to work, the dialog must be in focus.
- Combine this action with the "External Input Text" action to be able to work with file choosers during your test.
- Some of the keystrokes you may need include ENTER, SPACE, PERIOD and /.
 |
Under Swing, this action only supports the American character set. Under SWT, you can use any character set under Windows, but there are some problems with non-American characters under Linux. |
 |
We recommend using the action Copy to Clipboard to help fill out native dialogs in SWT and RCP AUT's . The string you copy to the clipboard can then simply be entered into the textfield in the dialog using »CTRL+V« as an External Key Combination action. |
Parameters
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 |
Base Key |
String |
- |
none |
- Use the "base key" parameter to specify which key to ''press''.
- The various keys have different codes.
- The most important keycodes are:
Input Text
- Use this action to enter text into the component which currently has focus.
- The text you want to enter is given as a parameter.
- The difference between this action and the "External Input Text" is that Jubula can check that the keystrokes have arrived at the component.
- Use this action for components that Jubula supports, and the "External Input Text" action for components in external dialogs, such as file choosers.
 |
In HTML AUT's , this action can only be used with alphanumeric characters. Also, if the focus is not currently on the browser, then this action will not be successful. |
Parameters
Name |
Data Type |
Values |
Default |
Text |
String |
- |
none |
- Use this parameter to specify the text you want to enter into the component.
Key Combination
- This action allows you to send a key command to the application.
- This is useful for actions such as »DELETE«, »ENTER«, etc.
 |
Under Swing, this action only supports the American character set. Under SWT, you can use any character set under Windows, but there are some problems with non-American characters under Linux. |
 |
In HTML, on Firefox, the keys »F5« and »ESCAPE« cannot be used. |
 |
Users working on Linux systems should increase the key repeat delay on their test system or remove it completely. Some Linux systems can otherwise tend to repeat key presses which can lead to undesired actions being produced during test execution. |
Parameters
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 |
Base Key |
String |
- |
none |
- Use the "base key" parameter to specify which key to ''press''.
- The various keys have different codes.
- The most important keycodes are:
Manual Test Step
- Use this action to specify a manual Test Step .
- Manual Test Steps can be specified in Jubula and must be executed by a manual tester.
- Jubula provides a special test execution mode for manual testing, in which the manual Test Steps are presented to the user to be executed.
Parameters
Name |
Data Type |
Values |
Default |
Action to perform |
String |
- |
none |
- Enter a description of the action you wish to be performed.
- This description will be displayed during execution.
Name |
Data Type |
Values |
Default |
Expected Behavior |
String |
- |
none |
- Enter a description of the expected behaviour of the action.
- This description will be displayed during execution.
Name |
Data Type |
Values |
Default |
Timeout in ms |
Integer |
- |
900000 |
- Enter the amount of time to wait for the execution of the manual Test Step , in milliseconds.
- If the manual Test Step is not manually passed or failed by the tester in this time, the action is marked as failed.
 |
We recommend entering a higher timeout for manual Test Steps than for automated ones, as a human tester may need more time to perform the action(s) and document any errors. |
Pause Test Execution
- This action pauses the test execution.
- To continue a paused test, press the pause button in the ITE .
This action has no parameters.
Read Timer
- Use this action to read a timer (stopwatch).
- You enter the name of the timer you want to read and enter a variable which saves the difference (in milliseconds) between the current time and the time at which the timer was started.
- You can start timers and compare values between starting and reading timers using other actions.
- This action is useful for measuring how long your AUT takes to execute certain actions.
 |
You must have used the actionStart timer at least once in your test to use this action. |
Parameters
Name |
Data Type |
Values |
Default |
Timer Name |
String |
- |
none |
- Enter the name of the timer you want to read.
Name |
Data Type |
Values |
Default |
Timer Value Variable Name |
Variable |
- |
none |
- Enter the variable name you will use to save the time difference between starting the timer and reading it.
Restart
- Use this action to restart the AUT during the test.
- The action closes your AUT and all windows/dialogs associated with it.
- It then starts the same AUT with the same configuration as it had when you originally started it and carries on with the test.
- If your AUT takes a while to load/to be ready, it is a good idea to use the "wait for window" or "wait for component" action after the restart action.
 |
Do not use the restart action as the first Test Step in a test. |
This action has no parameters.
Set Toggle Key
- Use this action to turn the following keys on or off:
- Caps-lock
- Num-lock
- Scroll-lock
- You specify which key to (de)activate and whether the function should be turned on or off.
 |
Due to current Java limitations, Jubula does not support this action when testing under Linux. This means that any Test Step containing this action will fail when testing under Linux. |
Parameters
Name |
Data Type |
Values |
Default |
Key |
Integer |
1 2 3
|
1 |
- Use this parameter to tell Jubula which key you want to (de)activate.
- "1" = Num-lock
- "2" = Caps-lock
- "3" = Scroll-lock
Name |
Data Type |
Values |
Default |
Activate Key |
Boolean |
true false
|
true |
- Use this parameter to specify whether you want to turn the function on or off.
- Select true to turn the function on.
- Select false to turn the function off.
- Turning the function on when it is already on will not have any effect. The function remains on.
Start Timer
- Use this action to start a timer (stopwatch).
- You name the timer and enter a variable which saves the current time (in milliseconds since the January 1st 1970).
- You can read timers and compare values between starting and reading timers using other actions.
- This action is useful for measuring how long your AUT takes to execute certain actions.
Parameters
Name |
Data Type |
Values |
Default |
Timer Name |
String |
- |
none |
- Enter a name you will use to identify this timer in your tests.
Name |
Data Type |
Values |
Default |
Start Time Variable Name |
Variable |
- |
none |
- Enter the variable name you will use to save the current time.
Store Value
- Use this action to store a value you specify so that you can use it as data for other actions.
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.
Name |
Data Type |
Values |
Default |
Value |
String |
- |
none |
- Enter the value that you want to store.
Take Screenshot
- This action takes a screen capture and saves the resulting image to disk.
- The action takes a screenshot of the whole screen. To take a screenshot of only the active window, use the action Take Screenshot of Active Window.
- If you do not enter a file extension, the screenshot will be saved as a .png file. You can also save the file as an .jpeg or .bmp file.
Parameters
Name |
Data Type |
Values |
Default |
Destination |
String |
- |
none |
- Use this parameter to define the path and filename of the saved image.
- Make sure that you have write access to the destination.
- If the destination file does not have an extension, the .pngextension will be automatically appended.
- For information on using relative paths to the location where screenshots should be saved, see the section in this document 8.
Name |
Data Type |
Values |
Default |
Delay |
Integer |
- |
0 |
- Use this parameter to insert a delay before taking the screenshot.
Name |
Data Type |
Values |
Default |
File Access |
String |
rename overwrite
|
rename |
- Use this parameter to control how this image is saved if the destination file already exists.
- Select ''overwrite'' to simply overwrite the Destination file.
- Select ''rename'' to append a sequential integer to the file name. This automates the creation of sequentially labeled screenshots.
Name |
Data Type |
Values |
Default |
Scaling Factor |
Integer |
- |
100 |
- Use this parameter to scale the image created by the screenshot.
- The value for this parameter must lie between 1 and 200 (inclusive).
- The units for this parameter are ''percent''. This means that a value of 50 scales the image to half its original size, and a value of 200 scales the image to double its original size.
Name |
Data Type |
Values |
Default |
Create Directories |
Boolean |
true false
|
true |
- Use this parameter to determine how the image is saved if the given path does not exist.
- Select true to create the necessary directories automatically.
- Selecting false will cause the test step to fail if the path does not already exist.
Take Screenshot of Active Window
- This action takes a screen capture of the active window and saves the resulting image to disk.
- To take a screenshot of thw whole screen, use the action Take Screenshot.
- If you do not enter a file extension, the screenshot will be saved as a .png file. You can also save the file as an .jpeg or .bmp file.
- You can specify a margin around the active window to extend the range of the screenshot. This may be necessary on some systems where the title bar of some dialogs is not included in the screenshot.
Parameters
Name |
Data Type |
Values |
Default |
Destination |
String |
- |
none |
- Use this parameter to define the path and filename of the saved image.
- Make sure that you have write access to the destination.
- If the destination file does not have an extension, the .pngextension will be automatically appended.
- For information on using relative paths to the location where screenshots should be saved, see the section in this document 8.
Name |
Data Type |
Values |
Default |
Delay |
Integer |
- |
0 |
- Use this parameter to insert a delay before taking the screenshot.
Name |
Data Type |
Values |
Default |
File Access |
String |
rename overwrite
|
rename |
- Use this parameter to control how this image is saved if the destination file already exists.
- Select ''overwrite'' to simply overwrite the Destination file.
- Select ''rename'' to append a sequential integer to the file name. This automates the creation of sequentially labeled screenshots.
Name |
Data Type |
Values |
Default |
Scaling Factor |
Integer |
- |
100 |
- Use this parameter to scale the image created by the screenshot.
- The value for this parameter must lie between 1 and 200 (inclusive).
- The units for this parameter are ''percent''. This means that a value of 50 scales the image to half its original size, and a value of 200 scales the image to double its original size.
Name |
Data Type |
Values |
Default |
Create Directories |
Boolean |
true false
|
true |
- Use this parameter to determine how the image is saved if the given path does not exist.
- Select true to create the necessary directories automatically.
- Selecting false will cause the test step to fail if the path does not already exist.
Name |
Data Type |
Values |
Default |
Margin Top |
Integer |
- |
0 |
- Use this parameter to enter the amount of pixels you wish you include in the screenshot above the top of the dialog.
- You can enter positive and negative values.
- Enter 0 to neither extend nor reduce the margin at the top of the dialog.
Name |
Data Type |
Values |
Default |
Margin Right |
Integer |
- |
0 |
- Use this parameter to enter the amount of pixels you wish you include in the screenshot to the right of the dialog.
- You can enter positive and negative values.
- Enter 0 to neither extend nor reduce the margin.
Name |
Data Type |
Values |
Default |
Margin Bottom |
Integer |
- |
0 |
- Use this parameter to enter the amount of pixels you wish you include in the screenshot at the bottom of the dialog.
- You can enter positive and negative values.
- Enter 0 to neither extend nor reduce the margin.
Name |
Data Type |
Values |
Default |
Margin Left |
Integer |
- |
0 |
- Use this parameter to enter the amount of pixels you wish you include in the screenshot at left of the dialog.
- You can enter positive and negative values.
- Enter 0 to neither extend nor reduce the margin.
Wait
- Sometimes it is necessary to wait for a period of time before continuing.
- Use this action to tell the AUT Agent to wait for a given amount of time before continuing with the next Test Step .
- Jubula also offers actions to wait for a window and a component. If you are waiting for a component, or a window, use the actions specific to these events.
Parameters
Name |
Data Type |
Values |
Default |
Millisecs |
Integer |
- |
none |
- Use this parameter to enter the amount of time to wait before carrying on.
- Enter the amount of time in milliseconds.
Wait for Window
- This action waits for the window you name to open.
- This action does not check whether the window is active
- Once the window is open (or if the window is already open), the test continues.
- If the window does not open, the action fails.
Parameters
Name |
Data Type |
Values |
Default |
Title |
String |
- |
none |
- Enter the title of the window you are waiting for.
- The title you provide will be compared to the title bar of each window as it opens, 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 |
Timeout in ms |
Integer |
- |
1000 |
- Enter the amount of time to wait for the window, in milliseconds.
- If the window does not open in this time, the action fails.
Name |
Data Type |
Values |
Default |
Delay after Visibility |
Integer |
- |
200 |
- Sometimes a window is not ready to receive events (mouse clicks, key presses) until a few moments after becoming visible.
- Use this parameter to set the amount of time (in milliseconds) to wait once the window has appeared before continuing.
Wait for Window Activation
- This action waits for the window you name to become active. A window is active only when it is the currently selected window.
- Once the window is active (or if the window is already active when this test step begins), the test continues.
- If the window does not become active, the action fails.
Parameters
Name |
Data Type |
Values |
Default |
Title |
String |
- |
none |
- Enter the title of the window you are waiting for.
- Enter the title exactly as it appears in the title bar of the window.
- The title you provide will be compared to the title bar of each window as it becomes active, 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 |
Timeout in ms |
Integer |
- |
1000 |
- Enter the amount of time to wait for the window, in milliseconds.
- If the window does not appear in this time, the action fails.
Name |
Data Type |
Values |
Default |
Delay after Visibility |
Integer |
- |
200 |
- Sometimes a window is not ready to receive events (mouse clicks, key presses) until a few moments after activation.
- Use this parameter to set the amount of time (in milliseconds) to wait once the window has appeared before continuing.
Wait for Window to Close
- This action waits for the window you name to close.
- Once the window is closed (or if no open window with a corresponding title can be found), the test continues.
- If a window is found and does not close within the timeout period, the action fails.
Parameters
Name |
Data Type |
Values |
Default |
Title |
String |
- |
none |
- Enter the title of the window you are waiting for.
- Enter the title exactly as it appears in the title bar of the window.
- The title you provide will be compared to the title bar of each window as it closes, 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 |
Timeout in ms |
Integer |
- |
1000 |
- Enter the amount of time to wait for the window, in milliseconds.
- If the window does not close in this time, the action fails.
Name |
Data Type |
Values |
Default |
Delay after Closure |
Integer |
- |
200 |
- Sometimes other windows are not ready to receive events (mouse clicks, key presses) until a few moments after becoming the overlapping window is closed.
- Use this parameter to set the amount of time (in milliseconds) to wait once the window has closed before continuing.
Copyright BREDEX GmbH 2011. Made available under the Eclipse Public License v1.0.