Python bindings for SAP NetWeaver RFC Library
Reason this release was yanked:
A more complete SAP NWRFC SDK wrapper replaces this package. See: https://github.com/SAP/PyRFC
Project description
Asynchronous, non-blocking SAP NetWeawer RFC SDK client bindings for Python.
Features
- 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
- :new: Throughput monitoring
- Extensive unit tests
Supported platforms
-
Python 3
-
Windows 10 and macOS 10.15 supported by pre-built wheels and build from source installation
-
Linux supported by build from source installation only
-
Pre-built portable Linux wheels
-
are not supported, neither issues related to portable Linux wheels
-
:exclamation: must not be distributed with embedded SAP NWRFC SDK binaries, only private use permitted
-
-
Platforms supported by SAP NWRFC SDK can be supported by build from source
Prerequisites
All platforms
-
SAP NWRFC SDK 7.50 PL3 or later must be downloaded (SAP partner or customer account required) and locally installed
- Using the latest version is reccomended as SAP NWRFC SDK is fully backwards compatible, supporting all NetWeaver systems, from today S4, down to R/3 release 4.6C.
- SAP NWRFC SDK overview and release notes
-
Build from source on macOS and older Linux systems, may require
uchar.h
file, attached to SAP OSS Note 2573953, to be copied to SAP NWRFC SDK include directory: documentation
Windows
-
Visual C++ Redistributable Package for Visual Studio 2013 is required for runtime, see SAP Note 2573790 - Installation, Support and Availability of the SAP NetWeaver RFC Library 7.50
-
Build toolchain for Python 3 requires Microsoft C++ Build Tools, the latest version reccomended
-
Build toolchain for Python 2 requires Microsoft Visual C++ 9.0
:exclamation: 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.
macOS
- 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: documentation
-
Build from source requires
uchar.h
file, attached to SAP OSS Note 2573953, to be copied to SAP NWRFC SDK include directory: documentation
Installation
PYRFC_BUILD_CYTHON
environment variable can be set to trigger Cython based build, overriding the default C based build from already cythonized CPP source.
Binary wheel installed if found on PyPI, fallback to build from source otherwise:
pip install pynwrfc
Build from source
pip install pynwrfc --no-binary :all:
# or
PYRFC_BUILD_CYTHON=yes pip install pynwrfc --no-binary :all:
or
git clone https://github.com/SAP/PyRFC.git
cd PyRFC
python setup.py bdist_wheel
pip install --upgrade --no-index --find-links=dist pynwrfc
# set ABAP system parameters in test/pyrfc.cfg
pytest -vv
See also the the pyrfc documentation, complementing SAP NWRFC SDK documentation.
Getting started
Note: The package must be installed before use.
Open Connection
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.
Call ABAP function modules
Using an open connection, remote function modules (RFM) can be invoked. More info in pyrfc documentation.
# ABAP variables are mapped to Python variables
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'}
# ABAP structures are mapped to Python dictionaries
IMPORTSTRUCT = { "RFCFLOAT": 1.23456789, "RFCCHAR1": "A" }
# ABAP tables are mapped to Python lists, of dictionaries representing ABAP tables' rows
IMPORTTABLE = []
result = conn.call("STFC_STRUCTURE", IMPORTSTRUCT=IMPORTSTRUCT, RFCTABLE=IMPORTTABLE)
print result["ECHOSTRUCT"]
{ "RFCFLOAT": 1.23456789, "RFCCHAR1": "A" ...}
print result["RFCTABLE"]
[{ "RFCFLOAT": 1.23456789, "RFCCHAR1": "A" ...}]
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 here
Alternatively, 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
True
See also the the pyrfc documentation, complementing SAP NWRFC SDK documentation.
How to obtain support
If you encounter an issue or have a feature request, you can create a ticket.
Check out the SAP Community (search for "pyrfc") and stackoverflow (use the tag pyrfc), to discuss code-related problems and questions.
License
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for pynwrfc-2.0.5-cp38-cp38-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56bc600f7e1e3658936fd18bfdbcc52a901011774551a2fbe800e98cc6050ca1 |
|
MD5 | 48dc30b425c8fc06abad507bcbf55986 |
|
BLAKE2b-256 | 5f6b675252192cf3c509c3874e6364ef9f28902a58f866bbc4cb3a30c2046f4f |
Hashes for pynwrfc-2.0.5-cp38-cp38-macosx_10_15_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bda6d8347348623d7e0e3a4eb274923b5d7f577900e62d8752e4ad736fe9d7c0 |
|
MD5 | 5c2b67b2624375c9bfc77d9ea2051950 |
|
BLAKE2b-256 | a114d0f186d8d499a0ca745f30451ccb99b37c987b4d260135594c6299f1dd33 |
Hashes for pynwrfc-2.0.5-cp37-cp37m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6bce8948e276f0a88b7204f6b61754bfe00cbfbafd2bba8300d4b382f515da2a |
|
MD5 | 5525ba60c55320feee4391280cb02928 |
|
BLAKE2b-256 | 294eebe697fee98147bf8a93cb561ac0ed7d7a6408c32249867604dee3681fd9 |
Hashes for pynwrfc-2.0.5-cp37-cp37m-macosx_10_15_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cbf0d10ea14ca1d8edb385af7c3fb3ff15a1ad09450b1074b0b8dc7846e2e464 |
|
MD5 | 28c96243ed0865aa04e2c74c4ce2cbaf |
|
BLAKE2b-256 | 49049ebb4ca357bdd61abf836a2ba268ce3eb84c3a133fe2636c30b1c86eae76 |
Hashes for pynwrfc-2.0.5-cp36-cp36m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a872a191ee403393eeba6b189b54a24ac07a7979d3ff2e8d227153d9797f5aec |
|
MD5 | d9a9b26eb64bd2153c703cfa27cc5cc0 |
|
BLAKE2b-256 | c68fd6b3bff52d83c732402330f75989a8d8e82dc6f35b10ed7a91d269843fb7 |
Hashes for pynwrfc-2.0.5-cp36-cp36m-macosx_10_15_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1a342376ada8a3b89554b8632d3446015952aab11f4300f63479ebb3fef388e2 |
|
MD5 | d14b7694ee630652729f6b2ca9021c43 |
|
BLAKE2b-256 | 819c1921692ee9e98d42cd5e7b564e5ad4972545725ea7c0904e52896cf7d9d5 |