Liquid UI - WS Reference Library

2.3.8 Automating SAP Transactions


Purpose

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 Android support two types of automation.

1. Automation via URL

2. Automation via .sap file


Automation via URL

Liquid UI for Android will parse the URL and perform require function depending on tcode, fields value and action definition. All the required information is included in the URL and pass to the SAP. The app requires sap login credentials.


Example

Open the below link in a web browser on your Android 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 recieve a popup message and Click Open to open for Liquid UI App as shown below:

 

You are navigated to the specified SAP transaction and enters all the field values to execute the process specified in the URL.

 

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

URL EXAMPLES

Message Server:

<a href='sapr3://r3/target?gui=/M/SAPMSGSERVER/S/3600&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;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 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 drop-down list
    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 the 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 a .sap 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 the desired transaction automatically.
  10. Similarly, you can automate any transaction with a single click by creating a .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 Android will parse the URL and download the file content from the web.


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


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