1. 概述
1.1 版本
| FineBI版本 | 多語言方案插件版本 | 功能變動 |
|---|---|---|
| 6.0.19 | V2.2.0 | - |
| 6.1 | V2.2.5 | 分析主題中Tab名稱支援多語言切換 分析主題匯出excel時，表資料、表頭、sheet名支援多語言 目錄支援直接搜尋譯文 |
1.2 應用場景
在企業中，如果遇到在不同場合下需要展示不同語言的儀表板內容時，為了減少製作成本和維護成本，需要實現同一張儀表板的多語言展示的效果，如下圖所示：
本文介紹如何在儀表板中設定範本國際化並實現範本的語言切換。
1.3 支援範圍
注1：支援範圍內的內容切換均需要在「管理系統>語言配置」中添加key及對應語言的翻譯，添加方法見下述 第2.5節。
在已添加key及對應語言的翻譯後，下述表格中標註了「fi18n[]」的部分說明文字內容需要透過fi18n[]函式實現多語言的切換，未標註的可自動讀取平台內的key實現語言切換。
注2：只有key全詞匹配的情況下才能夠被識別並實現多語言切換，詳情見下述 第1.4節。
| 分類 | 支援范圍 | 範例 |
|---|---|---|
| 元件 | 元件標題「fi18n[]」
| |
| 元件內容 | ||
| 表格 | 表格標題「fi18n[]」
| |
| 表头 | ||
| 表格內容 | ||
| 圖表 | 圖表標題「fi18n[]」
|
|
分類/系列名稱 圖例/指標名稱 坐標軸名稱 圖表標籤 圖表提示趨勢線名稱 警戒線名稱 | ||
| 其他 | 儀表板名稱 | |
| 組件名稱 | | |
| 匯出Excel | 表資料、表頭、sheet名支援多語言 注1：檔案名稱不支援多語言。 注2：分析主題全局匯出時，儀表板名稱不支援多語言，匯出後對應sheet名稱預設為「儀表板」。 | |
| 目錄 | 支援在目錄菜單中根據譯文搜尋儀表板 注1：目錄之外的搜尋框暫不支援搜尋譯文。 注2：只支援透過譯文進行搜尋，不支援原始正文搜尋。 | |
1.4 key匹配規則
1.4.1 通用規則
富文本中需使用fi18n[]函式的場景可參見1.3節中標註的場景，此處介紹不使用fi18n[]時的匹配規則：以列為單位，每列的key需要全詞匹配（包括符號和空格）才能夠被識別並實現轉換。
| 場景 | 規則 | 範例 |
|---|---|---|
| 文字 | 單列情況下 當列的文本內容需要為一個key（包括符號和空格） | 1）若已將「購買數量」錄入為key，則「購買數量」能被識別並轉換，「購買數量:」則不能被識別。
2）如果希望「購買數量:」能被識別的話，需要將「購買數量:」作為一個key錄入
|
多列的情況下 每列識別為單獨的key | 換列的情況下，「購買數量」能被識別
| |
文字 + 資料欄 | 若當列富文本內容中存在資料欄，則將以資料欄作為分割，資料欄前後的文本可以被單獨識別為key，例如：key1資料欄key2，則key1、key2均可以被識別。同樣，key1、key2需滿足全詞匹配（包括符號和空格）。 | 若已將「購買數量:」和「（個）」錄入為key，則「購買數量:+資料欄+（個）」中，「購買數量:」和「（個）」均能夠被識別。
|
1.4.2 例外情況
圖表提示中，適配了key1:key2的場景，如果key之間使用:進行了分割並緊貼:（不能有空格），則可以key1、key2均可以被識別。
除:外的其他符號同1.4.1節中的規則一致。
1.5 使用前提
點選連結獲取插件：點選下載
插件安裝方法請參見：插件管理
2. 範例
本文以製作「合同分析看板」為例，資料下載：CONTRACT.xlsx 。
2.1 添加資料
下載上述Excel並添加進公共資料中，如下圖所示：
2.2 添加表格
將「合同類型、合同付款類型、合同ID」拖入維度，將「總金額」拖入指標，如下圖所示：
2.3 添加圖表
2.3.1 添加柱形圖
1）選擇「分隔槽柱形圖」，將「合同類型」拖入橫軸，將「總金額」拖入縱軸。
2）添加標籤與提示。
3）添加警戒線。
2.3.2 添加折線圖
1）選擇「分隔槽折線圖」，將「合同簽約時間」拖入橫軸，將「記錄數」拖入縱軸。
2）添加趨勢線。
2.4 製作儀表板
1）將製作好的表格和圖表拖入儀表板，並修改組件標題。
同理，將其餘組件標題均修改為 fi18n[組件標題] 格式。
2）添加「其他>文字組件」作為儀表板標題，內容設定為：2011-2017 fi18n[合同分析看板]，如下圖所示：
3）添加「過濾組件>文字下拉」對合同類型進行過濾，標題設定為：fi18n[合同類型]，如下圖所示：
4）同理，添加「過濾組件>年月區間」對合同簽約進行過濾，如下圖所示：
2.5 添加多語言Key
點選「管理系統>語言配置」，匯入「整體中文-英文」對應的Key。如下圖所示：
Excel下載：language.xlsx
匯入成功後可在決策平台中看到所有key，並進行添加、刪除、修改等操作：
3. 效果展示
點擊頁面右上角語言切換按鈕進行多語言切換，如下圖所示：
