1. Content HubのSitecore Connectの設定

チュートリアル: コンテンツ インポート用のアイテムの構成

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

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フォルダを右クリックし、Insertをクリックして、Bucketをクリックします。

    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. 必要なフィールドをすべて追加します。たとえば、ブログ投稿の場合は、Title 1行テキスト フィールドとBody複数行テキスト フィールドを追加します。

    The Builder tab on a CMP template item

  3. ContentタブのDataセクションのBase templateフィールドで、Content Hub Entityをクリックし、右矢印をクリックしてSelectedリストに追加します。

    The Data section on the Content tab showing how to select base templates

  4. メニュー バーのViewタブで、Standard FieldsとBucketsを選択します。

  5. メニュー バーのBuilder Optionsタブで、Standard Valuesを選択します。

  6. ContentタブのItem Bucketsセクションで、Bucketableを選択します。アイテムを保存します。

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

Entity MappingアイテムとField Mappingアイテムは、コンテンツのインポート方法と保存するバケットを定義します。

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

  1. /sitecore/system/Modules/CMPに移動し、Configを右クリックし、Insertをクリックして、Entity Mappingをクリックします。新しいアイテムの名前を入力します (例: Article)。デフォルトでは、すべてのエンティティマッピングには、表示名のデフォルトのフィールドマッパーが付属しています。

  2. 記事エンティティ マッピングで、/__Display nameを選択します。 ContentタブのCMP Field Nameフィールドに、エンティティ タイプまたはスキーマの有効なPropertyフィールド名をSitecore Content Hubに入力します。Sitecoreはこの名前を表示名として使用します。

  3. アイテムを保存します。

  4. コンテンツ ツリーで、Articleエンティティ マッピングに移動します。

    The Data section on the Content tab for the Article entity mapping

  5. ContentタブのDataセクションで、次のフィールドに入力します。

    畑

    コンテンツ

    Entity Type Schema

    Sitecore Content Hubで使用するエンティティ タイプを入力します

    Bucket

    アイテム バケットを入力して、特定のコンテンツ タイプIDのMエンティティから作成されたSitecoreアイテムを保持します

    Template

    Sitecoreアイテムの作成に使用するテンプレートを入力します。テンプレートには、インポートされたコンテンツの保存に使用されるフィールドが含まれている必要があります

    Item Name Property

    エンティティ タイプの有効なPropertyフィールド値を項目名として入力しますSitecore

  6. アイテムを保存します。

フィールド マッピングを作成する

インポートしたコンテンツをSitecoreアイテム構造にマップするには、各Entity MappingアイテムにField Mappingアイテムを追加する必要があります。インポートするフィールドごとにField Mapping項目を作成する必要があります。

Field Mappingアイテムを作成するには:

  1. 前に作成したEntity Mappingアイテムを右クリックし、Insertをクリックして、Field Mappingをクリックします。

  2. 名前( Titleなど)を入力し、OKをクリックします。

  3. ContentタブのDataセクションで、次のフィールドに入力します。

    畑

    コンテンツ

    CMP Field Name

    Sitecore Content Hubのフィールドの名前

    Sitecore Field Name

    使用しているテンプレートで定義されているフィールド名

    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

    これで、コンテンツ タイプ (この例では . M.ContentType.Blog) が表示されます。

    The content type in the entity structure JSON

リレーション フィールド マッピングの作成

リレーション フィールド マッピングを追加すると、Sitecore Content Hubの任意のコンテンツのタクソノミー フィールドをSitecoreフィールドにマッピングできます。コンテンツが複数のタクソノミー値に属している場合、マッピングは 設定された区切り文字を使用して値を区切ります。

リレーション フィールド マッピング アイテムを作成するには:

  1. 前に作成したEntity Mappingアイテムを右クリックし、Insertをクリックして、Relation Field Mappingをクリックします。

  2. 名前( Audiencesなど)を入力し、OKをクリックします。

  3. Dataセクションで、次のフィールドに入力します。

    畑

    コンテンツ

    CMP Relation

    Sitecore Content Hubエンティティのリレーション名。

    CMP Field Name

    Sitecore Content Hubリレーション エンティティのプロパティの名前。

    Sitecore Field Name

    Sitecoreがタクソノミー値を保存するコンテンツ フィールドの名前 (使用しているテンプレートで定義されているもの)。

    たとえば、Dataセクションは次のようになります。

    Data section for a relation field mapping

タグ フィールド マッピングの作成

タグ フィールド マッピングを使用すると、Content Hubの任意のコンテンツのタクソノミー フィールドをSitecoreのタグ リポジトリにマッピングできます。コンテンツが複数のタクソノミー値に属している場合、マッピングは 設定された区切り文字を使用して値を区切ります。

タグフィールドマッピングを作成するには:

  1. 前に作成したEntity Mappingアイテムを右クリックし、Insertをクリックして、Tag Field Mappingをクリックします。

  2. 名前 ( Tag Taxonomyなど) を入力します。 OKをクリックします。

  3. Dataセクションで、次のフィールドに入力します。

    畑

    コンテンツ

    CMP Relation

    Sitecore Content Hubエンティティのリレーション名。

    CMP Field Name

    Sitecore Content Hubリレーション エンティティのプロパティの名前。

    Enable / Disable to store Non-Leaf Node

    次のいずれかを選択します。

    • 非リーフ ノードを有効にする (デフォルト)

    • 非リーフ ノードの無効化

    Store Tag Name Option As

    次のいずれかを選択します。

    • フルパス名 (デフォルト)

    • ノード名

    Custom Taxonomy Provider Name

    Sitecoreカスタム分類プロバイダーの名前。カスタム分類プロバイダーを選択した場合、Sitecoreは既定の分類プロバイダーではなく、カスタム プロバイダーに分類を保存します。デフォルトのタクソノミープロバイダーを使用するには、このフィールドを空白のままにします。

    手記

    見る カスタム分類プロバイダーを構築するカスタム分類プロバイダーを構築するSitecore開発者向けドキュメントで、カスタム タクソノミー プロバイダーの作成方法に関する情報を参照してください。

    たとえば、Dataセクションは次のようになります。

    Data section for a tag field mapping

タグフィールドマッピング設定の仕組みについて詳しくは、Sitecore開発者向けドキュメントSitecore開発者向けドキュメント.

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

関連エンティティ マッピングを使用すると、Content Hubの任意のエンティティ関係をSitecoreのフィールドにマッピングできます。

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

  1. 以前に作成したエンティティマッピングアイテムを右クリックし、InsertをクリックしてからRelated entity mappingをクリックします。

  2. エンティティマッピングにPCMProductToMasterAssetなどの名前を付け、OKをクリックします。

  3. Dataセクションで、次のフィールドに入力します。

    畑

    コンテンツ

    CMP Relation

    Sitecore Content Hubエンティティのリレーション名。

    Sitecore Field Name

    Sitecoreがタクソノミー値を保存するコンテンツ フィールドの名前 (使用しているテンプレートで定義されているもの)。

    たとえば、Dataセクションは次のようになります。

    Data section for a related entity mapping
この記事を改善するための提案がある場合は、 お知らせください!