SXAの拡張

データソース

Version:

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

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

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

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

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

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

メモ

新しいレンダリングを作成するとき、Sitecore開発者は、レンダリングを適切に設定できるように、新しいカスタムレンダリングがどのカテゴリに分類されるかを決定する必要があります。

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

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

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

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

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

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

プラットフォーム/テナント/サイトごとに1つのデータソース項目

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

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

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

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

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

手記

追加のテンプレートを選択するには、レンダリングsitecore/Layout/Renderings/Feature/rendering group/renderingに移動し、エクスペリエンスアクセラレータセクションのAdditional compatible templatesフィールドでテンプレートをクリックし、右矢印をクリックして選択したテンプレートのリストに移動します。

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

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

たとえば、 sitecore/Layout/Renderings/Feature/JSON/JSON Contentに移動し、エクスペリエンスアクセラレータセクションでCan select Page as a data sourceオプションを選択します。

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

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

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

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

管理者は、次のいずれかのオプションを選択することで、Settingsアイテム(/sitecore/content/<TENANT_GROUP>/<TENANT>/<SITE>/Settings)のEditingセクションで再利用できないコンポーネントの動作を設定できます。

名前を自動生成し、サイトデータの下にアイテムを保存 – 新しいデータソースアイテムは、自動生成された名前で作成され、サイト全体で共有される場所に保存されます。
名前を自動生成し、現在のページにアイテムを保存する - 新しいデータソースアイテムが自動生成された名前で作成され、特定のページの下にページ相対データソースアイテムとして保存されます。
ユーザーに名前の入力を求め、サイトデータの下にアイテムを保存する – 作成者は、サイト全体で共有される場所に格納されている新しいデータソースアイテムの名前を指定するように求められます。
ユーザーに名前の入力を求め、現在のページにアイテムを保存する - 作成者は、特定のページの下にページ相対データソースアイテムとして格納される新しいデータソースアイテムの名前を入力するように求められます。

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

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

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

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

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