文字列のローカライズの概要

ここでは、インターシステムズ製品の文字列のローカライズの概要を示します。文字列のローカライズは、ローカリゼーション・サポートの重要な要素です。

アプリケーションのテキストをローカライズする場合、ある言語のテキスト文字列のインベントリを作成してから、アプリケーションのロケールが異なるときに別言語の変換バージョンのメッセージに置き換える規約を設定します。そのため、インターシステムズ製品は、文字列をローカライズするために以下のプロセスをサポートします。

1. 開発者が、ローカライズ可能な文字列をコード内 (Web アプリケーションまたはビジネス・インテリジェンス・モデル内) に含めます。

   このメカニズムはさまざまですが、最も一般的なメカニズムは $$$Text マクロです。ハードコードされたリテラル文字列の代わりに、$$$Text マクロのインスタンスを記述して、マクロ引数の値を以下のように指定します。

   • 既定の文字列

   • この文字列の所属先のドメイン (文字列がドメインにグループ化されている場合、ローカライズの管理が簡単になります)

   • 既定の文字列の言語コード

   例えば、以下を指定するのではなく、

    write "Hello world"

   

   以下を記述します。

    write $$$TEXT("Hello world","sampledomain","en-us")

   

2. コードをコンパイルすると、コンパイラによって、$$$Text マクロの一意のインスタンスごとに、メッセージ・ディクショナリにエントリが生成されます。

   メッセージ・ディクショナリはグローバルであるため、(例えば) 管理ポータルで簡単に確認できます。データを管理するためのクラス・メソッドがあります。

3. 開発が完了したら、リリース・エンジニアは、対象のドメインまたはすべてのドメインのメッセージ・ディクショナリをエクスポートします。

   結果は、元の言語でのテキスト文字列を含む 1 つ以上の XML メッセージ・ファイルになります。

4. リリース・エンジニアは、これらのファイルをトランスレータに送信し、変換されたバージョンを要求します。

5. トランスレータは、好みの XML オーサリング・ツールを使用してファイルで作業します。基本的には、前後の XML を変更することなく、テキストを元の言語から新しい言語に変換します。

6. トランスレータは、同じ構造を持つ以下のような新しいファイルを返します。

   • <MsgFile> 要素の language 属性の RFC1766Opens in a new tab 値を識別する

   • 識別された言語の変換済みテキストを格納する

7. リリース・エンジニアは、変換された XML メッセージ・ファイルを、元のファイルのエクスポート元である同じネームスペースにインポートします。

   メッセージ・ディクショナリに、変換されたテキストと元のテキストが共存します。

8. 実行時に、アプリケーションは、ブラウザの既定の言語に基づいてどのテキストを表示するかを選択します。

メッセージの引数と $$$FormatText マクロ

メッセージ・テキストに引数 (%1、%2、%3、%4) が含まれる場合、テキストを表示する前に対応する置換テキストを指定する必要があります。$$$Text は文字列を返すため、コーディング言語にネイティブな任意の文字列操作を使用できます。例えば、JavaScript では以下のようになります。

 var prompt = '#($$$TextHTML("Remove user %1 from this Role?"))#';
 prompt = prompt.replace(/%1/g,member.userName);

インターシステムズは、メッセージの引数のテキストを置換するための追加のマクロを提供しています。

• $$$FormatText

• $$$FormatTextJS ($$$FormatText の結果に JavaScript エスケープを適用)

• $$$FormatTextHTML ($$$FormatText の結果に HTML エスケープを適用)

これらのマクロは、%occInclude.inc に含まれる %occMessages.inc にあります。これらのマクロは、順番に以下の引数を取ります。

text

メッセージ・テキスト、文字列。$$$Text から返された値を使用します。

arg1、arg2 など

メッセージ引数の置換テキスト。