5.2.1 Application

Description:

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

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)

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

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)

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)

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

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)

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 2011. Made available under the Eclipse Public License v1.0.