5.2.1 Application

Description:

Synopsis:

New Actions
Name Type Parameters
Activate e

String:Activation Method

CONCRETE_GraphicApplication_Activate
Check Existence of Window e

String:Title
String:Operator
Boolean:Exists

CONCRETE_GraphicApplication_CheckExistenceOfWindow
Check Numeric Values e

String:Value 1
String:Comparison Method
String:Value 2

CONCRETE_GraphicApplication_CheckValues
Check String Values e

String:Value 1
String:Value 2 Operator
String:Value 2

CONCRETE_GraphicApplication_CheckStringValues
Click in Active Window e

Integer:Number of Clicks
Integer:Mouse Button
Integer:x-position
String:x-units
Integer:y-position
String:y-units

CONCRETE_GraphicApplication_ClickInActiveWindow
Copy Text to Clipboard e

String:Text

CONCRETE_GraphicApplication_CopyToClipboard
Execute External Command e

String:Command
Integer:Expected Exit Code
Boolean:Local
Integer:Timeout in ms

CONCRETE_GraphicApplication_ExecuteCommand
External Input Text e

String:Text

CONCRETE_GraphicApplication_NativeInputText
External Key Combination e

String:Modifier Keys
String:Base Key

CONCRETE_GraphicApplication_NativeKeyStroke
Input Text e

String:Text

CONCRETE_GraphicApplication_InputTextDirect
Key Combination e

String:Modifier Keys
String:Base Key

CONCRETE_GraphicApplication_KeyStroke
Manual Test Step e

String:Action to perform
String:Expected Behavior
Integer:Timeout in ms

CONCRETE_GraphicApplication_ManualTestStep
Pause Test Execution e
CONCRETE_GraphicApplication_Pause
Read Timer e

String:Timer Name
Variable:Timer Value Variable Name

CONCRETE_GraphicApplication_ReadTimer
Restart e
CONCRETE_GraphicApplication_Restart
Set Toggle Key e

Integer:Key
Boolean:Activate Key

CONCRETE_GraphicApplication_KeyToogle
Start Timer e

String:Timer Name
Variable:Start Time Variable Name

CONCRETE_GraphicApplication_StartTimer
Store Value e

Variable:Variable Name
String:Value

CONCRETE_GraphicApplication_ReadValue
Take Screenshot e

String:Destination
Integer:Delay
String:File Access
Integer:Scaling Factor
Boolean:Create Directories

CONCRETE_GraphicApplication_TakeScreenshot
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

CONCRETE_GraphicApplication_TakeScreenshotOfActiveWindow
Wait e

Integer:Millisecs

CONCRETE_GraphicApplication_Wait
Wait for Window e

String:Title
String:Operator
Integer:Timeout in ms
Integer:Delay after Visibility

CONCRETE_GraphicApplication_WaitForWindow
Wait for Window Activation e

String:Title
String:Operator
Integer:Timeout in ms
Integer:Delay after Visibility

CONCRETE_GraphicApplication_WaitForWindowActivation
Wait for Window to Close e

String:Title
String:Operator
Integer:Timeout in ms
Integer:Delay after Closure

CONCRETE_GraphicApplication_WaitForWindowToClose

Inherited Actions

none


Activate (Application)

Parameters
Name Data Type Values Default
Activation Method String AUT_DEFAULT
NONE
TITLEBAR
NW
NE
SW
SE
CENTER
AUT_DEFAULT

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 (Application)

Parameters
Name Data Type Values Default
Title String - none

Name Data Type Values Default
Operator String equals
not equals
matches
simple match
equals

Name Data Type Values Default
Exists Boolean true
false
true


Check Numeric Values (Application)

Parameters
Name Data Type Values Default
Value 1 String - none

Name Data Type Values Default
Comparison Method String less than
less or equal than
equal to
greater or equal than
greater than
equal to

Name Data Type Values Default
Value 2 String - none


Check String Values (Application)

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

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.

Name Data Type Values Default
Value 2 String - none


Click in Active Window (Application)

Parameters
Name Data Type Values Default
Number of Clicks Integer - 1

Name Data Type Values Default
Mouse Button Integer 1
2
3
1

Name Data Type Values Default
x-position Integer - 50

Name Data Type Values Default
x-units String percent
pixel
percent

Name Data Type Values Default
y-position Integer - 50

\includegraphics[height=2cm]{danger} 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


Copy Text to Clipboard (Application)

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


Execute External Command (Application)

Parameters
Name Data Type Values Default
Command String - none

\includegraphics[height=2cm]{lightbulb} Use .cmd commands instead of .bat commands.

Name Data Type Values Default
Expected Exit Code Integer - 0

Name Data Type Values Default
Local Boolean true
false
false

Name Data Type Values Default
Timeout in ms Integer - 5000


External Input Text (Application)

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


External Key Combination (Application)

\includegraphics[height=2cm]{danger} 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.

\includegraphics[height=2cm]{lightbulb} 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

