Advanced settings & configurations | Ranorex
Help CenterUser GuideRanorex Studio system details

Advanced settings & configurations

Most of the settings shown in the ‘Advanced‘ tab are used to configure Ranorex object recognition and RanoreXPath generation. Please be careful when changing these settings.

In this chapter

    Advanced

    Ranorex advanced settings - part I

    Ranorex advanced settings – part I

    Enable 32/64 Bit Bridge: Use the checkbox ‘Enable 32/64 Bit Bridge’ to turn off the bit bridge required to handle 32/64 bit based applications on 64 bit operating systems automatically.
    Use hidden screenshot capturing (if possible): Tries to capture screenshots used by recordings, repositories or Ranorex snapshot files, even from application windows which are not in the foreground. If disabled, Ranorex tries to make the application window visible before capturing a screenshot.
    Disable expensive attribute in tools: This setting instructs plug-ins not to evaluate computationally intensive attributes for Ranorex Spy, Recorder, and Ranorex Studio. If checked, attributes like Row.Index do not have a value for certain technologies when shown in Ranorex Spy. This improves performance is some cases.
    Let snapshot contain complete ancestor subtree: When checked, the subtree containing the whole application will be stored when saving a snapshot file. If not checked, only the direct subtree to the selected item will be stored.
    Use asynchronous dispatching of mouse and keyboard events: This setting is used to turn on or off asynchronous dispatching of mouse and keyboard events during recording. With enabled asynchronous dispatching mouse and keyboard events will not be forwarded to an application before Ranorex has finished processing the event.
    Use UiaLauncher to elevate privileges for processes started by tools: Specifies whether test execution is started with elevated privileges or not.
    Synchronize element selection of Studio’s repository with element selection in Spy: Specifies whether a UI-element will be automatically selected in Ranorex Spy when the representing repository item will be selected or not.
    Enable IME Hook: This option enables input support for complex characters, e.g. for Chinese and Japanese. Note: Does not work for Windows Store apps, WPF applications, and in Microsoft Edge, Internet Explorer, or Mozilla Firefox.

    Delay before pressing a key sequence (ms): Specifies the time to wait in milliseconds before performing a key sequence simulation.

    RanoreXPath settings

    These settings allow you to change the behavior of automatic RanoreXPath generation.

    Speed/robustness slider

    This slider controls how Ranorex Studio balances speed (flexibility; faster execution times) and robustness (more resistance to UI changes, slower execution times) when generating RanoreXPaths.

    Note icon

    Note

    Setting the slider to between 30 % and 50 % achieves the best results for generating RanoreXPaths that are well balanced between speed and robustness.

    Let’s take a look at how setting the slider to different positions influences RanoreXPath generation.

     

    50 % setting – balanced

    At the default setting of 50 %, Ranorex Studio generates a RanoreXPath for the button in the Ranorex Studio Demo Application that is equally balanced in terms of execution speed and resistance to UI changes.

    Button in the Ranorex Studio Demo Application

    The button in the element tree in Ranorex Spy. It is located on the fourth level of the tree.

    The generated RanoreXPath for the button. It contains two ? wildcards between the root node and the parent of the UI element, which give the path a reasonable amount of flexibility.

    0 % setting – speed

    At 0%, Ranorex Studio generates a path that is focused on achieving the highest execution speed. This results in a very fast, definitive path that has the least resistance against UI changes.

    Button in the Ranorex Studio Demo Application

    The button in the element tree in Ranorex Spy. It is located on the fourth level of the tree.

    The generated RanoreXPath for the button. It does not contain any wildcards. This makes the path fast, but means that changes in the UI or its structure will likely prevent it from successfully identifying the targeted UI element.

    100 % setting – robustness

    At 100%, Ranorex Studio generates a path that is focused on achieving the highest robustness. This results in a slower, flexible path that has the most resistance against UI changes.

    Button in the Ranorex Studio Demo Application

    The button in the element tree in Ranorex Spy. It is located on the fourth level of the tree.

    The generated RanoreXPath for the button. It consists only of the root node, a // wildcard, and the final node. This means that any number of other nodes can be between the root and the final node. This makes the path slower, but very resistant to UI changes.

    Attribute weights and Expert settings

    IEdit attribute wights… lets you edit how automatic RanoreXPath generation weighs UI element attributes, i.e. which of them it prefers using over others.

    Reference

    Attribute weights and other weight rules are explained in:

    Ranorex Studio expert > ⇢ Mapping dynamic UI elements

    Expert settings contains critical settings that change core aspects of how Ranorex Studio’s algorithm generates RanoreXPaths.

    tipp icon

    Attention

    DO NOT change any of the expert settings unless instructed to do so by our support team. Changes can easily lead to test failures.

    Statistics, defaults, import/export

    Checkbox for agreeing to send us anonymous usage statistics to improve Ranorex Studio. Default is checked. Click the button for more information about what data we use and how we use it.

    Resets all advanced settings to their defaults.

    Allows you to import settings from other solutions or export them for use in other solutions.