多言語サポートのためのDigital Customer Serviceのローカライズ
このトピックでは、Digital Customer Serviceを多言語サポートのためにローカライズする方法について説明します。
ローカライズされたDigital Customer Serviceアプリケーションの作成方法
アプリケーションのローカライズ済バージョンを作成するには、アプリケーション内のUIテキストとメッセージを他の言語に翻訳します。 ローカライズされた文字列が実行時にアプリケーションに表示されます。 ステージングまたは公開されたアプリケーションを実行すると、ブラウザの言語設定に基づいて、ローカライズされたバージョンが表示されます。
リファレンス実装テンプレートを使用して作成されたDigital Customer Serviceアプリケーションには、Oracle Fusion Serviceでサポートされている25言語の翻訳が含まれています。 参照実装テンプレートにはこれらの翻訳文字列およびファイルが付属していますが、Digital Customer Serviceアプリケーションの文字列に適用する変更には追加の翻訳が必要です。
サポートされているデフォルトの言語ロケールは、ar、cs、da、de、es、fi、fr-CA、fr、hu、it、iw、ja、ko、nl、no、nl、pt-BR、ro、ru、sk、sv、th、tr、zh-CN、zh-TWです。
リソース・バンドルには、ほとんどのアプリケーションで独自の翻訳ファイルに使用できる翻訳済文字列の初期セットが用意されています。 サポートする言語の残りの翻訳ファイルに入力するには、新しい言語のファイルを生成する手順を実行してから、既存の翻訳済ファイルを使用して、新しいファイルで使用するための翻訳を取得します。
Digital Customer Serviceリファレンス実装テンプレートには、アプリケーション固有のバンドルが1つ付属しています。 文字列を作成する場合は、このバンドルに翻訳を追加するか、バンドルを作成する必要があります。
アプリケーションへの翻訳済テキストの追加に関する包括的な情報は、関連トピックの『Oracle Visual Builderによるアプリケーションの開発』ガイドの「アプリケーションの開発」の章の「翻訳の処理」のトピックを参照してください。
Digital Customer Serviceアプリケーションで使用可能な言語の構成
デフォルトでは、表示ブラウザで指定した優先言語が、Digital Customer Serviceアプリケーションをユーザーに表示するために使用されます。 Digital Customer Serviceリファレンス実装テンプレートでは、ユーザーが別の言語を使用する場合に使用可能な特定の言語をリストするように言語メニューを構成できます。
Digital Customer Serviceアプリケーション・ユーザーが使用可能な言語を構成するには:
-
Oracle Visual Builderにサインインします。
-
Digital Customer Serviceアプリケーションを開きます。
-
Webアプリケーションをクリックします。
-
Webアプリケーション・ツリーで、
dcsを展開します。 -
「変数」タブをクリックします。
- 「定数」セクションからlocaleListを選択します。
- 「摘要」から言語メニューに含める言語をコピーします。
たとえば、イタリア語を使用可能にするには、次の文字列をコピーします:
{ code: "it", name: "Italiano"} - デフォルト値に追加して、JSONが正しく書式設定されていること、配列内のエントリ間のカンマ、最後のエントリの末尾にカンマがないことを確認します。
- 「実行」アイコンをクリックして、アプリケーションで変更を表示します。
- 地球アイコン(「言語」)をクリックして、追加した言語が使用可能な言語のリストに表示されることを確認します。
非英語のデフォルト言語の設定
index.htmlページで、次のエントリを見つけます。- 次のエントリを検索します:
<html lang="en"> - このエントリを
<html lang="es">に変更します。 - ここで、var langエントリを見つけます:
var lang =window.localStorage.getItem('odcs-reference-implementation.locale') || navigator.language; - このエントリを
var lang = window.localStorage.getItem('odcs-reference-implementation.locale') || "es";に変更します。
- 次のエントリを検索します:
- ここで、
app-flow.jsonファイルで、次を実行します。- 次のエントリを検索します:
"{{ window.localStorage.getItem('odcs-reference-implementation.locale') || navigator.language }}" - このエントリを
"locale": "{{ window.localStorage.getItem('odcs-reference-implementation.locale') || 'es' }}"に変更します。
- 次のエントリを検索します:
- これで、デフォルト言語はスペイン語になりました。 これらの例を使用し、必要に応じてロケール・コードに置き換えます。
新規言語の翻訳の作成
リファレンス実装を使用して作成されたDigital Customer Serviceアプリケーションで提供される言語以外の新しい言語を導入できます。
詳細は、関連トピックの『Oracle Visual Builderによるアプリケーションの開発』の翻訳の処理に関する項を参照してください。
リファレンス実装を使用して作成されたDigital Customer Serviceアプリケーションで提供される言語以外の新しい言語を導入するには、次のステップに従います。
-
Oracle Visual Builderにサインインします。
-
Digital Customer Serviceアプリケーションを開きます。
-
エディタで「メニュー」アイコンをクリックし、「設定」を選択します。
「設定」タブが表示されます。
-
「翻訳」セカンダリ・タブをクリックします。
-
すべての文字列のダウンロード・セクションの
ARBまたはXLIFFダウンロード・リンクをクリックして、最新の言語バンドルをダウンロードします。zipファイルがダウンロードされます。 -
zipファイルを開きます。
-
app-stringsファイルを展開します。
-
app-stringsファイルの名前を、ダウンロードしたファイルのタイプに応じて、app-strings-<locale>.arbまたはapp-strings-<locale>.xliffに変更します。
<locale>は言語ロケールです。たとえば、ウェールズの翻訳を含むファイルの場合、変更ファイル名は
app-strings-cy.arbまたはapp-strings-cy.xliffである必要があります。 -
app-strings-<locale>ファイルをテキスト・エディタで開きます。 ファイルの最初の数行は、次のようになります。
{ "@@x-bundleName" : "app", "@@x-bundlePath" : "webApps/dcs/resources/strings/app/nls/app-strings", "common_save" : "Save", "@common_save" : { "description" : "Used by components that perform a saving operation.", "source_text" : "Save" }, "common_cancel" : "Cancel", "@common_cancel" : { "description" : "Used by components that cancel the current operation.", "source_text" : "Cancel" }, "common_done" : "Done", "@common_done" : { "description" : "Used by components that finish an operation causing no changes.", "source_text" : "Done" }, "common_download" : "Download", "@common_download" : { "description" : "Used by components that require a download label.", "source_text" : "Download" -
英語の文字列を、作成する言語の翻訳に置き換えます。 次の
Cancel文字列について考えます。}, "common_cancel" : "Cancel", "@common_cancel" : { "description" : "Used by components that cancel the current operation.", "source_text" : "Cancel" },"common_cancel": "の後の文字列を、同じ翻訳言語に置き換えます。 この例では、文字列Cancelを、Cancelと等しいWelsh (Canslo)で置き換えます。 変更されたテキストは次のようになります。}, "common_cancel" : "Canslo", "@common_cancel" : { "description" : "Used by components that cancel the current operation.", "source_text" : "Cancel", }, -
作成している言語のすべての文字列に対して、ステップ10を繰り返します。
-
app-strings-<locale>ファイルを保存します。
-
app-strings-<locale>ファイルをステップ5でダウンロードした
zipファイルに追加し、更新したzipファイルを保存します。 -
エディタで「メニュー」アイコンをクリックし、「設定」を選択します。
「設定」タブが表示されます。
-
「翻訳」セカンダリ・タブをクリックします。
-
ステップ13で保存した
zipファイルをアップロードします。新しいapp-strings-<locale>ファイルをアップロードされた更新済バンドル・セクションに含めます。言語がバンドルに追加されます。
既存の言語の新しい文字列翻訳の追加
参照実装テンプレートから生成されたDigital Customer Serviceアプリケーションの文字列を変更した後、さらに多くの文字列を翻訳できます。
詳細は、関連トピックの『Oracle Visual Builderによるアプリケーションの開発』の翻訳の処理に関する項を参照してください。
既存の言語の新しい文字列翻訳を追加するには:
-
Oracle Visual Builderにサインインします。
-
Digital Customer Serviceアプリケーションを開きます。
-
エディタで「メニュー」アイコンをクリックし、「設定」を選択します。
「設定」タブが表示されます。
-
「翻訳」セカンダリ・タブをクリックします。
-
新規および変更された文字列のダウンロード・セクションの
ARBまたはXLIFFダウンロード・リンクをクリックして、最新の言語バンドルをダウンロードします。zipファイルがダウンロードされます。 -
zipファイルを開きます。
-
app-stringsファイルを展開します。
-
app-stringsファイルの名前を、ダウンロードしたファイルのタイプに応じて、app-strings-<locale>.arbまたはapp-strings-<locale>.xliffに変更します。
<locale>は言語ロケールです。x
たとえば、フランス語の翻訳を含むファイルの場合、変更されたファイル名は
app-strings-fr.arbまたはapp-strings-fr.xliffである必要があります。 -
app-strings-<locale>ファイルをテキスト・エディタで開きます。
-
英語の文字列を更新する言語の翻訳に置き換えます。 次の
Submit Now文字列について考えます。}, "common_submit_now" : "Submit Now", "@common_submit_now" : { "description" : "Used to submit data entered in a form immediately.", "source_text" : "Submit Now", },"common_submit_now": "の後の文字列を、同じ翻訳言語に置き換えます。 この例では、文字列Submit Nowを、Submit Now (Soumettre Maintenant)と等しいフランス語に置き換えます。 変更されたテキストは次のようになります。}, "common_submit_now" : "Soumettre Maintenant", "@common_submit_now" : { "description" : "Used to submit data entered in a form immediately.", "source_text" : "Submit Now", }, -
作成している言語のすべての文字列に対して、ステップ10を繰り返します。
-
app-strings-<locale>ファイルを保存します。
-
app-strings-<locale>ファイルをステップ5でダウンロードした
zipファイルに追加し、更新したzipファイルを保存します。 -
エディタで「メニュー」アイコンをクリックし、「設定」を選択します。
「設定」タブが表示されます。
-
「翻訳」セカンダリ・タブをクリックします。
-
ステップ13で保存した
zipファイルをアップロードします。新しいapp-strings-<locale>ファイルをアップロードされた更新済バンドル・セクションに含めます。言語バンドルが既存の言語の新しい文字列翻訳で更新されます。