模板多语言切换

1.1 版本

1.2 应用场景

在企业中，如果遇到在不同场合下需要展示不同语言的模板内容时，为了减少多张模板的制作成本，降低多张模板的维护成本，需要实现一张模板，多语言展示的效果。

如下图所示：

1.3 功能简介

本文将介绍如何在设计器和平台中设置模板国际化，如何通过工具栏控件、URL传参、参数控件实现模板的语言切换，以及遇到需要前端展现的内容如何通过 JS 来实现语言的切换。

1.4 使用前提

安装多语言方案插件 ，详情请参考：插件安装 。

注：FVS 可视化看板 不支持在设计器中对模板设置「键-值」，请参考第三章节在决策平台中设置。

2.1 设置界面入口

模板国际化设置即对「键-值」的对应映射关系进行设置，设置内容仅对当前模板生效。

点击「模板>模板国际化」即可进入国际化设置界面。

界面上有两个 tab，模板 tab 支持对「键-值」的对应关系进行新增、删除、修改、查看，服务器 tab 仅支持查看。

界面顶部搜索框支持对当前界面中的模板tab和服务器tab下的「键-值」内容进行关键词搜索，「描述」列不支持搜索。

2.2 「键-值」设置

点击「+」按钮，弹出「键-值」设置界面。

「键」中输入用于公式调用的对象，可输入任意值，「描述」中输入对当前键的解释说明，各语言栏位中输入不同语言下当前键的显示内容。

注：语言字段中至少填写一个语言的显示内容才可以提交。

点击「」按钮，可对当前「键-值」设置进行修改。

点击对应「键-值」行后的「」按钮可删除单个「键-值」设置。

选中「键-值」行前的复选框后，点击列表顶部的「」按钮可删除多个「键-值」设置。

注：2.0.7 及之后的版本支持「导入当前范本所有 i18n函数 key 」，如下图所示：

注：2.0.7及之后的版本，设计器导入导出 excel 新增 xlsx 格式，如下图所示：

导出 excel 文件的默认格式为 xls 格式，手动改成 xlsx 后即可导出 xlsx 格式文件。

导入 xlsx 类型的 excel 文件与导入 xls 类型的 excel 文件效果一致。如下图所示：

注：导出时当 key 与非中文译文相同时，默认取工程语言对应的译文。

2.3 模板语言设置

点击列表右上方的「」按钮，进入模板语言设置界面，设置内容仅对该模板生效。

模板语言设置可选择「使用服务器设置」或「为此模板设置」。

使用服务器设置即默认语言和备用语言选项置灰，不能修改。

为此模板设置可自定义默认语言和备用语言。

默认语言可选择跟随平台/浏览器语言或具体的语言内容。

• 选择跟随平台/浏览器语言时，若平台和浏览器语言不一致时，模板默认语言为平台语言。

• 选择跟随平台/浏览器语言时，若浏览器语言不包含于所支持的语言范围内，则模板语言为备用语言。

注：FVS 可视化看板需要将 FVS 插件升级至 V1.11.1 及之后的版本，且多语言插件需为 2.0.8 及之后版本。

3.1 设置界面入口

服务器模板国际化设置即对「键-值」的对应关系进行设置，设置内容对当前服务器上所有模板生效。

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

界面顶部右侧搜索框支持对「键-值」内容进行关键词搜索，「备注」列不支持搜索。

「显示字段」可切换当前「键-值」列表显示的语言栏。

3.2 「键-值」设置

点击「+」按钮，弹出「键-值」设置界面。

「键」中输入用于呼叫的对象，可自定义任意值，「备注」中输入对当前键的解释说明，各语言栏位中输入不同语言下当前键的显示内容。

注：语言字段中至少填写一个语言的显示内容才可以提交。

点击「」按钮，可对当前「键-值」设置进行修改。

点击对应「键-值」行后的「」按钮可删除单个「键-值」设置。

选中「键-值」行前的复选框后，点击列表顶部的「」按钮可删除多个「键-值」设置。

「键-值」列表还支持批量导入、导出。

3.3 服务器模板语言设置

点击菜单栏「服务器>国际化管理」，进入设置界面。

可自定义默认语言和备用语言。

默认语言可选择跟随平台/浏览器语言或具体的语言内容。

• 选择跟随平台/浏览器语言时，若平台和浏览器语言不一致时，模板默认语言为平台语言。

• 选择跟随平台/浏览器语言时，若浏览器语言不包含于所支持的语言范围内，则模板语言为备用语言。

3.4 浏览器Tab名称国际化

注：多语言插件 2.0.8 版本新增支持浏览器 Tab 名称设置。

将模板名称（需要完全匹配）设置为 Key，需要展示的名称设置为值。

例如：模板名称为line-chart，预览后希望浏览器 Tab 显示为自定义的折线图。

