1. Sitecore Connectの設定Content Hub

ウォークスルー:コンテンツインポートのためのアイテム設定

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

このページの翻訳は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単行テキストフィールドと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開発者ドキュメントをご参照ください。

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

関連エンティティマッピングは、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
この記事を改善するための提案がある場合は、 お知らせください!