FineReport 整合到 FineBI- FineBI帮助文档 FineBI帮助文档

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工程即可
可參考：FineReport 設計器遠端連結 FineBI 工程
已有一個FineBI工程（已有儀表板或平台配置）
希望增加FineReport相關功能
1）無需重新部署工程，FineBI工程本身就自帶FineReport相關JAR
2）license增購FineReport相關功能點
3）製作FineReport範本時，使用設計器遠端連結該FineBI工程即可
可參考：FineReport 設計器遠端連結 FineBI 工程
已有一個FineReport工程（已有範本，無平台配置）
希望增加FineBI相關功能
1）部署一個FineBI工程，其中會自帶FineReport相關JAR
2）按照本文執行
已有一個FineReport工程和一個FineBI工程（已有儀表板、範本和配置）
希望將這兩個工程整合到一個工程
完全按照本文執行
已有一個FineReport工程和一個FineBI工程（已有儀表板、範本和平台配置）
保留兩個工程，無需整合
但希望能統一門戶存取範本/儀表板
透過「多產品連結工具」插件，即可實現跨工程掛載範本
可參考：多產品連結工具插件

情況	方案說明
完全未部署希望部署一個包含FineBI和FineReport功能的工程	1）部署一個FineBI工程，其中會自帶FineReport相關JAR 2）註冊license時，選購FineReport相關功能點 3）製作FineReport範本時，使用設計器遠端連結該FineBI工程即可可參考：FineReport 設計器遠端連結 FineBI 工程
已有一個FineBI工程（已有儀表板或平台配置）希望增加FineReport相關功能	1）無需重新部署工程，FineBI工程本身就自帶FineReport相關JAR 2）license增購FineReport相關功能點 3）製作FineReport範本時，使用設計器遠端連結該FineBI工程即可可參考：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 裏的不替換