反饋已提交

網絡繁忙

範本多語言切換

1. 概述

1.1 版本

報表伺服器版本多語言方案插件版本新增功能
11.0V1.3-
11.0V2.0.7

1)新增「匯入當前範本所有i18n函式key」選項

2)設計器匯入匯出 excel 支援 xlsx 格式

3)平台匯出 excel 的格式由 xls 類型更改為 xlsx 類型

11.0V2.0.8

1)匯出檔案名稱支援國際化

2)瀏覽器 Tab 名稱支援國際化

3)fvs 中的 i18n 公式適配國際化

11.0
V2.3.12

1)參數面板中標籤元件,按鈕元件,複選按鈕元件支援國際化

2)語言配置頁支援匯出搜尋資料

1.2 應用場景

在企業中,如果遇到在不同場合下需要展示不同語言的範本內容時,為了減少多張範本的製作成本,降低多張範本的維護成本,需要實現一張範本,多語言展示的效果。

如下圖所示:

16777404624m4A.gif


1.3 功能簡介

本文將介紹如何在設計器和平台中設定範本國際化,如何透過工具欄元件、URL傳參、參數元件實現範本的語言切換,以及遇到需要前端展現的內容如何透過 JS 來實現語言的切換。

1.4 使用前提

安裝多語言方案插件 ,詳情請參考:插件安装 。


2. 設計器中設定範本國際化

FVS 視覺化看板 不支援在設計器中對範本設定「鍵-值」,請參考第三章節在決策平台中設定

2.1 參數面板設定

V2.3.12 及之後的版本,參數面板中標籤元件,按鈕元件,複選按鈕元件支援國際化,其他元件不支援。

元件
支援範圍設定方式
標籤元件

元件值

  • 字串:i18n(元件值)

  • 公式:i18n(公式)


  • 欄位:不支援

1)選中元件,右鍵,選擇「國際化參數面板」,如下圖所示:

2)使用快捷鍵:Ctrl + I

3)點選「元件設定 > 國際化參數面板」,如下圖所示:

按鈕元件

按鈕名稱:

複選按鈕元件

正文:

2.2 設定介面入口

範本國際化設定即對「鍵-值」的對應映射關係進行設定,設定內容僅對當前範本生效。

點選「範本>範本國際化」即可進入國際化設定介面。

介面上有兩個 tab,範本 tab 支援對「鍵-值」的對應關係進行新增、刪除、修改、查看,伺服器 tab 僅支援查看。

介面頂部搜尋框支援對當前介面中的範本tab和伺服器tab下的「鍵-值」內容進行關鍵詞搜尋,「描述」列不支援搜尋。


2.3 「鍵-值」設定

注:鍵與值的內容必須不同,否則可能會出現顯示為當前語言下的譯文的問題。

點選「+」按鈕,彈出「鍵-值」設定介面。

「鍵」中輸入用於公式呼叫的物件,可輸入任意值,「描述」中輸入對當前鍵的解譯說明,各語言欄位中輸入不同語言下當前鍵的顯示內容。

注:語言欄位中至少填寫一個語言的顯示內容才可以提交。

點選「」按鈕,可對當前「鍵-值」設定進行修改。

點選對應「鍵-值」行後的「」按鈕可刪除單個「鍵-值」設定。

選中「鍵-值」行前的複選框後,點選列表頂部的「」按鈕可刪除多個「鍵-值」設定。

1.gif

注:2.0.7 及之後的版本支援「匯入當前範本所有 i18n函式 key 」,如下圖所示:

2.gif

注:2.0.7及之後的版本,設計器匯入匯出 excel 新增 xlsx 格式,如下圖所示:

匯出 excel 檔案的預設格式為 xls 格式,手動改成 xlsx 後即可匯出 xlsx 格式檔案。

匯入 xlsx 類型的 excel 檔案與匯入 xls 類型的 excel 檔案效果一致。如下圖所示:

注:匯出時當 key 與非中文譯文相同時,預設取工程語言對應的譯文。

3.gif


2.4 範本語言設定

點選列表右上方的「」按鈕,進入範本語言設定介面,設定內容僅對該範本生效。

範本語言設定可選擇「使用伺服器設定」或「為此範本設定」。

使用伺服器設定即預設語言和備用語言選項置灰,不能修改。

為此範本設定可自訂預設語言和備用語言。