预览后，可以看到 Tab 名称为折线图。

3.5 导出文件名称国际化

注1：多语言插件 2.0.8 版本新增支持导出文件名称国际化。

注2：名称国际化支持的导出文件类型为：excel、pdf、word。

注3：如果是通过__filename__ 参数指定了文件名称，则名称不会进行国际化转换。

根据 3.4 节在平台设置好「键-值」后，导出文件时，文件名称支持国际化。如下图所示：

3.6 fvs中的i18n公式适配国际化

注：多语言插件 2.0.8 版本新增支持 fvs 中的 i18n 公式国际化。

根据 3.4 节在平台设置好「键-值」后，在 fvs 中设置公式i18n('line-chart')，显示为“折线图”。如下图所示：

4.1 方法一：工具栏控件

• 点击「模板>模板Web属性」，进入「分页预览设置」或「填报页面设置」或「数据分析设置」页面。

• 选择「为该模板单独设置」后，可自定义工具栏中的控件。

• 双击「模板语言」控件，即可新增到当前模板的工具栏中。

模板语言控件支持自定义控件图标和控件名，以及是否显示图标和名字。

设置完成后，预览模板，点击顶部工具栏中该控件即可选择需要切换的语言，效果如下图所示。

4.2 方法二：URL传递参数

预览模板后，在URL后加上&fr_locale=，输入对应语言的值即可切换语言，效果如下图所示。

注：「简体中文」对应「zh_CN」，繁体中文」对应「zh_TW」，「英文」对应「en_US」，「日文」对应「ja_JP」，「韩文」对应「ko_KR」。

4.3 方法三：参数控件

注：此方式仅对查询后的内容生效，查询前载入的（如：工具栏、其他控件文字等）不生效。

新增一个名为fr_locale的模板参数或全局参数。

在模板参数面板中生成参数fr_locale，设置参数控件为下拉框控件。

给控件设置数据字典，类型设置为「自定义」，加入需要的语言选项，实际值需对应为 zh_CN、zh_TW、en_US、ja_JP、ko_KR。

参数控件的显示值固定，无法设置为多语言切换。

4.4 方法四：前端展现

当在模板中遇到需要前端展现文本的时候，譬如：提示、弹窗等，单元格公式i18N()对前端展现的文本则不生效，此时可以通过事件去实现前端文本的多语言展示。

通过前端函数FR.i18nText()返回对应语言的文字，方便在前端工具栏、事件中，进行文字的国际化 key 调用。

这里以超链接为示例，其他可以添加事件的地方方法均相同。

新增一个 JavaScript 脚本事件，输入 JS 代码，保存模板，点击预览。

JS 代码如下：

var a = FR.i18nText('水洗溫度不超過30攝氏度！');//此处文本需在【模板国际化】中设置键-值FR.showDialog("Details",600,400,a);

var a = FR.i18nText('排名第一');//此处文本需在【模板国际化】中设置键-值FR.showDialog("Details",600,400,a);

5.1 数据准备

点击下载示例文件：示例.xlsx。

1）准备一个有不同语言的 Excel 文件，给文件加上一个「语言」字段，在字段中输入对应语言的值，如：zh_CN、zh_TW、en_US、ja_JP、ko_KR。

2）在模板中新建 Excel数据集，导入刚刚准备好的 Excel 文件。

5.2 制作报表-设置数据

• 将数据集中的字段拖入 A2:E2 单元格中，并给 A2:E2 单元格设置居中且加上表格内外框。

• 选中 A2 单元格，双击进入数据列设置界面，点击「过滤」。

• 设置数据过滤，根据语言参数的值展示对应语言的数据。

• 设置「语言」字段「等于」参数「fr_locale」，点击「+增加」生成过滤条件。

此时若当前浏览器语言为繁体中文，则只展示繁体中文的数据。

5.3 设置列表标题多语言

• 点击「模板>模板国际化」进入国际化设置界面。

• 点击「+」按钮，新增「键-值」对应关系，在设置界面输入键名称和不同语言的显示。

• 完成设置后点击「确定」。

5.4 制作报表-插入多语言标题

• 在 A1:E1 单元格中插入列表标题，并给 A1:E1 单元格设置居中且加上表格内外框。

• 标题使用公式，选择「插入公式」，输入i18n("键")即可。

• 标题全部设置完成后，若当前浏览器语言为繁体中文，则标题内容显示为繁体。

5.5 设定语言切换

• 点击「模板>模板Web属性」，进入「分页预览设置」界面。

• 选择「为该模板单独设定」后，可自定义工具栏中的控件。

• 双击「模板语言」控件，即可新增到当前模板的工具栏中。

完成设置后点击「确定」，点击预览，在浏览器中查看效果，切换语言后，报表工具栏、标题、数据均展示为对应语言的内容，效果如下图所示。

点击下载模板：多语言方案.cpt