多言語サポートのための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に相当するウェールズ語である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>ファイルをアップロードされた更新済バンドル・セクションに含めます。言語バンドルが既存の言語の新しい文字列翻訳で更新されます。