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

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

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

Sitecore Content Hub からコンテンツをインポートするには、Sitecore でいくつかのアイテムを作成して設定する必要があります。

このチュートリアルでは、次の必須アイテムを作成する方法について説明します。

  • Bucket - インポートされたコンテンツを保存する場所を指定します。

  • Template - インポートされたコンテンツ アイテムの構造を定義します。

  • Entity mapping と Field mapping - インポートされたコンテンツがどのようにインポートされ、どこに保存されるのかを決定します。

このチュートリアルでは、コContent Hub のリレーション コンテンツの処理方法を制御する次のオプション アイテム作成する方法についても説明します。

  • Relation field mapping - リレーション コンテンツを Sitecore のフィールドにマッピングする。

  • Tag field mapping - リレーション コンテンツを Sitecore のタグにマッピングする。

バケットを作成する

インポートされたすべてのコンテンツは Sitecore バケットに保存されます。たとえば、すべてのブログ投稿は、Blogs というバケットに保存されます。

バケットを作成するには:

  1. CMP フォルダーを右クリックし、[挿入] をクリックして [バケット] をクリックします。

    CMP フォルダーのクリック メニューに、バケット アイテムを挿入するオプションが表示されます

  2. バケットに名前を付け (例: Article)、[OK] をクリックします。

テンプレートの作成

インポートされたコンテンツの構造は、Sitecore テンプレートによって定義されます。各テンプレートは、Content Hub エンティティ テンプレートを継承している必要があります。このテンプレートには、 EntityIdentifier フィールドが含まれています。

テンプレートを作成するには:

  1. CMP フォルダー (例: templates\User Defined\CMP Connect) に移動します。テンプレートを作成し、Blog などの名前を付けます。

  2. 必要なすべてのフィールドを追加します。たとえば、ブログ投稿の場合は、Title という Single-Line Text フィールドと、Body という Multi-Line Text フィールドを追加します。

    CMP テンプレート アイテムの [ビルダー] タブ

  3. [データ] セクションの [ベース テンプレート] フィールドで、[Content Hub エンティティ] をクリックし、右矢印をクリックして [選択済み] リストに追加します。

    基本テンプレートの選択方法を示す [コンテンツ] タブの [データ] セクション

  4. メニュー バーの [表示] タブで、[スタンダード フィールド] および [バケット] を選択します。

  5. メニュー バーの [ビルダー オプション] タブで、[スタンダード バリュー] を選択します。

  6. [コンテンツ] タブの [アイテム バケット] セクションで、[バケット化を許可] を選択して、アイテムを保存します。

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

エンティティ マッピング アイテムとフィールド マッピング アイテムでは、コンテンツがどのようにインポートされ、どのバケットに保存されるのかを定義します。

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

  1. /sitecore/system/Modules/CMP に移動して [設定] を右クリックし、[挿入]、[エンティティ マッピング] の順にクリックします。新しいアイテムの名前 (例: Article) を入力します。既定では、すべてのエンティティ マッピングには、表示名に対応した既定のフィールド マッパーが伴います。

  2. Article エンティティ マッピングで、/__Display name を選択します。[コンテンツ] タブの [CMP フィールド名] フィールドに、Sitecore Content Hub のエンティティ タイプまたはスキーマから取得した、有効な [プロパティ] フィールド名を入力します。Sitecore は、この名前を表示名として使用します。

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

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

    Article エンティティ マッピングの [コンテンツ] タブの [データ] セクション

  5. [コンテンツ] タブの [データ] セクションで、次のフィールドに入力します。

    フィールド

    コンテンツ

    エンティティ タイプのスキーマ

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

    バケット

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

    テンプレート

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

    アイテム名のプロパティ

    エンティティ タイプの有効な [プロパティ] フィールド値を Sitecore のアイテム名として入力します

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

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

インポートされたコンテンツを Sitecore のアイテム構造にマップするには、各エンティティ マッピング アイテムにフィールド マッピング アイテムを追加する必要があります。インポートするフィールドごとに、フィールド マッピング アイテムを作成する必要があります。

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

  1. 以前に作成したエンティティ マッピング アイテムを右クリックし、[挿入]、[フィールド マッピング] の順にクリックします。

  2. 名前 (例: Title) を入力し、[OK] をクリックします。

  3. [コンテンツ] タブの [データ] セクションで、次のフィールドに入力します。

    フィールド

    コンテンツ

    CMP フィールド名

    Sitecore Content Hub のフィールド名

    Sitecoreフィールド名

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

    CMP フィールド名のフィールドと Sitecore フィールド名のフィールドを表示するフィールド・マッピング アイテムの [コンテンツ] タブの [データ] セクション

フィールド マッピング アイテムは、必要に応じていくつでも追加できます。

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") をたどります。

    エンティティ構造 JSON の ContentType ToContent ノード

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

    エンティティ構造 JSON のコンテンツ タイプ

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

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

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

  1. 以前に作成したエンティティ マッピング アイテムを右クリックし、[挿入]、[リレーション フィールド マッピング] の順にクリックします。

  2. 名前 (例: Audiences) を入力し、[OK] をクリックします。

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

    フィールド

    コンテンツ

    CMP リレーション

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

    CMP フィールド名

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

    Sitecoreフィールド名

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

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

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

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

  1. 以前に作成したエンティティ マッピング アイテムを右クリックし、[挿入]、[タグ フィールド マッピング] の順にクリックします。

  2. 名前 (例: Tag Taxonomy) を入力し、[OK] をクリックします。

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

    フィールド

    コンテンツ

    CMP リレーション

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

    CMP フィールド名

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

    非リーフ ノードの格納を有効/無効にする

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

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

    • 非リーフ ノードを無効にする

    「タグ名の保存」オプション:

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

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

    • ノード名

    カスタム タクソノミー プロバイダー名

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

    注記

    カスタム タクソノミー プロバイダーを作成する方法の詳細については、Sitecore 開発者向けドキュメントの「カスタム タクソノミー プロバイダーを作成するカスタム タクソノミー プロバイダーを作成する」を参照してください。

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

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、