1. 概述
1.1 版本
报表服务器版本 | JAR 包 | SAP 数据集插件版本 |
|---|---|---|
| 10.0 | 2016-12-14 | V1.8.8 |
| 9.0 | 2016-12-14 | V1.8.4 |
| 8.0 | 2016-12-14 | V1.8.2 |
1.2 功能介绍
启用「SAP数据集插件」后，可连接 SAP 系统，并在数据集中添加 SAP 数据集类型。
2. 准备工作
2.1 安装 SAP 插件
安装插件 SAP 数据集，安装方法参考以下文档：
设计器插件安装方法参照 设计器插件管理
服务器安装插件方法参照 服务器插件管理
2.2 环境准备
与 SAP 系统进行连接，需要导入 SAP 接口包和本地库，并确保运行的 JVM 能够找到接口包和本地库。
2.2.1 Windows 系统服务器
报表工程部署在 Windows 系统的服务器下，以 Tomcat 为例。
| JDK 位数 | JDK 版本 | SAP 文件包 | 将SAP 文件包中的文件导入对应路径 |
|---|---|---|---|
| 32 | JDK 1.8 且小版本需在 JDK8u102 以上 | sapjco3.jar 放在%TOMCAT_HOME%\lib路径下 sapjco3.dll 放在C:\Windows\System32路径下 | |
| 64 | JDK 1.8 且小版本需在 JDK8u102 以上 | sapjco3.jar 放在%TOMCAT_HOME%\lib路径下 sapjco3.dll 放在C:\Windows\System32路径下 |
注1：如果数据连接失败，可以尝试将 sapjco3.dll 文件放置在系统 jre 的 bin 目录下，例如：%JAVA_HOME%\jre\bin
注2：Windows Server 2003 和 Windows XP 的系统在连接 SAP 时，需要下载安装 Microsoft Visual C++ 2005 SP1。
2.2.2 Mac OS 系统服务器
1）点击下载驱动：libsapjco3.rar，解压后可以将其放置在%FineReport%/lib下。
2）打开设计器%FineReport%/lib，右击「designer」，选择「显示包内容」，打开 vmoptions.txt 文件，如下图所示：
3）在文件中写入：-Djava.library.path=/Applications/FineReport10.0/lib（放置驱动文件的路径）
注：如果同时安装了 SAP 和 SAP BW 插件，可能会存在冲突导致有某一种数据集预览报错的问题。
2.2.3 Linux 系统服务器
报表工程部署在 Linux 系统的服务器下，以 Tomcat 为例。
| JDK 位数 | SAP 文件包 | 将SAP 文件包中的文件导入对应路径 |
|---|---|---|
| 32位 | sapjco3.jar 放在%TOMCAT_HOME%\lib路径下 libsapjco3.so 放在%JAVA_HOME%\jre\bin路径下 libsapjco3.so 放在usr\lib文件夹下，若 Linux 为 64 位，放到usr\lib64路径下 | |
| 64位 | sapjco3.jar 放在%TOMCAT_HOME%\lib路径下 libsapjco3.so 放在%JAVA_HOME%\jre\bin路径下 libsapjco3.so 放在usr\lib64路径下 |
注：如果仍连接不了，看报错信息，例如验证 SAPJCO 失败，缺少依赖包 libstdc++.so「SAPJCO2 才需要，而 SAPJCO3 不需」，则需要安装共享库。
2.2.4 本地设计器
如果本地设计器用到 SAP 数据连接，根据安装的设计器位数，下载 Windows 系统下对应位数的 JDK1.6 版本的 SAP 文件包。
| 设计器位数 | SAP文件包 | 将SAP 文件包中的文件导入对应路径 |
|---|---|---|
| 32位 | sapjco3.jar 放在%FR_HOME%\lib路径下 | |
| 64位 | sapjco3.jar 放在%FR_HOME%\lib路径下 |
3. SAP 数据连接
3.1 建立连接
1）进入设计器，点击「服务器>定义数据连接」，如下图所示：
2）输入连接信息。
局域网中已配置的 SAP 的主机名称，也可以写此机器的 IP 地址。（不是数据库服务器的主机名，而是 SAP 应用服务器的 IP）
SAP 系统中设置的属性，用于交互的端口号，一般来说是 00，具体根据 SAP 系统来定。
SAP 系统管理的业务和数据的最大有效集合，也是 SAP 系统的一个属性，具体根据 SAP 系统决定。
用户：连接 SAP 时使用的账号的用户名。（不是数据库用户名，而是连接应用的 SAP 用户账号）
密码：连接 SAP 时使用的账号的密码。（不是数据库密码，而是连接应用的 SAP 用户密码）
SAP 系统中的容量和最大连接数。
3）点击「测试连接」，连接成功后点击「确定」推出数据连接设置页面。如下图所示：
3.2 添加 SAP 数据集
连接成功之后就可以通过此数据连接从 SAP 系统中取数，添加 SAP 数据集至 FineReport ，详细请查看 SAP 数据集 。