---
title: "ウォークスルー:関連するすべてのエンティティを取得するための関連エンティティマッピングの設定"
slug: "walkthrough--configuring-related-entity-mapping-to-retrieve-all-related-entities"
abstract: "Sitecoreで関連エンティティマッピングを設定し、Content Hubで関連エンティティとして定義されたすべてのアイテムを取得します。"
---
# ウォークスルー:関連するすべてのエンティティを取得するための関連エンティティマッピングの設定

Content Hubでは、CMPアイテムに複数のアイテムが紐付いている場合、Sitecoreの関連エンティティマッピングは最初のCMPアセットのみを取得します。他の関連エンティティは取得しません。このウォークスルーでは、Content HubでCMPアイテムに紐づいたすべてのアセットを取得し、それらがSitecoreで利用可能になる方法を説明します。

このウォークスルーでは、以下の方法を説明します:

-   エンティティのフィールドのテンプレートを作成します
-   以前作成したテンプレートのバケットを作成します
-   エンティティマッピングを作成する
-   フィールドマッピングを作成する
-   関連するエンティティマッピングを作成します
-   エンティティを同期する
-   Sitecore検索インデックスの再構築

## エンティティのフィールドのテンプレートを作成します

この手順は、CMPエンティティのフィールドのテンプレートを作成する手順を示しています。

エンティティのフィールドのテンプレートを作成するには:

1.  コンテンツエディターで/sitecore/templates/に行き、右クリックしてから「**新しいテンプレート**\>**挿入**」をクリックします。
    
2.  例えばテンプレート名を入力してください。 *Products*。
    
3.  後で使う関連エンティティマッピング用の新しいフィールドを作成します。
    
    以下の例では **、ProductImage**という新しいフィールドが作成され、フィールドタイプは**Multilist**です。
    
    ![The new field properties, including the field name, type and source.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/images/Create_a_new_field.png)
    
4.  CMPエンティティのフィールドのテンプレートを追加するには、**コンテンツ** タブの **「データ** 」セクションで「 **CMP**」をクリックし、その後「 **Content Hub Entity**」をダブルクリックしてください。
    
    > !注DAMエンティティのフィールドのテンプレートを追加するには、DAMをクリックし、その後Content Hub Entityをダブルクリックしてください。
    
    Content Hubエンティティのベーステンプレートは、選択されたテンプレートリストに含まれます。例えば:
    
    ![The selected base template.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/images/Selected_base_template.png)
    
5.  これらの手順をすべての必要なエンティティのフィールドで繰り返します。
    

## 新しいテンプレート用のアイテムバケットを作成します

Sitecoreでは、アイテムバケットを使ってコンテンツツリー内の大量のアイテムを管理できます。 [前のステップ](https://doc.sitecore.com/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/walkthrough--configuring-related-entity-mapping-to-retrieve-all-related-entities.html#UUID-bfbef1c7-b365-6e65-d892-3fb272a96dc8_section-idm4576067513596833902867611811 "Create a template for the entity's field")で作成した各テンプレートごとにバケットを作成します。

バケツを作成するには:

1.  コンテンツエディターで /sitecore/Content/CMPに移動します。
2.  CMP項目を右クリックし、「 **Insert** > **Bucket**」をクリックします。
3.  新しいバケットアイテムの名前を入力します。例えば、 *Assets* 、または *Products*。

## エンティティマッピングを作成する

エンティティマッピングアイテムは、特定のコンテンツタイプのエンティティをContent Hubで同期させることができます。以前作成した各テンプレートごとにエンティティマッピングを作成してください。

エンティティマッピングを作成するには:

1.  /sitecore/system/Modules/CMP/Configに移動し、右クリックして**「挿入**」をクリックし、「**エンティティマッピング**」をクリックします。
    
2.  例えば、エンティティマッピングの名前を入力します。 *Products*。
    
3.  エンティティマッピングのフィールド値を入力します。例えば:
    
    ![An example of an entity mapping properties, including the Entity Type Schema, Bucket, Template, and the Item Name Property.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/images/Products_entity_mapping.png)
    
4.  これらの手順は、必要に応じて各実体のマッピングで繰り返します。例えば*Assets*実体に対してです。
    

## 場の写像を作成する

Sitecoreのフィールドマッピングは、Content Hubエンティティ内のフィールド名とSitecoreアイテム内のフィールド名を含みます。フィールドマッピングを作成するには:

1.  以前作成したエンティティマッピングのいずれかを右クリックし、例えば *Products*を選び、 **挿入**をクリックしてから **フィールドマッピング**をクリックします。
2.  **CMPフィールド名**と**Sitecoreフィールド名**の値を入力してください。
3.  各フィールドごとにこれらの手順を繰り返します。

## 関連するエンティティマッピングを作成します

関連するエンティティマッピングを作成するには:

1.  以前作成したエンティティマッピングのいずれかを右クリックし、「**関連するエンティティマッピング**\>**挿入**」をクリックします。
2.  これらの手順を各エンティティマッピングごとに繰り返します。

## エンティティを同期させる

コンテンツエディターで必要な項目を作成したら、エンティティをContent HubからSitecoreに同期できます。エンティティは関連するエンティティマッピングを表示します(もしあれば)。例えば、Sitecoreに同期され、*Products*エンティティに関連する*Assets*エンティティは**ProductImage**フィールドに表示されます。

エンティティを同期するには:

1.  コンテンツエディターのリボン部分で**DAM**をクリックします。
    
2.  コンテンツツリーで、DAMアセットプロパティと同期させたいアイテムフィールドをクリックします。
    
    > !注フィールドはImageまたはLinkのタイプでなければなりません。
    
3.  リボンの上で **「同期**」をクリックし、ドロップダウンメニューで以下のいずれかを選びます:
    
    -   選択したフィールドのプロパティのみを同期するには、「 **同期現在**」をクリックしてください。
    -   選択したターゲットアイテムの下のすべての子のプロパティを同期するには、「 **子を同期**」をクリックしてください。
4.  **DAMバッチ同期**ダイアログで「**次へ**」をクリックし、**ターゲットアイテム**フィールドに同期すべき正しいアイテムが表示されているか確認してください。
    
5.  バッチ **同期開始**をクリックします。
    

関連するエンティティマッピングを持つエンティティは、関連するエンティティを表示します。例えば、Sitecoreに同期され*Products*エンティティに関連する*Assets*エンティティは、以下の例のように**ProductImage**フィールドに表示されます。

![An example showing a Content Hub entity synchronized in Sitecore.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/images/Synced_entities.png)

## Sitecoreインデックスの再構築

Sitecoreインデックスを再構築するには:

1.  例えばSitecore URLにアクセスしてhttps://xp1cm.localhost/ し、コントロールパネルを開きます。
    
2.  **インデックスセクション**で**「Polulate Solr Managed Schema**」をクリックしてください。
    
3.  スキーマポピュレートダイアログで「 **すべて選択**」をクリックし、次に **「ポピュレート」**をクリックします。
    
    手続きが終わるのを待ちましょう。
    
4.  コントロールパネルの **インデックス** セクションで「 **インデックスマネージャー**」をクリックします。 **インデックスマネージャー** のダイアログで、以下のインデックスを選択します:
    
    -   sitecore\_master\_index
    -   sitecore\_core\_indexsitecore\_core\_index
    -   sitecore\_web\_index
    -   sitecore\_marketing\_asset\_index\_master
    -   sitecore\_marketing\_asset\_index\_web データベース
5.  「 **再構築**」をクリックします。インデックスが再構築されたら、「 **閉じる**」をクリックします。