反饋已提交

網絡繁忙

範本多语言切換

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 中的 i8n 公式適配國際化

1.2 應用場景

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

36.gif

1.3 功能簡介

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

1.4 使用前提

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

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

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

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

功能説明範例
功能入口點選「範本>範本國際化」即可進入國際化設定介面。

1)介面上有兩個 tab:

  • 範本 tab 支援對「鍵-值」的對應關系進行新增、刪除、修改、查看

  • 伺服器 tab 僅支援查看

2)介面頂部有搜尋框:

  • 支援對當前介面中的範本tab和伺服器tab下的「鍵-值」內容進行關鍵詞搜尋

  • 「描述」列不支援搜尋

「鍵-值」設定點選「+」按鈕,彈出「鍵-值」設定介面
  • 「鍵」中輸入用於公式呼叫的物件,可輸入任意值,「描述」中輸入對當前鍵的解譯說明,各語言欄位中輸入不同語言下當前鍵的顯示內容。

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

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

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

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

2.2-1.gif
2.0.7及之後的版本支援「匯入當前範本所有i18n函式key」2.2-2.gif

2.0.7及之後的版本,設計器匯入匯出 excel 新增 xlsx 格式:

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

  • 匯入 xlsx 型別的 excel 檔案與匯入 xls 型別的 excel 檔案效果一緻。

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

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

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

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

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

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

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

2.3.gif

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

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

功能
說明範例
功能入口

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

2)介面頂部右側搜尋框支援對「鍵-值」內容進行關鍵詞搜尋,「備注」列不支援搜尋。
3)「顯示欄位」可切換當前「鍵-值」列表顯示的語言欄。

3.1.gif
「鍵-值」設定點選「+」按鈕,彈出「鍵-值」設定介面。
1)「鍵」中輸入用於呼叫的物件,可自訂任意值,「備注」中輸入對當前鍵的解譯說明,各語言欄位中輸入不同語言下當前鍵的顯示內容。
  • 點選「」按鈕,可對當前「鍵-值」設定進行修改。

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

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

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

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

3.2.gif
範本語言設定點選菜單欄「伺服器伺服器>範本語言設定」,進入設定介面。

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

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

2)選擇跟隨平台/瀏覽器語言時:

  • 若平台和瀏覽器語言不一緻時,範本預設語言為平台語言。

  • 若瀏覽器語言不包含於所支援的語言範圍內,則範本語言為備用語言。

瀏覽器Tab名稱切換將範本名稱(需要完全匹配)設定為 Key,需要展示的名稱設定為值。

注1:多語言插件 2.0.8 版本新增支援瀏覽器 Tab 名稱設定。
注2:如果是 FVS 範本,需要將 FVS 插件升級至 1.11.1 及以上的版本。

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

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

 匯出檔案名稱切換平台設定好「鍵-值」後,匯出檔案時,檔案名稱支援多語言切換

注1:多語言插件 2.0.8 版本新增支援匯出檔案名稱稱國際化。
注2:名稱國際化支援的匯出檔案類型為:excel、pdf、word。
注3:如果是透過__filename__ 參數指定了檔案名稱稱,則不做國際化處理等檔案支援國際化。

4. 範本語言切換方式匯總

方法
說明範例

方法一:

工具欄元件

點選「範本>範本Web屬性」,進入「分頁預覽設定」或「填報頁面設定」或「資料分析設定」頁面:
1)選擇「為該範本單獨設定」後,可自訂工具欄中的元件。
2)雙擊「範本語言」元件,即可新增到當前範本的工具欄中。
2)範本語言元件支援自訂元件圖示和元件名,以及是否顯示圖示和名稱。
4)設定完成後,預覽範本,點選頂部工具欄中該元件即可選擇需要切換的語言。
4.1.gif

方法二:

URL傳遞參數

預覽範本後,在URL後加上&fr_locale=,輸入對應語言的值即可切換語言:
  • 「簡體中文」對應「zh_CN」

  • 繁體中文」對應「zh_TW」

  • 「英文」對應「en_US」

  • 「日文」對應「ja_JP」

  • 「韓文」對應「ko_KR」

4.2.gif

方法三:

參數元件

1)新增一個名為fr_locale的範本參數或全局參數。
2)在範本參數面板中生成參數fr_locale,設定參數元件為下拉框元件。
3)給元件設定資料字典,類型設定為「自訂」,加入需要的語言選項,實際值需對應為 zh_CN、zh_TW、en_US、ja_JP、ko_KR。

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

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

4.3.gif

方法四:

前端展現

當在範本中遇到需要前端展現正文的時候,譬如:提示、彈窗等,儲存格公式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)儲存範本,點選預覽:

4.4.gif

5. 範本多語言切換範例

場景
文檔連結
單範本多語言切換範本多語言切換--單範本語言切換
多範本多語言切換範本多語言切換-多範本語言切換


附件列表


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

文 檔回 饋

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

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

不再提示

10s後關閉