Using SAPGUI (Record) to Record Transactions


Use SAPGUI (Record) to record transactions that contain controls.

During the course of recording, one or more SAPGUI commands are created in which changes to the state of the screen elements are recorded. You can choose to have these created automatically at each token change, screen change, transaction change, or session. You can also at any point during the recording choose Insert New SAPGUI Command to generate a SAPGUI command manually.


SAPGUI 6.20 or higher must be installed on the same machine that the test script is running on.

Scripting support has been installed and is active. See Preparing Systems and Computers for eCATT.



       1.      In the test script editor, choose Pattern.

The Insert Statement dialog box appears.

       2.      From the Group dropdown list, choose UI Control.

       3.      From the Command dropdown list, choose SAPGUI(Record).

A system-generated name appears in the Interface field. If a maintenance system is specified on the Attributes tab, a system-generated name appears in the Target System field.

       4.      Accept or edit the system-generated names.

       5.      Choose .

The Record SAP GUI Command dialog box appears. In this box you can set the recording mode. You can change the mode while recording.

       6.      Select one of the following recording modes:


Ў        Manual. A SAPGUI command is only generated when Enter SAPGUI Command is chosen or when you stop the recording.

Ў        At each dialog step. Every communication between front end and backend creates a separate SAPGUI command.

Ў        At each screen change. Each screen change creates a separate SAPGUI command.

Ў        For each transaction. Each transaction change creates a separate SAPGUI command.

Ў        For each session. The data for each session is recorded in a separate SAPGUI command.

       7.      If you want a transaction to be started automatically by eCATT, enter the transaction code in the Start Recording with Transaction field.

       8.      Choose  Start Recording.

A new session is automatically started. A new Record SAP GUI Command dialog box appears in the first session.

       9.      Check the session data on the popup and choose Yes.

The Recording Running... dialog box appears. It will remain available during the recording. You can change the settings at any time during the recording.


Ў        You can change the recording mode and confirm the change by choosing Change Recording Mode.

Ў        You can generate a new SAPGUI command by choosing Insert New SAPGUI Command.

Ў        You can record the initial state of selected types of screen elements. This can generate a lot of data, so be selective about what and when you record.

Ў        You can insert GETGUI or CHEGUI commands during recording by using the corresponding buttons.

Ў        You can insert a comment in the test script by choosing Advanced ® Insert Comment. If the current granularity is to coarse, eCATT will split a command to insert the comment at the correct place.

Ў        You can set the recording modes for context menus and tree controls under Advanced. For tree controls, you can select Key or Path. For context menus, Key, Text, or Position.

   10.      If you did not supply the transaction code in step 5, start the transaction in the second session.

   11.      In the first session, choose Stop Recording.

The SAPGUI commands and their corresponding command interfaces are entered in the test script.