Connection Settings
This page contains an overview of the SAP connection settings in the XTRACT Connection Manager.
For information on the properties of an XTRACT Connection Manager, see List of XTRACT Connection Manager Properties.
Xtract Conenction Manager Settings
Some input fields for the SAP connection vary depending on the selected connection method.
| Input Field | Description |
|---|---|
| Client | A three-digit number of the SAP client between 000 and 999, e.g., 800. |
| Username | SAP username. |
| Password | Password of the SAP user. |
| Language | The logon language for the SAP system, e.g., EN for English or DE for German. |
| Application server | Host name or IP address of the application server (Property Host). |
| Instance number | A two-digit number between 00 and 99 (Property SystemNumber). |
| Input Field | Description |
|---|---|
| Client | A three-digit number of the SAP client between 000 and 999, e.g., 800. |
| Username | SAP username. |
| Password | Password of the SAP user. |
| Language | The logon language for the SAP system, e.g., EN for English or DE for German. |
| System ID | Three-digit System ID (Property SID e.g., MSS). |
| Logon group | Property LogonGroup, usually PUBLIC. |
| Message Server | Name or IP address of the message server (Property MessageServer). |
Trace Directory
You can log debug information and save it locally.
Enter a path to a local directory in the field Trace directory to save the debug information. For more information, see Troubleshooting: Trace Directory.
Clear the Trace Directory field when it is not needed.
Warning
Increase of used hard drive memory.
A big amount of information is collected when debug logging is activated. This can decrease the capacity of your hard drives dramatically. Activate the debug logging only when necessary e.g., upon request of the support team.
RFC Libraries
Select an RFC library. The following RFC libraries are supported:
- NetWeaver RFC library (sapnwrfc.dll)
- Classic RFC library (librfc32.dll)
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. For more information on SAP libraries, see SAP Help: RFC Libraries.
SAP does not support librfc32.dll anymore.
Note
For some older SAP releases, e.g., R/3 4.6C, it is necessary to enter the user name in upper case when using the NetWeaver RFC library.
Note
When using the NetWeaver RFC library with the Xtract DeltaQ component or the Xtract OHS component, the RFC destination in SAP transaction SM59 must be set to Unicode. We recommend using the not supported librfc32.dll for some components, e.g., Xtract DeltaQ as it runs more stable than the NetWeaver RFC library.
Test Connection
Clicking [Test Connection] validates the connection parameters. A window with a status message opens in the bottom right corner of the window.
Additions
The "Additions" menu contains settings for Secure Network Communication (SNC), as well as some expert options.
In the window "XTRACT Connection Manager" click Additions. The window "XTRACT Connection Manager Additions" opens.
SNC
The section SNC contains the Secure Network Connection options of the XTRACT Connection Manager. For more information, see SNC Authentication
| Input Field | Description |
|---|---|
| SNC enabled | Activate this option to enable Secure Network Communication (SNC) between Xtract IS and SAP. |
| SNC library (32 Bit, Visual Studio) | Path to the SNC library for 32 Bit, e.g., C:\Program Files (x86)\SAP\FrontEnd\SecureLogin\sapcrypto.dll |
| SNC library (64 Bit) | Path to the SNC library for 64 Bit, e.g., C:\Program Files\SAP\FrontEnd\SecureLogin\sapcrypto.dll |
| Partner Name | The SAP Partner Name configured for the SAP application server, e.g., p:SAPserviceERP/Alice@THEOBALD.LOCAL. |
| Quality of Protection | The SNC level of protection. The default value is 9 - Maximum. For more information, see SAP Help: Secure Network Communications (SNC) - Levels of Protection. |
Expert Options
| Input Field | Description |
|---|---|
| Legacy storage mode (connection string) | Activate this option, if you still use a single connection string for the SAP connection (default in Xtract IS versions before 09.2017). You can either use Connection properties or a Connection string, not both. Connection string does not support sensitive environment variable. |
| Obfuscate Password | Masks the SAP connection password. This option is activated by default when activating Legacy storage mode. |
| Internal Table Function | Defines the function module that is used for Xtract IS' internal communication with SAP, e.g., retrieving metadata. To change the selected function module, type the name of function module manually. |
| AttachesSapGui | This option is only accessible in the Properties of the XTRACT Connection Manager and not in the GUI. There are SAP Reports and BAPIs that require an installed SAP GUI even when they are called remotely. In this case, set the AttachesSapGui property in the Expert Options of the XTRACT Connection Manager to True. |
Warning
'sapgui' start failed.
Sometimes SAP opens a pop-up window that requires input when running extractions. To deactivate pop-up windows, open the SAP GUI Logon pad and navigate to Options... > Security Settings. Click the [Open Security Configuration] button and select Allow as the Default Action. Apply the changes and close the SAP GUI Logon pad.