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.

Liquid UI for iOS support two types of automation.

  1. Automation via URL
  2. Automation via .sap file

Automation via URL: All the required information is included in the URL and passed to the SAP.

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

The app require sap login credentials.


Open the below link from your iOS device.

<a href='sapr3://r3/target?gui=/H/;ZLUI-FLD1=VA21;ZLUI-FLD3=1460;ZLUI-FLD4=AFF-SF-OP-NO;enter'>Create Quote</a>

You will recieve a popup message to open the link with Liquid UI App as shown below:

Click Open to open from Liquid UI App. If username and password is specified in the Web URL, it will login into SAP with the specified information in the URL. 

If autologon is turned off, then logon screen will be visible to the user for further user action, and parameters from the connection if any will be displayed to the user on the logon screen (client, username, language) 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.

Web URL Parameters

Liquid UI follows it’s own connection parameters in its URL. The URL parameters in 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/SAPMSGSERVER/S/3600/G/SPACE&client=800&user=luiuser&password=luipassword&language=EN&command=VA03;VBAK-VBELN=5235;RV45S-KUNNR=1460;enter'>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 require 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 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 appears as following:

  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 appears as following:

  8. If you haven’t logon to SAP GUI and attempt to open .sap file, then you will be prompted with a window to enter logon credentials as following:
  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