カスタムチャイルドビューの作業

コマースエンティティに子ビューを追加する

任意のCommerceエンティティに子ビューを追加してカスタムプロパティを作成できます。

以下は、サンプルHabitat_Masterカタログのプロパティを拡張するために使われた「カスタムチャイルドビュー」という子表示の例を示しています。この例では、子表示はカスタムプロパティCustom View Propertyを定義し表示しています。

!注カスタム子ビューを作成すると、それはBusiness Toolsでのみ表示されます。Sitecore Content Editorでは、追加 またはComposerテンプレートに 変換 しない限り表示されません。

例えば、カタログエンティティにカスタムプロパティを追加する子ビューを追加するには:

1. マーチャンダイジングダッシュボードを開きます。
2. カタログセクションでカタログをクリックしてください。
3. カタログ 詳細 ページの サマリー セクションのドロップダウンメニューで「 View 追加」をクリックします。
4. 「 View 追加 」ダイアログボックスで、子ビューの内部名と表示名を入力します。
5. カタログ 詳細 ページで、新しい子表示のドロップダウンメニューを開き、「 プロパティを追加」をクリックします。
6. 「 プロパティを追加 」ダイアログボックスで、新しいプロパティの内部名と表示名を入力します。その後、ドロップダウンメニューで以下のいずれかのデータ型をクリックします。
   • ストリング
   • DateTimeOffSet
   • 小数点
   • 整数
   • ブール
   • リッチテキスト
7. 新しいプロパティのデータ型に応じて、許可された値に制約を設定することも可能です。
   • 整数または小数型のプロパティに対する最大最小制約を設定するには、ドロップダウンメニューで「最小最大制約を追加」をクリックします。
   • 文字列型のプロパティの許可値を指定する には、ドロップダウンメニューで「 選択オプション制約を追加」をクリックします。

既存の子ビューをComposerテンプレートに変換する

カスタムエンティティプロパティを定義するためにCommerceエンティティに子ビューを追加した後、そのカスタム子ビューをComposerテンプレートに変換し、定義したプロパティを他のCommerceエンティティでも利用できるようにします。

既存のカスタム子ビューをComposerテンプレートに変換するには:

1. Business ToolsのCommerce項目 詳細 ページ、カスタム子表示セクションのドロップダウンメニューで「 テンプレート作成 」をクリックします。
2. 「 テンプレート作成 」ダイアログボックスで、Composerテンプレートの内部名と表示名を指定します。
3. 左側のナビゲーションペインで、Composerダッシュボードを開くには 「Composer」をクリックしてください。
4. 新しいComposerテンプレートが テンプレート セクションに掲載されているか確認してください。

作曲家テンプレートを作成する

Composerダッシュボードから直接Composerテンプレートを作成できます。

新しいComposerテンプレートを作成するには:

1. 左側のナビゲーションペインで、Composerダッシュボードを開くには 「Composer」をクリックしてください。
2. テンプレートセクションのドロップダウンメニューで「テンプレート作成」をクリックします。
3. 「 Create Template diablo」ボックスで、以下のフィールドを指定します:
   • 名前 - Composerテンプレートの内部名
   • 表示名 - Composer ダッシュボード上のComposerテンプレートの外部名
   • View Name - カスタム子ビューの内部名
   • 表示表示 表示 名前 - Commerce アイテム 詳細 ページ上の子表示の外部名
4. Composerダッシュボードのテンプレートセクションで、テンプレートセクションの新しいComposerテンプレートをクリックしてください。
5. Composerテンプレート の詳細 ページで、1つ以上のカスタムプロパティを追加してください。

Composerテンプレートから子表示を追加する

既存のComposerテンプレートからCommerceエンティティに子ビューを追加できます。Commerceエンティティメニューから子ビューを追加すると、元のComposerテンプレートに影響を与えずに子ビューに変更できます。

Composerテンプレートからカスタム子表示を追加するには:

1. 商取引項目の詳細ページ、****まとめセクションのドロップダウンメニューで「テンプレートからビューを追加」をクリックします。
2. 「 テンプレートからView 追加 」ダイアログボックスで、ドロップダウンリストの「Composer template」をクリックします。

複数のCommerceエンティティタイプにComposerテンプレートを適用してください

Composerテンプレートは、異なる細かなレベルで複数のCommerceエンティティタイプに適用できます。例えば、特定のタイプのすべてのCommerceエンティティにカスタムの子ビューを適用できます。

!注ComposerダッシュボードのComposerテンプレートから子ビューを追加すると、Commerceエンティティ内の子ビューからプロパティを追加または削除することはできません。テンプレート自体に変更を加えなければならず、その変更は子ビューを引き継ぐすべてのCommerceエンティティに適用されます。

