5
启用国际化
本文档提供了有关配置 Identity Manager 以使用多种语言或显示非英语语言的信息。
体系结构概述
组件
文件
|
描述
|
WPMessages.properties
|
默认消息文件。位于 $WSHOME/idm/web/WEB-INF/classes/com/waveset/msgcat。在 idmcommon.jar 文件中发布。
以英语显示消息文本,默认情况下会加载此消息文件,除非自定义 IDM 安装以采用其他方式。
|
Waveset.properties
|
位于 $WSHOME/config。编辑以启用对多种语言的支持。(将 Internationalization.enabled 设置为 true。)
|
系统配置对象
|
指定自定义消息目录。
|
各种受支持语言的其他消息文件
|
支持的每种其他语言都需要自己的消息文件。WPMessages_xx_XX.properties 中的 xx 表示语言,XX 表示国家/地区。例如,WPMessages_en_US.properties 包含以美国英语显示的消息。每个国际化目录都有自己的 .jar。
|
i18n.xml
|
包含多个 <Object> 元素,用于定义 Identity Manager 管理员或用户可以选择哪些语言。
|
其他注意事项:
- 如果已在 /config 中加载了新目录,则新目录的优先级高于默认目录。这仅适用于名称相同的目录。
- 如果有多个消息文件,则可以通过指定 catalogname:keyname 来指定目录,以从该目录派生消息关键字。
典型条目
消息包含在关键字/文本对中,并且包含三个部分:
- 文本字符串,或称为关键字,是代码用来检索数据的标识符。这个必需的组件不应翻译。它用在产品配置中,并作为翻译的占位符。
- 等号 ("="),用于分隔关键字和文本。这是必需的。
- 字符串,包含运行应用程序时显示的数据。这是翻译的内容,在浏览器中显示页时用于替换关键字。
资源数组中的每一行都包含两个字符串。翻译每行中第二个带引号的字符串。
有些要翻译的字符串包含特殊的代码,以便在显示这些字符串时插入相应的数据。例如,如果需要翻译以下字符串:
UI_USER_CONNECT={0}, connected at 100 mbs
处理后的结果可能为 jfaux,以 100 mb 连接
翻译内容通常会显示在浏览器中,因此可以适当地添加 HTML 标记以格式化字符串,如下所示:
_FM_ACCOUNT_ID_HELP=<b>Account ID</b><br>输入此用户的名称。此字段为必填字段。
启用对多种语言的支持
要启用对多种语言目录的支持,请执行以下步骤,这些步骤将在后面详细介绍:
- 下载本地化的文件。
- 编辑 Waveset.properties 文件,将 Internationalization.enabled 设置为 true。
- 导入、编辑并加载 .\sample\i18n.xml 文件
- 重新启动 Identity Manager
- 在登录屏幕上选择一种语言。此外,默认语言应与用户浏览器中选择的语言匹配。
步骤一:下载并安装本地化的文件
安装之前
安装本地化的文件之前执行以下任务:
- 安装 Identity Manager。有关详细的安装过程,请参见 Identity Install Pack Installation。
- 确保应用程序服务器上的以下语言环境已设置为 UTF-8。
- 应用程序服务器实例
- 数据库
- Java 虚拟机 (Java Virtual Machine, JVM)
有关设置语言环境的信息,请参阅这些产品的文档。
下载消息目录文件
下载相应的 msgcat jar 并将其放到 WEB-INF/lib 中。Identity Manager Image Server Web 站点提供了以下 ZIP 文件,这些文件中包含本地化的产品文件和文档。
文件名 (.zip)
|
语言
|
语言环境
|
IDM__5_0_l10n_de
|
德语
|
de_DE
|
IDM__5_0_l10n_es
|
西班牙语
|
es_ES
|
IDM__5_0_l10n_fr
|
法语(法国和加拿大)
|
fr_FR
|
IDM__5_0_l10n_it
|
意大利语
|
it_IT
|
IDM__5_0_l10n_ja
|
日语
|
ja_JP
|
IDM__5_0_l10n_ko
|
韩语
|
ko_KR
|
IDM__5_0_l10n_pt
|
巴西葡萄牙语
|
pt_BR
|
IDM__5_0_l10n_zh
|
简体中文
|
zh_CN
|
IDM__5_0_l10n_zh_TW
|
繁体中文
|
zh_TW
|
将 ZIP 文件下载到一个临时位置。默认情况下,ZIP 文件的内容提取到 FileName\IDM_5_0_l10n 目录,其中 FileName 与下载文件的名称匹配(除去 ZIP 扩展名)。
Zip 文件内容
每个提取的 ZIP 文件都包含:
大多数提取的 ZIP 文件包含:
- Identity Manager 5.0 发行说明的翻译版本
- Identity Manager 管理的翻译版本。
可能还有其他翻译的出版物。
安装本地化的文件
使用以下步骤将本地化的文件安装到应用程序服务器上。
- 将 JAR 文件从临时位置复制到 IdentityManagerInstallation/WEB-INF/lib 目录。
步骤二:编辑 Waveset.Properties 文件
- 使用文本编辑器打开 IdentityManagerInstallation/config/Waveset.properties 文件。
- 将 Internationalization.enabled 属性更改为 true。
- 保存更改并关闭文件。
- 可以重新启动 Identity Manager 或选择“调试”-->“重新加载属性”使此更改生效。
步骤三:导入、编辑并加载 <ApplicationDirectory>\sample\i18n.xml 文件
配置此文件以设置 Identity Manager 管理员和最终用户可以显示哪些语言。
- 用文本编辑器打开 IdentityManagerInstallation/sample/i18n.xml 文件。该文件包含多个 <Object> 元素,用于定义 Identity Manager 管理员或用户可以选择哪些语言。每个 <Object> 元素都类似于:
<Object name='en_US'>
<Attribute name='lang' value='en'/>
<Attribute name='cntry' value='US'/>
<Attribute name='gif' value='images/f0-us.gif'/>
</Object>
- 添加、编辑和/或删除 <Object> 元素,直到仅显示适合您的环境的语言。如果需要添加或编辑 <Object> 元素,请使用下表来确定对象的 name、lang、cntry 和 gif 的正确值。
语言
|
名称
|
lang
|
cntry
|
gif
|
中文(简体)
|
zh_CN
|
zh
|
CN
|
images/f0-cn.gif
|
中文(繁体)
|
zh_TW
|
zh
|
TW
|
images/f0-cn.gif
|
英语(美国)
|
en_US
|
en
|
US
|
images/f0-us.gif
|
法语(加拿大)
|
fr_CA
|
fr
|
CA
|
images/f0-ca.gif
|
法语(法国)
|
fr_FR
|
fr
|
FR
|
images/f0-fr.gif
|
德语(德国)
|
de_DE
|
de
|
DE
|
images/f0-de.gif
|
意大利语(意大利)
|
it_IT
|
it
|
IT
|
images/f0-it.gif
|
日语(日本)
|
ja_JP
|
ja
|
JP
|
images/f0-jp.gif
|
韩语(韩国)
|
ko_KR
|
ko
|
KR
|
images/f0-kr.gif
|
葡萄牙语(巴西)
|
pt_BR
|
pt
|
BR
|
images/f0-br.gif
|
西班牙语(西班牙)
|
es_ES
|
es
|
ES
|
images/f0-es.gif
|
- 保存更改并关闭文件。
- 登录到 Identity Manager 管理界面。
- 单击页面顶部的配置选项卡。然后单击左边的导入交换文件子选项卡。
- 指定路径或浏览 IdentityManagerInstallation/sample/i18n.xml 文件。然后单击导入按钮以加载该文件。
完成这些步骤之后,注销 Identity Manager。重新启动应用程序服务器。重新加载 Identity Manager 登录页时,将显示您在 i18n.xml 文件中指定的标志和语言环境。选择适当的标志来查看本地化的文本。