studio
latest
false
UiPath logo, featuring letters U and I in white

Studio User Guide

Last updated Apr 22, 2025

Supported SAP GUI for Java Elements

The SAP interfaces contain a variety of specific controls with which you can interact as exemplified in this page.

SAP Buttons

Represents any button found in the SAP GUI for Java windows. There are several types, each defined by a particular element:

Icons

Icons are interactive buttons which do not display text labels.

docs image

Push Buttons

A push button is a simple UI element which gives you direct access to a command in the application.

docs image

Radio Buttons

Radio buttons present a set of options. A list contains at least two radio buttons, and you can only select one.

docs image

You can use the Click activity to interact with buttons.

SAP Checkbox

Checkbox elements represent a list of multiple choices. You can select one, more, or no options.

docs image

You can use the Click activity to interact with checkboxes.

SAP Context Menu

Represents a list of items inside a context menu. Note that multiple child context menus can be available in a parent context menu.

docs image

You can use Java selectors and the Click activity to interact with the SAP Context Menu.

SAP Dialog Box

Represents an external window which can hold different types of other SAP controls such as buttons, text messages, or pop-up windows.

docs image

Selectors inside a dialog box are generated according to the element they represent.

If you want to close a dialog box using the Close button, you need to use the AA element detection framework.

You can use UIAutomation activities such as Click or Type Into to interact with dialog boxes.

SAP Dropdown Lists

Dropdown lists allow you to select items from predefined lists.

docs image

You can use the Select Item activity to interact with list items.

SAP Input Field

Represents a specialized field which accepts user input.

docs image

You can use the Type Into activity to interact with input fields.

SAP Logon

SAP Logon is a locally installed program that you use to directly log on to an SAP system.

docs image

You can use the Click activity to open SAP.

SAP Statusbar

Represents a section at the bottom of the SAP GUI for Java window which displays messages. It does not show system and login information.

docs image

You can use the Get Attribute activity to read the status properties from the SAP Statusbar.

Note: This SAP control is not supported by Recording in Studio.

SAP Session Information

Displays detailed information about the current SAP session, such as System, Client, logged User or current opened program and transaction.

docs image

The following optional selector attributes are available in UIExplorer, and can be used with other activities such as the Get Attribute activity when you build your SAP automation:

sapClient, sapLanguage, sapProgram, sapScreen, sapSession, sapSysName, sapSysNumber, sapSysSessionId, sapTransaction, sapUser
docs image

SAP Tab

SAP Tab represents a set of buttons which let you access specific information and controls.

docs image

You can use the Click activity to select a single tab at a time, or you can use the Select Item activity to choose the tab of interest from a list.

Special automation case

Some SAP transactions have slash / in their names, which may lead to identification issues, while using a wildcard in the selector.
For example, in SAP Transaction: /COCKPIT/1, the selector for one of SAP Tab inside the transaction can be:

<sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

The dynamic part of the selector is: SAPLDISPLAY46:0389, where the number 0389 is dynamically changing and does not allow a stable identification.

The structure of the selector is:



For purpose of stable identification, you would need to use wildcard in between hierarchy separators and then all (and only) the slashes between those separators/slashes need to be replaced by ?
Before <sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />
After <sap id='usr/subSUB_MAIN:?COCKPIT?SAPLDISPLAY46:038*/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

SAP Tables

The SAP Table represents a standard set of controls for elements displayed in a tabular structure.

Common Operations

In SAP, there are multiple types of tables available. The most commonly used are Standard (default) tables, Grid Tables and ALV Tables. All kind of SAP Tables can be automated with Studio.

You can use the following activities to interact with SAP Tables and their content:

SAP Standard Table

The SAP Standard Table supports the following common operations:

docs image

SAP Grid Table

The SAP Grid Table supports Select/Deselect operations, Data Scraping, and the following common operations:

docs image

Select/Deselect

Using the Click activity or the Check activity, you can perform the following operations in your SAP automation project:

  • Select/Deselect Column
  • Select/Deselect Row
  • Select/Deselect All
    docs image

Data Scraping

Data scraping enables you to extract structured data from SAP Tables.

If you are automating a table that contains multiple columns with the same name, the scraping mechanism automatically increments the column names (e.g. column1, column2, column3, etc.).
The Extract Structure Data activity provides additional possibilities while extracting the data from the SAP GridView table. You can use the following values for the columns_name_source parameter to define the way you want to get the table information:
  • Longest - The full name of column is extracted and used.
  • Shortest - The short name of column is extracted and used.
  • Displayed - The visible/displayed name in SAP GUI for Java is used.
  • Technical - The technical header name of the column is extracted and used.
  • Tooltip - The tooltip name which appears after hovering the mouse over a column name.


SAP ALV Table

The SAP ALV Table supports all common operations that are available, as mentioned above, as well as Data Scraping for simple header tables and Screen Scraping. You can extract a single ALV table on the SAP screen.

docs image

Data Scraping

This works similarly to mentioned Data Scraping for SAP Grid Tables, with the following exceptions:

Note:
  • Horizontal scrolling is not supported. The table must fit horizontally on the screen and be in full view. Any columns out of view will not be scraped.

  • Multiple lines in a cell are not supported.

  • In some cases, the column tooltip name can be different from the display name in SAP ALV Tables.

Screen Scraping

In case you decide to use Screen Scraping, the recommended scraping method is FullText, and the Ignore Hidden check box should be selected. Please note that only visible text on the SAP screen is extracted by using this method.



To learn more about Screen scraping, please visit this page.

SAP Textedit

The SAP Textedit control represents an editable text field/editor.

docs image

You can use the following activities to interact with this control:

SAP Toolbar

The SAP Toolbar represents a set of buttons, which you can interact with. In SAP, there are multiple types of toolbars, depending on the SAP Transaction or SAP Program.

  • SAP System Toolbar
  • SAP Application Toolbar
  • SAP Special Toolbar
  • SAP GridTable Toolbar
  • SAP Generic Object Services

You can use the Click activity to interact with buttons inside the toolbars.

Note: This SAP control is not supported by Recording in Studio.

SAP Tree

The SAP Tree represents a list of elements organized in a tree structure. Several types of SAP Tree controls are available:

  • Simple Tree

    docs image
  • List Tree

    docs image
  • Column Tree

    docs image

You can use the Click or the Get Text activity to interact with a node or an item in any of the SAP Tree control types.

Note: We recommend you use the SimulateClick property when you interact with SAP Trees.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2025 UiPath. All rights reserved.