1. Business Toolsのローカリゼーション

チュートリアル: Business Toolsユーザー インターフェイスへの新しい言語の追加

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecore XC Business Toolsユーザー インターフェイスのデフォルト言語は英語ですが、選択した言語でインターフェイスを表示するようにBusiness Toolsを設定できます。Sitecoreがダウンロードとして提供している言語以外の言語 (デンマーク語、日本語、ドイツ語) でCommerce Business Toolsを表示するには、このチュートリアルの手順に従います。

メモ

SitecoreとXC Business Toolsは、日本語、デンマーク語、ドイツ語の言語IDとロケールをサポートするように事前設定されています。これらの言語のいずれかでビジネスツールインターフェイスを表示するには、言語リソースファイル をダウンロードしてインストール するだけです。このチュートリアルの手順に従う必要はありません。

その他の言語サポートについては、このチュートリアルを実行する前に、XML翻訳ファイルを提供してSitecoreにアップロードする 必要があります。

Business Toolsで選択した言語の翻訳ファイルがインストールされていない場合、Business Toolsのユーザー インターフェイスはデフォルトで英語になります。

このチュートリアルでは、次の方法について説明します。

このチュートリアルの最後に、Sitecore XC Business Toolsを開き、言語セレクターを使用して、新しくインストールした言語でユーザー インターフェイスを表示できます。

Sitecoreシステム設定に新しい言語を追加する

新しい言語コードと関連する国/地域コードをSitecore内で設定可能にするには、Sitecoreシステム設定で新しい言語を追加する必要があります。

Sitecoreシステム設定に言語を追加するには:

  1. コンテンツ エディタで、/sitecore/System/Languagesに移動します。

  2. 右クリックして、Insert, Languageをクリックします。

  3. Add a New LanguageダイアログボックスのChoose a predefined language codeフィールドで、使用する言語コードを選択し、必要に応じて残りのフィールドに入力し、Nextをクリックしてウィザードの残りのページを進めます。終了したら、Closeをクリックします。

    The Add a New Language dialog box in Sitecore Content Editor.

    新しい言語がコンテンツ ツリーに追加されます。

  4. 「 Save 」をクリックして変更を保存します。

Commerceコントロール パネルに新しい言語を追加する

Commerceコントロール パネルに新しい言語を追加すると、その言語をSitecore Experience Commerceで利用できるようになります。

Commerce Control Panelに新しい言語を追加するには:

  1. コンテンツ エディタで、/sitecore/Commerce/Commerce Control Panel/Shared Settings/Language Sets/Defaultsに移動します。

  2. Commerce Control Panelセクションで、追加した新しい言語をダブルクリックしてSelected列に移動します。

    The language selector in the Commerce Control Panel.

  3. 保存 をクリックして変更を保存します。

コンテンツ パスの同期

新しい言語をCommerceコントロール パネルで利用できるようにした結果、新しいコンテンツ アイテムがSitecoreに作成されました。これらの新しいアイテムをCommerce Engineで、ひいてはBusiness Toolsで表示するには、PostmanのSync content pathサンプル リクエストを使用してコンテンツを同期する必要があります。

コンテンツパスを同期するには:

  1. Postmanで、Sync content pathサンプル要求を実行します。

    手記

    項目の同期操作が完了したら、Redisキャッシュをクリアしてください。

  2. Microsoft IIS Managerで、Commerce Engineアプリケーションを再起動します。

  3. Microsoft IISマネージャで、Business Toolsアプリケーションを再起動します。

Commerce EngineのGlobalEnvironmentポリシーに言語を追加します

Commerce Engineが新しい言語を認識するには、言語コードをSitecore.Commerce.Core.GlobalEnvironmentPolicyポリシー ファイルに追加してから、Commerce Engineをブートストラップする必要があります。