預設語言可選擇跟隨平台/瀏覽器語言或具體的語言內容。

  • 選擇跟隨平台/瀏覽器語言時,若平台和瀏覽器語言不一致時,範本預設語言為平台語言。

  • 選擇跟隨平台/瀏覽器語言時,若瀏覽器語言不包含於所支援的語言範圍內,則範本語言為備用語言。

4.gif


3. 決策平台中設定範本國際化

注:FVS 視覺化看板需要將 FVS 插件升級至 V1.11.1 及之後的版本,且多語言插件需為 2.0.8 及之後版本。

3.1 設定介面入口

伺服器範本國際化設定即對「鍵-值」的對應關係進行設定,設定內容對當前伺服器上所有範本生效。

以管理者身分登入決策系統,點選「管理系統>語言配置」即可進入國際化設定介面。

介面頂部右側搜尋框支援對「鍵-值」內容進行關鍵詞搜尋,「備註」列不支援搜尋。

「顯示欄位」可切換當前「鍵-值」列表顯示的語言欄。

5.gif

3.2 「鍵-值」設定

注:鍵與值的內容必須不同,否則可能會出現顯示為當前語言下的譯文的問題。

點選「+」按鈕,彈出「鍵-值」設定介面。

「鍵」中輸入用於呼叫的物件,可自訂任意值,「備註」中輸入對當前鍵的解譯說明,各語言欄位中輸入不同語言下當前鍵的顯示內容。

注:語言欄位中至少填寫一個語言的顯示內容才可以提交。

點選「」按鈕,可對當前「鍵-值」設定進行修改。

點選對應「鍵-值」行後的「」按鈕可刪除單個「鍵-值」設定。

選中「鍵-值」行前的複選框後,點選列表頂部的「」按鈕可刪除多個「鍵-值」設定。

「鍵-值」列表還支援批量匯入、匯出。

6.gif


3.3 伺服器範本語言設定

點選菜單欄「伺服器>國際化管理」,進入設定介面。

可自訂預設語言和備用語言。

預設語言可選擇跟隨平台/瀏覽器語言或具體的語言內容。

  • 選擇跟隨平台/瀏覽器語言時,若平台和瀏覽器語言不一致時,範本預設語言為平台語言。

  • 選擇跟隨平台/瀏覽器語言時,若瀏覽器語言不包含於所支援的語言範圍內,則範本語言為備用語言。

3.4 瀏覽器Tab名稱國際化

注1:多語言插件 2.0.8 版本新增支援瀏覽器 Tab 名稱設定。

注2:如果是 FVS 範本,需要將 FVS 插件升級至 1.11.1 及以上的版本。

將範本名稱(需要完全匹配)設定為 Key,需要展示的名稱設定為值。

例如:範本名稱為line-chart,預覽後希望瀏覽器 Tab 顯示為自訂的折線圖

預覽後,可以看到 Tab 名稱為折線圖


3.5 匯出檔案名稱國際化

注1:多語言插件 2.0.8 版本新增支援匯出檔案名稱國際化。

注2:名稱國際化支援的匯出檔案類型為:excel、pdf、word。

注3:如果是透過__filename__ 參數指定了檔案名稱,則名稱不會進行國際化轉換。

根據 3.4 節在平台設定好「鍵-值」後,匯出檔案時,檔案名稱支援國際化。如下圖所示:


3.6 fvs中的i18n公式適配國際化

注:多語言插件 2.0.8 版本新增支援 fvs 中的 i18n 公式國際化。

根據 3.4 節在平台設定好「鍵-值」後,在 fvs 中設定公式i18n('line-chart'),顯示為“折線圖”。如下圖所示:


4. 範本語言切換

4.1 方法一:工具欄元件

  • 點選「範本>範本Web屬性」,進入「分頁預覽設定」或「填報頁面設定」或「資料分析設定」頁面。

  • 選擇「為該範本單獨設定」後,可自訂工具欄中的元件。

  • 雙擊「範本語言」元件,即可新增到當前範本的工具欄中。

範本語言元件支援自訂元件圖示和元件名,以及是否顯示圖示和名稱。

設定完成後,預覽範本,點選頂部工具欄中該元件即可選擇需要切換的語言,效果如下圖所示。

7.gif

4.2 方法二:URL傳遞參數

