盘古低代码

i18n 国际化业务数据组件使用手册 ​

目的 ​

  1. 实现用户业务数据国际化的业务端自行管理，平台仅提供前端组件及后端方案（以下示例仅供参考，具体实现由业务方自行管理）

使用步骤及示例 ​

实现业务数据的国际化需前后端协作完成，具体操作步骤分为前端页面设计和后端接口编写

前端操作步骤示例 ​

  1. 进入页面设计器，拖入表单容器，拖入业务国际化组件

alt text

  1. 拖入按钮，配置按钮的点击事件，在该按钮的点击事件中取出组件值及国际化值，根据接口格式构建请求体；在点击事件中绑定后端提供的数据保存接口

alt text

alt text

注意：请求体构建请参考业务后端接口定义

  1. 进入运行时页面，录入业务数据及业务国际化数据，执行保存操作

alt text

  1. 生成的请求头数据格式，可供参考
  • 新增一条业务数据请求体格式示例：
json
{
    "sku":"",
    "price":"",
    "stock":"",
    "langValueList":[
        {
            "languageCode":"zh_CN",
            "name":"璀璨空调",
            "description":"变频新风空调"
        },{
            "languageCode":"en_GB",
            "name":"Brilliant air conditioning",
            "description":"Inverter fresh air conditioner"
        }
    ]
}

后端操作步骤示例 ​

数据存储原则：国际化数据及业务数据应仅存一份，如某业务表的某字段做了国际化，那么该字段应当存在于国际化表中，而不应当存在于业务表中

  1. 创建业务数据表、业务数据国际化表 例如：产品表 product_test，产品国际化表 product_test_i18n

alt text

alt text

以上表字段设计含义：

  • 产品表中的SKU、PRICE、STOCK字段未做国际化，直接在产品表中定义即可；NAME、DESCRIPTION字段需做国际化，为避免数据重复存储，可仅在对应的产品国际化表中定义
  • 产品国际化表中LANGUAGE_CODE字段代表语言编码，NAME、DESCRIPTION字段值为对应语言的国际化值，MASTER_ID字段值为对应关联的产品表的ID
  1. 创建对应实体类 示例如下： alt text

alt text

  1. 定义业务系统针对产品数据的增删改查接口

具体业务数据及对应国际化数据的增删改查代码由用户自行实现，示例如下：

alt text

alt text