Asynchronous, non-blocking SAP NetWeawer RFC SDK client bindings for Python.
- Stateless and stateful connections (multiple function calls in the same ABAP session (same context))
- Sequential and parallel calls, using one or more clients
- Automatic conversion between Python and ABAP datatypes
- Extensive unit tests
-
Python 3, Python 2 until 2020
-
The pyrfc connector can be built from source on all platforms supported by SAP NW RFC SDK.
-
Pre-built pyrfc wheels are provided in respective releases, for Python 3 and Python 2 (until 2020), for Windows 10, Ubuntu 16.04 and macOS 10.14 (experimental).
SAP NW RFC SDK C++ binaries must be downloaded (SAP partner or customer account required) and locally installed (installation instructions). More information on SAP NW RFC SDK section on SAP Support Portal.
SAP NW RFC Library is fully backwards compatible, supporting all NetWeaver systems, from today S4, down to R/3 release 4.6C. Using the latest version is recommended.
On Windows platforms the Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package (KB973544), or newer, must be installed, per SAP Note 1375494 - SAP system does not start after applying SAP kernel patch.
❗ Due to a change introduced with Python 3.8 for Windows, PATH directories are no longer searched for DLL. The SAP NWRFC SDK lib path is no longer required on PATH, for Python >= 3.8.
- The macOS firewall stealth mode must be disabled (Can't ping a machine - why?):
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setstealthmode off- Remote paths must be set in SAP NWRFC SDK for macOS: node-rfc/#58
After the SAP NW RFC SDK installed on your system, download the adequate wheel from the latest release and run pip install:
For PyRFC release 1.9.99, for Python 3.7 on Darwin, run for example:
wget https://github.com/SAP/PyRFC/releases/download/1.9.99/pyrfc-1.9.99-cp38-cp38-macosx_10_15_x86_64.whl
pip install pyrfc-1.9.97-cp37-cp37m-macosx_10_14_x86_64.whlAlternatively, or if the pyrfc package for your platform not provided, build the package from source on your system and pip install:
git clone https://github.com/SAP/PyRFC.git
cd PyRFC
python setup.py bdist_wheel
pip install dist/pyrfc-1.9.97-cp37-cp37m-macosx_10_14_x86_64.whl
# set ABAP system parameters in test/pyrfc.cfg
pytest -vvSee also the the pyrfc documentation, complementing SAP NW RFC SDK documentation.
Note: The package must be installed before use.
In order to call remote enabled ABAP function module (ABAP RFM), first a connection must be opened.
>>> from pyrfc import Connection
>>> conn = Connection(ashost='10.0.0.1', sysnr='00', client='100', user='me', passwd='secret')Connection parameters are documented in sapnwrfc.ini file, located in the SAP NWRFC SDK demo folder.
Using an open connection, remote function modules (RFM) can be invoked. More info in pyrfc documentation.
>>> result = conn.call('STFC_CONNECTION', REQUTEXT=u'Hello SAP!')
>>> print result
{u'ECHOTEXT': u'Hello SAP!',
u'RESPTEXT': u'SAP R/3 Rel. 702 Sysid: ABC Date: 20121001 Time: 134524 Logon_Data: 100/ME/E'}Finally, the connection is closed automatically when the instance is deleted by the garbage collector. As this may take some time, we may either call the close() method explicitly or use the connection as a context manager:
>>> with Connection(user='me', ...) as conn:
conn.call(...)
# connection automatically closed hereAlternatively, connection parameters can be provided as a dictionary:
>>> def get_connection(conn_params):
... """Get connection"""
... print 'Connecting ...', conn_params['ashost']
... return Connection(**conn_param)
>>> from pyrfc import Connection
>>> abap_system = {
... 'user' : 'me',
... 'passwd' : 'secret',
... 'ashost' : '10.0.0.1',
... 'saprouter' : '/H/111.22.33.44/S/3299/W/e5ngxs/H/555.66.777.888/H/',
... 'sysnr' : '00',
... 'client' : '100',
... 'trace' : '3', #optional, in case you want to trace
... 'lang' : 'EN'
... }
>>> conn = get_connection(abap_system)
Connecting ... 10.0.0.1
>>>conn.alive
TrueSee also the the pyrfc documentation, complementing SAP NW RFC SDK documentation.
-
Python 2 will not be maintained past 2020
-
Unicode path fix required for build from source on macOS
If you encounter an issue or have a feature request, you can create a ticket.
Check out the SCN Forum (search for "pyrfc") and stackoverflow (use the tag "pyrfc"), to discuss code-related problems and questions.
Copyright (c) 2013 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the Apache Software License, v. 2 except as noted otherwise in the LICENSE file.