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 系统集成时，在 7.0.4 版本之前只能通过程序数据集或者是 ETL 工具进行取数，实现起来非常麻烦，希望有类似 JDBC 数据连接 的方式来设置 SAP 数据连接。
FineReport 在 8.0 及后续版本中，将 SAP 数据连接功能做成一个插件，启用插件后，可在处新增数据连接类型 SAP 数据连接，在数据集中添加 SAP 数据集类型。
注：SAP 插件需要授权。
2. 环境准备
与 SAP 系统进行连接，需要导入 SAP 接口包和本地库，并确保运行的 JVM 能够找到接口包和本地库，下载地址为 SAP JAR 包和本地库，服务器和本地设计器导入的接口包和本地库有所区别，下面分别介绍。
注：下文中使用到的 SAP 的文件请到 SAP 官网下载，可以联系技术支持 QQ:800049425 协助下载。
2.1 Windows 系统服务器
报表工程部署在 Windows 系统的服务器下，以 Tomcat 为例。
注：首先报表工程里需要安装 SAP 插件。
| JDK 位数 | JDK 版本 | 文件包 | SAP 文件导入位置 |
|---|---|---|---|
| 32 | JDK1.6 及以上 | sapjco3_windows_32bit | sapjco3.jar 放在%TOMCAT_HOME%\lib路径下 sapjco3.dll 放在C:\Windows\System32路径下 |
| 64 |
注1：如果数据连接失败，可以尝试将 sapjco3.dll 文件放置在系统 jre 的 bin 目录下，例如：%JAVA_HOME%\jre\bin
注2：Windows Server 2003 和 Windows XP 的系统在连接 SAP 时，需要下载安装 Microsoft Visual C++ 2005 SP1。
32 位系统： Microsoft Visual C++ 2005 SP1 x86
64 位系统： Microsoft visual c++ 2005sp1_x64.rar
2.2 Mac OS 系统服务器
2.2.1 放置驱动文件
点击下载驱动：libsapjco3.rar，解压后可以将其放置在…/FineReport/lib下。
2.2.2 定义文件指向
打开设计器 bin 目录，右击designer，选择显示包内容，打开 vmoptions.txt 文件，如下图所示：
在文件中写入：-Djava.library.path=/Applications/FineReport10.0/lib（所放置的文件路径）
注：如果同时安装了 SAP 和 SAP BW 插件，可能会存在冲突导致有某一种数据集预览报错的问题。
2.3 Linux 系统服务器
报表工程部署在 Linux 系统的服务器下，以 Tomcat 为例。
注：首先报表工程里需要安装 SAP 插件。
| JDK 位数 | 文件包 | SAP 文件导入位置 |
|---|---|---|
| 32位 | sapjco3_linux_32bit | sapjco3.jar 放在%TOMCAT_HOME%\lib路径下 libsapjco3.so 放在%JAVA_HOME%\jre\bin路径下 libsapjco3.so 放在usr\lib文件夹下，若 Linux 为 64 位，放到usr\lib64路径下 |
| 64位 | sapjco3_linux_64bit | sapjco3.jar 放在%TOMCAT_HOME%\lib路径下 libsapjco3.so 放在%JAVA_HOME%\jre\bin路径下 libsapjco3.so 放在usr\lib64路径下 |
注：如果仍连接不了，看报错信息，例如验证 SAPJCO 失败，缺少依赖包 libstdc++.so「SAPJCO2 才需要，而 SAPJCO3 不需」，则需要安装共享库。
2.4 本地设计器
如果本地设计器用到 SAP 数据连接，根据安装的设计器位数，下载 Windows 系统下对应位数的 JDK1.6 版本的 SAP 文件包。
| 设计器位数 | 文件包 | SAP 文件导入位置 |
|---|---|---|
| 32位 | sapjco3_windows_32bit | sapjco3.jar 放在%FR_HOME%\lib路径下 |
| 64位 | sapjco3_windows_64bit | sapjco3.jar 放在%FR_HOME%\lib路径下 |
注：8.0 及之后的版本需要安装 SAP 插件，安装方法见 3.1。
3. SAP 数据连接
3.1安装 SAP 插件
安装插件 SAP 数据集，安装方法参考以下文档：
设计器插件安装方法参照 设计器插件管理
服务器安装插件方法参照 服务器插件管理
3.2 建立连接
选择服务器>定义数据连接，点击+按钮，选择 SAP，如下图所示：
局域网中已配置的 SAP 的主机名称，也可以写此机器的 IP 地址。注意：不是数据库服务器的主机名，而是 SAP 应用服务器的 IP。
SAP 系统中设置的属性，用于交互的端口号，一般来说是 00，具体根据 SAP 系统来定。
SAP 系统管理的业务和数据的最大有效集合，也是 SAP 系统的一个属性，具体根据 SAP 系统决定。
用户：连接 SAP 时使用的账号的用户名。注：不是数据库用户名，而是连接应用的 SAP 用户账号。
密码：连接 SAP 时使用的账号的密码。注：不是数据库密码，而是连接应用的 SAP 用户密码。
SAP 系统中的容量和最大连接数。
3.3 连接测试
点击测试连接，如果提示连接成功则成功完成 SAP 数据连接，点击确定退出数据连接设置面板。
连接成功之后就可以在服务器数据集、模板数据集等地方使用此数据连接，通过此数据连接从 SAP 系统中取数，详细请查看 SAP 数据集 。
上一篇：多维数据库