資源遷移

1.1 版本

1.2 應用場景

使用 FineReport 數據決策系統時，一般先在測試環境系統上進行開發部署，確認無誤後再遷移到正式系統中 。

FineReport 支援將報表檔案、資料連結、伺服器資料集和平台配置從測試系統增量遷移到正式系統 。

1.3 功能簡介

FineReport提供資源遷移功能，支援將報表檔案、資料連結、伺服器資料集和平台配置等資源從測試系統到正式系統的增量遷移 。

管理者登入FineReport系統，點選「管理系統>智慧維運>資源遷移」，分為「資源匯出」、「資源匯入」兩部分，如下圖所示：

• 資源匯出：將需要遷移到其他系統的資源從原FineReport系統中匯出，以供後續遷移 。

• 資源匯入：將需要遷移的資源在新FineReport系統中匯入，即遷移至新系統 。

1.4 注意事項

1）正式工程需購買「維運平台」功能點（曾用名「智慧維運」）才可使用「資源遷移」功能 。

2）FineReport工程的資源支援匯入FineReport工程，或FineBI6.X及以下版本的工程，不支援匯入FineBI7.0工程 。

3）請確定在資源遷移程式中，沒有其他人使用對應管理者帳號，否則部分執行請求可能被取消 。

4）不建議在個人 PC 端工程開發範本後，再以資源遷移的形式同步到公司工程 。

       因為個人 PC 端沒有管理者維護，經常會因為 JAR 包不同步或資源以及配置不同步的問題導致資源遷移失敗，維運成本會很高 。

5）單次資源匯入內容不可超出2GB，否則在匯入資源時會報錯：out of memoryerror。請少量多次分配匯出和匯入資源 。

6）資源遷移功能支援超級管理者和次級管理者。超級管理者需為對應次級管理者開通「智慧維運」和「智慧維運>資源遷移」的使用權限 。

• 次管在進行「資源匯出」時不支援「同時匯出權限配置」 。

• 若在資源遷移匯入後發現部分目錄名稱顯示為空白，此問題是由於匯出資源時勾選了「同時匯出超連結跳轉範本」，導致部分目錄結構資訊丟失，進而在匯入後顯示為空名稱 。

2.1 確認註冊維運平台功能點

資源遷移功能，依賴「維運平台」功能點 。

管理者分別登入資源遷出和遷入的工程，點選「管理系統>註冊管理>功能列表」 。

請確定工程已註冊功能點中包含「維運平台」功能點。如不包含該功能點，請聯絡帆軟銷售增購 。

注：對於未註冊工程，預設擁有該功能點，可跨越 。

2.2 確認FineReport工程版本

資源遷出和遷入的工程，必須保證主工程類型完全一致，即都必須是FineReport工程，不支援FineReport工程資源遷入FineBI7.0工程 。

資源遷出和遷入的工程，必須保證工程小版本號和 JAR 包時間完全一致，否則資源無法成功匯入 。

1）管理者分別登入資源遷出和遷入的工程，查看「管理系統>註冊管理>版本資訊」頁面 。

2）請確定兩個工程均只包含報表模組，不包含BI模組，請確定兩個工程的小版本號和 JAR 包時間完全一致 。

若版本不一致，可透過升級FineReport工程來確定版本一致。詳情請參見：FineReport版本升級簡介

注：在資源匯入時，若上傳資源對應的工程和當前工程版本不一致，則無法上傳 。

        提示「無法匯入，即將匯入的資源需要的工程版本：XXX。當前工程版本：XXX。請確定工程版本一致！」

2.3 確認外接配置庫字元集排序規則

對於資源遷出和遷入的工程，若對接了外接配置庫，外接配置庫的字元集排序規則應當保持一致，均為「大小寫敏感」。否則在資源遷移後，構建表索引時，不同表ID可能被收信確認為同一張表，進而被錯誤改寫。

配置庫的字元集排序規則的查看和修改步驟，請自行查閱對應資料庫說明文檔。（例如MySQL類型，應當設定為utf8mb3_bin，別稱utf8_bin）

管理者登入 FineReport 系統後，進入「管理系統>智慧維運>資源遷移」，即可進行「資源匯出」。

3.1 選擇匯出資源

選擇需要匯出的資源類型，選擇每種類型下需要匯出的具體內容，支援多選。支援匯出的各種資源如下表所示：

注：單次資源匯入內容不可超出2GB。因此請少量多次匯出資源。

3.2 選擇同時匯出的內容

支援同時匯出超連結跳轉範本和同時匯出權限配置。具體說明如下表所示：

3.3 匯出的檔案

匯出後會生成檔案到本機，檔案名稱預設為 resource.zip

4.1 匯入前須知

FineReport工程的資源支援匯入FineReport工程，或FineBI6.X及以下版本的工程，不支援匯入FineBI7.0工程。

4.2 確認插件和驅動

1）若資料連結需依賴第三方插件，目前只支援遷移 JSON 資料集和 Mysql8 資料連結，其他插件類型不適配，會匯入失敗。

2）權限匯出插件生成的伺服器資料集，不支援遷移，會匯入失敗。

3）資料連結遷移只遷移配置。驅動jar包、kerberos認證檔案、JNDI 配置檔案等都不會遷移，需要手動配置/放置。

請在進行資料連結遷移前，確認正式工程下是否提前安裝依賴的相關資料連結插件，否則將導致匯入失敗。

請在進行資料連結遷移前，確認正式工程下是否提前安裝依賴的相關資料連結驅動，否則將導致匯入的資料連結不可使用。

4.3 確認資料連結

若匯出的目錄範本依賴資料連結，請確定同時選中相關資料連結資源進行匯出匯入。否則請在資源遷移匯入前，保證正式系統已建立好了資料連結，且該資料連結名需與測試系統一致，否則資源無法遷移成功。

若遷移的是伺服器資料集建立的範本，則在遷移前需要保證正式系統上建立好相同名稱的伺服器資料集。

伺服器資料集若依賴相關資料連結，請確認將相關資料連結匯入正式工程，否則匯入的伺服器資料集無法使用。

4.4 遷移自訂地圖

若範本中呼叫了自訂地圖，需要將地圖 json 檔案copy到正式工程下。

在%FineReport%/webroot/WEB-INF/assets/map/image路徑下，將需要遷移的 json 檔案copy到正式工程對應路徑下。

4.5 系統備份

資源匯入前建議對測試系統和正式系統均進行 工程備份。

5.1 上傳檔案

管理者登入 FineReport 系統，選擇「管理系統>智慧維運>資源遷移>資源匯入」，點選「上傳檔案」，上傳匯出的壓縮檔案。

注1：資源匯入前建議進行 工程備份，其中備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。

注2：單次只允許上傳單個壓縮檔案。

注3：單次資源匯入內容不可超出2GB，否則在匯入資源時會報錯：out of memoryerror。請少量多次分配匯出和匯入資源。

上傳檔案成功後，系統會獲取匯入檔案所包含的資源，各資源類型的欄位說明如下。

5.2 匯入檔案

勾選需要匯入的資源，按「匯入」，按「確定」。

若匯入失敗，頁面顯示失敗原因；若匯入成功，則資源即時生效。不同資源類型的常見失敗原因如下：