本地化配置

<< Click to Display Table of Contents >>

当前位置:  »当前无上一级«

本地化配置

Return to chapter overview

本地化配置不仅支持用户自定义数据段名字,还支持用户自定义产品中的一些标签。

在任一目录下,如 E:\yonghong,添加 userlocale_en_US.properties,userlocale_zh_CN.properties,userlocale.properties 三个文件,然后将该文件夹 E:\yonghong 的路径添加到产品 ..\tomcat\bin 下的 setclasspath.bat 文件的CLASSPATH中。其中 userlocale_en_US.properties 匹配产品的英文环境 ,userlocale_zh_CN.properties 匹配产品的中文环境,userlocale.properties 匹配产品的所有环境。在除了中英文环境外的其他环境中,使用 userlocale.properties 里的设置;在中英文环境中,优先使用 userlocale_zh_CN.properties 和 userlocale_en_US.properties 里的设置,未在这 2 个文件中配置,却在 userlocale.properties 中配置的也会被应用。

1. 自定义数据段名字

用户可以通过自定义的字段:XXX= 自定义名字 来设置,其中名字为中文时,需要将中文转换为 unicode。

如产品当前使用环境为中文,在 userlocale_zh_CN.properties 配置数据段:

ID=NO_CN

MARKET=Market_CN

DATE=date

SALES=a\u9500\u552e\u989d

STATE=\u5dde

其中 ID 显示为 “NO_CN”, MARKET 显示为 “Market_CN”,SALES 显示为 “a 销售额 ”, STATE 显示为 “ 州 ”,如图所示:

localconf1

2. 自定义标签

用户需要自定义的标签,需要在产品的标签前加上 ”g5_”完成覆盖,即:g5_ 标签 = 自定义名字。如果标签对应的值是中文,需要将中文转换为 unicode。

如产品当前使用环境为中文,在 userlocale_zh_CN.properties 配置标签:

g5_index.query=\u8fde\u63a5\u6570\u636e\u6a21\u5757

g5_index.editor=Dashboard_CN

g5_Export=\u5bfc\u51fa\u62a5\u8868\u4e2d

其中产品导航栏中创建数据集和制作报告会分别显示为“ 连接数据模块”和“Dashboard_CN”,产品报告的工具栏中输出显示为“ 导出报表中 ”。

产品首页上创建数据集和制作报告的显示,如图所示:

localconf2

产品中预览报告时,工具栏的显示如图所示:

localconf3

参数dynamic.class.dir=可实现热加载功能,如设置locale.types=en_US,zh_CN,de_DE,dynamic.class.dir=等号后面添加userlocale_en_US.properties,userlocale_zh_CN.properties,userlocale.properties 文件的路径,与classpath添加的路径一致,产品中的user bundle会每5分钟检测一下过期,如果过期的话会重新初始化,也就是说用户修改文件内容后,最迟5分钟后刷新就可以看到效果,无需重启。每一种语言都必须要有对应的文件才能实现热加载,如de_DE与userlocale_de_DE.properties,如果没有userlocale_de_DE.properties文件,系统语言选择de_DE,本地化会读取userlocale.properties 文件也能生效,只是不能提供这种热加载的能力。

userlocale