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, connected at 100 mb
翻譯通常顯示在瀏覽器中，因此可適當增加 HTML 標籤以格式化字串，如下所示︰
_FM_ACCOUNT_ID_HELP=<b>帳號 ID</b><br>輸入此使用者的名稱。這是必填欄位。
啟用多種語言支援
若要啟用多種語言目錄支援，請遵循以下步驟 (在以下建立的詳細資料中說明)︰
- 下載已本土化的檔案。
- 透過將 Internationalization.enabled 設定為 true 來編輯 Waveset.properties 檔案。
- 匯入、編輯以及載入 .\sample\i18n.xml 檔案
- 重新啟動 Identity Manager
- 在登入螢幕選擇一種語言。此外，預設語言應與使用者瀏覽器中選取的語言相符。
步驟一︰下載並安裝已本土化的檔案
安裝前注意事項
請先執行以下作業，然後再安裝已本土化的檔案︰
- 安裝 Identity Manager。請參閱「Identity Install Pack 安裝」，以取得詳細的安裝程序。
- 請確定已將應用程式伺服器上的以下語言環境設定為 UTF-8。
- 應用程式伺服器實例
- 資料庫
- Java Virtual Machine (JVM)
請參閱這些產品的文件以取得有關設定語言環境的資訊。
下載訊息目錄檔
下載相應的 msgcat jar 並將其置於 WEB-INF/lib 中。Identity Manager Image Server 網站提供以下包含本土化產品檔案以及文件的 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 檔案均包含以下內容︰
也可能會提供其他翻譯版本的出版物。
安裝已本土化的檔案
使用以下步驟將已本土化的檔案安裝在應用程式伺服器上。
- 從暫時位置將 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 值的正確值。
|
語言
|
name
|
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 檔案中指定的旗標和語言環境。選取相應的旗標以檢視已本土化的文字。
