Ranorize yourself in 20 minutes, step 4 | Ranorex Studio User Guide
Help CenterUser GuideRanorex Studio fundamentals

Record your first test

Required time: 6 minutes

It’s time to record our test! This means we’ll manually perform the actions we determined in the previous chapter and let Ranorex Studio record them.

In this chapter

    Steps for successful recording

    Ranorex Studio supports a wide range of environments, test specifications, and technical settings. So that your first recording is a success regardless of your environment, we recommend the following: 

    Use a mouse

    While recording, use only the mouse for navigation

    Avoid using other input devices such as graphic tablets, touchpads, pens, …

    Click every step

    Click every step

    Do not use the tab key to navigate through forms

    Close all other apps

    Close other applications

    Close any other application or tool that you don’t need for the test

    Open on another device

    Open the user guide on another machine

    If possible, open the user guide on another machine or tablet for reference while recording your test

    Click pause / play

    Click pause/continue in the recorder

    To check back to the user guide or perform actions that you don’t want to be recorded, just click the pause button in the Recorder control center

    No hidpi monitor

    Set display scaling to 100 %

    In the Windows display settings, set display scaling to 100 % for all of your displays.

    Select the app and start the recording

    Click the RECORD button in the recording view.

    Click Desktop in the dialog that opens.

    Start recording by clicking Record in Ranorex Studio

    In the next window, click Add app…
    Browse to where you saved the Ranorex demo application, e.g. the /Downloads/ folder of your computer.
    In the folder, select RxDemoApp.exe and click Open. The Ranorex demo application is selected as the test application.

    Selecting the application under test (AUT)
    tipp icon


    Do not click the Record button yet. Once you’ve clicked it, ALL key presses and most user interactions will be recorded. Read the next section first and then carry out the instructions in it.

    Record the test

    Click the Record button to start the recording. Ranorex Studio automatically switches to the demo application and the Recorder controls appear.
    Starting the test recording
    Click the Enter your name text field, enter Harry, and click Submit.
    Recording the text insertion

    Validate a UI element

    We can see that Harry has appeared in the welcome message. Now we’ll add a validation so that Ranorex Studio verifies this during testing.

    Click Validate in the recorder controls to pause recording and switch to validation mode.
    Activating test validation
    Mouse over the welcome message. A purple frame appears. This means the UI element has been identified. Click it.
    Validation element selection

    The Select element window opens. Check whether the screenshot in the lower right shows the UI element you want to validate. In our case, that’s the welcome message. Click Next to confirm.

    The Validation settings window opens. Here, you can select which attributes to validate. In our case, Text is correctly preselected. Click OK to confirm and switch back to recording mode.

    Validation element & attribute selection

    Exit the app and stop the recording

    Click Exit in the bottom right of the demo application to close it.

    Click Stop in the Recorder controls to stop recording.

    Finalize & end test recording


    The image below shows all the recording steps described in this chapter. You can use it as an on-screen aid while recording.

    Click image to enlarge
    Click image to enlarge