概述
本文詳細講解 FineBI6.0 各個小版本之間升級的注意事項和相容說明。
6.0.18
1）取消內建FineDataLink
FineBI6.0.18 版本開始，不再內建 FineDataLink 相關功能依賴的 JAR 包 。
建議升級到FineBI6.0.18及以上版本後，如需使用FineDataLink，請獨立部署 。
2）取消內建 postgresql 相關驅動
FineBI6.0.18 版本開始，fine-bi-engine-third-6.0.jar 中移除 postgresql 相關驅動
使用者如需使用相關資料連結（postgresql、華為DWS等），必須確定已透過驅動管理手動上傳相關驅動
6.0.17
1）內建 FineDataLink4.1 版本 JAR 包
FineBI6.0.17版本，內建 FineDataLink4.1 版本 JAR 包。
| 升級前 | 升級注意事項 |
|---|---|
| FineBI未整合FineDataLink | 1）參考 6.0.5之後的版本升級 正常升級FineBI即可 2）升級後產品內建 FineDataLink4.1 模組，如原本註冊 license 不包含 FineDataLink 相關功能點，則 FineDataLink 功能顯示為未註冊狀態，如需使用可聯絡銷售增購 |
| FineBI整合FineDataLink4.1版本 | 1）手動刪除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目錄下 fdl-xxx.jar 包 2）再參考 6.0.5之後的版本升級 正常升級 FineBI 3）升級後產品內建 FineDataLink4.1 模塊，可正常使用 |
| FineBI整合FineDataLink4.0版本 | 注意事項 1）無法保留 FineDataLink4.0 版本，必須升級至 FineDataLink4.1 版本 2）FineDataLink 4.1 版本功能點註冊與 4.0 不相容 升級後如不再使用 FineDataLink 功能，無需重新註冊 升級後如需繼續使用 FineDataLink 功能，需要重新生成 license 進行註冊，請提前聯絡商務溝通 升級步驟 1）手動刪除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目錄下 fdl-xxx.jar 包 2）再參考 6.0.5之後的版本升級 正常升級 FineBI 3）根據商務指導，參考 伺服器註冊方式 重新註冊 |
2）適配插件版本更新
| 插件 | 說明 |
|---|---|
| FineBI For Excel | 升級至FineBI6.0.17版本後，FineBI For Excel插件需要升級至V7.0.16版本 付費使用者請聯絡帆軟技術支援獲取對應版本插件。技術支援聯絡方式：帆軟官方服務渠道使用説明 注意事項：插件更新後，需要重啟FineBI工程，方可生效 |
6.0.16
1）伺服器資料集class檔案更換
相容說明：
從6.0.15及以下版本升級至6.0.16及以上版本，建議手動更換伺服器資料集class檔案。
本次更換，可確定後續任意升級無需手動更換class檔案，即可使用最新「BI系統配置資料集」
操作步驟：
點選下載並解壓：6016+.zip
將其改寫更新至工程%BI_HOME%/webroot/WEB-INF/classes/com/fr/log資料夾下
2）適配插件版本更新
| 插件 | 說明 |
|---|---|
| FineBI For Excel | 升級至FineBI6.0.16版本後，FineBI For Excel插件需要升級至V7.0.15版本 付費使用者請聯絡帆軟技術支援獲取對應版本插件。技術支援聯絡方式：帆軟官方服務渠道使用説明 注意事項：插件更新後，需要重啟FineBI工程，方可生效 |
6.0.15
1）伺服器資料集class檔案更換
相容說明：
從6.0.14及以下版本升級至6.0.15版本，需要手動更換以下伺服器資料集class檔案，方可使用最新「BI系統配置資料集」
操作步驟：
點選下載並解壓：6015class.zip
將其改寫更新至工程%BI_HOME%/webroot/WEB-INF/classes/com/fr/log資料夾下
2）適配插件版本更新
| 插件 | 說明 |
|---|---|
| HTML5行動端展現 | 升級至FineBI6.0.15版本後，HTML5行動端展現插件需要升級至V11.0.88版本 否則儀表板組件組，在行動端無法有效展示 |
| FineBI For Excel | 升級至FineBI6.0.15版本後，FineBI For Excel插件需要升級至V7.0.14版本 付費使用者請聯絡帆軟技術支援獲取對應版本插件。技術支援聯絡方式：帆軟官方服務渠道使用説明 注意事項：插件更新後，需要重啟FineBI工程，方可生效 |
6.0.14
1）伺服器資料集class檔案更換
相容說明：
從6.0.13及以下版本升級至6.0.14版本，需要手動更換以下伺服器資料集class檔案，方可使用最新「BI系統配置資料集」
操作步驟：
點選下載並解壓：6013+.zip
將其改寫更新至工程%BI_HOME%/webroot/WEB-INF/classes/com/fr/log資料夾下
2）適配插件版本更新
| 插件 | 說明 |
|---|---|
| BI明細表匯出CSV | 升級至FineBI6.0.14版本後，BI明細表匯出CSV插件需要升級至最新版本 付費使用者請聯絡帆軟技術支援獲取對應版本插件。技術支援聯絡方式：帆軟官方服務渠道使用説明 |
6.0.13
1）適配FineDataLink版本更新
對於FineBI整合FineDataLink的工程，如需升級FineBI至6.0.13版本，需要升級FineDataLink至4.0.28.1版本
付費使用者請聯絡帆軟技術支援獲取對應版本JAR包。技術支援聯絡方式：服務平台>線上支援
2）DEF_ADD函式邏輯調整
歷史版本，合計-自動計算時，使用當前檢視表中所有維度，收起時則再次對計算結果再次進行合計
6.0.13版本，合計-自動計算時，使用當前合計檢視表所使用到的連接維度
3）伺服器資料集class檔案更換
相容說明：
從6.0.12及以下版本升級至6.0.13版本，需要手動更換以下伺服器資料集class檔案，方可使用最新「BI系統配置資料集」
操作步驟：
點選下載並解壓：2023.08.30-6013+.zip
將其改寫更新至工程%BI_HOME%/webroot/WEB-INF/classes/com/fr/log資料夾下
4）適配插件版本更新
| 插件 | 說明 |
|---|---|
| FineBI For Excel | 升級至FineBI6.0.15版本後，FineBI For Excel插件需要升級至V7.0.13版本 付費使用者請聯絡帆軟技術支援獲取對應版本插件。技術支援聯絡方式：帆軟官方服務渠道使用説明 注意事項：插件更新後，需要重啟FineBI工程，方可生效 |
6.0.12
1）取消內建FineDataLink
FineBI6.0.12 版本開始，不再內建 FineDataLink 相關功能依賴的 JAR 包。
| 類型 | 說明 |
|---|---|
| 全新安裝 | 不再內建 FineDataLink 相關功能 如需整合使用 FineDataLink，請聯絡技術支援獲取 FineDataLink 相關的 JAR 包 |
| 低版本升級 | FineBI6.0.11 及以下版本、整合 FineDataLink 功能的工程 如需升級到 6.0.12 及以上版本，需要依次升級 FineBI 和 FineDataLink 相關的 JAR，才能正常使用 請在聯絡技術支援獲取最新 JAR 包時，表明自己需要 FineBI 和 FineDataLink 的 JAR |
2）新增血緣層級限制
FineBI6.0.12及之後版本，限制資料表的 血緣層級 最高為 16 。
全新制作的資料表，不可超過最高層級限制。
歷史製作的、超過層級深度限制的表，仍可使用其製作組件、儀表板。
歷史製作的、超過層級深度限制的表，不可使用其製作更深層級的子表，建議優化父表血緣層級。
3）伺服器資料集class檔案更換
相容說明：
從6.0.11及以下版本升級至6.0.12版本，需要手動更換以下伺服器資料集class檔案，方可使用最新「BI系統配置資料集」
操作步驟：
點選下載並解壓：log-2023.07.06.zip
將其改寫更新至工程%BI_HOME%/webroot/WEB-INF/classes/com/fr/log資料夾下
4）適配插件版本更新
| 插件 | 說明 |
|---|---|
| HTML5行動端展現 | 升級至FineBI6.0.12版本後，HTML5行動端展現插件需要升級至V11.0.83版本 |
6.0.11
1）遮蔽自助資料集歷史步驟複製貼上功能
6.0.11版本遮蔽了自助資料集歷史步驟的複製貼上功能入口
下個版本修複相關隱患後即會重新開put 命令口
2）解決叢集啟動慢問題
6.0.11版本支援解決叢集啟動慢問題。
管理者需要手動刪除temp目錄下spark快取bitmap檔案，再啟動工程即可。
3）weblogic部署FineBI整合FineDataLink暫緩升級
weblogic環境部署FineBI工程，如整合FineDataLink，普通使用者登入工程出現異常報錯。
對於不使用FineDataLink的工程，請手動刪除%Tomcat_HOME%/webapps/webroot/WEB-INF/lib目錄下 fdl-xxx.jar 包
對於使用FineDataLink的工程，請暫緩升級，建議直升6.0.17版本
6.0.10
1）WebLogic環境衝突
問題描述：
6.0.10 版本新增參數安全校驗，因此改動了 cbb JAR 包，部分工程升級後，工程所用的weblogic容器中的JAR包與改動衝突。
如存在JAR包衝突，會導致工程啟動失敗或部分功能不可用，工程日誌中有相關報錯關鍵詞「validation」/「validator」
解決方案一：
1）在/webroot/WEB-INF目錄下尋找weblogic.xml，如果不存在該檔案，建立即可。
2）在weblogic.xml檔案中配置過濾，優先使用應用內建jar包。
3）儲存檔案後，重啟工程生效。
點選下載並解壓，獲取範例檔案：weblogic.zip
解決方案二：
1）下載javax.validation.jar：javax.validation.jar
2）上傳並改寫/weblogic/Oracle/Middleware/oracle common/modules目錄下的低版本javax.validation.jar。
2）WebSphere環境衝突
問題描述：
11.0.16 版本新增參數安全校驗，因此改動了 cbb JAR 包，部分工程升級後，工程所用的WebSphere容器中的JAR包與改動衝突。
如存在JAR包衝突，會導致工程啟動失敗或部分功能不可用，工程日誌中有相關報錯關鍵詞「validation」/「validator」
解決方案：
1）下載javax.j2ee.validation.jar：javax.j2ee.validation.jar
2）上傳並改寫%WebSphereHome%/AppServer/plugins目錄下的javax.j2ee.validation.jar。
6.0.9
無
6.0.8
1）分析主題模型相容
6.0.8 分析主題新增模型功能。一個主題只存在一個模型，這個模型對應主題內的所有資料和組件。
分析主題內 所有組件的 待分析區域配置 都會 複製到主題模型 上，使用者使用該表/模型聯動的多表製作其他組件可重複使用，提高製作效率。
分析主題內 相同表製作組件 的 待分析區域配置 會被複制到主題上，相同的配置會進行相容。相容詳情如下所示：
注1：模型裏同一張表製作的組件才會進行欄位合併。
注2：欄位相容不會影響分析區域已新增的欄位。
若使用鑽取目錄製作組件，鑽取目錄中的非首目錄欄位未在分析區域設定顯示名，可能分析區域中鑽取目錄欄位會出現 XX-1， XX-2 的欄位名。
| 組件待分析區域配置 | 相容說明（複製並整合到主題上的配置項會同步到所有組件中） |
|---|---|
鑽取目錄 | 前提：當前主題內相同表製作的多個組件（組件1、組件2都使用表1製作） 1）待分析區域鑽取目錄完全相同，則將鑽取目錄整合並保留
2）若鑽取目錄不完全相同，則將這些鑽取目錄用到的欄位複製，然後整合並保留
3）當同一個欄位有的組件不在鑽取目錄，有的組件在鑽取目錄時，如果是第一個鑽取欄位會進行復制，其他的欄位只保留一個
|
複製的欄位 | 1）多個組件的待分析區域欄位複製並整合到主題上 2）滿足以下條件只保留一個：複製的欄位名稱和配置完全相同 |
計算欄位 | 1）多個組件的待分析區域欄位複製並整合到主題上 2）欄位完全相同只保留一個 |
參數 | 1）多個組件的待分析區域欄位複製並整合到模型上 2）滿足以下條件只保留一個：
|
維度轉指標 指標轉維度 | 同「計算欄位」 |
地理角色-指標 地理角色-維度 | 同「計算欄位」 |
明細過濾 | 多個組件的待分析區域欄位複製並整合到模型上 滿足以下條件只保留一個：
|
記錄數 | 1）多個組件的待分析區域欄位複製並整合到模型上 2）組件1用表1製作有記錄數，設定明細過濾條件A 組件2用表1製作有記錄數，設定明細過濾條件B 升級後都會保留，結果為：記錄數、記錄數-1 |
指標名稱 | 保留 |
6.0.7
無
6.0.6
無
