1. 概述
1.1 版本
| 報表伺服器版本 | 字體管理插件 | 功能變更 |
|---|---|---|
| 11.0 | V1.0 | - |
| 11.0.20 | V1.1.4 | 1）產品預設內建該插件，預設安裝 2）設計器「範本>範本匯出屬性>通用>特殊字元匯出優化」功能，合併到插件「匯出支援字體>備用字體」功能 3）對於字體缺失、生僻字無法正常顯示等情況，支援手動新增匯出和預覽範本所需的字體，支援啟用備用字體 |
1.2 應用場景
伺服器往往是缺少中文字體的，尤其是 Linux 伺服器，缺少字體後預覽/匯出範本會出現亂碼、斜線丟失等現象。
在伺服器中使用語句安裝字體操作較複雜，「字體管理」插件可降低安裝字體的難度。
2. 插件安裝
2.1 安装插件
11.0.20 及之後版本，產品預設內建該插件。
字體管理插件下載請點選：字體管理插件
設計器插件安裝方法請參見：設計器插件管理
伺服器安裝插件方法請參見：伺服器插件管理
2.2 效果展示
管理者登入數據決策系統，點選「管理系統>字型管理」，支援對匯出和預覽的字體進行管理和新增。
注1：字體管理插件僅對普通報表生效，對決策報表、大屏報表不生效。
注2：透過「字體管理插件」安裝的字體，僅對該工程生效，對Linux/Windows伺服器中的其他工程/應用不生效。
3. 匯出支援字體
3.1 使用邏輯
使用者匯出範本時，若範本使用了字體A，依次判斷以下條件並執行：
| 判斷 | 效果 |
|---|---|
| 判斷工程所在伺服器是否安裝了字體A | 若已安裝，則使用該字體匯出 若未安裝，進入下一步判斷 |
| 判斷「字型管理-匯出支援字體-已安裝字體」中是否包含字體A | 若包含，則使用該字體匯出 若不包含，進入下一步判斷 |
| 判斷「字型管理-匯出支援字體」是否開啟備用字體 | 若已開啟，則匯出時提示字體缺失，使用第一個備用字體匯出 若未開啟，則匯出時提示字體缺失，匯出內容可能存在bug |
3.2 已安裝字體
管理者登入數據決策系統，點選「管理系統>字型管理>匯出支援字體」。
在「已安裝字體」中，展示工程支援使用的全部字體，包括兩種來源的字體。
1）系統字體庫
來源為系統字體庫的字體，包括工程所在伺服器中已安裝的字體，自動讀取展示到列表中。
2）使用者手動安裝
| 序號 | 步驟 | 說明 |
|---|---|---|
| 1 | 準備資源 | 使用者需要先在本地準備好字體檔案，帆軟不提供相關資源 僅支援格式為otf、ttf或ttc且不超過50M的字體檔案 |
| 2 | 新增字體 | 在「管理系統>字型管理>匯出支援字體>已安裝字體」中，點選「新增字體」，選擇準備好的字體檔案，上傳到工程 |
| 3 | 效果說明 | 上傳成功後，在「匯出支援字體-已安裝字體」中出現該字體，無需重啟，即時生效 該字體檔案將上傳至工程assets/fonts資料夾中 該字體僅對該工程生效，對伺服器中的其他工程/應用不生效 注：在「預覽支援字體-線上字體」中新增的字體，如格式為otf、ttf或ttc且不超過50M，也會被同時新增到「匯出支援字體-已安裝字體」中。 |
3.3 備用字體
管理者登入數據決策系統，點選「管理系統>字型管理>匯出支援字體」。
在「備用字體」中，支援是否「開啟備用字體」，預設開啟。
1）預設提供一個內建字體Noto Sans CJK SC，作為備用字體。
2）支援新增 3.2 節已安裝字體，作為備用字體。
3）備用字體最多支援5個，可手動拖曳調整呼叫順序。
4）支援刪除手動新增的備用字體，不支援刪除內建備用字體Noto Sans CJK SC。
5）11.0.19 之前版本，該功能由「範本>範本匯出屬性>通用>特殊字元匯出優化」提供。
4. 預覽支援字體
4.1 使用邏輯
使用者預覽範本時，若範本使用了字體A，依次判斷以下條件並執行：
| 判斷 | 效果 |
|---|---|
| 判斷使用者預覽時所用的電腦裝置是否安裝了字體A | 若已安裝，則使用該字體預覽 若未安裝，進入下一步判斷 |
| 判斷「字體管理-預覽支援字體-線上字體」中是否包含字體A | 若包含，則使用該字體預覽 若不包含，進入下一步判斷 |
| 判斷「字體管理-預覽支援字體」是否開啟備用字體 | 若已開啟備用字體且存在備用字體，則預覽時提示字體缺失，使用第一個備用字體預覽 若已開啟備用字體但不存在備用字體，則預覽時提示字體缺失，預覽內容可能存在bug 若未開啟備用字體，則預覽時提示字體缺失，預覽內容可能存在bug |
4.2 線上字體
支援將線上字體下載安裝到伺服器中，方便使用者預覽範本時呼叫。
| 序號 | 步驟 | 說明 |
|---|---|---|
| 1 | 準備資源 | 使用者需要先準備好一個線上字體的下載連結，帆軟不提供相關資源 僅支援格式為otf、ttf或ttc且不超過50M的字體檔案 |
| 2 | 新增字體 | 在「管理系統>字型管理>預覽支援字體>線上字體」中，點選「新增字體」，輸入線上字體連結，點選「確定」 |
| 3 | 效果說明 | 該字體檔案將下載至工程assets/fonts資料夾中 在「預覽支援字體>線上字體」中出現該字體，無需重啟，即時生效 在「匯出支援字體-已安裝字體」中出現該字體，無需重啟，即時生效 該字體僅對該工程生效，對伺服器中的其他工程/應用不生效 注：在「匯出支援字體-已安裝字體」中手動新增的字體，如格式為otf、ttf或ttc且不超過50M，也會被同時新增到「預覽支援字體-線上字體」中。 |
4.3 備用字體
管理者登入數據決策系統，點選「管理系統>字型管理>預覽支援字體」。
在「備用字體」中，支援是否「開啟備用字體」，預設不開啟。
1）支援新增 4.2 節已新增的線上字體，作為備用字體。
2）備用字體最多支援5個，可手動拖曳調整呼叫順序。
3）支援刪除手動新增的備用字體。
5. 錯誤代碼
使用字體管理功能時，錯誤代碼及含義如下表所示：
| 錯誤代碼 | 介紹 |
|---|---|
| 21300002 | 上傳檔案失敗，檔案過大 |
| 21300003 | 上傳檔案失敗，二進制頭校驗失敗 |
| 21300012 | 上傳檔案失敗，上傳檔案在目錄中已存在 |
| 21300013 | 檔案解析失敗，請檢查檔案型別 |
