平台多语言切换

1.1 版本

1.2 应用场景

在企业中，不同部门使用不同语言时，为了避免使用多个系统来满足各部门的需求，需要实现一个系统并具备多语言展示的效果。不仅包括切换数据决策系统平台的界面语言，还需要切换平台的目录名称、平台标题以及移动平台服务器等。

1.3 功能简介

FineReport 支持对数据决策系统的语言进行切换，切换范围包括以下两类：

• 支持一键切换系统界面语言：管理系统、登录页 。

• 支持通过「键-值」切换平台语言：系统中可自定义名称的部分，如：平台目录名称、平台标题、移动平台服务器名称等。

不支持模板内容的多语言切换，如需实现模板语言切换请参考 模板多语言切换 。

只支持「简体中文、繁体中文、英文、日文、韩文」5 种语言的切换，如需实现其他语言的切换请参考 多语言插件新增小语种 。

本文将以一个简单的示例来演示如何切换数据决策系统的语言。

1.4 使用前提

安装多语言方案插件，点击下载插件：多语言方案。

设计器插件安装方法请参见： 设计器插件管理。

本节示例：

切换数据决策系统的语言为英文，切换范围包括管理系统、「测试」目录以及该目录下的子目录和子模板、平台标题、移动平台服务器名称。

实现思路：

设置「键-值」，将自定义的目录/模板名称、平台标题、移动平台服务器名称设置为 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 存在对应的国际化值，切换平台语言后显示为国际化后的值。

2.3 切换语言

点击「简体中文」按钮，在下拉框中选择「English」，即可切换系统语言为英文，如下图所示：

2.4 效果预览

1）管理系统的语言已切换为英文，且平台标题以英文显示，如下图所示：

2）点击「Directory」，可看到 2.1.1 节添加的目录及模板名称以英文显示，如下图所示：

3）使用 数据分析 APP 登录数据决策系统，查看效果如下图所示：

• 服务器名称以英文「mobile terminal」显示

•  2.1.1 节添加的目录及模板名称以英文显示

3.1 语言配置

3.1.1 管理「键-值」

管理员身份登录决策系统，点击「管理系统>语言配置」即可进入国际化设置界面。

可在该页面内查看、新增、删除、修改、搜索、批量导入、批量导出、备份、还原备份「键-值」等操作。

注1：不支持搜索「备注」字段。

注2：「清空列表」按钮仅在选中全部 Key 时出现，可勾选「Key」字段实现一键全选。

3.1.2 导入内置key

该功能支持批量获取所有系统内置的key，用户可选择直接翻译或导出 EXCEL 翻译后导入系统。

3.1.3 批量导入「键-值」

1）新建一个 Excel 文件作为数据源，Excel 字段名必须满足格式，否则导入失败，Excel 示例表如下图所示：

2）在决策平台内点选「导入」，选择数据源，导入成功，如下图所示。

注：导入 Excel 时，2.0.7 之前的版本仅支持 xls 格式，2.0.7 及之后的版本支持 xls、xlsx 格式。

3.1.4 批量导出「键-值」

在「管理系统>语言配置」页面，点击「导出>导出Excel」，即可批量导出 Excel 文件，如下图所示：

3.1.5 备份还原

点击「备份」，出现「备份成功」提示，即可成功备份当前「键-值」。

点击「还原备份」，出现「恢复备份成功」提示，即可成功还原备份的「键-值」，如下图所示：

3.2 系统偏好语言

管理员登录决策系统，点击「管理系统>语言配置>更多配置」，即可进入系统语言偏好设置，如下图所示：

• 平台语言偏好：设置后，任意用户登入系统以当前设置语言展示，设置将在重启服务器后生效。

• 平台支持语种设置：系统支持切换的语言类型。
  

注1：支持简体中文、繁体中文、英文、日文、韩文。

注2：如需使用登入页语言切换功能，平台语言偏好需设置为「简体中文」。

3.3 管理系统国际化设置

管理员登录数据决策系统，点击「管理系统>安全管理>Security Headers>浏览器缓存禁用」，开启「浏览器缓存禁用」。

点击页面上方的「简体中文」按钮，选择「下拉框」内的语言，即可实现一键切换管理系统语言。

3.4 登录页国际化设置

在数据决策系统登录页面下方，可以选择登录页的语言，如下图所示：

注1：如需使用登录页语言切换功能，平台语言偏好需设置为「简体中文」，详情请参考本文 3.2 节。

      但开启登录页语言切换功能后，语言会跟随登录页的语言走，不再跟随上次用户保存的语言。

注2：对于 FineBI 系统，如需使用登录页语言切换功能，在在「管理系统>外观配置>登录页>登录风格」中，必须选择「小窗口」风格 。