特定のタイプのすべてのコマースエンティティにカスタム子ビューを適用するには:

1. Composerダッシュボードのテンプレートセクションで、適用したいComposerテンプレートをクリックしてください。

2. 作曲家テンプレート の詳細 ページで、リンクアイコンをクリックしてください。

3. 「 エンティティへのリンク 」ダイアログボックスで、カスタム子ビューを継承したいすべてのエンティティタイプを選択します。

   

   !注Composerテンプレートが以下のいずれかのエンティティタイプにリンクされている場合、Sitecoreコンテンツエディタはそのエンティティタイプのすべてのコンテンツ項目に対してComposerテンプレートのビューで定義されたカスタムプロパティを表示します。

   • Sitecore。Commerce.Plugin.Catalog.SellableItem

   • Sitecore。Commerce.Plugin.Catalog.category

   • Sitecore。Commerce.Plugin.Catalog.catalog

   Composerテンプレートは1つのカタログエンティティタイプ(カタログ*、カテゴリ、**または販売*可能なアイテムのいずれか)にしかリンクできません。これらのエンティティの組み合わせにComposerテンプレートをリンクすることはできません。異なるカタログエンティティタイプごとに異なるComposerテンプレートを作成する必要があります。

特定の販売可能なアイテムの一部に作曲家テンプレートを適用してください

カスタムComposerテンプレートを、タグやアイテム定義が一致する販売可能なアイテムのサブセットに適用できます。

!注カスタムプロパティをSitecoreコンテンツエディターから表示したり、ストアフロントでカスタムプロパティをレンダリングしたりするには、アイテム定義を使って販売可能なアイテムのサブセットにComposerテンプレートを適用する必要があります。

タグを使って販売可能なアイテムに適用されるComposerテンプレートのカスタムプロパティはSitecore Content Editorには表示されず、ストアフロントでレンダリングすることはできません。

販売可能なアイテムのサブセットにカスタム子表示を適用するには:

1. Composerダッシュボードのテンプレートセクションで、適用したいComposerテンプレートをクリックしてください。

2. タグが一致する販売可能な商品にテンプレートを適用するには、詳細 ページでタグアイコンをクリックしてください。

   !注タグの代わりにアイテム定義を使って、テンプレートをマッチングする販売可能なアイテムに適用するには、ステップ4に進みましょう。

3. 「 タグ管理 」ダイアログボックスで、Composerテンプレートに関連付けたいタグを入力してください。

   !注タグ文字列は完全に一致しなければなりません。タグが一致するすべての販売可能なアイテムは、カスタム子ビューとそのプロパティを引き継ぎます。

4. または、アイテム定義を使うには、作曲家テンプレート の詳細 ページで + アイコンをクリックしてください。

5. 有効な品目定義のリストを表示するには、「 アイテム定義へのアソシエイト 」ダイアログボックスのドロップダウンリストで、カタログをクリックしてください。 そのカタログで定義された品目定義 が表示されます。

6. Composerテンプレートに関連付けられたいすべてのアイテム定義を確認してください。同じアイテム定義を持つカタログ内の販売可能なアイテムはカスタム子ビューを引き継ぎます。

   !注もしComposerテンプレートがカタログエンティティタイプ(カタログ、カテゴリ、または販売可能なアイテム)のカスタムプロパティを定義している場合、Commerce Dataテンプレートをコンテンツ エディターでカスタム子表示に更新する必要があります。

Commerceエンティティから子ビューを削除する

エンティティ詳細ページから直接子ビューを追加した場合(またはCommerceエンティティのComposerテンプレートをスタート地点として選択した場合)、Commerceエンティティ自体から子ビューを削除できます。

!注まずComposerテンプレートでカスタムプロパティを定義し、その後ComposerダッシュボードからCommerceエンティティにComposerテンプレートを適用した場合、Composerテンプレート内でCommerceエンティティへの関連付けを削除しなければなりません。

例えば、Commerceエンティティから販売可能なアイテムから子ビューを削除するには:

1. Business ToolsでMerchandisingダッシュボードを開きます。

2. カタログセクションで、販売可能な商品を含むカタログ(該当する場合はカテゴリ)をクリックしてください。

3. 販売可能なアイテムセクションで、販売可能なアイテムをクリックします。

4. 販売可能なアイテム詳細ページ、削除したい子ビューがあるセクションのドロップダウンメニューで 「ビューを削除」をクリックします。

   !注削除したカスタムプロパティがComposerテンプレートを使ってCommerceエンティティに割り当てられていた場合、ビューを削除した後にCommerce Cacheを更新 する必要があります。

