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
|
Identity Manager 管理者またはユーザーが選択できる言語を定義する複数の <Object> 要素が含まれます。
|
注意:
- /config の新しいカタログを読み込んだ場合は、新しいカタログがデフォルトより優先されます。これは、同じ名前のカタログだけに適用されます。
- 複数のメッセージファイルがある場合、catalogname:keyname を指定することにより、メッセージキーの派生元カタログを指定できます。
一般的なエントリ
メッセージはキーとテキストのペアで格納され、次の 3 つの部分で構成されます。
- キーとなるテキスト文字列。データを取得するためにコードが使用する識別子です。この必須コンポーネントを翻訳してはいけません。製品の構成で使用され、翻訳時のプレースホルダとして機能します。
- 等号 (=)。キーとテキストを区切ります。これは必須です。
- アプリケーションの実行時に表示されるデータを含む文字列。翻訳されたメッセージで、ブラウザがページを表示するたびにキーの代わりに使用されます。
リソース配列の各行には、2 つの文字列が含まれます。各行の引用符で囲まれた 2 番目の文字列を翻訳します。
文字列に挿入されるデータについては、表示されるときに特定の文字列が特定の特別なコードに変換されます。たとえば、次の文字列を変換する場合があります。
UI_USER_CONNECT={0}、100 mbs で接続
これは、「jfaux、100 mbs で接続」のように表示されます。
通常、変換はブラウザ内で表示されるので、次のように HTML タグを追加して文字列の書式を設定することをお勧めします。
_FM_ACCOUNT_ID_HELP=<b>Account ID</b><br>このユーザーの名前を入力してください。このフィールドは必須です。
複数言語のサポートの有効化
複数言語カタログのサポートを有効にするには、次の詳細な手順に従います。
- ローカライズ版ファイルをダウンロードします。
- Waveset.properties ファイルを編集し、Internationalization.enabled を true に設定します。
- samplei18n.xml ファイルをインポートし、編集後、読み込みます。
- Identity Manager を再起動します。
- ログイン画面で言語を選択します。デフォルト言語がユーザーのブラウザで選択されている言語と一致するようにしてください。
手順 1: ローカライズ版ファイルのダウンロードとインストール
インストールの前に
ローカライズ版ファイルをインストールする前に、次の手順を実行します。
- Identity Manager をインストールします。詳細なインストール手順については、『Identity Install Pack Installation』を参照してください。
- アプリケーションサーバー上で次のロケールが UTF-8 に設定されていることを確認します。
メッセージカタログファイルのダウンロード
適切な 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 ファイルの内容は FileNameIDM_5_0_l10n ディレクトリに解凍されます。この FileName は、ダウンロードされたファイルの名前から拡張子 ZIP を除いたものと一致します。
Zip ファイルの内容
解凍された ZIP ファイルにはすべて、次の内容が格納されています。
- ローカライズ版のメッセージカタログ、ヘルプファイル、およびその他の必須ファイルを含む JAR ファイル。この JAR ファイルには IDM_5_0_l10n_Locale.jar という名前が付けられています。
- Identity Manager Localization README
ほとんどの解凍された ZIP ファイルには、次の内容が格納されています。
- Identity Manager 5.0 リリースノートの翻訳バージョン
- 『Identity Manager 管理ガイド』の翻訳バージョン
その他の翻訳された発行物が提供されることもあります。
ローカライズ版ファイルのインストール
アプリケーションサーバーにローカライズ版ファイルをインストールするには、次の手順を実行します。
- JAR ファイルを一時的に使用する場所から IdentityManagerInstallation/WEB-INF/lib ディレクトリにコピーします。
手順 2: Waveset.Properties ファイルの編集
- テキストエディタで IdentityManagerInstallation/config/Waveset.properties ファイルを開きます。
- Internationalization.enabled プロパティーを true に変更します。
- 変更を保存して、ファイルを閉じます。
- 変更を反映させるために、Identity Manager を再起動するか、デバッグページから「Reload Properties」を選択します。
手順 3: <ApplicationDirectory>samplei18n.xml ファイルのインポート、編集、および読み込み
このファイルで、Identity Manager 管理者とエンドユーザーに表示できる言語を設定します。
- IdentityManagerInstallation/sample/i18n.xml ファイルをテキストエディタで開きます。このファイルには、Identity Manager 管理者またはユーザーが選択できる言語を定義する複数の <Object> 要素が含まれます。各 <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
|
|
英語 (U.S.)
|
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 ファイルで指定した言語に対応した国旗のイメージのリストが表示されます。適切な国旗を選択して、各言語に翻訳されたテキストを表示します。
