Liquid UI - WS Reference Library

2.3.5 Automating SAP Transactions


Automating transactions inside your SAP ERP system can help you to eliminate slow, manually dependent and error prone processes restricting your business. This can generate significant cost and time savings.

User Interface

Liquid UI for iOS support two types of automation.

1. Automation via URL

2. Automation via .sap file

1. Automation via URL:

Liquid UI for iOS will parse the url and perform require function depending on tcode, fields value and action definition. If the username and password specified in the Web URL is correct, it will login to Liquid UI App and parse specified field values from the URL.


Open below link from your iOS device.

<a href='sapr3://r3/target?gui=/H/SAPAPPSERVER/S/3600&client=800&user=luiuser&password=luipassword&language=EN&command=VA03;VBAK-VBELN=5235;enter'>Display Sales Order</a>

You will receive a popup message to open the link with Liquid UI App. Click Open to open Liquid UI App as shown below:

You are navigated to the transaction and enters all the fields value specified in the URL as shown below.


Note: The Liquid UI App will only get connected to SAP if the connection parameters in URL matches with the connection list in Liquid UI App. If autologon is turned off or entered invalid logon credentials in the URL, then logon screen will be visible to the user for further user action as shown below:

Web URL Parameters

Liquid UI follows it’s own connection parameters in its URL. The URL parameters in a sequence are described below:

URL ParametersLiquid UI Connection Parameters
sapr3:// Tell the browser to open link through LUI app
//r3/target?gui Specify the target server you want to connect.
/H/Servername Application Server Configuration
/M/Servername Message Server Configuration
/S/3224 Sapproxy Port Configuration
24 System Number, which is drawn from the last two digits of sapproxy port number
Client 800 - Liquid UI Client number
User Liquid UI username
Password Liquid UI password
Language EN - English
Command It can be a transaction, report, or system command


Message Server:

<a href='sapr3://r3/target?gui=/M/SAPAPPSERVER/S/3600/G/SPACE&client=800&user=luiuser&password=luipassword&language=EN&command=VA03;VBAK-AUART=AE;>Connect to SAP Message Server</a>

Application Server:

<a href='sapr3://r3/target?gui=/H/SAPAPPSERVER/S/3200&client=800&user=luiuser&password=luipassword&language=EN&command=VA03;VBAK-VBELN=5235;RV45S-KUNNR=1460;enter'>Connect to SAP Application Server</a>

Automation via .sap file:

All the required information is included in the file and pass to the SAP.

The file is generated through SAPGUI.

Creating .Sap file

  1. Place the cursor on the desktop and perform a right click. Then choose New → SAP GUI Shortcut.
  2. Enter the desired name for the file with “.sap” extension.
  3. To define this .Sap file, place the cursor on the shortcut icon and do a right click. Select Edit from the context menu.
  4. The Properties window appear as follows:

  5. The properties window has following details:
    Title Enter the shortcut title.
    Type Specify the type of transaction. The type can be a transaction, report, or system command.
    Transaction/Command/report Enter the appropriate transaction, report, or system command.
    System Description Enter the name of your desired SAP system. You can even select from the dropdownlist.
    System ID Enter the system id of the SAP system.
    Start Parameters Enter the SAP GUI parameters.
    Client Enter your SAP client number.
    User Enter your user name. By default it takes windows user name.
    Password If the field is enabled, you can specify a password. By default, it is deactivated for security reason.
    Language Select your preferred language.
  6. After entering all the fields, click OK. You can view the .sap file shortcut on desktop.
  7. With this .Sap file you can automatically navigate to va01 transaction without any manual entry. To do this the SAP GUI should be in active state. Click on .sap shortcut icon to open va01 transaction in SAP GUI. The va01 screen appear as follows:

  8. If you haven’t logon to SAP GUI and attempt to open file, then you will be prompted with a window to enter logon credentials as follows:
  9. Once you logon to SAP GUI, you will be navigated to desired transaction automatically.
  10. Similarly you can automate any transaction with a single click by creating .sap file.

Creating an SAP shortcut from specific transaction in SAP GUI

Go to the desired transaction you want to run, click on “Generates a Shortcut” icon . The new window appears as following:

Verify the information in the create window is valid and choose OK. The shortcut appears as an icon on your SAP Logon screen as following:

Liquid UI for iOS will parse the url and download the file content from web.

The app will connect to R/3 server based on host and port information. If the file contain password, then the app will try to autologon.

Liquid UI for iOS perform require function depending on tcode, fields value and action definition