1. 概述
1.1 版本
FineDataLink版本 | 功能变动 |
|---|---|
| 4.0.10 | - |
| 4.1.12.2 |
|
1.2 功能介绍
FineDataLink 支持通过 RFC 接口调用 SAP 系统内已经开发好的函数，并将数据取出。
在调用前需要首先建立 FineDataLink 与 SAP 系统的连接。
1.3 前提条件
详情请参见：前提条件
2. 导入文件
与 SAP 系统进行连接，需要导入 SAP 接口包和本地库，并确保运行的 JVM 能够找到接口包和本地库。
1）下载文件
下载下表对应版本并解压文件夹，获得sapjco3.jar、sapjco3.dll等文件。
2）上传文件
对于运维平台部署的项目，将获得的文件上传到工程外挂目录/fdl/customlib/lib文件夹中
对于非运维平台部署的项目，将获得的文件上传到工程/webapps/webroot/WEB-INF/lib文件夹中
3）重启FineDataLink工程或组件。
| 服务器系统 | SAP 文件包 |
|---|---|
| Linux64 | 注意事项： 若同一个 SAP 数据库创建了多个数据连接，使用下方驱动文件： |
| Linux32 | |
| Windows64 | |
| Windows32 |
注1：请确保工程JDK版本为 1.8 且小版本在 JDK8u102 以上。
注2：如果数据连接失败，可以尝试将 sapjco3.dll 文件放置在系统 jre 的 bin 目录下，例如：%JAVA_HOME%\jre\bin
注3：Windows Server 2003 和 Windows XP 的系统在连接 SAP 时，需要下载安装 Microsoft Visual C++ 2005 SP1。
注4：如果仍连接不了，看报错信息，例如验证 SAPJCO 失败，缺少依赖包 libstdc++.so「SAPJCO2 才需要，而 SAPJCO3 不需」，则需要安装共享库。
3. 具体连接步骤
3.1 建立连接
1）管理员登录 FDL 工程，点击「管理系统>数据连接>数据连接管理」，选中某个文件夹后，新建数据连接。如下图所示：
2）设置数据连接名称（可同时修改数据连接所在目录）。如下图所示：
3）可根据数据源分类、支持形式、适配模块、数据源名称筛选数据库。如下图所示：
4）输入连接信息并点击测试连接，如下图所示：
| 配置项 | 说明 |
|---|---|
| 数据连接名称 | 数据连接名称 默认值重名时，追加递增的数字后缀，如「数据连接1」 |
| 主机名称 | SAP应用服务器的主机名；例如：192.168.1.123 对应SAP系统中的应用服务器：
|
| 系统编号 | SAP 实例编号（由SAP系统确定）；例如：00 对应SAP系统中的实例编号：
|
| 语言代码 | 填写SAP系统语言代码（由SAP侧确定） 如：ZH 为中文 注：SAP 中可以根据透明表T002查到支持的配置项 查看SAP系统登录界面的登录语言：
|
| 客户端编号 | SAP客户端编号，即SAP系统管理的业务和数据的最大有效集合（由SAP系统确定） 如：000 查看SAP系统登录界面的集团编号：
|
| 用户名 | 连接使用的 SAP 用户账号 查看SAP系统登录界面的用户：
|
| 密码 | 连接使用的 SAP 用户密码 密码不可复制 查看SAP系统登录界面的密码：
|
| SAP路由 | SAP路由配置（由SAP侧确定） SAP路由是其主机名的下一层，用于相同主机名下多个应用的区分 对应SAP系统中的 SAProuter 字符串：
|
5）点击「测试连接」，若连接成功则「保存」该连接。如下图所示：
3.2 使用 SAP 取数
连接成功之后就可以通过此数据连接从 SAP 系统中取数，并进行定时任务数据开发，详细参见 SAP ERP取数概述
