Skip to main content

A Robot Framework Library for automating the SAP GUI desktop client

Project description

SapGui Library

This library is created to automate testing the SAP GUI desktop client using the Robot Framework. It uses the native Sap Gui Scripting engine to interact with the SAP GUI interface.


SapGuiLibrary can be found on PyPI:

To install, simply use pip:

pip install robotframework-sapguilibrary

Dependencies are automatically installed.

Importing in Robot Framework

As soon as installation has succeeded, you can import the library in Robot Framework:

*** Settings ***
Library  SapGuiLibrary


First of all be sure you've enabled the user_scripting option on the server. I haven't done this myself so I can't give you a proven example on how to do this. I've checked it on Google and it looks like you can change this using the RZ11 transaction.

When de Scripting Engine is enabled, you have to start de Sap Logon Pad. Unfortunately the scripting engine doesn't enable you to start this so you have to use something like the Process or the AutoIT library. When the Sap Logon Pad is available, you use the 'Connect to session' keyword to attach to the session.

Finding locators

Finding the locators for the elements requires you to use an extra tool to identify these locators. To best tool for that is the SAP Scripting Tracker. More information about this tool can be found at this blogpost on the SAP website

If you just want to download the tool follow this link. To tool Tracker.exe is the one you want to use.

Tip: Finding an element within a Shell type component requires an extra step, because the Tracker will only show you the Shell identifier. You can find the identifier by using de recorder function and than perform the actions you want to automate. After saving the recording you can find the identifiers within the recorded script.

Keyword documentation

For the keyword documentation go here.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robotframework-sapguilibrary-1.1.tar.gz (9.5 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page