平台多語言切換

1.1 版本

1.2 應用場景

在企业中，不同部门使用不同语言时，为了避免使用多个系统来满足各部门的需求，需要实现一个系统并具备多语言展示的效果。不仅包括切换数据决策系统平台的界面语言，还需要切换平台的目录名称、平台标题以及移动平台服务器等。

1.3 功能簡介

FineReport 支援對數據決策系統的語言進行切換，切換範圍包括以下兩類：

• 支援一鍵切換：管理系統、登入頁 。

• 支援透過「鍵-值」切換：系統中可自訂名稱的部分，如：平台目錄名稱、平台標題、行動平台伺服器名稱等。

不支持模板内容的多语言切换，如需实现模板语言切换请参考 模板多语言切换 。

只支持「简体中文、繁体中文、英文、日文、韩文」5 种语言的切换，如需实现其他语言的切换请参考 多语言插件新增小语种 。

本文將以一個簡單的範例來示範如何切換數據決策系統的語言。

1.4 使用前提

安装多语言方案插件，点击下载插件：多语言方案。

设计器插件安装方法请参见： 設計器插件管理。

本節範例：
切換數據決策系統的語言為英文，切換範圍包括管理系統、「測試」目錄以及該目錄下的子目錄和子範本、平台標題、行動平台伺服器名稱。
實現思路：
設定「鍵-值」，將自訂的目錄/範本名稱、平台標題、行動平台伺服器名稱設定為 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 存在對應的國際化值，切換平台語言後顯示為國際化後的值。

2.3 切換語言

點選「簡體中文」按鈕，在下拉框中選擇「English」，即可切換系統語言為英文，如下圖所示：

2.4 效果預覽

1）管理系統的語言已切換為英文，且平台標題以英文顯示，如下圖所示：

2）點選「Directory」，可看到 .2 節新增的目錄及範本名稱以英文顯示，如下圖所示：

3）使用 資料分析 APP 登入數據決策系統，查看效果如下圖所示：

• 伺服器名稱以英文「mobile terminal」顯示

• 2.1.1 節新增的目錄及範本名稱以英文顯示

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 檔案，如下圖所示：

V2.3.12及之後版本支援匯出搜尋後的資料：

• 搜尋後不選擇任何資料，匯出全量搜尋資料

• 如果有選中資料，匯出選中資料

• 全選時，匯出當前頁全選資料

3.1.5 備份還原

點選「備份」，出現「備份成功」提示，即可成功備份當前「鍵-值」。
點選「還原備份」，出現「恢複備份成功」提示，即可成功還原備份的「鍵-值」，如下圖所示：

3.2 系統偏好語言

管理者登入決策系統，點選「管理系統>語言配置>更多配置」，即可進入系統語言偏好設定，如下圖所示：

• 平台語言偏好：設定後，任意使用者登入系統以當前設定語言展示，設定將在重啟伺服器後生效。

• 平台支援語種設定：系統支援切換的語言型別。

注1：支援簡體中文、繁體中文、英文、日文、韓文。
注2：如需使用登入頁語言切換功能，平台語言偏好需設定為「正體中文」。

3.3 管理系統國際化設定

管理者登入數據決策系統，點選「管理系統>安全管理>Security Headers>瀏覽器快取禁用」，開啟「瀏覽器快取禁用」。

點選頁面上方的「繁體中文」按鈕，選擇「下拉框」內的語言，即可實現一鍵切換管理系統語言。

3.4 登入頁國際化設定

在數據決策系統登入頁面下方，可以選擇登入頁的語言，如下圖所示：

注1：如需使用登录页语言切换功能，平台语言偏好需设置为「简体中文」，详情请参考本文 3.2 节。

         但开启登录页语言切换功能后，语言会跟随登录页的语言走，不再跟随上次用户保存的语言。

注2：对于 FineBI 系统，如需使用登录页语言切换功能，在在「管理系统>外观配置>登录页>登录风格」中，必须选择「小窗口」风格 。