Ranorex Help Center

How can we help you?

During Recording

Click the 'Record' button to trigger a new recording.

Click 'Record' to start recording

Click 'Record' to start recording


After clicking the record button you're assisted in running an application, opening a browser to navigate to a particular URL or starting an app on a mobile device before recording any actions. Therefore it's not necessary to record actions like double clicking a shortcut on the desktop. By choosing the option instant recording it's on you to start the application under test.
New recording dialog

New recording dialog

Start a desktop recording

Start a desktop recording

Start a web recording

Start a web recording

Start a mobile recording

Start a mobile recording

After clicking the 'Record' button, the Recorder or Ranorex Studio will be minimized. A running recording session is indicated in the Ranorex Recorder tool bar.


Ranorex Recorder toolbar

Ranorex Recorder toolbar

Now perform all the actions you want to be part of the automated test. You can also pause the recording session at any time by clicking the 'Pause' button.


Note The Recording can be stopped either by using the keyboard shortcut <SHIFT>+<ESC> or by pressing the 'Stop' button.

Validation (aka Checkpoint)

The Ranorex Recorder provides two different types of validation during a running recording session:

  • Validation based on attribute values of a UI element
  • Image-based validation


Note A validation step is also known as checkpoint.


Screencast: The screencast "Quick Start with Ranorex Test Automation" provides a short overview, and among other useful information also shows how to create a validation step during a recording. You can jump directly to the noted position in the video by clicking http://youtube.com/watch?v=0S_YC7uwI-s.


Validating States or Attributes

The Ranorex Recorder tool bar can be used to validate states or attributes of GUI elements during a running recording session. Click the 'Validate' button to pause the recording in order to start the validation.


Validation mode is active

Validation mode is active

The Recording is now paused. Move your mouse pointer over a specific UI element. Wait a moment to ensure that the highlight frame is surrounding the intended UI element indicating that it is ready to be validated. Click on the element to open the validation dialog.
The highlight frame specifies the element to validate

The highlight frame specifies the element to validate

In the Validation dialog you can check if you have chosen the right UI element to validate. By clicking "Next" button you can define the attributes and their values you want to validate.
Select the UI element you want to validate

Select the UI element you want to validate

Select the attributes of the UI element to validate

Select the attributes of the UI element to validate

To validate UI elements of pop-up windows like menus, use the shortcut key 'V' to turn on validation mode without clicking the 'Validate' button. Read more about how to enable hotkeys in the section Recorder Hotkeys later on in this lesson.
Validation of menu items using shortcuts

Validation of menu items using shortcuts

Validating Images

In addition to validating attribute values of a UI element, it is also possible to validate images or screen regions of an application. Simply switch to validation mode as described above and select a UI element. To validate the element's image, open the 'Image' tab in the validation dialog.


Validate whether a specific listitem contains a specified image or not

Validate whether a specific listitem contains a specified image or not

Recorder Hotkeys

Ranorex Recorder provides useful hot keys for triggering special features like validation or the recording of simple mouse movements. When you start a new recording session, the hot key functionality is turned off. To activate the Recorder's hot keys simply click on the 'Enable Hotkeys' checkbox or press the master hot key '<SCROLL>'.

The recorder's toolbar will then show which shortcuts are available.

Available hot keys during a recording session

Available hot keys during a recording session

'V':

Press the hot key 'V' to turn on validation mode - especially useful for validating elements of a pop-up window like menu items and drop-down lists.

'M':

Use the hot key 'M' to record simple mouse movements. Simply move the mouse pointer to a certain position and press the hot key to record the mouse movement in relation to the underlying UI element.

'T':

It's easy to validate the content of a tooltip by pressing the hot key 'T' after the tooltip box appears. Ranorex Recorder automatically captures a mouse move action in relation to the underlying item and validates the current content of the tooltip.

'I'

The hot key 'I' is used to turn on/off image-based recording - used for pop-up windows, menu items or drop-down lists.

'Roll Mouse Wheel'

Roll the mouse wheel during validation mode to change the level of UI element selection.