This article explains the required setup to automate SAP GUI applications with Ranorex Studio. If these prerequisites are not met, you may run into object recognition issues or unstable recordings.
Before you start
Display scaling (required)
Set the scaling of all connected displays to 100%.
Different DPI scaling values (especially in multi-monitor setups) can cause object recognition and geometry-related issues during automation.
Important: This guidance is not SAP-specific—DPI/scaling mismatches can affect Ranorex automation in other technologies as well.
Privilege level must match (hard blocker)
Run Ranorex Studio and SAP GUI under the same Windows privilege level.
If SAP GUI is started with elevated (administrator) privileges and Ranorex is not (or vice-versa), Windows security prevents Ranorex from attaching to the SAP process. This can cause recording and Ranorex Spy to hang.
Important: A privilege mismatch is a hard blocker. There is no workaround—no code change, setting, or configuration can bypass Windows security restrictions.
To resolve it, align the privilege levels of both applications (for example, run both as Administrator or as a standard user).
Deselect Ranorex EXE manifest files
When installing Ranorex Studio, deselect Ranorex EXE manifest files under Ranorex Main Components.
If Ranorex Studio is already installed:
- In Windows, go to Add or remove programs.
- Find Ranorex Studio and click Modify.
- Select Change.
- Under Ranorex Main Components, deselectRanorex EXE Manifest Files.
- Click Next, then Finish.
Note: If this doesn’t work, you can turn off User Account Control (UAC) in Windows as a last resort (follow Microsoft guidance).
Enable SAP GUI scripting (server and client)
SAP GUI scripting must be enabled on both the SAP server and the client machine.
Enable scripting on the server
- Set the profile parameter sapgui/user_scripting to TRUE on the application server (admin privileges required).
Enable scripting on the client
- In SAP, open SAP GUI Options.
- Go to Accessibility & Scripting > User Settings.
- Enable scripting and disable all notification options (as shown in SAP GUI options).
SAP plugin setting: Enable SAP Row Offset
The Enable SAP Row Offset setting controls whether Ranorex applies row offset handling for SAP elements at the solution level.
Enable this option if you are testing SAP GUI 800, patch levels 0 to 2, or if you encounter incorrect element identification caused by row indexing issues.
Important: Only change plugin-specific settings when needed for your application or when recommended by Ranorex Support, as they can affect object recognition behavior.