SXAの拡張

データソース

Version:

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

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

SXAには、モジュラーコンポーネントベースの設計を保証するための事前定義されたレンダリングのライブラリが付属しています。ほとんどのSXAレンダリングは、再利用性を考慮して設計されており、データソースアイテムからデータを取得します。つまり、表示されるコンテンツは、表示されるページにバインドされず、データソースアイテムに格納されます。レンダリングをページに追加すると、Associated Contentダイアログで既存のデータソースアイテムを選択するか、新しいデータソースアイテムを作成できます。

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

Datasource Location – ユーザーがデータソースを検索できる場所を指定します(sitcore/Layout/Renderings/Feature/Headless Experience Accelerator/rendering/
Datasource Template – ユーザーが作成できるデータソースのタイプを指定します。
Data source – データソースアイテムを指定します。

このトピックでは、レンダリングでデータソースアイテムがどのように使用されるかについて説明します。

メモ

Datasource LocationフィールドとDatasource Templateフィールドを見つけるには、コンテンツエディターでsitecore/Layout/Renderings/Feature/Headless Experienceに移動し、レンダリングを選択してEditor Optionsセクションまで下にスクロールします。Data sourceフィールドはDataセクションにあります。
新しいレンダリングを作成する場合、Sitecore開発者は、レンダリングを適切に設定できるように、新しいカスタムレンダリングがどのカテゴリに分類されるかを決定する必要があります。

データソースアイテムがありません

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

畑	価値
データソースの場所	空のままにします。
データソーステンプレート	空のままにします。
データソース	空のままにします。

オプションのデータソース項目

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

畑	価値
データソースの場所	空のままにします
データソーステンプレート	空のままにします
データソース	空のままにするか、データソース項目を参照します

プラットフォーム/サイトコレクション/サイトごとに1つのデータソースアイテム

1つのデータソースアイテムを含むレンダリングでは、特定のプラットフォーム、サイトコレクション、またはサイトに固有の1つのデータソースが常に使用されます。たとえば、プロモーションレンダリングです。

畑	価値
データソースの場所	空のままにします
データソーステンプレート	空のままにします
データソース	データソース項目参照

再利用可能なデータソース

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

畑	価値
データソースの場所	レンダリングデータソース項目をグループ化する項目への参照。
データソーステンプレート	データソースアイテムテンプレートへの参照。
データソース	空のままにします。

手記

追加のテンプレートを選択するには、レンダリングsitecore/Layout/Renderings/Feature/Headless Experience Acceleratorに移動し、Additional compatible templatesフィールドでテンプレートをクリックし、右矢印をクリックして選択したテンプレートのリストに移動します。

データソースとしてページを選択

現在のページのコンテンツを使用できるレンダリングには、ページをデータソースとして選択するオプションがあります。 Can select Page as a data sourceボックスを選択すると、ページをデータソースとして使用できます。このオプションは、ページコンテンツなど、現在のページからコンテンツを取得するレンダリングで使用できます。

たとえば、 sitecore/Layout/Renderings/Feature/Headless Experience Accelerator/Page Content/Page Contentに移動し、Experience AcceleratorセクションでCan select Page as a data sourceチェックボックスをオンにします。

Use content from the current page and select the Page as data source option.

自動生成されたデータソース

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

畑	価値
データソースの場所	レンダリングデータソース項目をグループ化する項目への参照。
データソーステンプレート	データソースアイテムテンプレートへの参照。
データソース	空のままにします。
その他のプロパティ	IsAutoDatasourceRendering - レンダリングをページに追加した後にデータソースが自動的に作成されるレンダリングの場合はtrueに設定します。

ローカルデータソースの名前を変更する

ローカルデータソース項目 (<Page>/Data) の名前を手動で変更しないことをお勧めします。ローカル・データ・ソース項目の名前を変更すると、コンポーネントとのリンクが切断される可能性があります (リンクは相対パスとして格納されるため)。

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

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

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