SAP controls

A control is a screen element in your application that you want to test. For example, a text box or a table. This topic lists all SAP controls that Tosca Cloud supports:

Standard controls

Tosca Cloud supports the following standard controls for SAP: 

SAP-specific controls

In addition to the standard controls listed in this topic, Tosca Cloud also supports the following controls:

Calendar

Tosca Cloud identifies SAP Calendars as textboxes.

You can select a date, range of dates, or a week from the calendar:

  • Use action mode Input.

  • Use one of the following Values:

Value

Description

Example

yyyyMMdd

Select a specific day.

20260430

yyyyMMdd-yyyyMMdd

Select a date range.

20260401-20260430

CWxx/yyyy

Select a specific calendar week.

CW12/2026

SAP ComboBox

The ComboBox control allows you to select an item from a predefined dropdown list. A ComboBox item is an entry in the dropdown list.

Tosca Cloud identifies SAP ComboBoxes as comboboxes.

In SAP, every ComboBox item has a key and a value:

  • A key, which can consist of letters and numbers.

  • A value, which is the text of the item.

By default, SAP GUI displays only values. You can configure SAP to display both keys and values: 

  1. In SAP GUI, select the Customize Local Layout icon. Then, select Options... from the context menu.

  2. In the Options screen, go to Interactive Design > Visualization 1 > Controls.

  3. In the Controls area, select the check box Show keys within dropdown lists.

SAP SpecialToolbar

SAP SpecialToolbar is a toolbar with buttons that open context menus.

Tosca Cloud identifies SAP SpecialToolbars as tree views.

Please choose your use case:

During the scan, make sure you can scan a toolbar independently from its table grid:

  • If you use Basic View or Condensed View, right-click the table grid and select Toolbar from the context menu.

  • If you use Advanced View, select the ribbon menu option Select on screen. Then, right-click the table grid and select Toolbar.

In your test case, perform the following actions:

  • In the Value field of the Toolbar control, select the item you want to steer from the dropdown menu.

  • Use action mode Input.

SAP Table and SAP grid views

Tosca Cloud identifies SAP Tables and SAP grid views as tables.

If you have one control in a cell, you can steer it.

Tosca Cloud supports the following click operations with action mode Input:

Click operation

Description

{SELECT}

Select the specified row, column, or table.

{ADDSELECT}

Select the specified row or column while any existing selections remain unchanged.

{DESELECT}

Deselect the specified row or column while any existing selections remain unchanged.

If the SAP Toolbar offers the function Select All, Tosca Cloud supports the selection of a whole SAP table or grid view.

SAP TableTree

Tosca Cloud identifies SAP TableTrees as table trees.

To steer the table tree, use action mode Select for the TableTree control. Define the item you want to steer in one of the following ways:

  • Enter the path, separating the nodes with ->.

  • Select the items directly, via tree items. In this case, you must also use action mode Select for all items that are located hierarchically above the selected item.

To select the cell of a TableTree item, enter the name of its column into the Name column.

Here are other considerations for SAP TableTrees:

If you use the action mode Constraint on a TableTree, we recommend that you use the $ sign to define parameters such as a ColumnName or ColumnNumber.

If you use the # sign, Tosca Cloud only returns the occurrence that matches the specified number .

For example, #3 only returns the third occurrence of cells with the specified parameter. On the other hand, $3 returns the first, second and third occurrences.

To streamline test case creation, you can copy cell paths for SAP TableTrees from the scan window:

  1. Scan the TableTree. You can now view its cell path in the Content View.

  1. Select Copy inline path to clipboard.

  1. In your test case, paste the cell path into your TableTree test step.

You can identify a column of a TableTree by its name instead of its caption. To do so, use the steering parameter IdentifyColumnsByName. 

Tosca Cloud creates this parameter during the scan, and you can see it in the Identify By Properties grid in the Steering section. 

To steer columns by their name instead of their caption, set the steering parameter to True.

Controls you steer with standard modules

To steer the controls listed in this section, you need to use Tosca Cloud's standard modules for SAP. Standard modules are pre-built modules for common tasks that Tosca Cloud provides out of the box.

You can find the SAP modules in the left panel of the test case building area, under Modules.

SAP ContextMenu

To steer SAP context menus, use the module SAP ContextMenu.

Please note that ContextMenus must be open at runtime for Tosca Cloud to steer them. Use image-based test automation to open context menus in trees.

SAP Emulated Tree

To steer SAP Emulated Trees, use the module SAP Emulated Tree.

SAP Emulated Table Tree

To steer SAP Emulated Table Trees, use the module SAP Emulated Table Tree.

SAP Emulated Table Trees consist of the following elements:

  • The main table with expandable rows. The header with column names of this table is at the top. Each corresponding row is marked with the icon Detail can be Expanded. In SAP, both the header and the rows of the main table are marked with an orange color. In the module SAP Emulated Table Tree, it's represented by Header Table.

  • The embedded table. The header with column names of this table is under the header of the main table. In SAP, it's marked with a blue color. The content of this table is visible when you expand the rows of the main table. In SAP, the content area of the embedded table is white. In the module SAP Emulated Table Tree, it's represented by Content Table.

SAP Login

To steer the SAP Login screen, follow these steps:

  1. Launch the SAP system. To do so, use the module SAP Logon in your test case.

  2. Use the module SAP Login to steer the SAP Login screen.

SAP Logon

To steer the SAP Logon window, use the module SAP Logon.

In some SAP environments, the default sign-in method might be single sign-on (SSO). To switch off SSO, follow these steps:

  1. For the SAP Logon module, create a module attribute called Bypass Single Sign-On.

  2. In the properties of the Bypass Single Sign-On attribute, create a new configuration parameter with the name Parameter and the value true.

  3. In your test case, switch off SSO as the default sign-in method. To do so, modify the Bypass Single Sign-On test step value: 

SAP Multiple Logon

The modal dialog window License Information for Multiple Logon opens if a user attempts to sign in to the system several times.

To steer the window, use the module SAP Multiple Logon License Warning.

You can define the caption of the dialog box in the module properties. To do so, enter the respective Value for the parameter CaptionList. Separate multiple languages with semicolons.

SAP Status Bar

To verify information on the SAP Status Bar as well as various session information, use the module SAP Statusbar.

You can verify the following properties via the Value column: 

Property

Description

Message

Verifies the text of the status bar message.

MessageType

Verifies the type of the status bar message.

You can use the following values:

  • Success

  • Warning

  • Error

  • Abort

  • Information

SAP SubToolbar

To steer SAP SubToolbars, use the module SAP SubToolbar. Alternatively, you can scan SAP SubToolbars to create your own modules.

Define the tooltip text of the SubToolbar button you want to click via the parameter SubToolBar.

If a tooltip of a SubToolbar button contains nodes ->, Tosca Cloud recognizes it as an entry path. To change this behavior, use wildcards.

SAP Toolbar

To steer an SAP Toolbar that contains the transaction code field, use the module SAP Toolbar. Alternatively, you can scan SAP Toolbars that contain context menus to create your own modules. In this case, follow the steps in SAP SubToolBar.

SAP TreeView

To steer SAP TreeViews, use the module SAP TreeView. Alternatively, you can scan SAP TreeViews to create your own modules.