1. 概述
1.1 版本
| FineBI 版本 | 多语言方案插件版本 |
|---|---|
| 6.0.19 | V2.2.0 |
1.2 应用场景
在企业中，如果遇到在不同场合下需要展示不同语言的仪表板内容时，为了减少制作成本和维护成本，需要实现同一张仪表板的多语言展示效果，如下图所示：
本文介绍如何在仪表板中设置模板国际化并实现模板的语言切换。
1.3 支持范围
注1：支持范围内的内容切换均需要在「管理系统>语言配置」中添加 key 及对应语言的翻译，添加方法见下述 第 2.5 节。
在已添加 key 及对应语言的翻译后，下述表格中标注了「fi18n[]」的部分说明文字内容需要通过 fi18n[]函数 实现多语言的切换，未标注的可自动读取平台内的 key 实现多语言切换。
注2：只有 key 全词匹配的情况下才能够被识别并实现多语言切换，详情见下述 第 1.4 节。
| 分类 | 支持范围 | 示例 |
|---|---|---|
| 控件 | 控件标题 「fi18n[]」
| |
| 控件内容 | ||
| 表格 | 表格标题「fi18n[]」
| |
| 表头 | ||
| 表格内容 | ||
| 图表 | 图表标题「fi18n[]」
| |
分类/系列名称 图例/指标名称 坐标轴名称 图表标签 图表提示 趋势线名称 警戒线名称 | ||
| 其他 | 仪表板名称 | |
1.4 key匹配规则
1.4.1 通用规则
富文本中需要使用 fi18n[] 函数的场景可参见 1.3 节中标注的场景，此处介绍不使用 fi18n[] 时的匹配规则：以行为单位，每行的 key 需要全词匹配（包括符号和空格）才能够被识别并实现转换。
| 场景 | 规则 | 示例 |
|---|---|---|
| 文字 | 单行情况下当行的文本内容需要为一个 key（包括符号和空格） | 1）若已将「购买数量」录入为 key，则「购买数量」能被识别并转换，「购买数量：」不能被识别
2）如果希望「购买数量：」能够被识别的话，需要将「购买数量：」作为一个 key 录入
|
| 多行情况下，每行识别为单独的 key | 换行的情况下，「购买数量」能被识别
| |
| 文字 + 字段 | 若当行富文本内容中存在维度/指标字段，则将以字段作为分割，字段前后的文本可以被单独识别为 key。例如：key1字段key2，则 key1、key2 均可以被识别。同样，key1、key2 需满足全词匹配（包括符号和空格） | 若已将「购买数量：」和「（个）」录入为 key，则「购买数量:+字段+（个）」中，「购买数量：」和「（个）」均可以被识别
|
1.4.2 例外情况
图表提示中，适配了 key1:key2 的场景，如果 key 之间使用「：」进行了分割并紧贴「：」（不能有空格），则 key1、key2 均可以被识别。
注：除「：」外其他符号同 1.4.2 节中的规则一致。
1.5 使用前提
安装多语言方案插件，点击下载插件：多语言方案。
设计器插件安装方法请参见： 插件管理。
2. 示例
本文以制作「合同分析看板」为例，资料下载：合同明细.xlsx
2.1 添加资料
下载上述 Excel 并添加进公共资料中。如下图所示：
创建分析主题，如下图所示：
2.2 添加表格
打开创建的分析主题，点击组件，将「合同类型、合同付款类型、合同ID」拖入维度，将「总金额」拖入指标，如下图所示：
2.3 添加图表
2.3.1 添加柱形图
1）添加一个新的组件，选择「分区柱形图」，将「合同类型」拖入横轴，将「总金额」拖入纵轴。
2）添加标签与提示。
3）添加警戒线。
2.3.2 添加折线图
1）新建一个组件，选择「分区折线图」，将「合同签约时间」拖入横轴，将「记录数」拖入纵轴。
2）添加趋势线。
2.4 制作仪表板
1）新建一个仪表板，将制作好的表格和图表组件拖入仪表板，并分别修改组件标题为 fi18n[组件标题] 格式。以表格为例，如下图所示：
2）添加「其他>文字组件」作为仪表板标题，内容设置为 2011-2017[合同分析看板]，如下图所示：
3）添加「过滤组件>文字下拉」对合同类型进行过滤，添加「过滤组件>年月区间」对合同签约进行过滤，如下图所示：
「文字下拉」组件的标题设置为 fi18n[合同类型] ，如下图所示：
「年月区间」组件的标题设置为 fi18n[合同签约时间]，如下图所示：
2.5 添加多语言key
点击「管理系统>语言配置」，导入对应的 key。如下图所示：
Excel 下载：language.xlsx
导入成功后可在决策平台看到所有的 key，并进行添加、删除、修改等操作：
3. 效果展示
点击页面右上角的语言切换按钮进行多语言切换，如下图所示：
