Using GUI Automation

Automation Anywhere Enterprise enables you to capture objects from the SAP GUI using the GUI Automation command.


  • Open the Enterprise Client and SAP GUI application in the same mode. For example, if you open the Enterprise Client in the Administrator mode, you must also open the SAP GUI application in the Administrator mode.
  • Log in to the SAP GUI before capturing objects because the SAP Log on screen is not supported for object capture.
  • Enable GUI scripting. See Enabling Scripting on the Client Side and Enabling Scripting on the Server Side.
  • Ensure that SAP GUI version 760 is installed.
To capture objects from the SAP GUI application, do the following:
Note: In the SAP GUI application, when you Double click on a node in Tree control that opens a new window, the AA player is stuck and does not execute. Close this window to execute the other commands. You will encounter this issue when you use Execute script action of the Main window control.


  1. Expand the SAP Integration command node and double-click the GUI Automation command.
    The SAP Integration dialog box appears.
  2. From the SAP Window Title list, select the SAP window to specify the window from which you want to capture an object.
    The list populates all the windows that are currently open in the SAP GUI application. If a window that is open in the SAP GUI application is not available in the list, click Refresh to update the list.
  3. Click Capture to capture an object.
    The SAP application window you have selected appears.
  4. Press and hold the left mouse button and drag the mouse over the object you want to capture.
    A red highlight appears around the object. Its properties are captured when the mouse is released over it.
  5. In the Object Details section, select the properties of the object that you want to use to search for the object .
    Note: The Id and SessionId properties are selected by default.
  6. From the Select Action To Perform list, select an option to specify the action that you want to perform on the object.
    The options available in the list vary based on the type of object you have captured.
    Note: The Assign To Variable list is available when you select certain actions from the Select Action To Perform list. This list is available for those actions that return a value after they are executed and enables you to assign that value to a variable. The value returned by an action can be a property of an object or the value of the selected text.
  7. Based on the option selected from the Select Action To Perform list, enter a value in the Value field of the Action Parameters section. See Actions available for captured objects.
  8. In the Wait for the object to exist field, specify how much time the command should wait for an object to be available.
    This option enables you to specify the amount of time the command should wait for an object. The system moves on to the next command as soon as the object is available and does not wait for the entire duration specified.
  9. Click Save.