1. 概述编辑
1.1 应用场景
在实际使用过程中存在需要将 FineReport 工程集成到 FineBI 数据决策系统上使用的情况。
将 FineReport 集成到 FineBI ，可以将这两个软件合并成一个整体的系统，应用服务只需维护一套。
FineReport 集成到 FineBI 后，统一 FineBI 和 FineReport 的用户、权限体系、门户以及管理系统，用户登录时只需要登录一个平台。
1.2 方案选择
请根据你的实际情况，选择适合的集成方案。
| 情况 | 方案说明 |
|---|---|
完全未部署 希望部署一个包含FineBI和FineReport功能的工程 | 1）部署一个FineBI工程，其中会自带FineReport相关JAR 2）注册license时，选购FineReport相关功能点 3）制作FineReport模板时，使用设计器远程连接该FineBI工程即可 |
已有一个FineBI工程（已有仪表板或平台配置） 希望增加FineReport相关功能 | 1）无需重新部署工程，FineBI工程本身就自带FineReport相关JAR 2）license增购FineReport相关功能点 3）制作FineReport模板时，使用设计器远程连接该FineBI工程即可 |
已有一个FineReport工程（已有模板，无平台配置） 希望增加FineBI相关功能 | 1）部署一个FineBI工程，其中会自带FineReport相关JAR 2）按照本文执行 |
| 已有一个FineReport工程和一个FineBI工程（已有仪表板、模板和配置） 希望将这两个工程整合到一个工程 | 完全按照本文执行 |
已有一个FineReport工程和一个FineBI工程（已有仪表板、模板和平台配置） 保留两个工程，无需集成 但希望能统一门户访问模板/仪表板 | 通过「多产品连接工具」插件，即可实现跨工程挂载模板 可参考：多产品连接工具插件 |
2. 准备步骤编辑
2.1 确认服务器配置
请根据工程访问量和数据量，对FineBI工程的内存、CPU、磁盘等配置进行增加，确保集成后的工程可正常运行。
详情请参见：确认FineBI项目服务器配置
2.2 确认工程版本一致
请确保FineBI与FineReport版本完全一致，且版本兼容。
1）确认FineBI各模块版本兼容
管理员登录FineBI系统，点击「管理系统>注册管理>版本信息」。
查看报表模块和BI模块版本，对照 FineBI 与 FineReport 版本适配说明 ，确认版本是否兼容
2）确认FineBI与FineReport版本一致
管理员登录FineReport系统，点击「管理系统>注册管理>版本信息」。
查看FineReport的报表模块版本，与上一步FineBI的报表模块版本对比，确认完全一致，请精确到JAR包。
如版本不一致，请对其中一个工程进行升级/回退处理，务必确保一致，否则无法集成。
小版本升级指南请参考：FineReport工程小版本升级指南 、非容器化FineBI6.0.x小版本升级指南
2.3 确定工程配置库情况
配置库，即finedb，本文方案仅能保留其中一个工程的配置库。
请分别登录FineBI和FineReport工程，点击「管理系统>系统管理>常规」，检查外接数据库是否已配置。
已配置：点击「已配置」，记录该工程的外接数据库位置信息。
未配置：说明工程未配置外接数据库。（对于正式工程，建议管理员为其配置外接数据库，工程使用更加稳定，详情请参见：配置外接数据库）
请提前思考，需要保留哪一个工程的配置库，下文拷贝文件时需要按选择拷贝文件
建议对外接数据库进行备份，防止出现任何意外情况
2.4 资源导出
上一步考虑好保留哪个工程配置后，对于另一工程的配置，如果仍然非常希望保留
可通过 资源迁移 先导出相关数据连接、服务器数据集、目录等内容，在集成后再资源导入。
注：该步骤不能完全保证一定保留另一个工程配置，只能尽可能的降低集成后的工程配置难度
3. 工程集成编辑
3.1 关闭工程
请参考「关闭或重启FineBI工程」文档，关闭FineReport和FineBI工程
3.2 拷贝文件
请将FineReport工程中相关文件，拷贝到FineBI工程中同位置。
如有相同文件，一般建议保留FineBI文件不覆盖。
| 工程文件 | 说明 |
|---|---|
| /webroot/WEB-INF/lib | 作用：工程原有/外部引入的JAR包，提供工程所有基础功能，是工程的关键文件 是否必须拷贝：必须拷贝 如有相同文件，请务必保留FineBI文件不覆盖 |
| /webroot/WEB-INF/plugins | 作用：插件相关文件 是否必须拷贝：必须拷贝，如不拷贝会影响插件相关功能的实现 如有相同文件，请务必保留FineBI文件不覆盖。 |
| /webroot/WEB-INF/reportlets | 作用：FineReport模板存放目录 是否必须拷贝：必须拷贝，如不拷贝会导致工程所有模板丢失 如有相同文件，请务必逐一判断或在reportlets下为模板新建目录存放 |
| /webroot/WEB-INF/resources | 作用：保存了报表信息、配置信息 是否必须拷贝：用户自行决定 请务必不要拷贝该目录下的FanRuan.lic文件到FineBI工程 跨工程拷贝lic文件，会导致新老工程都可能无法使用该lic 授权如需迁移，请在工程集成完毕后再进行 |
| /webroot/WEB-INF/schedule | 作用：定时调度生成的文件 是否必须拷贝：用户自行决定 如果不拷贝，定时任务挂载到决策平台的结果报表无法访问 |
| /webroot/WEB-INF/classes | 作用：工程调用的默认和自定义class文件 是否必须拷贝：必须拷贝 有可能存在自定义的class文件，如不拷贝会影响工程正常使用 |
| /webroot/WEB-INF/assets/temp_attach | 作用：读写缓存存储路径 是否必须拷贝：必须拷贝 该文件夹中存放着工程读写（图片）缓存，不拷贝可能会导致FR模板设置的背景图片预览为空 |
| /webroot/WEB-INF/assets/vcs | 作用：FineReport模板备份文件 是否必须拷贝：用户自行决定 如果工程不需要回退历史开发的FineReport模板，则无需拷贝 |
| /webroot/WEB-INF/assets/其他文件 | 作用：通用的共享持久化目录 是否必须拷贝：必须拷贝 工程正常运行所需要的文件，如不拷贝会影响工程正常使用 |
| /webroot/backup | 作用：工程历史备份文件 是否必须拷贝：用户自行决定，可存储在原始的目录下备份，可不拷贝 |
| /webroot/help | 作用：工程自定义内容 是否必须拷贝：必须拷贝 该文件夹中存放着自定义地图、自定义函数、定制css、定制js等文件，不拷贝会导致模板预览出现异常 |
| /webroot/logs | 作用：swift日志 是否必须拷贝：用户自行决定 如果不拷贝，会丢失工程历史操作日志（即logdb），「管理系统>平台日志」功能无数据 如对历史使用情况无要求，无需拷贝 如有相同 JAR 包，保留原先 FineBI 里的不替换 |
| /webroot/WEB-INF/config | 作用：配置库相关文件 是否必须拷贝：按需选择！！！ 平台调用的外接配置库（finedb）的相关连接信息 无论是否拷贝，建议备份 如果希望仍然使用FineBI工程的配置库，请勿拷贝 如果希望使用原FineReport工程的配置库，请务必拷贝 |
| /webroot/WEB-INF/embed | 作用：存放着工程曾经/现在使用的内置finedb数据库 是否必须拷贝：按需选择！！！ 无论是否拷贝，建议备份 如果希望仍然使用FineBI工程的配置库，请勿拷贝 如果希望使用原FineReport工程的配置库，请务必拷贝 |
3.3 修改FineBI配置库
请参考「关闭或重启FineBI工程」文档，启动FineBI工程。
如果在上一步，选择保留了FineReport的配置库，并且配置库是外接的，请务必执行本节操作。
否则可能出现FineReport和FineBI共用一个配置库，导致工程异常的情况
1）新建空表空间
请在该外接数据库新建一个表空间，作为待迁移的空库。
2）迁移配置库
管理员登录FineBI工程，点击「管理系统>系统管理>常规>外接数据库」。
配置外接数据库为上一步的空表空间
勾选「迁移数据至要启用的数据库」
点击「启用新数据库」
当出现提示「已成功切换至目标数据库！」，则代表外接数据库切换成功。
3.4 资源迁移导入
如2.4节资源导出了相关配置，此时可以选择按需导入FineBI工程
3.5 授权迁移
如需要将FineReport工程的授权迁移到FineBI，由于需要增购FineBI相关功能点，请联系销售确认。
不可以直接将FineReport工程的授权lic放置到FineBI工程中