範例一：單範本語言切換

1.1 版本

1.2 應用場景

在企業中，如果遇到在不同場合下需要展示不同語言的範本內容時，為了減少多張範本的製作成本，降低多張範本的維護成本，需要實現一張範本，多語言展示的效果。透過安裝「多語言方案」插件可實現不同語系的報表使用者在查看報表時自行切換語言，如下圖所示：

1.3 注意事項

1）範本多語言切換依賴於I18N()函式，無法使用函式的地方無法實現語言切換。I18N()函式的支援範圍可參見：I18N函式 。

2）本文為範例，更多功能相關說明請參見：範本语言切換 。

3）範本語言切換不支援行動端，具體說明請參見：［App］系統語言。

2.1 插件安装

點選連結獲取插件：點選下載

伺服器-設計器插件安裝方法請參見：伺服器-設計器插件管理

2.2 语言确认

多語言插件內置「簡體中文、整體中文、英文、日文、韓文」5種語言，如需使用其他語言可參見：多語言插件新增小語種 。

如所需语言不包含在 多語言插件新增小語種 中支援的33种语言范围内，请联络技术支援进行沟通确认。

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 節所示。

注：不支援行動端。

點選下載範本：範本多語言範例.cpt