About SAP WinGUI Automation

About SAP WinGUI

Enabling SAP WinGUI API scripting allows you to create reliable automations for the SAP WinGUI. Studio and Robots require SAP WinGUI scripting to be enabled on the local machine as well as on the server side. Before you can create your first automation projects for SAP, you need to go over the configuration steps.

UI elements in SAP are known as controls, and you might need a particular approach or activity to detect and use them. Find out more about supported SAP elements.

SAP WinGUI Supported Versions

The following versions of SAP WinGUI are supported for Windows 7, Windows 10, and Windows 11, for both architecture types (32-bit and 64-bit). SAP Logon and SAP Logon Pad are supported on all versions.

• SAP WinGUI 7.40
• SAP WinGUI 7.50
• SAP WinGUI 7.60
• SAP WinGUI 7.70

All available themes (such as Quartz, Belize, Blue Crystal, or Corbu) can be used for SAP automation.

SAP WinGUI Activities

The following activities are specifically tailored for SAP automation:

• SAP Logon
• SAP Login
• SAP Expand Tree
• Table Cell Scope
• SAP Call Transaction
• SAP Click Toolbar Button
• SAP Read Statusbar
• SAP Select Menu Item
• Expand ALV Tree
• Expand ALV Hierarchical Table
• SAP Select Dates in Calendar
• SAP Click Picture on Screen

All SAP WinGUI activities above mentioned are supported and work with Object Repository.

SAP WinGUI Additional Information

Wildcards and Regular expressions can be used inside selectors generated for SAP WinGUI elements.

SAP WinGUI selectors support for the identification purpose not only technical ID, but also Text, Tooltip and Type of SAP control attributes. Complex SAP controls such as SAP Tables, SAP Grids and SAP Trees do not have these attributes available, as identification is done differently.

In case SAP WinGUI API scripting is not activated or not allowed in your organization, you can interact with the SAP WinGUI interface with help of Computer Vision activities.

SAP WinGUI Scripting Notification

When SAP WinGUI cannot be automated through SAP API Scripting due to misconfiguration or incomplete configuration, the below error message is displayed:

Please follow the configuration steps to verify and to correct the settings.

Enforce hard timeout

The Enforce hard timeout setting can be found in Project Settings > UI Automation Classic > SAP. If the setting is set to True, the Robot terminates the SAP activity execution and it throws an error after the timeout specified in the activity target. You can catch and handle the error message in a Try Catch activity. By default, the setting is set to False.

This setting is useful in cases when you might want to end a long running SAP activity, or when SAP becomes stuck or unresponsive, or network or connection issues arise.