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

Commerceエンティティのプロパティをローカライズ可能にする

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

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

コマース エンティティのプロパティをローカライズ可能にするには、PlugIn.LocalizeEntities.PolicySet-1.0.0.jsonファイルにLocalizeEntitiesポリシーを追加します。LocalizeEntitiesポリシーの説明については、LocalizeEntitiesポリシー・セットを参照してください。

メモ

次の手順を使用して、既定のBusiness Toolsビューと子ビューのプロパティを公開するだけでなく、カスタム プラグインに実装するプロパティも公開できます。

Composerを使用して作成したエンティティ ビューのプロパティはローカライズできません。

マーチャンダイジング ツールでは、既定のSellable商品の概要ビューには、いくつかの既定のプロパティを持つ子ビューの 商品仕様 が含まれています。アイテム仕様 プロパティは既定ではローカライズできません。つまり、PlugIn.LocalizeEntities.PolicySet-1.0.0.jsonにはその子ビューを指定するポリシーが含まれていません。次の例は、一部のItem Specificationsプロパティをローカライズ可能にする方法を、具体的にはSellable商品レベルとSellableバリアント レベルでローカライズする方法を示しています。

Sellable商品のエンティティ プロパティをローカライズ可能にする

商品仕様の子ビューのプロパティをSellable商品レベルでのみローカライズ可能にするには、次の手順に従います。

手記

ポリシー構成では、正確なプロパティ名を指定する必要があります。正確なプロパティ名がわからない場合は、Postmanを使用してエンティティ ビューを取得する要求を送信し、応答内で返されるプロパティの名前を確認できます。

  1. wwwroot\<CommerceEngineService>\wwwroot\data\Environments\PlugIn.LocalizeEntities.PolicySet-1.0.0.jsonファイルを開きます。

  2. このファイルで、"ComponentsPolicies" セクションの下にある既存のエンティティ タイプ "Type": "Sitecore.Commerce.Plugin.Catalog.SellableItem"を見つけ、次の例に示すように、LocalizeEntityComponentPolicyポリシーのインスタンスを追加します。

     {
    "$type": "Sitecore.Commerce.Core.LocalizeEntityPolicy, Sitecore.Commerce.Core",
    "Type": "Sitecore.Commerce.Plugin.Catalog.SellableItem",
    "Properties": [
      "DisplayName",
      "Description",
      "Brand"
    ],
    "ActionView": "Details",
    "ComponentsPolicies": [
      {
         "$type": "Sitecore.Commerce.Core.LocalizeEntityComponentPolicy, Sitecore.Commerce.Core",
         "Path": "ItemSpecificationsComponent",
         "Properties": [
            "WeightUnitOfMeasure",
            "DimensionsUnitOfMeasure"
            "SizeOnDiskUnitofMeasure"
            ],
            "ActionView": "ItemSpecifications",
            "IsItemComponent": false
       },
 }
    手記

    "IsItemComponent": falseプロパティは、リストされた子ビュープロパティがSellable商品レベルでのみローカライズ可能であることを示します。この場合、Sellableバリアントは、ローカライズされたプロパティ値をSellable Itemエンティティから継承します。

    プロパティを商品バリアント レベルのみ (Sellable商品エンティティ レベルではなく) ローカライズ可能にするには、"IsItemComponent": をtrueに設定します。

  3. Commerce Engineをブートストラップ して、設定の変更を登録します。

プロパティをSellable商品レベルとバリアント レベルでローカライズ可能にする

また、プロパティがSellable商品レベルとバリアント レベルの両方で個別にローカライズできるように、ポリシー構成を設定することもできます。これは、アイテム仕様のプロパティではありそうにないシナリオですが、必要に応じて、他のビュー プロパティの例として使用できます。

商品仕様プロパティのプロパティをSellable商品と商品バリアント レベルの両方でローカライズ可能にするには、次の手順に従います。

  1. wwwroot\<CommerceEngineService>\wwwroot\data\Environments\PlugIn.LocalizeEntities.PolicySet-1.0.0.jsonファイルで、Sellable商品レベル ("Path":"ItemSpecificationsComponent") と商品バリアント レベル ("Path": "ItemVariationsComponent.ItemVariationComponent.ItemSpecificationsComponent") にポリシーを追加し、"IsItemComponent" プロパティを "true"に設定します。

     {
    "$type": "Sitecore.Commerce.Core.LocalizeEntityPolicy, Sitecore.Commerce.Core",
    "Type": "Sitecore.Commerce.Plugin.Catalog.SellableItem",
    "Properties": [
      "DisplayName",
      "Description",
      "Brand"
    ],
    "ActionView": "Details",
    "ComponentsPolicies": [
      {
         "$type": "Sitecore.Commerce.Core.LocalizeEntityComponentPolicy, Sitecore.Commerce.Core",
         "Path": "ItemSpecificationsComponent",
         "Properties": [
            "WeightUnitOfMeasure",
            "DimensionsUnitOfMeasure"
            "SizeOnDiskUnitofMeasure"
            ],
            "ActionView": "ItemSpecifications",
            "IsItemComponent": false
       },
       {
         "$type": "Sitecore.Commerce.Core.LocalizeEntityComponentPolicy, Sitecore.Commerce.Core",
         "Path": "ItemVariationsComponent.ItemVariationComponent.ItemSpecificationsComponent",
         "Properties": [
            "WeightUniOfMeasure",
            "DimensionsUnitOfMeasure"
            "SizeOnDiskUnitofMeasure"
            ],
            "ActionView": "ItemSpecifications",
            "IsItemComponent": true
       },
}

  2. Commerce Engineをブートストラップ して、設定の変更を登録します。

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