---
title: "カタログアイテムテンプレートに新しいフィールドを追加する"
slug: "add-new-fields-to-a-catalog-item-template"
abstract: "カタログ内の商品項目には、カタログスキーマを拡張するか、カタログ商品テンプレートを拡張することで、商品にフィールドを追加できます。このトピックでは、コンテンツエディターでカタログ商品テンプレートを修正して商品にフィールドを追加する方法について説明します。"
---
# カタログアイテムテンプレートに新しいフィールドを追加する

カタログ内のカテゴリ、バンドル、バリアント、商品などの商品にフィールドを追加できるのは、以下の方法でです:

-   Business Toolsの[Composer機能](https://doc.sitecore.com/xp/en/users/100/sitecore-experience-commerce/en/adding-properties-to-commerce-entities.html) を使ってカタログスキーマを拡張し、テンプレートを作成します。その後、マーチャンダイジングツールを使って新しいフィールドを編集できます。ただし、コンテンツエディターやエクスペリエンスエディターではこれらのフィールドは読み取り専用です。カタログスキーマを拡張すると、追加した値は製品に関連付けられるすべての場所で共有されます。詳細については、「 [Commerce itemsへのプロパティ追加](https://doc.sitecore.com/xp/en/users/100/sitecore-experience-commerce/en/adding-properties-to-commerce-entities.html)」をご覧ください。
    
    > !注カタログスキーマをプログラム的に拡張する方法については、[ナレッジベース](https://kb.sitecore.net/articles/083614)をご覧ください。
    
-   テンプレートマネージャーを使ってカタログアイテムテンプレートを拡張する方法。これらの新しいフィールドはマーチャンダイジングツールで編集できませんが、コンテンツエディターとエクスペリエンスエディターで編集できます。カタログアイテムテンプレートを拡張すると、追加した値は共有されず、製品が関連付けられているすべての場所で設定しなければなりません。
    

![An example of a catalog item field displayed in the Content Editor.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/MaterialsSection.png)

カタログアイテムテンプレートにフィールドを追加するには、Commerce Foundationがテナントスキャフォールディング中に作成した */sitecore/Templates/Project/Sitecore/Commerce Product*テンプレートを修正してください。デフォルトでは、各Commerceテナントごとに1つのテンプレートがあり、そのテナントのすべてのサイトで共有されます。このテンプレートは、データプロバイダーに付属しているものを含む多数の基礎的な商業専用テンプレートから継承されています。このテンプレートは必要に応じて変更可能です。

> !重要データ提供者に提供されるCE Connectの一環として提供される */sitecore/Templates/Commerce/Catalog/Commerce Product*テンプレートは変更しないでください。

## 追加フィールドを含むセクションを追加してください

すべてのSitecore固有テンプレートフィールドと同様に、データはカタログ内の*ExternalSettingsComponent*リポジトリに保存されます。ただし、Commerce Business Toolsではデータを編集または閲覧することはできません。

> !注ルートテナントフォルダが混雑しないように、新しいテンプレートは他のテンプレートのセクションを表すサブフォルダに保存してください。

追加フィールドを含むセクションを追加するには:

1.  *sitecore\\Templates\\Project\\*に移動し、テナントを右クリックして「**Insert」→「Template Folder」**をクリックし、**メッセージ**ダイアログボックスでフォルダ名(例えば*Catalog Item Section Templates*)を入力し、「**OK」**をクリックします。
    
2.  新しく作成したフォルダを右クリックし、「**挿入」→「新しいテンプレート**」をクリックし、「**名前選択**」ダイアログボックスで新しいテンプレートの名前を入力します。例えば、***Product Media Assets*、次を**クリックして再度**「次へ**」をクリックし、「**閉じ**る」をクリックしてください。
    
3.  **ビルダー**タブで最初のフィールドをクリックし、新しいセクションの名前(例:*Media Material*)を入力してください。
    
4.  「 **新しいフィールドを追加」** ボックスをクリックし、新しいフィールドの名前(例: *Video*)を入力し、型リストからアイテムタイプを選択します(例: *File*)。
    
5.  「 **新しいフィールドを追加** 」ボックスをクリックし、新しいフィールドの名前(例: *Image*)を入力し、型リストからアイテムタイプを選択します(例: *Image*)。
    
    ![Builder tab showing the new fields.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/AddTemplateItemProperties.png)
    
6.  リボンの上で「 **保存**」をクリックします。
    
7.  コンテンツエディターで*sitecore/Templates/Commerce/Catalog*に移動し、新しいセクションやフィールドを追加したいテンプレートを選択してください。例えば*Commerce Product*。
    
    > !注テナントベースのCommerce Productテンプレートに新しいベーステンプレートを追加すると、変更はテナントの下にあるサイトにのみ影響します。変更がすべてのテナントとサイトに影響を及ぼすには、新しいベーステンプレートをCE Connectが提供するCommerce Productテンプレートに追加する必要があります。
    
8.  **コンテンツ**タブの**「データ**」セクションの**ベーステンプレート**リストで、*Templates\\Project\\\\*に行き、新しく作成したテンプレート*Product Media Assets*をダブルクリックして**「選択リスト**」に移動させます。
    
    ![Extending the Commerce Product template](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/MaterialsSelected.png)
    
9.  リボンの上で「 **保存**」をクリックします。
    

## 新しいフィールドに値を追加する

例えば、製品が2つのカテゴリーで入手可能の場合、その製品の新しいフィールドに両方のカテゴリで値を追加しなければなりません。例えば、*Studio X Over-the-Earワイヤレスヘッドホン* 製品がオーディオとFeaturedの両方のカテゴリに存在し、Audioカテゴリから新しいフィールドに値を追加した場合、これらの値は自動的にFeaturedカテゴリの*Studio Xオーバーイヤーワイヤレスヘッドホン* 製品に引き継がれません。

新しいフィールドに値を追加するには:

1.  コンテンツエディターで、例えば*sitecore/Content//Home/Catalogs/Habitat\_Master/Departments/Audio/*にアクセスし、*例えばStudio Xのオーバーイヤーワイヤレスヘッドホン*をクリックしてください。
    
    ![Adding values to the newly created fields](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/MaterialsSelected2.png)
    
2.  **メディアマテリアル**セクションの動画欄で**「****ファイルを開く**」をクリックし、動画ファイルをクリックしてください。
    
3.  **画像**欄で「**ブラウズ」**をクリックして画像を選択してください。
    
4.  リボンの上で「 **保存**」をクリックします。
    
    > !注コンテンツは公開する必要はありません。データ提供者は保存後、コンテンツ管理(CM)インスタンスとコンテンツ配信(CD)インスタンスの両方で同じコンテンツを公開します。
    

## ストアフロントで変更をレンダリングします

ストアフロントで変更をレンダリングするには:

1.  コンテンツエディターで */sitecore/Content///Presentation/Rendering Variants/Page Content*に行き、**ページコンテンツ**を右クリックし、**挿入、バリアント定義** をクリック、**メッセージ** ダイアログボックスで名前を入力し、例えば*Materials*、**OK**をクリックします。
    
2.  新しく作成したバリアント定義を右クリックし、「 **挿入」→「応答画像**」をクリックし、名前を入力してOK**をクリックし、**リボンメニューで「 **保存**」をクリックします。
    
3.  レスポンシブ画像サブアイテムを選択し、「 **コンテンツ** 」タブで **フィールド** 名の値を*Responsive Image*から*Image*に変更します。これは新しく作成された画像フィールドの名前で、「 **保存**」をクリックします。
    
4.  コンテンツエディターで */sitecore/Content///Presentation/Partial Designs*へ行ってください。
    
5.  右クリックで **「デフォルトメインプロダクトページコンテンツ** 」をクリックし、「 **エクスペリエンスエディター**」をクリックします。
    
6.  エクスペリエンスエディターのツールボックスの **ページ** コンテンツセクションで、**ページコンテンツ** レンダリングをクリックしてページにドラッグします。
    
7.  ページコンテンツツールバーのバリアントリストから「 **Materials** variant」をクリックします。
    
    ![The Materials variant on the Page Content toolbar.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/MaterialsSelected3.png)
    
8.  リボンの上で「 **保存**」をクリックします。
    
9.  変更点を公開してください。