1. 概述
1.1 版本
| 报表服务器版本 | 字体管理插件 | 功能变更 |
|---|---|---|
| 11.0 | V1.0 | - |
| 11.0.20 | V1.1.4 | 1）设计器「模板>模板导出属性>通用>特殊字符导出优化」功能，合并到插件「导出支持字体>备用字体」功能 2）对于字体缺失、生僻字无法正常显示等情况，支持手动添加导出和预览模板所需的字体，支持启用备用字体 |
1.2 应用场景
服务器往往是缺少中文字体的，尤其是 Linux 服务器，缺少字体后预览/导出模板会出现乱码、斜线丢失等现象。
在服务器中使用语句安装字体操作较复杂，「字体管理」插件可降低安装字体的难度。
2. 插件安装
2.1 安装插件
字体管理插件下载请点击：字体管理插件
设计器插件安装方法请参见：设计器插件管理
服务器安装插件方法请参见：服务器插件管理
2.2 效果展示
管理员登录数据决策系统，点击「管理系统>字体管理」，支持对导出和预览的字体进行管理和添加。
注1：字体管理插件仅对普通报表生效，对决策报表、word报告插件、FVS 可视化看板不生效。
注2：通过「字体管理插件」安装的字体，仅对该工程生效，对Linux/Windows服务器中的其他工程/应用不生效。
3. 导出支持字体
3.1 使用逻辑
用户导出模板时，若模板使用了字体A，依次判断以下条件并执行：
| 判断 | 效果 |
|---|---|
| 判断工程所在服务器是否安装了字体A | 若已安装，则使用该字体导出 若未安装，进入下一步判断 |
| 判断「字体管理-导出支持字体-已安装字体」中是否包含字体A | 若包含，则使用该字体导出 若不包含，进入下一步判断 |
| 判断「字体管理-导出支持字体」是否开启备用字体 | 若已开启，则导出时提示字体缺失，使用第一个备用字体导出 若未开启，则导出时提示字体缺失，导出内容可能存在bug |
3.2 已安装字体
管理员登录数据决策系统，点击「管理系统>字体管理>导出支持字体」。
在「已安装字体」中，展示工程支持使用的全部字体，包括两种来源的字体。
1）系统字体库
来源为系统字体库的字体，包括工程所在服务器中已安装的字体，自动读取展示到列表中。
2）用户手动安装
| 序号 | 步骤 | 说明 |
|---|---|---|
| 1 | 准备资源 | 用户需要先在本地准备好字体文件，帆软不提供相关资源 仅支持格式为otf、ttf或ttc且不超过50M的字体文件 |
| 2 | 添加字体 | 在「管理系统>字体管理>导出支持字体>已安装字体」中，点击「添加字体」，选择准备好的字体文件，上传到工程 |
| 3 | 效果说明 | 上传成功后，在「导出支持字体-已安装字体」中出现该字体，无需重启，即时生效 该字体文件将上传至工程assets/fonts文件夹中 注1：在「预览支持字体-在线字体」中添加的字体，如格式为otf、ttf或ttc且不超过50M，也会被同时添加到「导出支持字体-已安装字体」中。 注2：字体管理插件仅对普通报表生效，对决策报表、word报告插件、FVS 可视化看板不生效。 注3：通过「字体管理插件」安装的字体，仅对该工程生效，对Linux/Windows服务器中的其他工程/应用不生效。 |
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，也会被同时添加到「预览支持字体-在线字体」中。注2：字体管理插件仅对普通报表生效，对决策报表、word报告插件、FVS 可视化看板不生效。 注3：通过「字体管理插件」安装的字体，仅对该工程生效，对Linux/Windows服务器中的其他工程/应用不生效。 |
4.3 备用字体
管理员登录数据决策系统，点击「管理系统>字体管理>预览支持字体」。
在「备用字体」中，支持是否「开启备用字体」，默认不开启。
1）支持添加 4.2 节已添加的在线字体，作为备用字体。
2）备用字体最多支持5个，可手动拖拽调整调用顺序。
3）支持删除手动添加的备用字体。
5. 错误代码
使用字体管理功能时，错误代码及含义如下表所示：
| 错误代码 | 介绍 |
|---|---|
| 21300002 | 上传文件失败，文件过大 |
| 21300003 | 上传文件失败，二进制头校验失败 |
| 21300012 | 上传文件失败，上传文件在目录中已存在 |
| 21300013 | 文件解析失败，请检查文件类型 |