Name Data Type Values Default
Base Key String - none

value(s) description
0 ... 9 top-row keys 0 through 9
A ... Z letters A to Z. For capital letters,
use "shift" in the "Modifier" parameter.
ENTER Enter or Return key
SPACE the Spacebar
TAB the Tab key
ESCAPE the Escape key
BACK_SPACE the Backspace key
F1 ... F12 the function keys
HOME, END the home and end keys
(not the number pad keys!)
INSERT, DELETE the insertion and deletion keys
(not the number pad keys!)
PAGE_UP, PAGE_DOWN the page up and page down keys
(not the number pad keys!)
DOWN, UP the Up and Down arrow keys
(not the number pad keys!)
LEFT, RIGHT the Left and Right arrow keys
(not the number pad keys!)
NUMPAD0 ... NUMPAD9 The number pad keys.


Input Text (Application)

\includegraphics[height=2cm]{lightbulb} 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


Key Combination (Application)

\includegraphics[height=2cm]{lightbulb} 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.

\includegraphics[height=2cm]{danger} In HTML, on Firefox, the keys »F5« and »ESCAPE« cannot be used.

\includegraphics[height=2cm]{lightbulb} 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

Name Data Type Values Default
Base Key String - none

value(s) description
0 ... 9 top-row keys 0 through 9
A ... Z letters A to Z. For capital letters,
use "shift" in the "Modifier" parameter.
ENTER Enter or Return key
SPACE the Spacebar
TAB the Tab key
ESCAPE the Escape key
BACK_SPACE the Backspace key
F1 ... F12 the function keys
HOME, END the home and end keys
(not the number pad keys!)
INSERT, DELETE the insertion and deletion keys
(not the number pad keys!)
PAGE_UP, PAGE_DOWN the page up and page down keys
(not the number pad keys!)
DOWN, UP the Up and Down arrow keys
(not the number pad keys!)
LEFT, RIGHT the Left and Right arrow keys
(not the number pad keys!)
NUMPAD0 ... NUMPAD9 The number pad keys.


Manual Test Step (Application)

Parameters
Name Data Type Values Default
Action to perform String - none

Name Data Type Values Default
Expected Behavior String - none

Name Data Type Values Default
Timeout in ms Integer - 900000


Pause Test Execution (Application)

This action has no parameters.


Read Timer (Application)

\includegraphics[height=2cm]{lightbulb} 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

Name Data Type Values Default
Timer Value Variable Name Variable - none


Restart (Application)

This action has no parameters.


Set Toggle Key (Application)

Parameters
Name Data Type Values Default
Key Integer 1
2
3
1

Name Data Type Values Default
Activate Key Boolean true
false
true


Start Timer (Application)

Parameters
Name Data Type Values Default
Timer Name String - none

Name Data Type Values Default
Start Time Variable Name Variable - none


Store Value (Application)

Parameters
Name Data Type Values Default
Variable Name Variable - none

Name Data Type Values Default
Value String - none


Take Screenshot (Application)

Parameters
Name Data Type Values Default
Destination String - none

Name Data Type Values Default
Delay Integer - 0

Name Data Type Values Default
File Access String rename
overwrite
rename

Name Data Type Values Default
Scaling Factor Integer - 100

Name Data Type Values Default
Create Directories Boolean true
false
true


Take Screenshot of Active Window (Application)

Parameters
Name Data Type Values Default
Destination String - none

Name Data Type Values Default
Delay Integer - 0

Name Data Type Values Default
File Access String rename
overwrite
rename

Name Data Type Values Default
Scaling Factor Integer - 100

Name Data Type Values Default
Create Directories Boolean true
false
true

Name Data Type Values Default
Margin Top Integer - 0

Name Data Type Values Default
Margin Right Integer - 0

Name Data Type Values Default
Margin Bottom Integer - 0

Name Data Type Values Default
Margin Left Integer - 0


Wait (Application)

Parameters
Name Data Type Values Default
Millisecs Integer - none


Wait for Window (Application)

Parameters
Name Data Type Values Default
Title String - none

Name Data Type Values Default
Operator String equals
not equals
matches
simple match
equals

Name Data Type Values Default
Timeout in ms Integer - 1000

Name Data Type Values Default
Delay after Visibility Integer - 200


Wait for Window Activation (Application)

Parameters
Name Data Type Values Default
Title String - none

Name Data Type Values Default
Operator String equals
not equals
matches
simple match
equals

Name Data Type Values Default
Timeout in ms Integer - 1000

Name Data Type Values Default
Delay after Visibility Integer - 200


Wait for Window to Close (Application)

Parameters
Name Data Type Values Default
Title String - none

Name Data Type Values Default
Operator String equals
not equals
matches
simple match
equals

Name Data Type Values Default
Timeout in ms Integer - 1000

Name Data Type Values Default
Delay after Closure Integer - 200



Copyright BREDEX GmbH 2012. Made available under the Eclipse Public License v1.0.