BEA ホーム | 製品 | dev2dev | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > WebLogic Server > Administration Console の拡張 > コンソール拡張でのローカライゼーションの使い方 |
Administration Console の拡張
|
以下の節では、Administration Console 拡張で使用されるテキストをローカライズする方法について説明します。
Administration Console 拡張をローカライズすると、コンソール拡張をさまざまな言語で提供できます。ローカライズしたテキストは、提供する言語ごとに作成した特別なローカライゼーション カタログ ファイルに格納します。さらに、すべてのカタログ ファイルのリストを index.xml というファイルに記述します。作成した index.xml ファイルとカタログ ファイルは、コンソール拡張を定義する Web アプリケーションにパッケージ化します(Administration Console 拡張のパッケージ化を参照)。
コンソール アプリケーションは、Administration Console で設定された言語プリファレンス、ユーザの Web ブラウザで指定された言語と国、および index.xml ファイルの設定値を使用して、コンソールを表示するためのローカライゼーション カタログを決定します。index.xml ファイル(index.xml ファイルの記述を参照)では、使用可能なすべてのローカライゼーション カタログのリストが定義され、それらのファイルと言語プリファレンス、および 1 つまたは複数のロケール設定が関連付けられます。ロケール設定には、国属性と言語属性があります。
コンソール アプリケーションは、Administration Console の [コンソール|プリファレンス] 画面で設定された言語プリファレンスをチェックします。言語が指定されている場合、コンソールは index.xml ファイルの <catalog> 要素の name 属性を参照して、その言語に関連付けられているローカライゼーション カタログを見つけます。
注意: [コンソール|プリファレンス] 画面で言語が明示的に指定されなかった場合、[言語] フィールドのデフォルトは英語です。プリファレンスが設定されていない場合、コンソールは index.xml ファイルの <locale> 要素を参照して、ユーザの Web ブラウザの設定値と一致する国と言語を見つけます。
コンソール拡張のテキストをローカライズするには、次の手順に従います。
手順の詳細については、ローカライゼーション カタログの記述を参照してください。
手順の詳細については、index.xml ファイルの記述を参照してください。
ローカライゼーション カタログは、XML 表記法を使用して記述します。XML エディタまたは通常のテキスト エディタを使用できます。サンプル カタログについては、サンプル ローカライゼーション カタログを参照してください。
ローカライゼーション カタログを記述するには、次の手順に従います。
カタログ ファイルには、以下の基本 XML 要素を記述する必要があります。
<?xml version="1.0" ?>
<catalog>
(Insert your catalog data here.)
</catalog>
単一の単語または語句のローカライズ テキストを作成するには、次の手順に従います。
textid = localized text string
<![CDATA[
...
]]>
<textlist>
<![CDATA[
example.mytext = This is localized text from the catalog.
example.title = Console Extensibility Example
example.tab.extra = Extra
example.tab.1 = Extension Catalog Text
example.tab.2 = Console Catalog Text
example.tab.3 = Programmatic
]]>
</textlist>
長い文字列のローカライズ テキストを作成するには、次の手順に従います。
<text id='example.error-message'>
<![CDATA[
...
]]>
<text id='example.error-message'>
<![CDATA[
An <b>error</b> has occured.
<p> Please consult the documentation for more information.
]]>
</text>
index.xml ファイルは、言語とカタログ ファイルにマップし、ローカライズ テキストの表示に関する詳細を提供します。
index.xml ファイルを作成するには、次の手順に従います。
言語の名前。詳細については、コンソールで使用するローカライゼーション カタログの決定を参照。 |
|
この言語用に使用するカタログ ファイルのパスとファイル名。index.xml ファイルを起点とする相対パスを指定する。index.xml ファイルは、コンソール拡張が格納されている Web アプリケーションの WEB-INF/catalogs ディレクトリに存在する必要がある。 |
|
ローカライズ テキストを表示するための文字セットの名前。World Wide Web Consortium(W3C)によって定義された標準文字セット名を使用する。 |
|
ローカライズ テキストを表示するためのエンコーディングの名前。World Wide Web Consortium(W3C)によって定義されたエンコーディングを使用する。 |
<?xml version="1.0" ?>
<catalog>
<text id='example.error-message'>
<![CDATA[
An <b>error</b> {0} has occured.
<p> Please consult the documentation for more information.
]]>
</text>
<textlist>
<![CDATA[
example.mytext = This is localized text from the catalog.
example.title = Console Extensibility Example
example.copyright = Copyright 2001 BEA Systems.
example.dialog = This is an example dialog for the server named {0}.
example.tab.extra = Extra
example.tab.1 = Extension Catalog Text
example.tab.2 = Console Catalog Text
example.tab.3 = Programmatic
example.tab.4 = Switch on the Fly
]]>
</textlist>
</catalog>
以下の節では、コンソール拡張のさまざまな要素をローカライズするための JSP コードについて説明します。
ナビゲーション ツリーのノードをローカライズするには、<wl:node> タグの labelId 属性を使用します。詳細については、<wl:node> タグを参照してください。
たとえば、次のコードを記述すると、ローカライゼーション カタログから node1 という ID で検索されるラベルを持つノードが作成されます。
<wl:node
labelId='node1'
icon='/images/bullet.gif'
url='/dialog_domain_example.jsp'>
</wl:node>
右クリック メニューをローカライズするには、<wl:menu> タグの labelId 属性を使用します。詳細については、<wl:menu> および <wl:menu-separator> タグを参照してください。
たとえば、次のコードを記述すると、右クリック メニュー付きのノードが作成されます。このメニュー アイテムのラベルは、ローカライゼーション カタログから beaDocs と beaHome という ID で検索されます。
<wl:node
label='My 2st nested node'
icon='/images/bullet.gif'>
<wl:menu
labelId='beaDocs'
url='http://e-docs.bea.com/index.html'
target='_blank'/>
<wl:menu-separator/>
<wl:menu
labelId='beaHome'
url='http://www.bea.com'
target='_blank'/>
</wl:node>
タブ ダイアログのラベルをローカライズするには、<wl:tab> タグの labelId 属性を使用します。詳細については、<wl:tab> タグを参照してください。
たとえば、次のコードではタブのローカライズ ラベルが使用されます。このラベルは、ローカライゼーション カタログから tab.1 という ID で検索されます。
<wl:tab name='LocalizedTextTab' labelId='tab.1'>
The tab label for this tab comes from the catalog.
</wl:tab>
labelId 属性を指定しない場合、コンソールはローカライゼーション カタログから次の形式のエントリを検索します。
tab + name
コンソール画面のテキストをローカライズするには、以下の 2 つの節で説明するように、<wl:text> タグの textId および textParamId 属性を使用します。このタグの詳細については、<wl:text> タグを参照してください。
テキストをローカライズするには、<wl:text> タグの textId 属性を使用してローカライゼーション カタログからテキストを検索します。たとえば、次のコードでは、ローカライゼーション カタログから ID LocalizedText.1 が検索されます。
<wl:tab name='LocalizedTextTab' labelId='tab.2'>
<wl:text textId='LocalizedText.1'/>
</wl:tab>
パラメータをローカライズすることもできます。パラメータは、文字列 {0} の代わりに使用されます(文字列がローカライゼーション カタログに格納されている場合)。
たとえば、次のコードでは、LocalizedText.3 という ID で格納されている文字列 {0} の代わりに、LocalizedParam.1 という ID でカタログに格納されているローカライズ テキストが表示されます。
<wl:text
textId='LocalizedText.3'
textParamId='LocalizedParam.1' />
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |