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 功能簡介
本文介紹瞭如何在設計器和平台中設定範本國際化,如何透過工具欄元件、URL傳參、參數元件實現範本的語言切換,以及遇到需要前端展現的內容如何透過 JS 來實現語言的切換。
1.4 使用前提
點選連結獲取插件:點選下載
伺服器-設計器插件安裝方法請參見:伺服器-設計器插件管理
2. 設計器中設定範本國際化
範本國際化設定即對「鍵-值」的對應映射關系進行設定,設定內容僅對當前範本生效。
功能 | 説明 | 範例 |
---|---|---|
功能入口 | 點選「範本>範本國際化」即可進入國際化設定介面。 1)介面上有兩個 tab:
2)介面頂部有搜尋框:
| ![]() |
「鍵-值」設定 | 點選「+」按鈕,彈出「鍵-值」設定介面。
注:語言欄位中至少填寫一個語言的顯示內容才可以提交。 | ![]() |
2.0.7及之後的版本支援「匯入當前範本所有i18n函式key」 | ![]() | |
2.0.7及之後的版本,設計器匯入匯出 excel 新增 xlsx 格式:
| ![]() | |
範本語言設定 | 點選列表右上方的「![]() 1)範本語言設定可選擇「使用伺服器設定」或「為此範本設定」。
2)預設語言可選擇跟隨平台/瀏覽器語言或具體的語言內容。
| ![]() |
3. 決策平台中設定範本國際化
伺服器範本國際化設定即對「鍵-值」的對應關系進行設定,設定內容對當前伺服器上所有範本生效。
功能 | 說明 | 範例 |
---|---|---|
功能入口 | 1)以管理者身分登入決策系統,點選「管理系統>語言配置」即可進入國際化設定介面 2)介面頂部右側搜尋框支援對「鍵-值」內容進行關鍵詞搜尋,「備注」列不支援搜尋。 | ![]() |
「鍵-值」設定 | 點選「+」按鈕,彈出「鍵-值」設定介面。 1)「鍵」中輸入用於呼叫的物件,可自訂任意值,「備注」中輸入對當前鍵的解譯說明,各語言欄位中輸入不同語言下當前鍵的顯示內容。
2)「鍵-值」列表還支援批量匯入、匯出。 注:語言欄位中至少填寫一個語言的顯示內容才可以提交。 | ![]() |
範本語言設定 | 點選菜單欄「伺服器伺服器>範本語言設定」,進入設定介面。 可自訂預設語言和備用語言: 1)預設語言可選擇跟隨平台/瀏覽器語言或具體的語言內容。 2)選擇跟隨平台/瀏覽器語言時:
| ![]() |
瀏覽器Tab名稱切換 | 將範本名稱(需要完全匹配)設定為 Key,需要展示的名稱設定為值。 注1:多語言插件 2.0.8 版本新增支援瀏覽器 Tab 名稱設定。 | 例如:範本名稱為line-chart,預覽後希望瀏覽器 Tab 顯示為自訂的折線圖: 預覽後,可以看到Tab名稱為折線圖: |
匯出檔案名稱切換 | 平台設定好「鍵-值」後,匯出檔案時,檔案名稱支援多語言切換 注1:多語言插件 2.0.8 版本新增支援匯出檔案名稱國際化。 | ![]() |
4. 範本語言切換方式匯總
方法 | 說明 | 範例 |
---|---|---|
方法一: 工具欄元件 | 點選「範本>範本Web屬性」,進入「分頁預覽設定」或「填報頁面設定」或「資料分析設定」頁面: 1)選擇「為該範本單獨設定」後,可自訂工具欄中的元件。 2)雙擊「範本語言」元件,即可新增到當前範本的工具欄中。 2)範本語言元件支援自訂元件圖示和元件名,以及是否顯示圖示和名稱。 4)設定完成後,預覽範本,點選頂部工具欄中該元件即可選擇需要切換的語言。 | ![]() |
方法二: URL傳遞參數 | 預覽範本後,在URL後加上&fr_locale=,輸入對應語言的值即可切換語言:
| ![]() |
方法三: 參數元件 | 1)新增一個名為fr_locale的範本參數或全局參數。 2)在範本參數面板中生成參數fr_locale,設定參數元件為下拉框元件。 3)給元件設定資料字典,類型設定為「自訂」,加入需要的語言選項,實際值需對應為 zh_CN、zh_TW、en_US、ja_JP、ko_KR。 4)參數元件的顯示值固定,無法設定為多語言切換。 注:此方式僅對查詢後的內容生效,查詢前載入的(如:工具欄、其他元件文字等)不生效。 | ![]() |
方法四: 前端展現 | 當在範本中遇到需要前端展現正文的時候,譬如:提示、彈窗等,儲存格公式I18N()對前端展現的正文則不生效,此時可以透過事件去實現前端正文的多語言展示。 透過前端函式FR.i18nText()傳回對應語言的文字,方便在前端工具欄、事件中,進行文字的國際化key呼叫。 | 這裏以超連結為範例,其他可以新增事件的地方方法均相同。 1)新增一個 JavaScript 腳本事件,輸入JS代碼: var a = FR.i18nText('水洗溫度不超過30攝氏度!');//此處正文需在【範本國際化】中設定鍵-值FR.showDialog("Details",600,400,a); var a = FR.i18nText('排名第一');//此處正文需在【範本國際化】中設定鍵-值FR.showDialog("Details",600,400,a); 2)儲存範本,點選預覽: |
5. 範本多語言切換範例
場景 | 文檔連結 |
---|---|
單範本多語言切換 | 範本多語言切換--單範本語言切換 |
多範本多語言切換 | 範本多語言切換-多範本語言切換 |