To use any Xtract for Alteryx component an SAP connection is required.
Creating an SAP Connection #
- Drag any Xtract for Alteryx component, e.g., Xtract Table (1), from the Alteryx Designer tool box. The configuration window opens.
- In the subsection Connection, open the drop-down menu (2) to display all SAP systems connected to the local machine.
- Click [New] to create a new connection. The window “SAP Connection Details” opens.
Connection Details #
The window “SAP Connection Details” consists of four subsections:
- Client and Language
Fill out the connection details to establish an SAP connection.
Tip: Values to fill out the fields can be found in the SAP Logon Pad in the Properties or acquired from SAP Basis team.
Note: The connection details of an SAP connection are stored in a JSON file in the following directory:
C:\Users\<UserName>\AppData\Roaming\Theobald Software\Xtract for Alteryx\Connections\<SAPSourceName>.json
There are two possibilities to connect to an SAP source system:
- Use a Single Application Server (1)
- Host: host name or IP address of the application server (Property Host)
- Sys. No.:: a two-digit number between 00 und 99 (Property SystemNumber)
- Use a Load Balancing Server (message server) (2)
- Message Server: name or IP address of the message server (Property MessageServer)
- Group: property LogonGroup, usually PUBLIC
- SID: three-digit System ID (Property SID e.g., MSS) See also SAP online help: Load Balancing.
Accessing via SAP router
If you access the SAP source system (Application server or Message server) via an SAP router, set the router string before the host name.
If the application server is “hamlet” and the router string is
/H/lear.theobald-software.com/H/, set the host property to
See also SAP online help: SAP-Router.
Client and Language #
- Client - a three-digit number of the SAP client between 000 and 999, e.g., 800.
- Language - the logon language for the SAP system, e.g., EN for English or DE for German.
The following authentication methods are supported:
- SNC (3) (Secure Network Communication) - encrypted connection between Xtract for Alteryx and SAP with username and password. For more details see the official SAP Help Site.
- Plain (4) - SAP username and password (system or dialogue user)
- Check the SAP parameter snc/gssapi_lib to determine, which library is used for encryption in your SAP system. Your SAP basis has to import and configure the same library on the application server and on the machine with the installed Xtract for Alteryx.
- When using SNC, make sure to enter the complete path of the library in the field SNC library e.g.,
- Fill in the SAP Partner Name configured for the SAP application server e.g.,
You can additionally use SAP Log On Ticket (5) for authentication.
Select a library and optionally define a trace directory for debug logging.
RFC libraries (6)
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.
There are two options for using RFC libraries:
- Use classic RFC library (librfc32.dll)
- Use NetWeaver RFC libraries (sapnwrfc.dll)
See additional information on SAP libraries on the SAP Help Site - RFC Libraries.
SAP has stopped supporting librfc32.dll.
Note: When using the NetWeaver RFC library with DeltaQ or OHS extractions, the RFC destination in SM59 must be set to Unicode.
Trace Directory (Debug Logging)
You can log debug information and save it locally. Fill the Trace directory field with a local path to a folder, where you want to save the debug information. See further details in the knowledge base article How to activate tracing for Xtract Products.
Make sure to 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.
To check the New SAP Connection #
- Click [Test Connection] (7) to test the successful connection. The confirmation window opens. The SAP connection is set up successfully.
- In the configuration window (left hand-side) check if created SAP connection is listed.