Composerテンプレートから子ビューを削除する

Composerダッシュボードを使ってComposerテンプレートに子ビューを追加すれば、テンプレートと特定のCommerceエンティティとの関連付けを解除できます。あるいは、Composerテンプレートが定義したカスタムプロパティをすべてのCommerceエンティティタイプで使う必要がなくなった場合は、テンプレート自体を削除することもできます。

!注もし子ビューをアイテム定義やタグで割り当てた場合、個別のアイテム定義やタグを削除することもできます。

Composerテンプレートから子ビューを削除するには:

1. Business ToolsでComposerダッシュボードを開きます。

2. テンプレートセクションで、削除したいプロパティを定義したComposerテンプレートの表示名をクリックします。

   !注関連するすべてのCommerceエンティティからComposerテンプレートを削除するには、ドロップダウンメニューの「Remove」をクリックします。

3. 特定のCommerceエンティティタイプとの関連付けを解除するには、ドロップダウンメニューをクリックし、「 エンティティへのリンク」をクリックしてください。

4. 「 エンティティへのリンク 」ダイアログボックスで、Composerテンプレートから解除したいCommerceエンティティをクリアし、変更を保存するためにチェックマークをクリックします。

5. 関連するエンティティを削除した後、Sitecoreから コマースデータテンプレートを削除 し、その後コ マースデータテンプレートを更新 してデフォルトのコマースデータテンプレートを再適用してください。

Commerceデータテンプレートの更新

Composerテンプレートを作成して、Commerceエンティティのカタログ、カテゴリ、販売可能なアイテムなどのカスタムプロパティを定義する際は、コンテンツエディターでデータテンプレートを更新し、新しいプロパティがSitecoreでそのコンテンツアイテムタイプを表示できるようにする必要があります。

!注

• Composerテンプレートを変更するたびに、Sitecoreで変更を伝播させるためにコンテンツエディターでデータテンプレートを更新する必要があります。

• エンティティ内で直接Composer Templateのプロパティを変更する場合、Content Editorでその変更を見るためには、Content EditorでCommerce Cacheをリフレッシュ する必要があります。

コンテンツエディタのComposerテンプレートで定義されたカスタムプロパティ(子ビューから)を表示するには:

1. Sitecore Launchpadで「Content Editor」をクリックしてください

2. コンテンツエディターのリボンで 「コマース」をクリックします。

3. 「 データテンプレートを更新」をクリックします。

   アップデートが完了すると、テンプレートの影響を受けたコンテンツ項目にカスタムプロパティが表示されます。

Commerceのデータテンプレートを削除してください

Sitecore Content Editorを使ってCommerceのデータテンプレートを削除します。Commerceアイテムからプロパティを削除する必要があるときに、Commerceデータテンプレートを削除します。

商務データテンプレートを削除するには:

1. Sitecore Launchpadで「Content Editor」をクリックしてください。

2. コンテンツエディターのリボンにある「 Commerce 」タブをクリックします。

3. 「 データテンプレートを削除」をクリックします。

   データテンプレートを削除した後、再度更新 して有効なCommerceテンプレートをCommerceコンテンツ項目に再適用できます。

カスタムプロパティの価値を編集する

子表示ではカスタムプロパティの値を設定または変更できます。

カスタムプロパティの値を編集するには:

1. Business Toolsで該当するエンティティビューに移動し、編集するカスタムプロパティを含む子ビューのドロップダウンメニューで「 ビュー編集」をクリックします。

2. 「 編集表示 」ダイアログボックスで、プロパティを必要な値に設定します:

   • DateTimeプロパティタイプを設定するには、Datepickerを使ってください。

   • DecimalProperty型を設定するには、十進形式で値を入力します。

   • 整数プロパティ型を設定するには、整数値を入力します。

   • ブール属性型の値をtrueに設定するには、Booleanを選択します。falseに設定するには、チェックボックスを空のままにしてください。

   • リッチテキストの値を設定するには、リッチテキストエディターを使います。

     !重要リッチテキストエディターで、保存する前にソースオプション(HTMLビュー)を無効にしてください。リッチテキスト設定をソースビューを有効にした状態で保存すると(ソースボタンがグレーアウト)、設定変更は保存されません。

     !注フォントの色や段落の書式設定など、一部の書式設定はリッチテキストエディタのウィンドウでのみ表示され、Business Toolsビューに戻っても表示されません。すべての書式情報は保持され、Business Toolsビューで見えるかどうかにかかわらずContent Editorに渡されます。

3. 変更を保存するにはチェックマークをクリックしてください。