Select the menu item Server -> Manage Sources to manage the SAP connections, where you can create, edit and delete connections.

Shared-SAP-Connections

To create a connection template, click on Add. Give the template a name and fill in the necessary fields.

SAP-Connection-Settings

If you filled in all required information you can check the connection by clicking the Test Connection button. If the connection is established the following info window will be displayed.

SAP-Connection-Test-Ok

To edit or delete a template, click on Edit or Delete accordingly.

Authentication via SNC / SSO

When your SAP system is configured to be accessed via SSO with SNC, select SNC and set Partner Name and Mechanism instead of User and Password.

You have the following mechanism options:

  • Kerberos5
  • NTLM
  • SNC Library: this property specifies the path to the SNC library (dll) manually.

SAP-Connection-SNC-Ok

If the mechanism option SNC Library is selected, the fields SNC Library and X.509 Certificated will be enabled.

Information about the SAP connection

To establish an SAP connection the following data are required:

  1. Client
  2. Language
  3. Authentication
  4. SAP target system
  5. SAP router

Client

A three-digit number of the SAP client between 000 and 999, e.g. 800.

Language

The logon language for the SAP system. Example: EN for English or DE for German.

Authentication

For the Authentication you can use an SAP username and password. In general all the following authentication modes are supported:
a. SAP username and password (system or dialogue user)
b. SNC (Secure Network Communication) with username and password
c. SNC with SSO (Single Sign On)
d. Log On Ticket (available only for some connectors, e.g. ERPConnect, ERPConnect Services and Xtract Universal)

SAP Library: SNC
SAP Library: SNC Parameters

SAP target system

The SAP target system kann be an application server or message server (Load Balancing). For an application server the following data are required:

  • Host name or IP address of the applikation server (Property Host)
  • System/Instance number , a two-digit number between 00 und 99 (Property SystemNumber)

For a message server the following data are required:

  • Three-digit System ID (Property SID, z.B. MSS)
  • Name or IP address of the Message Server (Property MessageServer)
  • Logon group (Property LogonGroup, usually it is PUBLIC)

SAP Library: Load Balancing

SAP router

If you access the SAP target system (Application server or Message server) via an SAP router. you should set the router string just before the host name or the message server Example: If the Application server is “hamlet” and the router string is “/H/lear.theobald-software.com/H/”, you should set the Host property to “/H/lear.theobald-software.com/H/hamlet”.

SAP Library: SAP-Router

RFC library (API): classical or Netweaver.

The RFC API (Remote Function Call) allows to establish an RFC connection to an SAP system from an external system, that communicates as Client or Server with the SAP system.
The RFC API exists in two different versions:

  • Classical RFC API (classical RFC library)
  • Netweaver RFC API (Netweaver RFC library). The Netweaver RFC Library does not support DeltQ or OHS.

SAP Library: RFC API: Classical & NetWeaver

SAP Log On

In this section you will see how to find the necessary SAP connection information in the SAP logon.

To log in on an SAP system you need:

  • Client and
  • Logon Language

For the authentication you use an SAP username and a password.

sapgui-client-lang

SAP target system

The SAP target system can be either an application server or a Message Server (Load Balancing).

Application Server

For an application server the following data are required:

  • Host name or IP address of the applikation server (Property Host)
  • System/Instance number , a two-digit number between 00 und 99 (Property SystemNumber)

sapgui-appserver

Message Server (Load Balancing)

For a message server the following data are required:

  • Three-digit System ID (Property SID, z.B. MSS)
  • Name or IP address of the Message Server (Property MessageServer)
  • Logon group (Property LogonGroup, usually it is PUBLIC)

sapgui-messageserver

Authentication

For the authentification with SNC the SNC Partner name is required, this can be found in the field SNC Name.

sapgui-sncname