Ranorex Recorder

This Documentation is only for Ranorex 2.x versions.

Click here for the Ranorex 3.x test automation documentation

General

The Ranorex Recorder is used to record and replay the user’s keyboard and mouse actions during a manually executed test of the user interface. In addition the Recorder can validate current states, properties like ‘Text’ or ‘Visibility’ and images of UI elements. The Recorder is a capture replay editor which is available both as stand-alone tool and as an integrated editor within Ranorex Studio.

: Ranorex Recorder as standalone tool

: Integrated into Ranorex Studio

The recorder’s GUI is divided into an actions table and an object repository. The actions table contains all recorded mouse, keyboard or validation actions. The object repository is used to identify all objects required by each recorded action item.

: The table lists all recorded and manually added action items

: The repository lists all objects used within the action table

For every captured user action the recorder logs the following information:

: Single action item

Time of execution

The time attribute represents the action's start time. Read more...

Type of action

Describes the type of recorded action (Key Sequence, Mouse or Validation). Depending on the type of action the recorder logs additional information like the type of mouse action (single or double click) or relative coordinates.

Associated repository object

Refers to the action’s corresponding object in the object repository.

Comment

Use the comment option to provide a brief description of the current recording.

How to share a repository for multiple recordings

The Ranorex Recorder is divided into an actions table and an object repository. After starting Ranorex Recorder, a new recording automatically uses an embedded repository. In that case the whole repository is part of a Ranorex recording.

To separate an embedded repository from a recording, save the repository as a file using the 'Save As...' button from the tool bar.

: After saving the repository the recording uses an external shared repository

: Use of an embedded repository

Just click the filename representing the external repository in order to switch back from an externally shared repository to an embedded one.

How to execute recordings from the console

Every single recording created with Ranorex Studio or created by the standalone tool can be triggered via console using command line options. To run recordings from the console save the current recording and run Ranorex.Recorder.exe as follows:

Ranorex.Recorder.exe /rp MyRecording.rxrec /p /q

Command line options
/rxrecpath or /rp	Specifies the recording to open.
/play or /p	Runs the recording immediately.
/quiet or /q	Hides Ranorex Recorder tool.
/help or /?	Shows command line help information.