1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
| 11.0.6 | 1）新增次級管理者支援「資源遷移」功能 2）超管進行「資源匯出」時「同時匯出權限配置」變更為預設不勾選 |
1.2 應用場景
使用 FineReport 數據決策系統時，一般先在測試環境系統上進行開發部署，確認無誤後再遷移到正式系統中。
FineReport 支援將「伺服器資料集」從測試系統增量遷移到正式系統。
1.3 功能簡介
超管登入數據決策系統，點選「管理系統>智慧維運>資源遷移」，分為「資源匯出」、「資源匯入」兩部分。
本文僅介紹遷移資源類型為「伺服器資料集」時的操作方法。
1.4 注意事項
1）資源遷移功能僅支援超級管理者，次級管理者。
2）次管在進行「資源匯出」時不支援「同時匯出權限配置」。
3）正式工程需購買「智慧維運」功能點才可使用「資源遷移」功能。
4）請確定在資源遷移程式中，沒有其他人使用超級管理者帳號，否則部分執行請求可能被取消。
5）不建議在個人 PC 端工程開發範本後，再以資源遷移的形式同步到公司工程。
因為個人 PC 端沒有管理者維護，經常會因為 JAR 包不同步或資源以及配置不同步的問題導致資源遷移失敗，維運成本會很高。
6）單次資源匯入內容不可超出2GB，否則在匯入資源時會報錯：out of memoryerror。請少量多次分配匯出和匯入資源 。
2. 準備工作
2.1 確認版本
資源遷移之前，請確定資源匯入和匯出的 FineReport 工程使用的版本一致（包括 JAR 包時間）。
管理者可在「管理系統>註冊管理>報表模組」下查看 JAR 包時間，如下圖所示：
若版本不一致，可透過升級來確定版本一致。
注：在資源匯入時，若上傳資源對應的工程和當前工程版本不一致，則無法上傳。
提示：無法匯入，即將匯入的資源需要的工程版本：XXX。當前工程版本：XXX。請確定工程版本一致！
2.2 系統備份
資源匯入前建議對測試系統和正式系統均進行 系統備份，如下圖所示：
注：備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。
2.3 確認插件和驅動
1）若伺服器資料集需依賴第三方插件，目前只支援 JSON 資料集和 Mysql8 資料連結，其他插件類型不適配，會匯入失敗。
2）權限匯出插件生成的伺服器資料集，不支援遷移，會匯入失敗。
3）伺服器資料集遷移只遷移配置。驅動jar包、kerberos認證檔案、JNDI 配置檔案等都不會遷移，需要手動配置/放置。
請在進行伺服器資料集遷移前，確認正式工程下是否提前安裝依賴的相關資料集插件，否則將導致匯入失敗。
請在進行伺服器資料集遷移前，確認正式工程下是否提前安裝依賴的相關驅動，否則將導致匯入的伺服器資料集不可使用。
2.4 確認資料連結
伺服器資料集若依賴相關資料連結，請確認將相關資料連結匯入正式工程，否則匯入的伺服器資料集無法使用。
資源遷移資料連結的操作請參見：資源遷移資料連結
3. 測試系統下資源匯出
超級管理者登入數據決策系統，選擇「管理系統>智慧維運>資源遷移>資源匯出」，如下圖所示：
| 設定 | 簡介 |
|---|---|
| 資源類型 | 資源類型為「伺服器資料集」，伺服器資料集列表可多選 匯出檔案到本地，檔案名稱預設為：resource.zip 支援匯出：SQL資料集、檔案資料集、樹資料集、JSON資料集、內建資料集、程式資料集、聯動資料集、儲存程式
若檔案資料集的資料集來源為URL，則只匯出配置，檔案不匯出 若檔案資料集的資料集來源為檔案，檔案路徑包含參數，則檔案不匯出
若匯出樹資料集時，未匯出依賴的原資料集，則匯入時可正常匯入但無法使用
若匯出聯動資料集時，未匯出依賴的原資料集，則匯入時可正常匯入但無法使用
權限匯出插件生成的伺服器資料集，不支援遷移，會匯入失敗
若伺服器資料集需依賴第三方插件，目前只支援 JSON 資料集和 Mysql8 資料連結，其他插件類型不適配，會匯入失敗 |
| 同時匯出超連結跳轉範本 | 遷移資源類型為「伺服器資料集」時，該選項不生效 |
| 同時匯出權限配置 | 遷移資源類型為「伺服器資料集」時，該選項不生效 |
4. 正式系統下資源匯入
4.1 上傳檔案
超級管理者登入數據決策系統，選擇「管理系統>智慧維運>資源遷移>資源匯入」，如下圖所示：
注1：資源匯入前建議進行 系統備份，其中備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。
注2：單次只允許上傳單個壓縮檔案。
注3：單次資源匯入內容不可超出2GB，否則在匯入資源時會報錯：out of memoryerror。請少量多次分配匯出和匯入資源 。
系統會獲取匯入檔案所包含的資源，包含類型、平台路徑、物理資源、權限資訊及匯入方式。
| 設定 | 說明 |
|---|---|
| 類型 | 伺服器資料集 |
| 平台路徑 | 平台路徑為「匯出系統」的伺服器資料集的名稱 |
| 物理資源 | 一般為空 如果匯入的伺服器資料集為檔案資料集，物理資源會顯示實體檔案路徑 |
| 權限資訊 | - |
| 匯入方式 | 在匯入時，系統會對資源進行檢查，檢查是否與系統現有資源有衝突。 衝突檢驗以資源的原始名與其在平台中的路徑名為準。 分為直接匯入和改寫匯入 直接匯入：與系統中已有資源沒有衝突，預設選中。 改寫匯入：與系統中已有資源有衝突，預設不選中且高亮，點選 |
| 衝突檢查 | 平台路徑：路徑衝突 物理資源：路徑衝突（僅限檔案資料集） |
4.2 匯入檔案
勾選需要上傳的資源，點選「匯入」，點選「確定」。
若匯入失敗，顯示失敗的原因（如：匯入不支援的插件類型資料連結或者匯入工程沒有安裝插件）；若匯入成功，則資源即時生效。如下圖所示：
