Settings and configuration

This chapter introduces and explains the various options for setting and configuring Ranorex Studio and its tools:

Machine-stored
Solution-stored

Machine-stored settings

If you access settings from a Ranorex tool without a solution associated with it.

You can access Ranorex Settings in three different ways:

The settings are stored on the machine in a Ranorex internal file structure. Find Ranorex Settings option in your installation directory.
You can find the Settings option in the stand-alone Spy dialog.
In Ranorex Studio start page find the Settings icon in the toolbar.

Solution-stored settings

Whenever you access settings from a Ranorex tool with an associated solution, the settings are stored in this solution.

Settings Solution.png

To access the Settings of your solution, click SETTINGS... while a solution is opened.

The settings dialog has the Current recording and Current repository tabs.

Settings solution 1.png

User-settings and solution-settings

Solution Settings

User settings

Include all settings that relate to the test solution, such as plugins, RanoreXPath generation, Ranorex Recorder defaults, and many more, which can be shared between different systems, within teams, and also be put under Version control.

These settings are always stored locally on a machine and include user-specific settings related to the Ranorex Studio working environment.

Solution settings file

The solution settings are saved in the settings file Ranorex.rxsettings, which is located in the Solution Items folder in the left side module of the corresponding solution.

Solution Items.png

Warning: Do not change the name of the folder or the file, if you remove the settings file (Ranorex.rxsettings), the solution settings stored on the local machine are automatically used during test execution, and if you open the settings file, it is shown in its raw format.
It is not recommended to edit the file in this view

If a solution does not contain a settings file, it can be added by clicking the Create solution settings in the Projects view toolbar of a solution

Solution settings and test execution

The solution settings file Ranorex.rxsettings is automatically copied into the output directory of the test project. It is saved in the same folder as the test executable. This is why the solution settings will be used for test execution.

Note: Do not rename the solution settings file. When deploying the test executable, make sure to include the solution settings.

If the solution settings are not stored in the same folder as the test executable, the solution settings from the local machine will be used.

Solution settings and Ranorex Remote

When selecting a solution for remote test execution, the solution settings saved in this solution are automatically sent to the Ranorex Agent and used during test execution.

If the solution does not include a solution settings file, the solution settings stored locally on the Ranorex Agent’s machine will automatically be used during test execution.