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工程的配置，如果仍然非常希望保留
可透過 資源遷移 先匯出相關資料連結、伺服器資料集、目錄等內容，在整合後再資源匯入。
注：該步驟不能完全保證一定保留FineReport工程配置，只能儘可能的降低整合後的工程配置難度
3. 工程整合
3.1 關閉工程
請參考「關閉或重啟FineBI工程」文檔，關閉FineReport和FineBI工程
3.2 copy檔案
請將FineReport工程中相關檔案，copy到FineBI工程中同位置。
如有相同檔案，一般建議保留FineBI檔案不改寫。
| 工程檔案 | 說明 |
|---|---|
| /webroot/WEB-INF/lib | 作用：工程原有/外部引入的JAR包，提供工程所有基礎功能，是工程的關鍵檔案 是否必須copy：必須copy 如有相同檔案，請務必保留FineBI檔案不改寫 |
| /webroot/WEB-INF/plugins | 作用：插件相關檔案 是否必須copy：必須copy，如不copy會影響插件相關功能的實現 如有相同檔案，請務必保留FineBI檔案不改寫。 |
| /webroot/WEB-INF/reportlets | 作用：FineReport範本存放目錄 是否必須copy：必須copy，如不copy會導致工程所有範本丟失 如有相同檔案，請務必逐一判斷或在reportlets下為範本建立目錄存放 |
| /webroot/WEB-INF/resources | 作用：儲存了報表資訊、配置信息 是否必須copy：使用者自行決定 請務必不要copy該目錄下的FanRuan.lic檔案到FineBI工程 跨工程copylic檔案，會導致新老工程都可能無法使用該lic 授權如需遷移，請在工程整合完畢後再進行 |
| /webroot/WEB-INF/schedule | 作用：排程管理生成的檔案 是否必須copy：使用者自行決定 如果不copy，定時任務掛載到決策平台的結果報表無法存取 |
| /webroot/WEB-INF/classes | 作用：工程呼叫的預設和自訂class檔案 是否必須copy：必須copy 有可能存在自訂的class檔案，如不copy會影響工程正常使用 |
| /webroot/WEB-INF/assets/temp_attach | 作用：讀寫快取儲存路徑 是否必須copy：必須copy 該資料夾中存放着工程讀寫（圖片）快取，不copy可能會導致FR範本設定的背景圖片預覽為空 |
| /webroot/WEB-INF/assets/vcs | 作用：FineReport範本備份檔案 是否必須copy：使用者自行決定 如果工程不需要回退歷史開發的FineReport範本，則無需copy |
| /webroot/WEB-INF/assets/其他檔案 | 作用：通用的共享持久化目錄 是否必須copy：必須copy 工程正常運作所需要的檔案，如不copy會影響工程正常使用 |
| /webroot/backup | 作用：工程歷史備份檔案 是否必須copy：使用者自行決定，可儲存在原始的目錄下備份，可不copy |
| /webroot/help | 作用：工程自訂內容 是否必須copy：必須copy 該資料夾中存放着自訂地圖、自訂函式、客製css、客製js等檔案，不copy會導致範本預覽出現異常 |
| /webroot/logs | 作用：swift日誌 是否必須copy：使用者自行決定 如果不copy，會丟失工程歷史操作日誌（即logdb），「管理系統>平台日誌」功能無資料 如對歷史使用情況無要求，無需copy 如有相同 JAR 包，保留原先 FineBI 裏的不替換 |
3.3 資源遷移匯入
如2.4節資源匯出了相關配置，此時可以選擇按需匯入FineBI工程
3.4 授權遷移
如需要將FineReport工程的授權遷移到FineBI，由於需要增購FineBI相關功能點，請聯絡銷售確認。
不可以直接將FineReport工程的授權lic放置到FineBI工程中
