Ranorex Recorder settings define how the Ranorex Recorder captures user actions and replays them.
General settings
General settings are the ones that can be accessed by selecting the General tab in the settings dialog window.
- Use ‘ensure visible’ by default: Specifies whether the application should force a UI element used as a Ranorex role to become visible before automation or not. By default, the application automatically uses this value for each repository item.
- Enable search by unique ID (if available): Specifies whether the application should identify web elements using their unique ID or not.
- On mouse/pointer move check if location is within visible desktop bounds: Specifies whether the application should throw an exception if the mouse/pointer tries to move outside the visible desktop bounds or not.
- Maximum length of text values in RanoreXPaths: Specifies the maximum length of attribute values used within RanoreXPath.
-
The factor that all timeouts of find operations are multiplied with: Multiplies all repository timeouts with the specified value to prevent test cases from failing in case of different timing behavior. This is especially useful when executing tests on different system configurations
- Restore limitation warnings: Resets the Do not show again checkboxes used to suppress the assistance dialog for technology limitations. Click to show the dialog again for non-instrumented technologies or applications
- Restore ignored dialogs: Resets all other Do not show again checkboxes
-
GDI capture settings…: Opens the dialog to change the current GDI capture list
- Copy runtime to output: Check to ensure the application copies the Ranorex Studio runtime to the output folder when compiling/running a test.
- Include license information: Includes the local machine’s floating license information with the test. This requires that you configure a floating license on the local machine and open a solution.
- Show invisible characters in report: Display otherwise invisible characters in report values.
- Restore defaults: Reset all values to their default values
- Import…/Export…: Save and load user-specific configurations
-
Apply: Click to validate the changes
Recorder settings overview
Access Recorder settings through the settings dialog. If you open the settings dialog from the Studio Recorder view (SETTINGS button in the action table), the configuration options for the current recording are available in addition to the recorder default settings.
- Current recording: Configuration parameters for code generation specific to the current recording. All settings on this tab page are stored within the recording.
- Recorder defaults: Global default values for every newly created recording are specified.
Recorder defaults settings
Specify global default values for every new recording. The following settings only affect newly created actions, not existing actions.
- Capture a screenshot for each step: Specifies whether the application should take a screenshot of the current action during the recording.
- Highlight elements: Specifies whether the application should enable element highlighting during recording.
-
Coordinate recording mode: Specifies the way the application records the coordinates. The following options are available:
None Actions are always invoked at the ‘center’ of the recognized elements Pixel Relative coordinates within a recognized element are recorded in pixels Proportional Relative coordinates within a recognized element are recorded in percent - Use timings also for recorded actions: When enabled, the application takes the timings specified below instead of the recorded durations.
-
Use keystroke optimization: Enabled by default. This setting makes recorded key sequences easier to read. This only applies to characters of the English alphabet, i.e. A–Z. Can also be enabled/disabled in the keystroke editor of an action.
Disabled Enabled {LShiftKey down}h{LShiftKey up}H {CAPITAL}helloHELLO helll {Back}ohello hello {Space}therehello there - Key sequence split time (ms): Specifies the maximum time between key presses in a key sequence during recording. If this time is exceeded, the sequence is split into multiple key sequences.
- Mouse move time per action (ms): Specifies the time in milliseconds used to move the mouse to the UI object related to the action.
- Mouse/Pointer-related action time (ms): Specifies the overall time in milliseconds used for a manually created mouse action. The application only takes into account this value for manually created actions when it is not possible to determine the time of an action during recording or when ‘Use timings also for recorded actions’ is activated.
- Keyboard-related action time (ms): Specifies the default overall time in milliseconds used for a manually created keyboard action. The application only takes into account this value for manually created actions when it is not possible to determine the time of an action during recording or when ‘Use timings also for recorded actions’ is activated.
- Recording namespace: Specifies the namespace used for the generated code.
- Recording class name: Specifies the class name used for the generated code.
- Use item logging by default: Activates or deactivates a default logging message for each action item.
- Generate replay reports: Activates or deactivates the generation of reports during replay.
-
Show warnings for possible invalid property values: Activates or deactivates invalid property warnings.
Current recording settings
Configure parameters for code generation specific to the current recording. All settings on this tab page are stored within the corresponding recording.
- Description: Use this to briefly describe the actions the recording performs.
- Recording namespace: Specifies the namespace used for the generated code.
- Recording class name: Specifies the class name used for the generated code.
- Replay speed factor (%): Increases or decreases the replay overall speed by a specific factor value.
- Replay iteration count: Specifies the number of iterations.
- Recorder UI mode: Specifying the recorder UI mode updates the set of actions available in the actions table (“Global”: all actions, “Desktop & Web”: no mobile actions, “Mobile”: no mouse and keyboard actions).
- Enable turbo mode for replay and generated code: Specifies whether recorded delays between actions should be part of the generated code. Review Turbo Mode for more information.
- Generate replay reports: Activates or deactivates the generation of reports during replay.
- Use item logging by default: Activates or deactivates a default logging message for each action item.