言語をCommerce Engineに追加するには:

  1. \inetpub\wwwroot\CommerceAuthoring_Sc\wwwroot\data\Environmentsに移動します。

  2. PlugIn.<catalog name>.CommerceAuthoring-1.0.0.jsonファイルを開きます。

  3. Sitecore.Commerce.Core.GlobalEnvironmentPolicyセクションの 言語 セクションで、新しい言語を言語セットに追加し、ファイルを保存します。

    {
        "$type": "Sitecore.Commerce.Core.GlobalEnvironmentPolicy, Sitecore.Commerce.Core",
        "Languages": {
          "$type": "System.Collections.Generic.List`1[[System.String, mscorlib]], mscorlib",
          "$values": [
            "en",
            "de-DE",
            "ja-JP",
            "fr-FR"
          ]
        },

  4. Postmanを使用して、Commerce Engineを ブートストラップ します。

  5. Postmanを使用して、<catalog>Shops環境キャッシュをクリアします。

  6. コンテンツ エディターで、Commerceタブをクリックし、Refresh Commerce Cacheをクリックします。

  7. ブラウザのキャッシュをクリアします。

  8. IISマネージャーを開き、Commerce Engineオーサリングを再起動します。

を作成します。JSON言語ファイル

Business Toolsインターフェイス ラベル (ユーザー インターフェイス ラベルの大部分を含む) の翻訳を含むXMLファイルに加えて、.JSON言語ファイルは、さらにいくつかのラベルと検証エラーメッセージ (合計9つの追加文字列) を翻訳するために使用されます。Business Toolsのユーザ インターフェイス全体を翻訳する場合は、必要な言語を作成する必要があります。JSONファイルを作成し、追加のラベルを翻訳します。

手記

必要に応じて、ローカリゼーションプロセスを簡略化するために、この手順をスキップできます。新しい言語のJSONファイルを作成しない場合、Business Toolsにはこれらの追加の9つの文字列が英語で表示されます。

言語のXMLファイル内で翻訳された他のすべてのラベル (インターフェイスの大部分を表す) は、追加の手順を必要とせず、新しく設定された言語で表示されます。

次に、英語の言語JSONファイル ( en.jsonファイル) の内容のサンプルを示します。これは、追加のラベル文字列を示しています。

{
    "ValidationErrors": {
        "IsRequired": "{{DisplayName}} is required.",
        "IncorrectDecimalValue": "{{DisplayName}} has an incorrect decimal value.",
        "IncorrectDateValue": "{{DisplayName}} has an incorrect date value."
    },
    "ActionExecuted": "{{DisplayName}} executed.",
    "Back": "Back",
    "Logout": "Log out",
    "LanguageSelector": "Language displayed",
    "NoSearchResults": "No results matching your search were found.",
    "Searching": "Searching..."
}
手記

Sitecore XCには .次の言語のJSONファイル:英語(en.json)、ドイツ語(de-DE.json)、フランス語(fr-FR.json)、日本語(ja-JP.json)。

を作成するには。別の言語のJSON言語ファイル:

  1. Business Toolsがインストールされているサーバで、c:/inetpub/wwwroot/SitecoreBizFxSite\assets\i18nに移動し、既存のファイルの1つ ( en.jsonファイルなど) をコピーし、必要な言語の名前 (スペイン語の場合はes-ES.jsonなど) を反映するようにファイルの名前を変更します。

  2. ファイルを開き、英語の文字列を翻訳された文字列に置き換えます。

  3. ファイルを保存します。

新しい言語IDを登録し、Business Toolsアプリケーションを再コンパイルします

前の手順 で新しいJSONファイルを作成した場合は、新しい言語を登録してアプリケーションを再コンパイルする必要があります。JSON言語ファイルで翻訳されたXC Business Toolsユーザーインターフェースの部分は、ユーザーインターフェースに適切に表示するためにAngularローカライゼーションフレームワークに依存しています。

手記

この手順は、開発環境でSitecore.BizFX.SDKをセットアップしてデプロイ していることを前提としています。

Business Toolsアプリケーションで新しい言語IDとロケールを登録するには:

  1. 開発環境で、Sitecore.BizFX.SDKフォルダーを開き、src/app/app.module.tsファイルを開きます。

  2. ファイルの /* Locales */という名前のセクションで、追加の言語を追加します。

    次の例は、スペイン語の言語ID (es) とロケール (ES) の追加サポートを示しています。

    /* Locales */
import localeFr from '@angular/common/locales/fr';
import localeFrExtra from '@angular/common/locales/extra/fr';
import localeJa from '@angular/common/locales/ja';
import localeJaExtra from '@angular/common/locales/extra/ja';
import localeDe from '@angular/common/locales/de';
import localeDeExtra from '@angular/common/locales/extra/de';
import localeEs from '@angular/common/locales/es';
import localeEsExtra from '@angular/common/locales/extra/Es';

registerLocaleData(localeFr, 'fr-FR', localeFrExtra);
registerLocaleData(localeJa, 'Ja-JP', localeJaExtra);
registerLocaleData(localeDe, 'de-DE', localeDeExtra);
registerLocaleData(localeEs, 'es-Es', localeEsExtra);
/**

  3. 変更を保存して、Angular import関数とregisterLocaleData(...) 関数を呼び出します。

  4. Business Tools (BizFx) アプリケーションを再コンパイルします。

この記事を改善するための提案がある場合は、 お知らせください!