データソース

概要

レンダリングがデータソース アイテムにどのように関係するかについての詳細をご覧ください。

SXA には、モジュール式コンポーネントを基にして設計できるように、事前定義されたレンダリングのライブラリが付属しています。ほとんどの SXA レンダリングは、再利用できるように設計されており、データソース アイテムからデータをプルします。これにより、表示されるコンテンツは、表示されるページにバインドされず、データソース アイテムに保存されます。ページにレンダリングを追加する際に、[関連コンテンツ] ダイアログでは、既存のデータソース アイテムを選択するか、新しいデータソース アイテムを作成できます。

次のフィールドは、レンダリングがデータソース アイテムにどのように関連付けられるかを指定します。

  • データソースの場所 – ユーザーがデータソースを検索できる場所を指定します。

  • データソース テンプレート – ユーザーが作成できるデータソースのタイプを指定します。

  • データソース – データソース アイテムを指定します。

このトピックでは、データソース アイテムの使用方法に応じた SXA のレンダリング方法について説明します。

注記

新しいレンダリングを構築する場合、Sitecore 開発者は、レンダリングを適切に設定するために、新しいカスタム レンダリングがどのカテゴリに分類されるかを決定する必要があります。

データソース アイテムのないレンダリングは、ナビゲーションや Breadcrumb レンダリングなど、独自のデータを保存しません。それらは静的であり、コンテンツ作成者が編集することはできません。

フィールド

データソースの場所

空のままにします。

データソース テンプレート

空のままにします。

データソース

空のままにします。

デフォルトでは、タイトル、サブタイトル、コンテンツなどのオプションのデータソース アイテムを使用するレンダリングでは、現在のページからデータを読み取りますが、代わりにデータソース アイテムから情報を読み取るように設定できます。

フィールド

データソースの場所

空のままにします

データソース テンプレート

空のままにします

データソース

空のままにするか、データソース アイテムを参照します

単一のデータソース アイテムを使用したレンダリングでは、Cookie の警告やプロモーションのレンダリングなど、常に特定のプラットフォーム、テナント、またはサイトに固有の 1 つのデータソースが使用されます。

フィールド

データソースの場所

空のままにします

データソース テンプレート

空のままにします

データソース

データソース アイテムの参照

アコーディオン、カルーセル、およびビデオのレンダリングなど、再利用可能なデータソースを使用したレンダリングにより、コンテンツ エディターでデータソース アイテムを作成および/または選択できます。

フィールド

データソースの場所

レンダリング データソース アイテムをグループ化するアイテムへの参照。

データソース テンプレート

データソース アイテム テンプレートへの参照。

データソース

空のままにします。

58F7EFB4774F478582B80016960DCCD1.png

注記

追加のテンプレートを選択するには、sitecore/レイアウト/レンダリング/機能/レンダリンググループ/レンダリングのレンダリングに移動します。[エクスペリエンス アクセラレーター] セクションの [追加互換性のあるテンプレート] フィールドで、テンプレートをクリックし、右矢印をクリックして、選択済みテンプレートのリストに移動します。

現在のページからのコンテンツを使用できるレンダリングの場合、データソースとしてページを選択するオプションがあります。[データ ソースとしてページを選択可能] のチェックボックスがオンになっている場合は、データソースとしてページを使用できます。このオプションは、ページ コンテンツ、ページ リスト、JSON コンテンツ、JSON リストなど、現在のページからのコンテンツを使用できるレンダリングの場合に表示されます。

たとえば、sitecore/レイアウト/レンダリング/機能/JSON/JSON コンテンツに移動して、[エクスペリエンス アクセラレーター] セクションで、[データソースとしてページを選択可能] オプションを選択します。

現在のページのコンテンツを使用し、[データソースとしてページを選択可能] オプションを選択します。

リッチ テキスト、画像、プレーン HTML のレンダリングなどの、自動生成されたデータソースを使用したレンダリングでは、コンテンツ エディターがレンダリングをページに配置したときにデータが保存されデータソース アイテムが作成されます。

フィールド

データソースの場所

レンダリング データソース アイテムをグループ化するアイテムへの参照。

データソース テンプレート

データソース アイテム テンプレートへの参照。

データソース

空のままにします。

その他のプロパティ

IsAutoDatasourceRendering - レンダリングをページに追加した後、データソースが自動的に作成されるレンダリングの場合に True に設定。

SXA-datasource-other-properties.png

管理者は、再利用不可能なコンポーネントの動作を [設定] アイテム (/sitecore/コンテンツ/<TENANT_GROUP>/<TENANT>/<SITE>/設定) の [編集] セクションで次のいずれかのオプションを選択することにより設定できます。

  • 名前を自動生成し、アイテムをサイト データに保存する – 自動生成された名前で新しいデータソース アイテムが作成され、サイト全体で共有できる場所に保存されます。

  • 名前を自動生成し、現在のページにアイテムを保存する – 自動生成された名前で新しいデータソース アイテムが作成され、特定のページの下にページ相対データソース アイテムとして保存されます。

  • ユーザーに名前の入力を求め、アイテムをサイト データに保存する – 作成者は、サイト全体で共有できる場所に保存される新しいデータソース アイテムの名前を入力するように求められます。

  • ユーザーに名前の入力を求め、現在のページにアイテムを保存する – 作成者は、特定のページの下にページ相対データソース アイテムとして保存される新しいデータソース アイテムの名前を入力するように求められます。

ローカル データソース アイテム (<ページ>/データ) の名前を手動で変更しないことをお勧めします。ローカル データソース アイテムの名前を変更すると、コンポーネントのリンクが壊れる可能性があります (リンクは相対パスに保存されているため)。

ローカル データソース アイテムの名前を変更する場合は、データソースの選択ダイアログでアイテムを再選択する必要があります。

または、名前を変更する前に、データソース参照を GUID に変換できます。その後なら、名前を変更しても安全です。

データソースを GUID に変換する