SAP Modules

The folder TBox XEngines->Sap in the Standard subset contains Modules that perform specific tasks for the SAP Engine 3.0.

The Sap folder contains a sub-folder named Classes with additional Modules ContextMenuEntry, MenuEntry, and TreeMenuEntry. These Modules perform background tasks for Modules that you use for your tests. You can't use them in TestCases.

SAP ContextMenu

The Module SAP ContextMenu allows you to steer SAP context menus.

Context menus must be open for the SAP Engine 3.0 to steer them. Use image-based test automation to open context menus in trees.

The Module has the following ModuleAttributes:

ModuleAttribute

Description

ContextMenu

Path to the menu item.

Indicate nodes with ->, for instance Insert->Image.

Use x, X, or no value to select the entry directly.

ContextMenu->ContextMenuEntry

Alternatively, you can use ContextMenuEntry to specify the menu item (see the example below).

In this example, the SAP Engine 3.0 opens the context menu and selects the entry Insert Unicode control character->Zero width joiner.

SAP context menu: specify the menu path

In this example, the SAP Engine 3.0 opens the context menu and verifies whether the option Zero width joiner exists.

Verify SAP context menu entries

SAP Login

The Module SAP Login allows you to steer the SAP Login screen.

It has the following ModuleAttributes:

ModuleAttribute

Description

Client

Client you want to use.

User

User name of the user that should sign in.

Password

Password of the user.

Language

Preferred language.

Enter

Enter {Click} to perform a mouse click on the Enter button.

In this example, you sign in to Client 001 with the user credentials of the user test01.

  • The first TestStep uses the SAP Logon Module to open the SAP system.

  • The second TestStep steers the Login screen. The SAP Engine 3.0 enters the necessary data and confirms with Enter.

Open the SAP system, then steer the Login screen

SAP Logon

The Module SAP Logon allows you to open an SAP session, i.e. to steer the SAP Logon window.

This is a mandatory first step if you want to steer the SAP log-in screen.

It has the following ModuleAttributes:

ModuleAttribute

Description

SapLogonPath

Full path to the program file saplogon.exe.

SapConnection

Name or system ID (SID) of the session that you want to connect to.

You can use wildcards.

In this example, you open the SAP Logon dialog using the connection name.

Open an SAP connection using the connection name

In this example, you open the SAP Logon dialog using the SID.

Open an SAP connection using the SID

SAP Menu

The Module SAP Menu allows you to steer SAP menus. You can also verify whether a certain menu entry exists by using ActionMode Verify.

It has the following ModuleAttributes:

ModuleAttribute

Description

MenuBar

Path to the menu item.

Indicate nodes with ->, for instance Insert->Image.

Use x, X, or no value to select the entry directly.

MenuBar->MenuEntry

Alternatively, you can use MenuEntry to specify the menu item (see the example below).

In this example, you select the menu entry QuickViewer by entering the path System->Services->QuickViewer.

SAP menu: use the menu path

In this example, you directly select the menu entry QuickViewer.

SAP menu: use the menu entry directly

In this example, the SAP Engine 3.0 verifies that the menu entry System->Services->QuickViewer exists.

SAP menu: verify that the menu entry QuickViewer exists

SAP Multiple Logon License Warning

The Module SAP Multiple Logon License Warning allows you to steer the modal dialog window License Information for Multiple Logon.

This dialog opens when a user attempts to sign in to the system several times.

The Module has the following ModuleAttributes:

ModuleAttribute

Description

Login Options

Specify what to do with the attempts to sign in.

The following values are available:

  • Continue with this logon and end any other logons in system: the SAP Engine 3.0 continues with the current log-on attempt and terminates any other log-on attempts.

  • Continue with this logon, without ending any other logons in system: the SAP Engine 3.0 continues with the current log-on attempt and leaves any other log-on attempts.

  • Terminate this logon: the SAP Engine 3.0 terminates the current log-on attempt.

Buttons

Steer the dialog box buttons.

The following values are available:

  • Confirm Selection: confirm your selection and close the dialog box.

  • Cancel: cancel your selection and close the dialog box.

In this example, the SAP Engine 3.0 performs the following actions:

  • It continues with the current log-on attempt and terminates any other log-on attempts.

  • It confirms the selection and closes the dialog box.

Steer the License Information for Multiple Logon dialog box

SAP Statusbar

The Module SAP Statusbar allows you to verify information on the SAP Status Bar and the current session.

It has the following ModuleAttributes:

ModuleAttribute

Description

Message

Message that you want to verify. Use ActionMode Verify.

Messagetype

Message type that you want to verify.

The following values are available:

  • Success

  • Warning

  • Error

  • Abort

  • Information

Use ActionMode Verify.

SessionInfo

Information on the current sessions that you want to verify.

The following values are available:

  • Client

  • Flushes

  • InterpretationTime

  • Language

  • Program

  • ResponseTime

  • RoundTrips

  • SystemName

  • Transaction

  • User

Use ActionMode Verify.

You can add this ModuleAttribute to any SAP Engine 3.0 Module.

SAP SubToolBar

The Module SAP SubToolBar allows you to steer SAP SubToolbars.

It has the following ModuleAttributes:

ModuleAttribute

Description

SubToolBar

SubToolbar entry that you want to steer.

In this example, the SAP Engine 3.0 steers the Create role button in the SAP SubToolbar.

Steer an SAP SubToolbar

SAP Toolbar

The Module SAP Toolbar allows you to steer SAP Toolbars that contain the transaction code field.

It has the following ModuleAttributes:

ModuleAttribute

Description

Transaction code

Specify the transaction code.

Buttons

Define which action you want to perform.

The following values are available:

  • Enter

  • Save

  • Back

  • Exit

  • Cancel

  • Print

  • Find, Find Next

  • First Page, Previous Page, Next Page, Last Page

  • Help

In this example, you search for transaction code RZ11.

Search for a transaction code

SAP TreeView

The Module SAP TreeView allows you to steer SAP TreeViews.

It has the following ModuleAttributes:

ModuleAttribute

Description

MenuPath

Path to the menu item.

Indicate nodes with ->, for instance Insert->Image.

Use x, X, or no value to select the entry directly.

MenuPath->TreeMenuEntry

Alternatively, you can use ContextMenuEntry to specify the menu item.

In this example, the SAP Engine 3.0 opens the menu entry SDCCN - Service Data Control Center via double-click.

Steer SAP TreeView

SAP Logon - Open with Solution Manager

The Module SAP Logon - Open with Solution Manager allows you to open multiple SAP connections during execution.

It has the following ModuleAttributes:

ModuleAttribute

Description

SapLogonPath

Full path to the SAP Logon GUI.

SapConnection

Name or system ID (SID) of the session that you want to connect to.