国际化配置
国际化配置
国际化配置包括内容国际化和显示国际化
内容国际化
内容国际化,可设置多种类语言包,满足不同地区和语言的需求,当切换系统语言时,显示内容国际化设置的内容。
点击添加语言按钮弹出添加语言弹窗
- 语言选择:选择国际化语言
- 显示名称:该语言显示在平台的名称
- 默认语言:选中后,默认展示该语言
- 内容多语言:选中后,平台可设置多种语言
- 支持内容国际化配置有数据表表标题、表字段标题、表字段说明、表字段提示文字,文本字段中值可以配置启用国际化、数据点名称和映射字段、计算节点的名称和映射、指令的名称。
例如,当系统展示场景为英文环境下,需要切换英文作为系统语言,同时将设置的内容也同步切换为英文语音下的内容,需进行如下操作:
第一步:国际化配置中选择英语作为配置语言;
第二步:输入内容设置时,需要点击国际化语言设置的图标,展示国际化语言输入框,输入对应英文的内容;
第三步:到中台基础配置>基础设置>系统语言,将对应的语音切换为英语,则平台中应用该内容的地方将显示英文设置内容;
显示国际化
显示国际化可自定义平台系统的语言列表,当平台语言列表无法满足语言需求时,可根据业务需求自定义上传语言包,将模板中的语言替换成对应语言,上传即可。
点击添加语言按钮,弹出添加语言弹窗
选择语言:选择需要新增的语言
显示名称:选择系统语言时的语言展示名称,默认以选择语言时的名称进行展示。例如我们在添加cgg语言时显示名称设置为“Chiga选择”
选择系统语言时,可选语言显示名称为“Chiga选择”
模板下载:模板为json格式,对模板中的内容做对应语言的切换即可
文件上传:在下载模板中将对应内容进行语言切换后可上传,上传成功后生效,即可选择新增的语言
国际化字典
国际化字典旨在简化内容国际化过程中相同字段定义显示国际化的操作。通过在系统设置中配置字典字段,并在可视化配置中绑定字典中的多语言记录,实现根据系统语言自动切换显示内容,提升配置效率。
使用步骤
一、字典配置
进入配置页面:登录系统后,依次点击 “系统设置” - “国际化配置” - “国际化字典”,进入字典配置页面。
- 新建字典
在字典配置页面点击 “添加字典”,弹出新建字典窗口。
字段key: 填写 “字段 key”,输入格式支持中文、英文大小写,且 key 值唯一,不允许重复,创建或导入后也不可修改。 语言配置: 根据系统中已添加的内容国际化语言,填写对应字段在每种语言下的展示内容。这些语言的展示名称取决于添加内容国际化时定义的显示名称,打开页面时系统会自动查询展示。所有字段均为必填项,填写完成后点击 “确定”。
- 导入字典
在字典配置页面点击 “导入字典”,支持导入后缀为.xlsx、.xls、.xlsm 的 Excel 文件。
- 点击 “下载模版” 获取正确的数据模版,模版中的语言展示名称会随内容国际化语言显示名称的修改而同步更新。 :::tip
- 文件后缀为 .xlsx、.xls 或 .xlsm。
- 字段名称与模板完全一致。
- 无空值或格式错误。 :::
- 选择处理规则,包括报错并跳过、覆盖、清空后导入,默认选中报错并跳过。
- 上传文件时,系统会进行格式校验、字段名称校验以及字段内容是否为空校验,任何一项不通过都会弹出相应报错提示。上传过程中,上传按钮及确定按钮会有 loading 效果,页面提示 “文件上传中,请耐心等待!”。若关闭弹窗,会弹出二次确认弹窗询问是否终止上传。
二、可视化绑定
- 找到绑定位置:在可视化配置具有国际化的位置,进行绑定。
- 选择绑定内容:在弹出的绑定弹窗中,绑定国际化字典的对应记录
- 生效与展示:绑定完成后,组件内容根据系统语言自动匹配字典中的翻译。
三、常见问题
- 字典操作影响:在字典列表中对记录进行删除或批量删除时,会导致绑定的内容国际化失效,操作时会弹出二次确认弹窗,提示谨慎操作。
- 语言相关问题
- 创建内容国际化时,每个语言的内容多语言选项默认勾选。若取消勾选或删除某种语言,系统会清除缓存并清除国际化效果。
- 当在 “内容国际化” 及 “显示国际化” 中增加语言 A 后又删除,可能会出现缓存未清除导致的显示异常问题。如在 “显示国际化” 语言列表中删掉语言 A,未清除缓存或重新登录时,语言切换列表中没有语言 A,但页面仍显示语言 A 的翻译内容;在 “内容国际化” 语言列表中删掉语言 A,可视化中已做国际化绑定的部分,画面加载时原有绑定不会失效。
- 字典记录删除影响:当字典中将记录删除,画面中的绑定将会失效。编辑画面时,选中对应的组件会提示绑定失效;前台预览时,展示平台中的默认内容国际化语言的翻译内容。
四、场景示例
场景:为“文本组件”配置多语言显示
新建字典:
Key: device_status
中文: 运行中
English: Running
俄语: Работает
可视化绑定:在文本组件中,绑定国际化字典中的Key device_status。
效果:用户切换系统语言时,自动显示对应翻译。