SAP PyRFC 安装与配置完全指南

项目基础介绍与编程语言

SAP PyRFC 是一个强大的Python库，提供了异步非阻塞的接口来访问SAP NetWeaver RFC库。它使开发人员能够轻松地从Python应用程序调用ABAP模块，并且支持从ABAP系统调用Python函数。项目完全采用Python语言编写，兼容Python 3.8及更高版本，依赖于SAP提供的NetWeaver RFC SDK（最低要求为7.50补丁级别12）。

关键技术和框架

• 异步非阻塞: 支持高效的数据交互，尤其适合高并发场景。
• 自动数据类型转换: 在Python和ABAP之间无缝转换数据类型。
• 客户端与服务器模式: 提供双向通信能力，既可以从Python调用ABAP功能模块，也可以在ABAP中调用Python定义的函数。
• 跨平台: 支持Linux, Windows, macOS，以及通过Docker容器部署。
• Cython辅助编译: 在Linux上构建时需要Cython来提高性能。

安装与配置步骤

准备工作

1. 下载并安装SAP NW RFC SDK: 访问SAP Software Download Center，查找并下载相应平台的SDK 7.50及其补丁级别12或更高版本。确保遵循SAP Note 3337381了解更新详情。

2. 环境检查:

   • 确保已安装Python 3.8或以上版本。
   • Windows用户需安装Visual C++ Redistributable Package for Visual Studio 2013。
   • 对于macOS，按照SDK文档设置远程路径。
   • Linux用户需安装Cython。

安装PyRFC库

直接安装（适用于Windows和macOS）

1. 打开命令行工具（如Terminal或CMD）。
2. 使用pip安装PyRFC库（会自动安装适用的预编译二进制包）:

   pip install pyrfc
   

源代码安装（适用于所有平台，特别是Linux）

1. 克隆PyRFC的GitHub仓库:

   git clone https://github.com/SAP/PyRFC.git
   

2. 进入项目目录:

   cd PyRFC
   

3. 根据需要，可以使用tox进行测试环境搭建（可选），例如对于Python 3.11:

   tox -e py311
   

4. 或者直接使用pip安装（如果需要强制构建，则添加--no-binary选项）:

   pip install .
   

   如果需要手动控制Cython的编译过程，可以加上环境变量：

   PYRFC_BUILD_CYTHON=yes pip install .
   

5. 配置SAP NW RFC SDK路径（仅当需要自定义路径时）: 在Python脚本开始处，可能需要配置正确的sapnwrfc.ini路径，使用如下命令:

   import pyrfc
   pyrfc.set_ini_file_directory('/path/to/sapnwrfc.ini')
   

验证安装

安装完成后，运行以下Python命令来验证PyRFC是否正确安装:

from pyrfc import Connection
print(pyrfc.__version__)

如果安装成功，将打印出PyRFC的版本号而不会报错。

开始编码

现在，你可以开始使用PyRFC调用ABAP中的函数模块了。记得先建立连接，然后调用模块，比如调用STFC_CONNECTION：

conn = Connection(
    ashost='your_sap_host',
    sysnr='00',
    client='100',
    user='username',
    passwd='password'
)
result = conn.call('STFC_CONNECTION', REQUTEXT='Hello SAP!')
print(result['ECHOTEXT'])
conn.close()

请替换上述示例中的连接参数为实际的SAP系统信息。

至此，您已完成SAP PyRFC的安装与基本配置，可以开始在Python项目中集成SAP系统的功能了。