Ranorex Help Center

How can we help you?

Before Starting to Record

Regardless whether you use Ranorex Recorder within Ranorex Studio or as a stand-alone tool, both the Recorder and the system under test have to be prepared.

Prepare to Record

Before you start recording, you need to ensure that your system under test is ready to start with the manual test execution. In addition, consider the following points in order to avoid too much effort in cleaning up the recording and the repository afterwards.

  • Do not run multiple instances of your application under test if that is not part of the test case itself
  • By default, mouse movements are not recorded; for this reason please also perform mouse clicks in situations such as navigating through menus (or use Recorder Hotkeys to record mouse movements)
  • Think about which steps should be part of the final test
  • Try to keep recordings small in order to make them modular

Recorder Settings Dialog

Before running a new recording session, you can configure Ranorex Recorder using the settings dialog. Click the 'Settings' button to open the settings dialog.
Settings for current recording file

Settings for current recording file


Default values used for every new recording

Default values used for every new recording


Current Recording

This tab primarily contains configuration parameters for code generation specific to the current recording. All settings on this tab page are stored within each recording.

Description:

Can be used to briefly describe the actions the recording performs.

Recording namespace:

Specifies the namespace used for the generated code.

Recording class name:

Specifies the class name used for the generated code.

Replay speed factor (%):

The speed factor is used to increase or decrease the replay overall speed by a specific factor value.

Replay repeat count:

The repeat count is used to specify the number of iterations.

Recorder UI mode:

By specifying the recorder UI mode the set of actions available in the actions table will be adapted ("Global": all actions, "Desktop & Web": no mobile actions, "Mobile": no mouse and keyboard actions).

Enable turbo mode for replay and generated code:

Is used to specify whether recorded delays between actions should be part of the generated code.

Generate replay reports:

This setting is used to turn the generation of reports during replay on and off.

Use item logging by default:

Activate this setting to turn on a default logging message for each action item.

Recorder Defaults

In this tab you can specify global default values for every newly created recording. The settings are divided into three sections:

Recording

Capture a screenshot for each step:

Specifies whether a screenshot of the current action should be made during the recording.

Highlight elements:

Specifies whether element highlighting during recording should be enabled.

Coordinate recording mode: 

Specifies the way coordinates will be recorded. Following options are available:

  • None: Actions will always be invoked on the 'center' of the recognized elements 
  • Pixel: Relative coordinates within a recognized element are recorded in pixels
  • Proportional: Relative coordinates within a recognized element are recorded in percent

Timings for new actions


Note Please note that the following settings only affect newly created actions, not existing actions.

Use timings also for recorded actions:

When enabled, the specified timings below will be taken instead of the recorded durations.

Key sequence split time (ms):

Use this setting to specify the maximum time between key presses in a key sequence during recording. If this time is exceeded, the sequence is split into multiple key sequences.

Mouse move time per action (ms):

Specifies the time in milliseconds used to move the mouse to the UI object related to the action.

Mouse/Pointer-related action time (ms):

Specifies the overall time in milliseconds used for a manually created mouse action. The value set for this setting is only taken into account for manually created actions, when the time of an action cannot be determined during recording or when 'Use timings also for recorded actions' is activated.

Keyboard-related action time (ms):

Specifies the default overall time in milliseconds used for a manually created keyboard action. The value set for this setting is only taken into account for manually created actions, when the time of an action cannot be determined during recording or when 'Use timings also for recorded actions' is activated.

Code Generation

Recording namespace:

Specifies the namespace used for the generated code.

Recording class name:

Specifies the class name used for the generated code.

Generate replay reports:

This setting is used to turn the generation of reports during replay on or off.

Use item logging by default:

Activate this setting to turn on a default logging message for each action item.