1. 概述
1.1 版本
| 報表伺服器版本 | JAR包 | 插件版本 | 功能變更 |
|---|---|---|---|
| 11.0 | - | V1.0.0 | - |
| 11.0 | 2022-07-05 | V2.0.7 | 新增“匯入當前範本所有i18n函式key” 設計器匯入匯出excel支援xlsx 平台的匯出excel功能由匯出xls格式改成匯出xlsx格式 |
| 11.0 | 2022-07-05 | V2.0.8 | 瀏覽器新開的tab名稱支援國際化 fvs中的i8n公式適配國際化 匯出excel,pdf,word等預設檔案名稱支援國際化 |
1.2 應用場景
在企業中，如果遇到在不同場合下需要展示不同語言的範本內容時，為了減少多張範本的製作成本，降低多張範本的維護成本，需要實現一張範本，多語言展示的效果。透過安裝「多語言方案」插件可實現不同語系的報表使用者在查看報表時自行切換語言，如下圖所示：
1.3 注意事項
1）範本多語言切換依賴於I18N()函式，無法使用函式的地方無法實現語言切換。I18N()函式的支援範圍可參見：I18N函式 。
2）本文為範例，更多功能相關說明請參見：範本语言切換 。
3）範本語言切換不支援行動端，具體說明請參見：［App］系統語言。
2. 准备工作
2.1 插件安装
點選連結獲取插件：點選下載
伺服器-設計器插件安裝方法請參見：伺服器-設計器插件管理
2.2 语言确认
多語言插件內置「簡體中文、整體中文、英文、日文、韓文」5種語言，如需使用其他語言可參見：多語言插件新增小語種 。
如所需语言不包含在 多語言插件新增小語種 中支援的33种语言范围内，请联络技术支援进行沟通确认。
3. 範例
3.1範本設計
3.1.1 報表主體設計
本文以 GettingStartedTW.cpt 為例：
1）將儲存格內的文字修改成公式：I18N('文字')，如下圖所示：
2）將富文字內的文字修改成公式：I18N('文字')，如下圖所示：
3）拖入資料集欄位的儲存格設定顯示值，公式為：I18N($$$)，如下圖所示：
4）同理，將所有儲存格進行修改。
3.1.2 設定參數面板
1）編輯參數面板，拖入標籤元件，元件值選擇公式：I18N('地區')，如下圖所示：
2）下拉框元件名稱改為地區 ，預設值選擇公式：I18N('華東')。點選資料字典，將顯示值設定為公式 I18N($$$) ，如下圖所示：
3.1.3 添加多語言key
此處以正體中文-英文切換為例：
方法一：手動添加
點選「範本>範本國際化(i18n)」，點擊「+」，輸入對應的key，整體中文和英文翻譯，點擊「確定」：
注：語言欄位中至少填寫一個語言的顯示內容才可以提交。
方法二：匯入EXCEL
1）準備好範本內涉及的所有key以及對應的英文翻譯，如下圖所示：
範例下載：範本多語言範例.xlsx
2）點選「範本>範本國際化(i18n)」，點擊「匯入Excel」，選中上一步中準備好的翻譯文件，如下圖所示：
可以看到所有的key已經成功匯入範本，點擊「確定」即可。
3.2 工具欄添加多語言切換按鈕
範本語言切換方式具體可參見：範本語言切換 。本文以工具欄按鈕切換為例：
點選「範本>範本Web屬性>分頁預覽設定」，雙擊「範本語言」將其添加進工具欄，如下圖所示：
預覽後可以發現，工具欄新增「範本語言」按鈕，點擊即可進行語言切換：
3.3 效果預覽
儲存範本，點選分頁預覽，效果如 1.2 節所示。
注：不支援行動端。
5. 範本下載
點選下載範本：範本多語言範例.cpt
