Before you start recording
Whether your test is simple or complex, preparation is key in test automation. Preparation prevents mistakes and saves time in the long run. This chapter describes the steps to take before you start recording your test.
In this chapter
Screencast
To learn how to configure recorder settings and enable process whitelisting to ensure optimum performance when recording an automated test, watch our video
Recording recommendations
Take the time to consider the following recommendations. They can make your testing life easier and your work more efficient.
| Do you want to start the AUT yourself each time, or do you want Ranorex Studio to start it automatically at the beginning of the recording? In either case, you need to know the installation path and any required starting parameters. | |
| Test data & parameters | Make sure you have all test data and parameters, such as login names and passwords, readily available for the test. |
| AUT instances | Only run one instance of your AUT during recording. If you’ve created your solution using the RocketStart solution wizard, Ranorex Studio will start (and quit) your AUT automatically by default. |
| Recording interaction | Unless you use ⇢ whitelisting, all user actions are captured during recording, even accidental ones that are unrelated to the AUT. Make sure to disable anything that could interfere with recording, such as pop-ups. |
Our AUT: The Ranorex Demo Application
To better demonstrate the concepts and methods in this User Guide, we’ve created a special app, the Ranorex Demo Application. It will serve as our AUT for the explanations and samples in the fundamentals and advanced chapters of this User Guide.
Download the Demo Application
Download
Download the latest version here: ⇢ Ranorex Demo Application. Unzip it to any folder on your system. For the purpose of our tutorials, we assume that it’s located in /Downloads/
Start the AUT
Before planning a test in detail, start the AUT to ensure that it is installed properly and is working. Browse to the location where you unzipped the Demo App. Double-click it.
The Ranorex Demo App in the default folder
The Demo App’s Welcome screen appears. After you’ve checked the Demo App opens and works correctly, close it again.
Note
A link to the demo application is also included with all downloadable sample solutions throughout the fundamentals and advanced chapters of this user guide.
Plan the recording
Plan your recording well. It helps prevent tedious restructuring and editing later.
Use a recording script
- Think about the steps you need to record.
- Prepare the necessary input data (usernames, passwords, etc.).
- Perform the test at least once without recording.
Consider the recording size
- Keep recordings as small as possible.
- Larger, modular test cases can be built out of smaller, reusable recordings.
Plan how mouse movements will be recorded
- By default, mouse movements are not recorded without mouse clicks.
- When navigation through menus is important for the test, use mouse clicks for detection, or use the option for recording mouse movements within the Recorder control center.
Reference
Learn about recording mouse movements in Ranorex Studio fundamentals > Ranorex Recorder > ⇢ Recorder control center & hotkeys.
Test definition
Following the recommendations above, we have defined a simple test with five steps. This same test serves as an example in the coming Ranorex Recorder chapters.
1. Open the Ranorex Demo Application.
2. In the “Enter your name” field, enter Harry and click Submit.
Entering and submitting a name
3. Verify that the welcome message changes accordingly.
4. Reset the welcome message.
5. End the demo application and stop the recording.
Create a desktop test solution
In the S
This is the caption of the image
Demo Application selected as AUT and set to launch automatically when you start recording. Once you’re done, the solution will open in Ranorex Studio as shown below:
The empty recording module Recording1 in the recording module view. In the test suite view, Recording1 is located in a test case that has setup and teardown regions. The former contains a recording module that starts the Demo Application, the latter contains one that closes it.
Recorder default settings
There are many settings you can configure to customize the behavior of the Recorder. The default settings are usually suitable for most recording tasks, including the ones in this chapter. However, for some recording tasks, you may need to change the Recorder settings. To access them, click Settings in the toolbar of the Recorder working environment or in the Ranorex Studio toolbar.
Global & local Recorder settings
Global Recorder settings
Local Recorder settings valid for the current recording module
Further reading
Learn about Recorder settings and their impact on recordings in Ranorex Studio system details > Settings and configuration > ⇢ Ranorex Recorder settings.