1. 概述
1.1 版本
| 报表服务器版本 | 多语言方案插件版本 | 新增功能 |
|---|---|---|
| 11.0 | V1.3 | - |
| 11.0 | V2.0.7 | 1）新增「导入当前模板所有i18n函数key」选项 2）设计器导入导出 excel 支持 xlsx 格式 3）平台导出 excel 的格式由 xls 类型更改为 xlsx 类型 |
| 11.0 | V2.0.8 | 1）导出文件名称支持国际化 2）浏览器 Tab 名称支持国际化 3）fvs 中的 i8n 公式适配国际化 |
1.2 应用场景
当企业中，不同部门所用语言不同时，为了避免分多个系统去满足各部门需求，需要实现一个系统，多语言展示的效果，如下图所示：
1.3 功能简介
FineReport 支持对数据决策系统的语言进行切换，切换范围包括以下两类：
本文将以一个简单的示例来演示如何切换数据决策系统的语言。
1.4 使用前提
安装多语言方案插件，详情请参考：插件安装
2. 示例
本节示例：
切换数据决策系统的语言为英文，切换范围包括管理系统、「测试」目录以及该目录下的子目录和子模板、平台标题、移动平台服务器名称。
实现思路：
设置「键-值」，将自定义的目录/模板名称、平台标题、移动平台服务器名称设置为 Key「键」，其对应的英文设置为「值」。
则在切换平台语言时，将一键切换管理系统的语言，并根据 Key 将自定义的名称切换为对应的英文。
2.1 准备工作
2.1.1 添加目录及模板
管理员登录数据决策系统，点击「管理系统>目录管理」，添加目录及模板，详情操作步骤请参考：添加目录
2.1.2 修改平台标题
管理员登录数据决策系统，点击「管理系统>外观配置>平台样式」，将平台标题修改为「决策平台」，如下图所示：
2.1.3 修改移动平台服务器名称
管理员登录数据决策系统，点击「管理系统>移动平台>APP配置」，设置服务器名称为「移动端」，如下图所示：
2.1.4 开启浏览器缓存禁用
注：若未开启「浏览器缓存禁用」，则无法实现管理系统的语言切换，详情请参考本文 3.3 节。
管理员登录数据决策系统，点击「管理系统>安全管理>安全防护」，开启「Security Headers 」功能。点击「高级设置」，即可开启「浏览器缓存禁用」。如下图所示：
2.2 添加「键-值」
管理员登录数据决策系统，点击「管理系统>语言配置」，点击「添加」按钮，在「Key」和「英语」的右侧文本框中输入值，如下图所示：
注1：Key 值不可为空，不可重复，至少填写一种语言翻译。
注2：FineReport 工程若之前迁移到 Oracle 、SQL Server，安装插件后如果添加 Key 值保存失败，可尝试下更换驱动版本，Oracle 更新到 ojdbc7 ，SQL Server 更新到 sqljdbc42.jar 。
「Key」和「英语」的右侧文本框中输入的值如下表所示：
注：若 Key 没有对应的国际化值，切换平台语言后显示 Key 原值；若 Key 存在对应的国际化值，切换平台语言后显示为国际化后的值。
| 类别 | Key | 英语 |
|---|---|---|
| 目录名称 | 测试 | test |
| 二级目录 | second-level directory | |
| 模板名称 | 行程管理 | Journey Management |
| 会议安排 | meeting arrangement | |
| 平台标题 | 决策平台 | Decision-making Platform |
| 移动平台服务器名称 | 移动端 | mobile terminal |
2.3 切换语言
点击「简体中文」按钮，在下拉框中选择「English」，即可切换系统语言为英文，如下图所示：
2.4 效果预览
1）管理系统的语言已切换为英文，且平台标题以英文显示，如下图所示：
2）点击「Directory」，可看到 .2 节添加的目录及模板名称以英文显示，如下图所示：
3）使用 数据分析 APP 登录数据决策系统，查看效果如下图所示：
服务器名称以英文「mobile terminal」显示
2.1.1 节添加的目录及模板名称以英文显示
3. 功能说明
3.1 语言配置
3.1.1 管理「键-值」
管理员身份登录决策系统，点击「管理系统>语言配置」即可进入国际化设置界面。
可在该页面内查看、新增、删除、修改、搜索、批量导入、批量导出、备份、还原备份「键-值」等操作。
注1：不支持搜索「备注」字段。
注2：「清空列表」按钮仅在选中全部 Key 时出现，可勾选「Key」字段实现一键全选。
3.1.2 批量导入「键-值」
1）新建一个 Excel 文件作为数据源，Excel 字段名必须满足格式，否则导入失败，Excel 示例表如下图所示：
2）在决策平台内点选「导入」，选择数据源，导入成功，如下图所示。
注：导入 Excel 时，2.0.7 之前的版本仅支持 xls 格式，2.0.7 及之后的版本支持 xls、xlsx 格式。
3.1.3 批量导出「键-值」
在「管理系统>语言配置」页面，点击「导出>导出Excel」，即可批量导出 Excel 文件，如下图所示：
3.1.4 备份还原
点击「备份」，出现「备份成功」提示，即可成功备份当前「键-值」。
点击「还原备份」，出现「恢复备份成功」提示，即可成功还原备份的「键-值」，如下图所示：
3.2 系统偏好语言
管理员登录决策系统，点击「管理系统>语言配置>更多配置」，即可进入系统语言偏好设置，如下图所示：
平台语言偏好：设置后，任意用户登入系统以当前设置语言展示，设置将在重启服务器后生效。
平台支持语种设置：系统支持切换的语言类型。
注1：支持简体中文、繁体中文、英文、日文、韩文。
注2：如需使用登入页语言切换功能，平台语言偏好需设置为「简体中文」。
3.3 管理系统国际化设置
管理员登录数据决策系统，点击「管理系统>安全管理>Security Headers>浏览器缓存禁用」，开启「浏览器缓存禁用」。
点击页面上方的「简体中文」按钮，选择「下拉框」内的语言，即可实现一键切换管理系统语言。
3.4 登录页国际化设置
在数据决策系统登录页面下方，可以选择登录页的语言，如下图所示：
注：如需使用登入页语言切换功能，平台语言偏好需设置为「简体中文」，详情请参考本文 3.2 节。
但开启登录页语言切换功能后，语言会跟随登录页的语言走，不再跟随上次用户保存的语言。
上一篇：模板多语言切换
