1. 概述
1.1 版本
| 報表伺服器版本 | 多語言方案插件版本 | 新增功能 |
|---|---|---|
| 11.0 | V1.3 | - |
| 11.0 | V2.0.7 | 1）新增「匯入當前範本所有i18n函式key」選項 |
| 11.0 | V2.0.8 | 1）匯出檔案名稱稱支援國際化 |
1.2 應用場景
當企業中，不同部門所用語言不同時，為了避免分多個系統去滿足各部門需求，需要實現一個系統，多語言展示的效果，如下圖所示：
1.3 功能簡介
FineReport 支援對數據決策系統的語言進行切換，切換範圍包括以下兩類：
本文將以一個簡單的範例來示範如何切換數據決策系統的語言。
1.4 使用前提
安裝多語言方案插件，詳情請參考：插件安裝
2. 範例
本節範例：
切換數據決策系統的語言為英文，切換範圍包括管理系統、「測試」目錄以及該目錄下的子目錄和子範本、平台標題、行動平台伺服器名稱。
實現思路：
設定「鍵-值」，將自訂的目錄/範本名稱、平台標題、行動平台伺服器名稱設定為 Key「鍵」，其對應的英文設定為「值」。
則在切換平台語言時，將一鍵切換管理系統的語言，並根據 Key 將自訂的名稱切換為對應的英文。
2.1 準備工作
2.1.1 新增目錄及範本
管理者登入數據決策系統，點選「管理系統>目錄管理」，新增目錄及範本，詳情操作步驟請參考：新增目錄
2.1.2 修改平台標題
管理者登入數據決策系統，點選「管理系統>外觀配置>平台樣式」，將平台標題修改為「決策平台」，如下圖所示：
2.1.3 修改行動平台伺服器名稱
管理者登入數據決策系統，點選「管理系統>行動平台>APP配置」，設定伺服器名稱為「行動端」，如下圖所示：
2.1.4 開啟瀏覽器快取禁用
注：若未開啟「瀏覽器快取禁用」，則無法實現管理系統的語言切換，詳情請參考本文 3.3 節。
管理者登入數據決策系統，點選「管理系統>安全管理>安全防護」，開啟「Security Headers 」功能。點選「進階設定」，即可開啟「瀏覽器快取禁用」。如下圖所示：
2.2 新增「鍵-值」
管理者登入數據決策系統，點選「管理系統>語言配置」，點選「新增」按鈕，在「Key」和「英語」的右側正文框中輸入值，如下圖所示：
注1：Key 值不可為空，不可重複，至少填寫一種語言翻譯。
注2：FineReport 工程若之前遷移到 Oracle 、SQL Server，安裝插件後如果新增 Key 值儲存失敗，可嘗試下更換驅動版本，Oracle 更新到 ojdbc7 ，SQL Server 更新到 sqljdbc42.jar 。
「Key」和「英語」的右側正文框中輸入值如下表所示：
注：若 Key 沒有對應的國際化值，切換平台語言後顯示 Key 原值；若 Key 存在對應的國際化值，切換平台語言後顯示為國際化後的值。
| 類别 | Key | 英語 |
|---|---|---|
| 目錄名稱 | 測試 | test |
| 二級目錄 | second-level directory | |
| 範本名稱 | 行程管理 | Journey Management |
| 會議安排 | meeting arrangement | |
| 平台標題 | 決策平台 | Decision-making Platform |
| 行動平台伺服器名稱 | 行動端 | mobile terminal |
2.3 切換語言
點選「簡體中文」按鈕，在下拉框中選擇「English」，即可切換系統語言為英文，如下圖所示：
2.4 效果預覽
1）管理系統的語言已切換為英文，且平台標題以英文顯示，如下圖所示：
2）點選「Directory」，可看到 .2 節新增的目錄及範本名稱以英文顯示，如下圖所示：
3）使用 資料分析 APP 登入數據決策系統，查看效果如下圖所示：
伺服器名稱以英文「mobile terminal」顯示
2.1.1 節新增的目錄及範本名稱以英文顯示
3. 功能說明
3.1 語言配置
3.1.1 管理「鍵-值」
管理者身分登入決策系統，點選「管理系統>語言配置」即可進入國際化設定介面。
可在該頁面內查看、新增、刪除、修改、搜尋、批量匯入、批量匯出、備份、還原備份「鍵-值」等操作。
注1：不支援搜尋「備注」欄位。
注2：「清空列表」按鈕僅在選中全部 Key 時出現，可勾選「Key」欄位實現一鍵全選。
3.1.2 匯入內建key
該功能支援批量拉取所有系統內建的key，使用者可選擇直接翻譯或匯出EXCEL翻譯後匯入系統。
3.1.3 批量匯入「鍵-值」
1）建立一個 Excel 檔案作為資料源，Excel 欄位名必須滿足格式，否則匯入失敗，Excel 範例表如下圖所示：
2）在決策平台內點選「匯入」，選擇資料源，匯入成功，如下圖所示。
注：匯入 Excel 時，2.0.7 之前的版本僅支援 xls 格式，2.0.7 及之後的版本支援 xls、xlsx 格式。
3.1.4 批量匯出「鍵-值」
在「管理系統>語言配置」頁面，點選「匯出>匯出Excel」，即可批量匯出 Excel 檔案，如下圖所示：
3.1.5 備份還原
點選「備份」，出現「備份成功」提示，即可成功備份當前「鍵-值」。
點選「還原備份」，出現「恢複備份成功」提示，即可成功還原備份的「鍵-值」，如下圖所示：
3.2 系統偏好語言
管理者登入決策系統，點選「管理系統>語言配置>更多配置」，即可進入系統語言偏好設定，如下圖所示：
平台語言偏好：設定後，任意使用者登入系統以當前設定語言展示，設定將在重啟伺服器後生效。
平台支援語種設定：系統支援切換的語言型別。
注1：支援簡體中文、繁體中文、英文、日文、韓文。
注2：如需使用登入頁語言切換功能，平台語言偏好需設定為「正體中文」。
3.3 管理系統國際化設定
管理者登入數據決策系統，點選「管理系統>安全管理>Security Headers>瀏覽器快取禁用」，開啟「瀏覽器快取禁用」。
點選頁面上方的「繁體中文」按鈕，選擇「下拉框」內的語言，即可實現一鍵切換管理系統語言。
3.4 登入頁國際化設定
注：如需使用登入頁語言切換功能，平台語言偏好需設定為「簡體中文」，詳情請參考本文 3.2 節。
在數據決策系統登入頁面下方，可以選擇登入頁的語言，如下圖所示：
