RPA Express 2.3.0 enables you to automate the SAP GUI client like any standard desktop application, inspecting UI elements, locating their selectors, and using them in your scripts.
For environment setup and further automation, we recommend to use SAP GUI v. 7.40 and and SAP GUI v. 7.50.
SAP GUI Setup
We recommend to use either Blue Crystal or Classical UI themes for better SAP GUI automation when using the Window action.
By default, when you run a recorded script, the following pop-up appears, that blocks script execution and must be switched off.
Editing Scripting Setttings
To disable the pop-up warning that a script is attempting to access SAP GUI, do as follows.
- Open SAP GUI Settings > Options.
- Select Accessibility & Scripting > Scripting.
If the warning message is thrown, the option Notify when a script attaches to SAP GUI is checked. Uncheck the following options:
Notify when a script attaches to SAP GUI
Notify when a script opens a connection.
- Click Apply followed by OK.
Enabling Connection by Command Line
To allow connection by command line, do as follows.
- Open SAP GUI Settings > Options.
Select Security and click on the Open Security Configuration button.
- Specify Allow for Default Action.
- Click Apply to save the changes.
Application Server Setup
Open SAP GUI and check if scripting is turned on.
If the appropriate menu item is grayed out, perform the following steps.
Start the rz11 transaction. Enter the transaction code
rz11into the OK Code field and press Enter.
Open the sapgui/user_scripting parameter. Enter the parameter name into the related field and either click Display or press Enter.
- To edit the current value, click on the Change Value button.
In the window that follows, enter
TRUEin the New Value field and press Save.
- Re-log into the system to view the changes.
Supported UI Controls
In the table below, we collected SAP UI controls that a WorkFusion Bot can interact with and their typical selectors (here Object selectors).
Text field with search help
Ok code field
ALV grid (fullscreen)
ALV grid (embedded)
ALV hierarchical list
SAP GUI Restrictions
When automating the SAP GUI client, there are certain restrictions to be aware of. In the table below, there are UI controls that either are not supported, or can be automated in case additional settings are performed.
Search help window
Search help windows are recognized only in the Dialog (modal) mode. To enable usage of search help windows, do as follows.
Scrollbar and scrollbar button
|Scrollbars and scrollbar buttons are not supported. To automate, use the Scroll Mouse action or arrow keys (for example, PgUp and PgDn) in the Keyboard action.|
|The top menu bar items are not supported. To automate, use shortcuts. Click on each of the top menu bar buttons to see available variants.|
To automate the context menu, refer to one of the following workarounds:
|The calendar picker option is not supported.|
Object recording is performed in the beta mode and not supported for all of the SAP GUI controls. To report an unsupported control, reach out to our support team or post on the forum.
Tips and Tricks
Navigating to Hidden Elements
To grab a selector of an element not visible on the SAP GUI screen, use Inspector. Thus, you open hidden tree elements or tabs.
Right click on any hidden element within the tree and select Focus.
On expanding the element, copy its selector to use in your script.
Automation of Complex Grids
Available from RPA Express 2.3.2.
If automation of complex trees or tables with a large number of elements takes much time for both inspecting and executing scripts, use the following SAP UI controls attributes:
native_id attribute immediately interacts with a selected element, e.g., a table cell of the Nth column in a complex grid, without waiting for information from the whole list of elements.
- Open SAP GUI desktop client and select the screen you need to automate. Open Inspector and click Capture.
- Hover over the needed element and press Escape.
- Build up your selector manually.
native_idin the native_id field and paste it after
NATIVE_IDin the Selector field.
CELLand specify the cell coordinates using the
Your selector will look as follows:
native_id, you can build selectors for the following UI elements:
table cells: use
tree items: use
name(refer to the
nameattribute in the element data)
SAP UI controls, e.g., buttons: use
SAP GUI Commands
The below mentioned commands are entered into the OK Code field, allowing to perform some actions quicker.
|used together with a transaction name, navigates to a transaction from the existing transaction window|
|displays a list of open SAP GUI sessions; all your sessions will be displayed in a dialog box with the options to create and end sessions|
|used together with a transaction name, closes the specified transaction window|
|logs out prompting to confirm that you want to close all the sessions|
|closes all the sessions and exits the SAP GUI desktop client without prompting|