預覽範本後,在URL後加上&fr_locale=,輸入對應語言的值即可切換語言,效果如下圖所示。

注:「簡體中文」對應「zh_CN」,繁體中文」對應「zh_TW」,「英文」對應「en_US」,「日文」對應「ja_JP」,「韓文」對應「ko_KR」。

8.gif


4.3 方法三:參數元件

注:此方式僅對查詢後的內容生效,查詢前載入的(如:工具欄、其他元件文字等)不生效。

新增一個名為fr_locale的範本參數或全局參數。

在範本參數面板中生成參數fr_locale,設定參數元件為下拉框元件。

給元件設定資料字典,類型設定為「自訂」,加入需要的語言選項,實際值需對應為 zh_CN、zh_TW、en_US、ja_JP、ko_KR。

參數元件的顯示值固定,無法設定為多語言切換。

9.gif

4.4 方法四:前端展現

當在範本中遇到需要前端展現正文的時候,譬如:提示、彈窗等,儲存格公式i18N()對前端展現的正文則不生效,此時可以透過事件去實現前端正文的多語言展示。

透過前端函式FR.i18nText()傳回對應語言的文字,方便在前端工具欄、事件中,進行文字的國際化 key 呼叫。

這裏以超連結為範例,其他可以新增事件的地方方法均相同。

新增一個 JavaScript 腳本事件,輸入 JS 程式碼,儲存範本,點選預覽。

JS 程式碼如下:

var a = FR.i18nText('水洗溫度不超過30攝氏度!');//此處正文需在【範本國際化】中設定鍵-值FR.showDialog("Details",600,400,a);
var a = FR.i18nText('排名第一');//此處正文需在【範本國際化】中設定鍵-值FR.showDialog("Details",600,400,a);

5. 範本國際化範例

5.1 資料準備

點選下載範例檔案:範例.xlsx

1)準備一個有不同語言的 Excel 檔案,給檔案加上一個「語言」欄位,在欄位中輸入對應語言的值,如:zh_CN、zh_TW、en_US、ja_JP、ko_KR。

2)在範本中建立 Excel 資料集,匯入剛剛準備好的 Excel 檔案。

5.2 製作報表-設定資料

  • 將資料集中的欄位拖入 A2:E2 儲存格中,並給 A2:E2 儲存格設定置中且加上表格內外框。

  • 選中 A2 儲存格,雙擊進入資料欄設定介面,點選「過濾」。

  • 設定資料過濾,根據語言參數的值展示對應語言的資料。

  • 設定「語言」欄位「等於」參數「fr_locale」,點選「+增加」生成過濾條件。

此時若當前瀏覽器語言為繁體中文,則只展示繁體中文的資料。

5.3 設定列表標題多語言

  • 點選「範本>範本國際化」進入國際化設定介面。

  • 點選「+」按鈕,新增「鍵-值」對應關係,在設定介面輸入鍵名稱和不同語言的顯示。

  • 完成設定後點選「確定」。

5.4 製作報表-插入多語言標題

  • 在 A1:E1 儲存格中插入列表標題,並給 A1:E1 儲存格設定置中且加上表格內外框。

  • 標題使用公式,選擇「插入公式」,輸入i18n("鍵")即可。

  • 標題全部設定完成後,若當前瀏覽器語言為繁體中文,則標題內容顯示為繁體。

5.5 設定語言切換

  • 點選「範本>範本Web屬性」,進入「分頁預覽設定」介面。

  • 選擇「為該範本單獨設定」後,可自訂工具欄中的元件。

  • 雙擊「範本語言」元件,即可新增到當前範本的工具欄中。

完成設定後點選「確定」,點選預覽,在瀏覽器中查看效果,切換語言後,報表工具欄、標題、資料均展示為對應語言的內容,效果如下圖所示。


6. 範本下載

點選下載範本:多語言方案.cpt


附件列表


主題: 設計器安裝與升級
已經是第一篇
已經是最後一篇
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉

獲取幫助
線上支援
獲取專業技術支援,快速幫助您解決問題
工作日9:00-12:00,13:30-17:30在线
頁面反饋
針對當前網頁的建議、問題反饋
售前咨詢
業務咨詢
電話:0933-790886或 0989-092892
郵箱:taiwan@fanruan.com
頁面反饋
*問題分類
不能為空
問題描述
0/1000
不能為空

反馈已提交

网络繁忙