Java开源ERP系统Axelor汉化方法初探

news2025/4/21 19:48:33

Axelor简介

汉化过程介绍

定义语言和本地化

导出多语言记录

导入翻译

验证翻译

调整翻译

Axelor简介

2024年6月份Axelor ERP发布了8.1版本，适配JDK11及PostgreSQL12及以上版本（7及以前版本适配JDK8及PostgreSQL10）数据库。v8版本较之前版本在界面上有很大的变化，深色（Dark）主题更Nice了。

浅色（Light）主题仍保持Axelor的简洁明亮的风格。Axelor在java开源ERP系统中具有很强的竞争力。

Axelor使用Gradle作为构建工具，前端采用ReactJS，但基本不需要开发人员写前端代码，官方的open-suite-webapp（一套完整的ERP系统，也就是本文中描述的这套系统）中也只有axelor-human-resource和axelor-project两个模块有单独的js模块代码，其余均为java或groove代码，因此对项目二次开发支持还是相当友好。

Axelor发布的版本中集成了Studio开发环境、BPM Studio以及WS Studio，使得二次开发效率得到更好的提升。本文中就不对这些内容展开描述了。以下截图为示例BMP流程（披萨发货流程）

Studio主要用于界面设计的调整，也可以进行项目的实体设计等，类似Axelor的一个低代码开发平台。

Axelor ERP多语言支持方面较Odoo（另外一个Python语言的开源ERP）要少很多，Odoo17中支持的多语言有72种，而Axelor默认的只有英语和法语，但是Axelor中，多语言的处理也还算友好，并不复杂。下面就介绍一种简单的快速翻译成中文的处理方法，供Axelor爱好者参考。

汉化过程介绍

汉化处理的过程大体分为以下几个步骤：

定义语言和本地化

增加语言：进入Application config->General data->Language增加中文记录，如下：

增加本地化：进入Application config->General data->Locallizatuions增加中文记录，如下：

导出多语言记录

官网对这部分的介绍并不详细，论坛中推荐的方式是通过Advanced Export（Application config->Technical maintenance->Advanced Export）,然后做后续的处理，本文采用的是直接从数据库表获取记录方式。

Axelor的多语言记录全部保存在数据库表“meta_translation”中，所以只要把这里的记录导出后进行翻译即可，该表的结构也很简单：

翻译主要用到的就是message_key和message_value两个字段，其中message_key是程序中处理和检索多语言的键值，字符串类型，根据模块中开发人员熟悉的语言进行预定义，message_value是界面中显示的内容，所以真正要翻译的就是message_value。因此这里只要把这两个内容导出来，对message_value进行翻译后再导入到meta_translation表中即可。

假设我们希望通过英文的多语翻译成中文，那么只要在SQL工具中执行以下语句，并将结果保存为excel文件即可（本文使用Google文档翻译，所以导出Excel，如果使用其他文档翻译器，根据文档翻译器支持的文档格式导出或者导出后再转换），导出的文件编码为UTF-8

select message_key,message_value from meta_translation where language = 'en' and  COALESCE(message_value,'') !='';

导入翻译

将上述字段导出Excel后，将文件另存一份，其中一份只保留需要翻译的message_value这一列（这里假设为文件B，原始导出的文件为A），然后把文件交给Google进行翻译，将翻译后的文件下载（这里假设文件C），将C中内容复制到文件A中（注意不要错行），然后在Excel中通过公式方式做SQL拼接，将A文件中的message_value和message_key拼接为insert语句，

INSERT INTO meta_translation (id,  version, message_key, language, message_value)

其中，id取值为nextval('meta_translation_seq')， version取值为0，languzge取值为"zh"，message_value和message_key分别为Excel表中的行记录。将拼接好的SQL通过SQL命令行或者工具执行插入。这里需要补充说明的是，由于key和value的值中均有可能存在单引号或者双引号这种特殊字符，需要对这两部分的值针对这些特殊字符进行替换处理，以保证拼接后的SQL能正常执行，当然也可以忽略这些内容，后续手工再做翻译的调整。