---
title: "コンテンツアイテムにJSONテンプレートを追加する"
slug: "add-a-json-template-to-a-content-item"
abstract: "コンテンツ項目にJSONテンプレートを割り当てる手続き的手順。"
---
# コンテンツアイテムにJSONテンプレートを追加する

> !重要機能の利用可能性は段階的に展開される一環です。あなたの組織はまだ検索体験機能が表示されていないかもしれません。環境が導入された際に利用可能になります。

SitecoreAIで検索コンポーネントを追加する際には、コンテンツ項目を割り当てる必要があります。コンテンツアイテムとは、Sitecoreのコンテンツツリー内の構造化された情報のことです。各項目は、ページ、コンポーネント、構成オブジェクト、データソース、機能定義など、ウェブサイト上のエンティティを表しています

ウェブサイト上の他の存在と同様に、検索体験もコンテンツの一種です。コンテンツツリーには独立したアイテムとして現れ、その体験の挙動やレンダリングを制御するフィールドがあります。

検索体験はコンテンツ項目にJSONを追加することで設定できます。この文脈では、コンテンツアイテムに追加するJSONがテンプレートとして機能し、検索コンポーネントが期待する構造と必要なプロパティを定義します。JSONを追加することで、どの検索インデックスを使うかやUIフィールドのマッピング方法など、コンポーネントに有効な設定値が割り当てられ、必要な項目が欠けている場合のレンダリング問題を防げます。

JSONテンプレートには、検索コンポーネントを実行するための以下のコアプロパティが含まれなければなりません:

-   **searchIndex** - 検索先/クエリインデックスのGUID。
-   **fieldsMapping** - コンポーネントUIフィールドをテンプレート内のコンテンツフィールドにマッピングします。

> !注**始める前に**「 [検索体験で始める](https://doc.sitecore.com/sai/en/users/sitecoreai/get-started-with-search-experiences.html)」に従って、検索体験が環境に合わせて設定されていることを確認してください。

## コンテンツアイテムをJSONテンプレートで設定してください

JSONテンプレートでコンテンツアイテムを設定するには:

1.  **コンテンツエディター**の左側のコンテンツツリーで、**/sitecore/content/sync//Data/Search Experiences/global-search**へ移動してください。
2.  検索体験コンテンツ項目を挿入するか、既存の検索経験コンテンツ項目をクリックしてください。
3.  **データ**セクションの**検索**欄で、必要なJSONプロパティを入力します。詳細は以下のコードサンプルをご覧ください。
4.  **「保存**」をクリックします。
5.  トップメニューバーで **「公開**」をクリックします。
6.  「 **公開** 」ドロップダウンリストで「 **公開サイト** 」または「 **アイテム公開**」をクリックします。

### コンテンツ項目テンプレートの例

コンテンツ項目のJSONテンプレートは、検索コンポーネントが期待する構造を定義しています。実際の値を入力する必要はなく、コンポーネントは実行時に自動的にこれらの値を入力します。そのため、以下の例では各プロパティに空のダブルクォート値が記載されています。

> !注searchIndexの値は [、あなたのソースID](https://doc.sitecore.com/sai/en/users/sitecoreai/create,-view,-and-delete-sources.html)と一致しなければなりません。

{
 "searchIndex": "fdd88035-ea32-4b6f-a0af-d4e869905c53",
 "fieldsMapping": {
 "tags":"",
 "images":"",
 "description":"",
 "title":"",
 "type":"",
 "link":"",
 }
}