Using the Connection List

The Connection List appears in the first screen when you launch Liquid UI. This is where you will create and manage your connections to SAP and to GuiXT Server. .

In the Connection List, you can perform the following actions.

Creating New Connections

When you first open the Connection List, you will see a small '+' icon located in the upper left corner . To create a new connection, please follow the instructions below.

  1. Click the '+' icon. The new connection screen will display.

  2. Enter the necessary data as explained in the following list.

    Description

    Enter a short description of the target server. This can be anything, but it should be informative.

    Group/Server

    Enter the SAP application server, the GuiXT Server, or the SAP message server in this field. If you are connecting from an external location, you will need to input the full name (e.g. test.guixt.com). This entry is required and can be either a name or an IP address.

    Note: Server names are case-sensitive. Make sure you enter the name of your server exactly as it appears in the SAP GUI Logon Pad.
    Instance Number

    This two-digit number is actually the last two digits of the port number your device will use to connect to the target server. If the SAP server is using port 3220, then your entry would be '20'. This is a required entry.

    Client

    This three digit number is your SAP client's ID number. In our example we are using '800', but you will need to use the correct number for your deployment. The client ID can be found in the 'Usage data' section of the SAP Status screen. Like the preceding entries, this is a required field.

    User Name

    This is your SAP user name. it should be enterd exactly as you would when you log into SAP GUI. This is only a required field if you are using Auto Login.

    Password

    This is your SAP password. Enter this exactly as you would wben you log into SAP GUI. Please note that passwords entered into the Connection List do not display in plain text. Like the 'User Name' field, this is only a required field if you are using Auto Login.

    Language

    This is an optional field. You can enter the two-digit language code used by the SAP application server here. Each language has its own code, and the code for English is 'EN'.

    Auto Login

    This pushbutton enables and disables the Auto Login feature - it is off by default. When Auto Login is active, Liquid UI will automatically log you into the current default connection when you launch the application.

  3. When you have finished entering the connection data explained above, click Save to return to the main Connection List.

Editing Existing Connections

Once a conenction is created, you can edit it from the Connection List.

  1. To edit an existing connection, open the Connection List and click on the icon at the far right of the entry you want to modify.

  2. The connection will open . Tap on each field that you want to edit and use the device keyboard to make your changes.

  3. When you are finished editing, click the Save button to save your changes and return to the Connection List.

Deleting Connections

All user-created connections can be deleted. To delete a connection, please do the following.

  1. Open the Connection List and then tap and hold on the connection you want to modify.

  2. A context menu will display. This menu offers you three options - 'Modify', 'Delete', and 'Set Default'. Tap 'Delete'.

  3. The connection will be removed from the Connection List.

Setting Default Connections

At least one connection must be set as the default. Whern you first start the Liquid UI app, the 'DEMO SERVER' connection is marked as default. However, once you add your own connections, you can set any of these to be the default connection. To select a default connection, please do the following.

  1. Open the Connection List and then tap the connection you want to use. The connection will launch and will simultaneously be designated as the default connection. Once a connection is set as the default, it will be marked with a blue checkmark.

  2. You can also set a default connection from the context menu that you use to modify and delete connections. This menu offers you three options - 'Modify', 'Delete', and 'Set Default'. Tap 'Set Default'.