Record a test
In this chapter, you’ll learn how to record a test and become familiar with the underlying automation concepts.
Steps for successful recording
Ranorex Studio supports a wide range of environments, specifications, and settings. To make your first recording a success regardless of your environment, we recommend the following:
While recording, use only the mouse for navigation
Click every step
Close other applications
Open the user guide on another machine
Click pause/continue in the Recorder
Set display scaling to 100 %
Record the test
- Click Pause to pause recording. Click Continue to resume recording.
- Click Stop to end recording.
Learn more about the Recorder control center in Ranorex Studio fundamentals > Ranorex Recorder > ⇢ Recorder control center & hotkeys.
Read about whitelisting in Ranorex Studio fundamentals > ⇢ Whitelisting.
The Recorder control center shows that recording is active.
Starting the recording
In the text field, enter ‘Harry‘ and click Submit.
Validate the test
We’ve recorded the UI interaction. Now it’s time to validate whether the interaction has led to the desired result, i.e. if the welcome message has changed accordingly.
The concept of test validation is introduced in Ranorex Studio fundamentals > Test validation > ⇢ Introduction.
Activating test validation
- Mouse over the changed welcome message. A purple frame follows your mouse movement.
- The purple frame indicates which element is currently selected for validation.
- Once your selection matches the welcome message, click it.
Selecting the element to validate
Select the validation attributes:
- Text and Visible are the default validation attributes for text-based validations. No other attributes are required.
- To confirm the selection, click OK.
Confirming the element and attribute selection
Finalize and end recording
Once you’ve finished the validation action, Ranorex Studio automatically continues recording. The next step is to finalize and end the test recording.
In the Recorder control center, click Stop to end the recording.
Finalize and end test recording
The recording ends, and you return to the Recorder view. If you followed the instructions exactly, you should see 5 recorded actions and 4 identified UI elements, organized in two folders as shown below.
Recording result in Recorder view
Download the sample solution
You can build your own test solution according to the instructions in this chapter. Alternatively, you can download a prepared sample test solution.
Unzip to any folder on your computer
Start Ranorex Studio and open the solution file
The sample solution is available for Ranorex Studio versions 8.0 or higher. You must accept the automatic solution upgrade for versions 8.2 and higher.