--- title: "ウォークスルー:コンテンツインポートのためのアイテム設定" slug: "walkthrough--configuring-items-for-content-import" abstract: "Sitecore Content Hubからのインポート用にSitecoreアイテムを設定する方法。" --- # ウォークスルー:コンテンツインポートのためのアイテム設定 Sitecore Content Hubからコンテンツをインポートするには、Sitecore内で複数のアイテムを作成・設定する必要があります。 このウォークスルーでは、以下の必須アイテムの作成方法を説明します: - Bucket - インポートコンテンツの保存場所を指定すること。 - Template - インポートコンテンツ項目の構造を定義する。 - Entity mappingField mapping - インポートされたコンテンツがどのようにインポートされ、どこに保存されているかを決定します。 ウォークスルーでは、Content Hubのリレーションコンテンツの処理方法を制御する以下のオプション項目の作成方法も説明しています。 - Relation field mapping - Sitecoreフィールドへのリレーション内容のマッピング。 - Tag field mapping - 関係内容をSitecoreタグにマッピングする。 - Related entity mapping - Sitecore内の異なるContent Hubアセットタイプをリンクすること。 ## バケツを作る インポートされたすべてのコンテンツはSitecoreバケットに保存されます。例えば、すべてのブログ記事は*Blogs*というバケットに保存されます。 バケツを作成するには: 1. **CMP**フォルダを右クリックし、「**挿入**」をクリックし、「**バケット**」をクリックします。 ![The right-click menu on the CMP folder, showing the option to insert a bucket item]() 2. 例えば、バケットに*Article*、を指定し、**OK**をクリックします。 ## テンプレートを作成する インポートされたコンテンツの構造はSitecoreテンプレートによって定義されます。各テンプレートが*Content Hub Entity*テンプレートを継承していることを確実にしてください。このテンプレートには**EntityIdentifier**フィールドが含まれています。 テンプレートを作成するには: 1. 例えば*CMP*フォルダに移動し、*templates\\User Defined\\CMP Connect*。テンプレートを作成し、例えば*Blog*と名付けます。 2. 必要なすべてのフィールドを追加してください。例えば、ブログ記事の場合は「 **タイトル** 単行テキストフィールド」と **「ボディ** 多行テキストフィールド」を追加してください。 ![The Builder tab on a CMP template item]() 3. **コンテンツ**タブの**「データ**」セクションの**ベーステンプレート**フィールドで「**Content Hub Entity**」をクリックし、右矢印をクリックして**「Selected**」リストに追加してください。 ![The Data section on the Content tab showing how to select base templates]() 4. メニューバーの **「ビュー** 」タブで「 **標準フィールド** と **バケット**」を選択してください。 5. メニューバーの **ビルダーオプション** タブで「 **標準値**」を選択してください。 6. **コンテンツ**タブの**アイテムバケット**セクションで「**バケット可能**」を選択してください。アイテムを保存します。 ## エンティティマッピングを作成する *Entity Mapping*アイテムと*Field Mapping*アイテムは、コンテンツのインポート方法や保存バケットを定義します。 エンティティマッピング項目を作成するには: 1. */sitecore/system/Modules/CMP*に移動し、**Config**を右クリックし、「**Insert**」をクリックし、「**Entity Mapping**」をクリックします。新しいアイテムの名前を入力します。例えば*Article*。デフォルトでは、すべてのエンティティマッピングには表示名用のデフォルトのフィールドマッパーが付属しています。 2. 記事エンティティマッピングの中に /\_\_Display nameを選択します。 **コンテンツ** タブの**CMPフィールド名** フィールドで、エンティティタイプ(スキーマ)から有効な **プロパティ** フィールド名を入力しSitecore Content Hub。Sitecoreこの名前を表示名として使用します。 3. アイテムを保存してください。 4. コンテンツツリーでArticleエンティティマッピングに移動します。 ![The Data section on the Content tab for the Article entity mapping](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/images/Content_tab_for_Article_entity_mapping_element.png) 5. **コンテンツ**タブの**「データ**」セクションで、以下の項目を入力してください: フィールド 内容 **エンティティタイプスキーマ** Sitecore Content Hubで使用されるエンティティタイプを入力してください **バケツ** アイテムバケットを入力して、特定のコンテンツタイプIDのMエンティティから作成されたSitecoreアイテムを保持します **テンプレート** Sitecoreのアイテムを作成するためのテンプレートを入力してください。テンプレートにはインポートされたコンテンツを保存するためのフィールドが含まれていなければなりません **アイテム名プロパティ** エンティティタイプの有効な **プロパティ** フィールド値をSitecoreのアイテム名として入力してください 6. アイテムを保存してください。 ## フィールドマッピングを作成する インポートしたコンテンツをSitecoreアイテム構造にマッピングするには、各*Entity Mapping*アイテムに*Field Mapping*アイテムを追加する必要があります。インポートしたい各フィールドごとに*Field Mapping*アイテムを作成しなければなりません。 *Field Mapping*アイテムを作成するには: 1. 先ほど作成した*Entity Mapping*アイテムを右クリックし、「 **挿入**」をクリックし、「 **フィールドマッピング**」をクリックします。 2. 例えば名前を入力し、*Title*、**をクリックします**。 3. **コンテンツ**タブの**「データ**」セクションで、以下の項目を入力してください: フィールド 内容 **CMPフィールド名** Sitecore Content Hubにおけるフィールド名 **Sitecoreフィールド名** 使っているテンプレートで定義されたフィールド名 ![The Data section on the Content tab for a Field Mapping item showing the CMP FIeld Name and Sitecore Field Name fields]() 必要なだけ多くの*Field Mapping*アイテムを追加できます。 Sitecore Content Hubでエンティティの種類と構造を確認するために: 1. Sitecore Content Hubで新しいアイテムを作成したり、既存のもの(例えばブログ記事)を編集したりできます。 2. 例えばURLをコピーし、https://yourdomain/en-us/content/detail/9782、を新しいブラウザタブに貼り付けます。 > !注例のURLでは、*9782*を選択したエンティティアイテムのIDに置き換えてください。 3. URLをhttps://yourdomain/api/entities/9782に変更し、**Enter**キーを押してください。 エンティティ構造は現在JSONで表示されています。 4. エンティティのコンテンツタイプを見つけるには、**ContentTypeToContent**の関係をクリックし、リンク("href": "https://yourdomain/api/entities/9782")をたどってください。 ![The ContentType ToContent node in the entity structure JSON](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/images/ContentTypeToContent.png) ここでコンテンツタイプが示されており、この例ではM.ContentType.Blogです。 ![The content type in the entity structure JSON]() ## 関係場の写像を作成する 関係フィールドマッピングを追加すれば、Sitecore Content Hub内の任意のコンテンツのタクソノミーフィールドをSitecoreフィールドにマッピングできます。コンテンツが複数のタクソノミー値に属している場合、[マッピングは設定済みの区切り符](https://doc.sitecore.com/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/changing-mapping-delimiters.html "Changing mapping delimiters")を使って値を分離します。 リレーションフィールドマッピング項目を作成するには: 1. 先ほど作成した *エンティティマッピング* アイテムを右クリックし、「 **挿入**」をクリックし、「 **リレーションフィールドマッピング**」をクリックします。 2. 例えば、名前を入力して、*Audiences*、**をクリックします** 。 3. **データ**セクションでは、以下の項目に記入してください: フィールド 内容 **CMP関係** Sitecore Content Hubエンティティの関係名。 **CMPフィールド名** Sitecore Content Hubの関係エンティティにおけるプロパティの名前。 **Sitecoreフィールド名** Sitecoreがタクソノミー値を保存しているコンテンツフィールドの名前で、あなたが使用しているテンプレートで定義されています。 **例えば、データ**セクションは次のような見た目であるべきです: ![Data section for a relation field mapping](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/images/CMP_relation_example.png) ## タグフィールドマッピングを作成する タグフィールドマッピングは、Content Hub内の任意のコンテンツからSitecoreのタグリポジトリに分類フィールドをマッピングできます。コンテンツが複数の分類値に属している場合、[マッピングは設定済みの区切り文字](https://doc.sitecore.com/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/changing-mapping-delimiters.html "Changing mapping delimiters")を使ってそれらを分離します。 タグフィールドマッピングを作成するには: 1. 先ほど作成した *エンティティマッピング* アイテムを右クリックし、「 **挿入**」をクリックし、「 **タグフィールドマッピング**」をクリックします。 2. 例えば、名前を入力してください。 *Tag Taxonomy*。 **OK**をクリックします。 3. **データ**セクションでは、以下の項目に記入してください: フィールド 内容 **CMP関係** Sitecore Content Hubエンティティの関係名。 **CMPフィールド名** Sitecore Content Hubの関係エンティティにおけるプロパティの名前。 **非リーフノードの保存を有効化/無効化する** 以下のいずれかを選んでください: - 非リーフノードを有効にする(デフォルト) - 非リーフノードを無効化する **ストアタグ名オプション:** 以下のいずれかを選んでください: - 完全なパス名(デフォルト) - ノード名 **カスタムタクソノミープロバイダー名** Sitecoreのカスタムタクソノミープロバイダーの名前。カスタムタクソノミープロバイダーを選択すると、Sitecoreはデフォルトのタキソノミープロバイダーではなくカスタムプロバイダーにタクソノミーを保存します。デフォルトのタキソノミープロバイダーを使うには、このフィールドを空欄のままにしてください。 \> \[!注\] \> 見て [カスタムのタクソノミープロバイダーを構築する](https://doc.sitecore.com/developers/92/sitecore-experience-manager/en/build-a-custom-taxonomy-provider-for-sitecore-cortex-content-tagging.html)[カスタムのタクソノミープロバイダーを構築する](https://doc.sitecore.com/developers/92/sitecore-experience-manager/en/build-a-custom-taxonomy-provider-for-sitecore-cortex-content-tagging.html) カスタムタクソノミープロバイダーの作成方法については、Sitecore開発者ドキュメントに記載されています。 **例えば、データ**セクションは次のような見た目であるべきです: ![Data section for a tag field mapping](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/images/CMP_tag_field_mapping_example.png) タグフィールドマッピング設定の仕組みの詳細については、[Sitecore開発者向けドキュメント](https://doc.sitecore.com/en/developers/)[Sitecore開発者向けドキュメント](https://doc.sitecore.com/ja/developers/). ## 関連するエンティティマッピングを作成する 関連エンティティマッピングは、Content Hub内の任意のエンティティ関係をSitecoreのフィールドにマッピングすることを可能にします。 関連するエンティティマッピング項目を作成するには: 1. 先ほど作成したエンティティマッピング項目を右クリックし、「 **挿入**」をクリックし、「 **関連するエンティティマッピング**」をクリックします。 2. 例えばエンティティマッピングに*PCMProductToMasterAsset*、を指定し、**OK**をクリックします。 3. **データ**セクションでは、以下の項目に記入してください: フィールド 内容 **CMP関係** Sitecore Content Hubエンティティの関係名。 **Sitecoreフィールド名** Sitecoreがタクソノミー値を保存しているコンテンツフィールドの名前で、あなたが使用しているテンプレートで定義されています。 **例えば、データ**セクションは次のような見た目であるべきです: ![Data section for a related entity mapping](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/connect-for-ch/52/connect-for-content-hub/images/CMP_related_entity_mapping.png)